Datenquellen für Canvas-Apps verstehen

In Power Apps verwenden die meisten Canvas Apps externe Informationen, die in Cloud-Diensten mit der Bezeichnung Datenquellen gespeichert sind. Ein gängiges Beispiel ist eine Tabelle in einer Excel-Datei, die in OneDrive for Business gespeichert ist. Apps greifen auf diese Datenquellen mithilfe von Verbindungen zu.

In diesem Artikel werden die verschiedenen Arten von Datenquellen und das Arbeiten mit Datenquellen in Form von Tabellen beschrieben.

Es ist einfach, eine App zu erstellen, die grundlegende Lese- und Schreibvorgänge in Bezug auf eine Datenquelle ausführt. Es gibt aber Fälle, in denen Sie den Datenfluss in Ihre App und aus Ihrer App besser kontrollieren möchten. In diesem Artikel wird beschrieben, wie die Funktionen Patch, DataSourceInfo, Validate und Errors eine bessere Kontrolle ermöglichen.

Arten von Datenquellen

Datenquellen können mit einem Clouddienst verbunden sein oder für eine App lokal sein.

Verbundene Datenquellen

Die geläufigsten Datenquellen sind Tabellen, die Sie zum Abrufen und Speichern von Informationen verwenden können. Mithilfe von Verbindungen mit Datenquellen können Sie Daten in Microsoft Excel-Arbeitsmappen, mit Microsoft Lists erstellte Listen, SharePoint-Bibliotheken, SQL-Tabellen und vielen anderen Formaten lesen und schreiben, die in Clouddiensten wie OneDrive for Business, DropBox und SQL Server gespeichert sein können.

Andere Datenquellen als Tabellen sind z.B. E-Mail, Kalender, Twitter und Benachrichtigungen, die jedoch in diesem Artikel nicht behandelt werden.

Lokale Datenquellen

Mithilfe der Steuerelemente Katalog, Formular anzeigen und Formular bearbeiten ist es einfach, eine App zu erstellen, die Daten aus einer Datenquelle liest und schreibt. Lesen Sie für den Einstieg den Element Grundlegendes zu Datenformularen.

Wenn Sie Power Apps zum Erstellen einer App aus Daten auffordern, werden diese Steuerelemente verwendet. Im Hintergrund verwendet die App eine interne Tabelle zum Speichern und Bearbeiten der Daten, die aus der Datenquelle stammen.

Eine besondere Art von Datenquelle ist die Sammlung, die für die App lokal ist und nicht über eine Verbindung mit einem Dienst in der Cloud gesichert ist, sodass die Informationen nicht auf Geräten für den gleichen oder andere Benutzer freigegeben werden können. Sammlungen können geladen und lokal gespeichert werden.

Arten von Tabellen

Bei Tabellen, die für eine App in Power Apps intern sind, handelt es sich wie bei einer Zahl oder einer Zeichenfolge um feste Werte. Interne Tabellen sind nur im Arbeitsspeicher der App vorhanden und werden an keiner anderen Stelle gespeichert. Sie können die Struktur und die Daten einer Tabelle nicht direkt ändern. Sie können stattdessen eine neue Tabelle mithilfe einer Formel erstellen, indem Sie mit dieser Formel eine geänderte Kopie der ursprünglichen Tabelle erstellen.

Externe Tabellen werden in einer Datenquelle für späteren Abruf und Freigabe gespeichert. Power Apps bietet „Verbindungen“ zum Lesen und Schreiben von gespeicherten Daten. Innerhalb einer Verbindung können Sie auf mehrere Tabellen mit Informationen zugreifen. Sie wählen aus, welche Tabellen in der App verwendet werden sollen, und aus jeder wird eine separate Datenquelle.

Wenn Sie mehr erfahren möchten, wird unter Arbeiten mit Tabellen ausführlicher auf interne Tabellen eingegangen, aber auch auf externe Tabellen, die sich in einem Clouddienst befinden.

Arbeiten mit Tabellen

Sie können Datenquellen in Form von Tabellen wie eine interne Power Apps-Tabelle verwenden. Wie eine interne Tabelle weist auch jede Datenquelle Datensätze, Spalten und Eigenschaften auf, die Sie in Formeln verwenden können. Zusätzlich:

• Die Datenquelle weist die gleichen Spaltennamen und Datentypen auf wie die zugrunde liegende Tabelle in der Verbindung.

  Hinweis

  Bei Excel- oder SharePoint-Datenquellen, die Spaltennamen mit Leerzeichen enthalten, ersetzt Power Apps die Leerzeichen durch "_X0020_". Beispielsweise Name der Spalte in SharePoint oder Excel wird als Column_x0020_Name in Power Apps angezeigt, wenn das Datenlayout angezeigt oder in einer Formel verwendet wird.

• Die Datenquelle wird automatisch vom Dienst geladen, wenn die App geladen wird. Sie können erzwingen, dass die Daten aktualisiert werden, indem Sie die Refresh-Funktion verwenden.

• Wenn Benutzer eine App ausführen, können sie Datensätze erstellen, ändern und löschen und diese Änderungen mithilfe von Push an die zugrunde liegende Tabelle im Dienst zurückleiten.

  • Datensätze können mithilfe der Funktionen Patch und Collect erstellt werden.
  • Datensätze können mithilfe der Funktionen Patch, Update und UpdateIf geändert werden.
  • Datensätze können mithilfe der Funktionen Remove und RemoveIf entfernt werden.
  • Fehler, die bei der Arbeit mit einer Datenquelle auftreten, sind über die Errors-Funktion verfügbar.

• Die Funktionen DataSourceInfo, Defaults und Validate bieten Informationen über die Datenquelle, mit denen Sie die Benutzerfreundlichkeit optimieren können.

Erstellen von Datenquellen

Power Apps kann nicht zum Erstellen einer verbundenen Datenquelle oder zum Ändern deren Struktur verwendet werden; die Datenquelle muss bereits in einem Dienst vorhanden sein. Beispielsweise verwenden Sie zum Erstellen einer Tabelle in einer auf OneDrive gespeicherten Excel-Arbeitsmappe zunächst Excel Online auf OneDrive, um eine Arbeitsmappe zu erstellen. Als Nächstes erstellen Sie eine Verbindung zu Ihrer App.

Datenquellen einer Sammlung können innerhalb einer App erstellt und geändert werden, sind jedoch nur temporär.

Anzeigen eines oder mehrerer Datensätze

Das obige Diagramm veranschaulicht den Informationsfluss, wenn eine App die Informationen in einer Datenquelle liest:

• Die Informationen werden über einen Speicherdienst (in diesem Fall Microsoft Lists bzw. SharePoint Online).
• Eine Verbindung stellt diese Informationen der App zur Verfügung. Die Verbindung übernimmt die Authentifizierung des Benutzers, der auf die Informationen zugreift.
• Wenn die App gestartet wird oder die Refresh-Funktion gedrückt wird, werden Informationen zur lokalen Verwendung aus der Verbindung in eine Datenquelle in der App geholt.
• Formeln werden verwendet, um die Informationen zu lesen und sie in Steuerelementen verfügbar zu machen, die der Benutzer sehen kann. Sie können die Datensätze einer Datenquelle anzeigen, indem Sie einen Katalog auf einem Formular verwenden und die Items-Eigenschaft mit der Datenquelle verknüpfen: Gallery.Items = DataSource. Sie verknüpfen Steuerelemente innerhalb des Katalogs mit dem Katalog, indem Sie die Default-Eigenschaft der Steuerelemente verwenden.
• Die Datenquelle ist auch eine Tabelle. Sie können also Filter, Sort, AddColumns und andere Funktionen verwenden, um die Datenquelle zu optimieren und zu erweitern, bevor Sie sie als Ganzes verwenden. Sie können auch Lookup, First, Last und andere Funktionen zur Arbeit mit einzelnen Datensätzen verwenden.

Ändern eines Datensatzes

Im vorherigen Abschnitt haben Sie gesehen, wie eine Datenquelle gelesen wird. Beachten Sie, dass die Pfeile in der Abbildung oben unidirektional sind. Änderungen an einer Datenquelle werden nicht mithilfe von Push über die gleichen Formeln zurückgeleitet, über die die Daten abgerufen wurden. Stattdessen werden neue Formeln verwendet. Häufig wird zum Bearbeiten eines Datensatzes ein anderes Formular als zum Durchsuchen von Datensätzen verwendet, vor allem auf einem mobilen Gerät.

Beachten Sie, dass zum Ändern eines vorhandenen Datensatzes einer Datenquelle der Datensatz ursprünglich aus der Datenquelle stammen muss. Der Datensatz kann durch einen Katalog, eine Kontextvariable und eine beliebige Anzahl von Formeln gegangen sein, aber sein Ursprung sollte zur Datenquelle zurückverfolgt werden können. Dies ist wichtig, da zusätzliche Informationen mit dem Datensatz übertragen werden, durch die er eindeutig identifiziert werden kann, um sicherzustellen, dass Sie den richtigen Datensatz ändern.

Das obige Diagramm zeigt den Informationsfluss zum Aktualisieren einer Datenquelle:

• Ein Bearbeitungsformular-Steuerelement stellt einen Container für Eingabekarten zur Verfügung, die aus Benutzereingabesteuerelementen wie einem Texteingabefeld oder einem Schieberegler bestehen. Die Eigenschaften DataSource und Item werden verwendet, um den zu bearbeitenden Datensatz zu identifizieren.
• Jede Eingabekarte verfügt über eine Default-Eigenschaft, die in der Regel auf das Feld des ThisItem-Datensatzes des Formulars festgelegt wird. Die Steuerelemente in der Eingabekarte nehmen dann ihre Eingabewerte von Default. Normalerweise müssen Sie diese Option nicht ändern.
• Jede Eingabekarte macht eine Update-Eigenschaft verfügbar. Diese Eigenschaft entspricht der Eingabe des Benutzers in ein bestimmtes Feld des Datensatzes für das Zurückschreiben an die Datenquelle. Normalerweise müssen Sie diese Option nicht ändern.
• Eine Schaltfläche oder ein Bildsteuerelement auf dem Formular ermöglichen dem Benutzer, Änderungen am Datensatz zu speichern. Die OnSelect-Formel des Steuerelements ruft die SubmitForm-Funktion für diese Aufgabe auf. SubmitForm liest alle Update-Eigenschaften der Karten und verwendet diese zum Zurückschreiben an die Datenquelle.
• In einigen Fällen werden Probleme auftreten. Eine Netzwerkverbindung ist möglicherweise offline, oder eine Validierungsüberprüfung erfolgt durch einen Dienst, der App nicht bekannt war. Die Eigenschaften Error und ErrorKind des form-Steuerelements stellen diese Informationen zur Verfügung, damit Sie dem Benutzer angezeigt werden können.

Für eine differenziertere Kontrolle über diesen Prozess können Sie auch die Funktionen Patch und Errors verwenden. Das Formular bearbeiten-Steuerelement stellt eine Updates-Eigenschaft zur Verfügung, damit Sie die Werte der Felder innerhalb des Formulars lesen können. Sie können diese Eigenschaft auch verwenden, um einen benutzerdefinierten Connector für eine Verbindung aufzurufen, und die Funktionen Patch und SubmitForm vollständig umgehen.

Überprüfung

Vor einer Änderung an einem Datensatz sollte die App so gut es geht sicherstellen, dass die Änderung akzeptiert wird. Es gibt zwei Gründe dafür:

• Unmittelbares Feedback für den Benutzer. Am besten wird ein Problem behoben, wenn es gerade aufgetreten und dem Benutzer noch besonders bewusst ist. Im Prinzip kann mit jedem Touch oder Tastaturanschlag roter Text angezeigt werden, der ein Problem mit dem Eintrag angibt.
• Weniger Netzwerkverkehr und geringere Wartezeit für den Benutzer. Je mehr Probleme in der App erkannt werden, desto weniger Konversationen über das Netzwerk sind nötig, um Fehler zu erkennen und zu beheben. Jede Konversation nimmt Zeit in Anspruch, während der Benutzer warten muss, bevor er den Vorgang fortsetzen kann.

Power Apps bietet zwei Tools zur Validierung:

• Die Datenquelle kann Informationen darüber geben, was gültig ist und was nicht. Zum Beispiel können Zahlen über Mindest- und Höchstwerte verfügen, und ein oder mehrere Einträge können erforderlich sein. Sie können auf diese Informationen mit der DataSourceInfo-Funktion zugreifen.
• Die Validate-Funktion verwendet dieselben Informationen, um den Wert einer einzelnen Spalte oder eines vollständigen Datensatzes zu überprüfen.

Fehlerbehandlung

Hervorragend, Sie haben den Datensatz validiert. Nun ist es an der Zeit, diesen Datensatz mit Patch zu aktualisieren!

Aber leider gibt es möglicherweise noch immer ein Problem. Das Netzwerk ist ausgefallen, die Validierung am Dienst ist fehlgeschlagen, oder der Benutzer verfügt nicht über die nötigen Berechtigungen, um nur einige der möglichen Fehler zu nennen, die bei Ihrer App auftreten können. Sie muss angemessen auf Fehlersituationen reagieren und dem Benutzer Feedback und eine Möglichkeit bieten, den Fehler zu beheben.

Wenn Fehler mit einer Datenquelle auftreten, zeichnet die App die Fehlerinformationen automatisch auf und stellt sie über die Errors-Funktion zur Verfügung. Fehler werden den Datensätzen zugeordnet, bei denen die Probleme aufgetreten sind. Wenn der Benutzer ein Problem selbst beheben kann wie z.B. ein Validierungsproblem, kann er den Datensatz erneut übermitteln, und die Fehler werden gelöscht.

Wenn ein Fehler bei der Erstellung eines Datensatzes mit Patch oder Collect auftritt, gibt es keinen Datensatz, dem Fehler zugeordnet werden können. In diesem Fall wird von Patch leer zurückgegeben, das als Datensatzargument für Errors verwendet werden kann. Erstellungsfehler werden mit dem nächsten Vorgang gelöscht.

Die Errors-Funktion gibt eine Tabelle mit Fehlerinformationen zurück. Diese Informationen können die Spalteninformationen enthalten, wenn der Fehler einer bestimmten Spalte zugeordnet werden kann. Verwenden Sie Fehlermeldungen auf Spaltenebene in Bezeichnungssteuerelementen, die sich in der Nähe der Spalte auf der Bearbeitungsansicht befinden. Verwenden Sie Fehlermeldungen auf Datensatzebene, bei denen die Spalte in der Fehlertabelle leer ist, in der Nähe der Schaltfläche Save (Speichern) für den gesamten Datensatz.

Arbeiten mit großen Datenquellen

Beim Erstellen von Berichten aus großen Datenquellen (z.B. Millionen von Datensätzen) möchten Sie den Netzwerkverkehr minimieren. Nehmen wir an, dass Sie über alle Kunden mit StatusCode „Platinum“ (Platin) in New York City Berichte erstellen möchten und dass die Customers-Tabelle (Kunden) Millionen von Datensätzen enthält.

Sie möchten nicht diese Millionen von Kunden in Ihre App überführen, sondern die gewünschten auswählen. Sie möchten, dass diese Auswahl in Ihrem Clouddienst erfolgt, in dem die Tabelle gespeichert ist, und Sie nur die ausgewählten Datensätze über das Netzwerk senden.

Viele, aber nicht alle Funktionen, die Sie zur Auswahl der Datensätze verwenden können, können delegiert werden, d.h. dass sie im Clouddienst ausgeführt werden. Wie Sie dies tun können, erfahren Sie unter Delegation (Delegierung).

Sammlungen

Sammlungen sind eine besondere Art von Datenquelle. Sie sind für die App lokal und werden nicht über eine Verbindung mit einem Dienst in der Cloud gesichert, sodass die Informationen nicht auf Geräten für den gleichen oder andere Benutzer freigegeben werden können. Sie funktionieren mit wenigen Ausnahmen wie jede andere Datenquelle:

• Sammlungen können mit der Collect-Funktion dynamisch erstellt werden. Sie müssen im Gegensatz zu verbindungsbasierten Datenquellen nicht im Voraus erstellt werden.
• Die Spalten einer Sammlung können jederzeit mit der Collect-Funktion geändert werden.
• Sammlungen lassen doppelte Datensätze zu. Mehr als eine Kopie desselben Datensatzes kann in einer Sammlung vorhanden sein. Funktionen wie Remove verarbeiten die erste Übereinstimmung, die sie finden, es sei denn, das All-Argument wird angegeben.
• Sie können die Funktionen SaveData und LoadData zum Speichern und erneuten Laden einer Kopie der Sammlung verwenden. Die Informationen werden an einem privaten Speicherort gespeichert, auf den andere Benutzer, Apps oder Geräte nicht zugreifen können.
• Sie können die Steuerelemente Exportieren und Importieren zum Speichern und erneuten Laden eine Kopie der Sammlung in eine Datei verwenden, mit der der Benutzer interagieren kann.

Weitere Informationen zum Arbeiten mit einer Sammlung als Datenquelle finden Sie unter Create and update a collection (Erstellen und Aktualisieren einer Sammlung).

Sammlungen werden häufig verwendet, um den globalen Zustand für die App zu speichern. Weitere Informationen zu den verfügbaren Optionen zum Verwalten des Zustands finden Sie unter Working with variables (Arbeiten mit Variablen).