So verbinden Sie Ihre Code-App mit Daten

Erfahren Sie, wie Sie Ihre Code-App mit Daten mithilfe von Power Platform-Connectors verbinden, damit Sie Datenquellen hinzufügen und generierte Dienste aus Ihrer App aufrufen können.

Führen Sie die folgenden Schritte aus:

1. Erstellen und Einrichten von Verbindungen mit der Power Apps CLI
2. Hinzufügen einer Verbindung zu einer Code-App
3. Aktualisieren Sie die App, um Verbindungen herzustellen

Hinweis

Führen Sie diese Schritte aus, nachdem Sie die App mit pa app init initialisiert haben.

Erstellen und Einrichten von Verbindungen mit der Power Apps CLI

Verwenden Sie die Power Apps CLI, um einen Verbinder zu finden und seine Verbindung zu erstellen. Befolgen Sie Erstellen einer Verbindung über die Power Apps CLI und speichern Sie die von dem Befehl zurückgegebene Verbindungs-ID.

Alle Connectors werden offiziell unterstützt, mit Ausnahme der im folgenden Abschnitt aufgeführten.

Connectors, die noch nicht unterstützt werden

• Excel Online (Business)
• Excel Online (OneDrive)

Tipp

Eine schrittweise Anleitung zum Verbinden Ihrer Code-App mit Azure SQL finden Sie unter How to: Connect your code app to Azure SQL.

Abrufen von Verbindungsmetadaten

Verwenden Sie pa connection list, um Ihre verfügbaren Verbindungen aufzulisten und ihre IDs abzurufen, falls Sie die von pa connection create zurückgegebene ID nicht gespeichert haben:

pa connection list

Der Befehl zeigt eine Tabelle mit Verbindungen, einschließlich der Verbindungs-ID und der Connector-ID. Verwenden Sie diese Werte, wenn Sie eine Datenquelle hinzufügen.

Fügen Sie eine Verbindung zu einer Code-App hinzu

Nachdem Sie vorhandene zu verwendende Verbindungen erstellt oder identifiziert und die Verbindungsmetadaten aus dem vorherigen Schritt kopiert haben, fügen Sie diese Verbindungen zur App hinzu.

Wenn Sie der App die Datenquellen hinzufügen, generiert der Prozess automatisch ein typiertes TypeScript-Modell und eine Dienstdatei im Repository. Beispielsweise erzeugt die Office 365 Benutzerdatenquelle Office365UsersModel und Office365UsersService Dateien.

Tipp

Führen Sie pa app add data-source in einem interaktiven Terminal ohne Parameter aus, um auf Eingabeaufforderungen zu reagieren. Für connectorbasierte tabellarische Datenquellen listet die CLI verfügbare Verbindungen, Datasets und Tabellen auf. Geben Sie für systemeigene Dataverse den logischen Tabellennamen und die Dataverse-Organisations-URL ein. Weitere Informationen zur Verwendung von pa app add data-source.

Hinzufügen einer nicht tabellarischen Datenquelle

Fügen Sie eine nicht tabellarische Datenquelle hinzu, z. B. Office 365-Benutzer, mithilfe von pa app add data-source.

Führen Sie in einer Befehlszeile den folgenden Befehl aus. Verwenden Sie den Bezeichner des Connectors und die Verbindungs-ID, die Sie den vorherigen Schritten entnommen haben. Für --connector können Sie auch den Anzeigenamen des Verbinders verwenden, z. B. "Office 365-Benutzer".

pa app add data-source --connector <connector-id> --connection-id <connection-id>

Beispiele:

pa app add data-source --connector "shared_office365users" --connection-id "aaaaaaaa000011112222bbbbbbbbbbbb"

Hinzufügen einer tabellarischen Datenquelle

SQL oder SharePoint sind Beispiele für tabellarische Datenquellen.

Verwenden Sie denselben pa app add data-source Befehl, fügen Sie jedoch die Tabelle und das Dataset ein. Das Schema der tabellarischen Datenquelle gibt diese Werte an. Wenn Sie diese Werte noch nicht haben, siehe Verfügbare Datasets und Tabellen ermitteln.

pa app add data-source `
--connector <connector-id> `
--connection-id <connection-id> `
--table <table-id> `
--dataset <dataset-name>

SQL-Beispiel

Wenn Sie mehrere Tabellen aus demselben Connector, derselben Verbindung und einem Dataset hinzufügen möchten, wiederholen Sie --table in einem einzigen Befehl:

pa app add data-source `
--connector "shared_sql" `
--connection-id "aaaaaaaa000011112222bbbbbbbbbbbb" `
--table "[dbo].[MobileDeviceInventory]" `
--table "[dbo].[EmployeeInformation]" `
--dataset "paconnectivitysql0425.database.windows.net,paruntimedb" 

Wenn eine einzelne Tabelle fehlschlägt, fügt der Befehl weiterhin die anderen gültigen Tabellen hinzu. Sie meldet, welche Tabellen erfolgreich waren und fehlgeschlagen sind, und gibt einen Exit-Code ungleich null zurück, wenn eine Tabelle fehlschlägt. Erfahren Sie mehr über pa app add data-source. Sie können pro Befehl nur eine systemeigene Dataverse-Tabelle oder sql-gespeicherte Prozedur einschließen.

beispiel für SharePoint

Für SharePoint --table ist der Listenname und --dataset die SharePoint Website:

pa app add data-source `
--connector "shared_sharepointonline" `
--connection-id "aaaaaaaa000011112222bbbbbbbbbbbb" `
--table "Travel%20Request" `
--dataset "https://contoso.sharepoint.com/sites/TravelPolicies"

Entdecken Sie verfügbare Datensätze und Tabellen

Verwenden Sie die pa connection Befehle, um verfügbare Datasets, Tabellen und gespeicherte Prozeduren für Ihre Verbindungen zu ermitteln. In einem interaktiven Terminal können Sie auch --connection-id, --dataset und --table auslassen, wenn Sie pa app add data-source ausführen. Der Befehl listet die verfügbaren Verbindungen und Datasets auf und öffnet dann eine durchsuchbare Tabellenliste, in der Sie eine oder mehrere Tabellen auswählen können.

Datensätze auflisten:

pa connection list-datasets --connector <connector-id> --connection-id <connection-id>

Listentabellen:

pa connection list-tables --connector <connector-id> --connection-id <connection-id> --dataset <dataset-name>

Sql-gespeicherte Prozeduren auflisten:

pa connection list-procedures --connection-id <connection-id> --dataset <dataset-name>

Beispielworkflow für SQL Server:

# Step 1: List available datasets
pa connection list-datasets --connector "shared_sql" --connection-id "aaaaaaaa000011112222bbbbbbbbbbbb"

# Step 2: List tables in the dataset
pa connection list-tables --connector "shared_sql" --connection-id "aaaaaaaa000011112222bbbbbbbbbbbb" `
  --dataset "paconnectivitysql0425.database.windows.net,paruntimedb"

# Step 3: Add the table to your code app
pa app add data-source --connector "shared_sql" --connection-id "aaaaaaaa000011112222bbbbbbbbbbbb" `
  --table "[dbo].[MobileDeviceInventory]" `
  --dataset "paconnectivitysql0425.database.windows.net,paruntimedb"

Tipp

Kopieren Sie die genauen Werte für Name aus der Befehlsausgabe, wenn Sie sie mit pa app add data-source verwenden. Namen unterscheiden zwischen Groß- und Kleinschreibung und können Sonderzeichen enthalten.

Hinzufügen einer gespeicherten SQL-Prozedur als Datenquelle

Führen Sie den folgenden Befehl über eine Befehlszeile aus. Verwenden Sie die Connector-ID und die Verbindungs-ID, die Sie zuvor erfasst haben.

pa app add data-source `
--connector <connector-id> `
--connection-id <connection-id> `
--dataset <dataset-name> `
--procedure <stored-procedure-name>

Beispiele:

pa app add data-source `
--connector "shared_sql" `
--connection-id "33dd33ddee44ff55aa6677bb77bb77bb" `
--dataset "paconnectivitysql0425.database.windows.net,paruntimedb" `
--procedure "[dbo].[GetRecordById]" 

Hinzufügen von Aktionen aus einem Connector, der auch Tabellen unterstützt

Einige Connectors, z. B. SharePoint und SQL Server, unterstützen sowohl Tabellen als auch Aktionen. Wenn Sie --table oder --procedure einschließen, fügt pa app add data-source eine Tabelle oder eine gespeicherte Prozedur hinzu. Wenn Sie stattdessen die Aktionen des Connectors hinzufügen möchten, schließen Sie --as action ein, und schließen Sie --table, --procedure oder --dataset nicht ein:

pa app add data-source `
--connector "shared_sharepointonline" `
--connection-id "aaaaaaaa000011112222bbbbbbbbbbbb" `
--as action

Sie können Tabellen und Aktionen aus demselben Connector in Ihrer App verwenden. Wenn Sie Aktionen für eine Verbindung hinzufügen, die Sie bereits als Tabelle hinzugefügt haben, erstellt die CLI eine separate Datenquelle in Ihrer App für die Aktionen und behält die vorhandene Tabellenbindung bei.

Wenn Sie --as, --table oder --procedure für einen dieser Connectors nicht angeben, fragt der Befehl Tabelle hinzufügen? in einem interaktiven Terminal. Im nicht interaktiven Modus, z. B. in einer CI/CD-Pipeline, schlägt der Befehl fehl, bis Sie --as table oder --as action hinzufügen.

Entfernen einer Datenquelle

Bei Bedarf können Sie Datenquellen nach dem Hinzufügen löschen.

Verwenden Sie pa app remove data-source mit dem Connectorbezeichner und dem Datenquellennamen.

pa app remove data-source --connector <connector-id> --name <data-source-name>

Beispiele:

pa app remove data-source `
--connector "shared_sql" `
--name "MobileDeviceInventory" 

Aktualisieren einer Datenquelle

Wenn sich das Schema ändert, verwenden Sie pa app refresh data-source, um die generierten Modell- und Dienstdateien zu aktualisieren:

pa app refresh data-source --name <data-source-name>

Verwenden von Verbindungsverweisen zum Hinzufügen einer Datenquelle

Verwenden Sie Verbindungsverweise, um Ihrer Code-App Datenquellen hinzuzufügen. Ein Verbindungsverweis ist eine Lösungskomponente, die auf eine bestimmte Verbindung für einen Verbinder verweist. Anstatt Ihre App direkt an eine benutzerspezifische Verbindung zu binden, binden Sie sie an einen Verweis. Dieser Ansatz macht die Lösung umgebungsfähig und portierbar in Dev-, Test- und Prod-Umgebungen für eine reibungslose Verwaltung des Anwendungslebenszyklus.

Hinweis

In diesem Abschnitt wird davon ausgegangen, dass Sie über grundlegende Kenntnisse zu Lösungen in Power Apps und zu Verbindungsreferenzen verfügen. Sie sollten bereits eine Lösung und einen Verbindungsverweis in dieser Lösung für Ihre Datenquelle erstellt haben. Falls nicht, folgen Sie den Schritten, die in den Links im nächsten Abschnitt beschrieben sind, um eines zu erstellen.

• Erfahren Sie mehr über Lösungen in Power Apps.
• Erfahren Sie mehr über Verbindungsverweise und was sie für Ihre Power Apps nützlich macht.

Lösungs-ID abrufen

Verwenden Sie den Lösungslistenbefehl, um die ID Ihrer Lösung abzurufen.

1. Öffnen Sie eine Eingabeaufforderung oder ein Terminalfenster.

2. Führen Sie den folgenden Befehl aus, um eine Liste der Lösungen in der Umgebung abzurufen, mit der Sie verbunden sind:

   pa solution list
   

   Durch diesen Befehl wird eine Tabelle mit den Lösungseigenschaften Id, SolutionUniqueName, Version und FriendlyName an die Konsole ausgegeben.

3. Kopieren Sie die Lösung Id , und speichern Sie sie zur späteren Verwendung.

Erhalten Sie den Namen der Verbindungsreferenz zu Ihrer Datenquelle

Verwenden Sie die Power Apps CLI, um die Verbindungsverweise in einer Lösung auflisten:

1. Öffnen Sie eine Eingabeaufforderung oder ein Terminalfenster.

2. Verwenden Sie pa connection list-references, um die Lösungs-ID und den Namen der Verbindungsreferenz zu Ihrer Datenquelle abzurufen:

   pa connection list-references --solution-id <solution-id>
   

3. Die Ausgabe enthält den Anzeigenamen, den logischen Namen und die Beschreibung der Verbindungsverweise in der Lösung.

Fügen Sie die Datenquelle mithilfe des Verbindungsverweises zu Ihrer Code-App hinzu.

Führen Sie in einer Befehlszeile den folgenden Befehl aus. Verwenden Sie die Lösungs-ID und den logischen Namen der Verbindungsreferenz, die aus den vorherigen Schritten gesammelt wurden.

pa app add data-source `
--connector <connector-id> `
--connection-ref <connection-reference-logical-name> `
--solution-id <solution-id>

Die App verwendet nun die Verbindung, die dem Verbindungsverweis in Ihrer Power Apps Lösung zugeordnet ist.

Verwenden Sie den logischen Namen des Verbindungsverweises, nicht den Anzeigenamen. Die Ausgabe enthält pa connection list-references den logischen Namen. Ein logischer Name beginnt mit einem Buchstaben und enthält nur Buchstaben, Ziffern und Unterstriche, z. B. cr123_sharedsharepointonline_1a2b3.

Für einen Verbinder, der auch Tabellen unterstützt, z. B. SharePoint, fügen Sie --dataset und --table ein, um eine Tabelle hinzuzufügen, oder --as action, um die Aktionen des Connectors hinzuzufügen. In einem interaktiven Terminal können Sie --dataset und --table auslassen und sie dann aus den Datasets und Tabellen auswählen, die über die Verbindung verfügbar sind, auf die die Referenz verweist.

Wenn Sie pa app add data-source in einem interaktiven Terminal ohne --connection-id oder --connection-ref ausführen, fragt der Befehl Verwenden Sie einen Verbindungsverweis anstelle einer Verbindungs-ID?, bevor Ihre Verbindungen aufgelistet werden. Wählen Sie Ja aus, und geben Sie dann den logischen Namen des Verbindungsverweises ein.

Aktualisieren Sie die App, um Verbindungen herzustellen

Nachdem Sie Verbindungen hinzugefügt haben, aktualisieren Sie die App so, dass das generierte Modell und der Dienst verwendet werden.

Hinweis

Sie können diese Änderungen auch mithilfe eines Agents in Ihrer IDE vornehmen. In Visual Studio Code können Sie beispielsweise den GitHub Copilot-Agentmodus verwenden, um sie nach dem Hinzufügen der Datenquellen für Sie zu erstellen.

1. Importieren erforderlicher Typen und Dienste

   Wenn Sie eine Datenquelle hinzufügen, generiert die CLI automatisch Modell- und Dienstdateien. Sie platziert diese Dateien im /generated/services/ Ordner. Wenn Sie beispielsweise als Datenquelle hinzufügen Office365Users , erstellt das Portal die folgenden Dateien:

   • Office365UsersModel.ts – Definiert das Datenmodell für Anforderungs- und Antwortobjekte im Office365Users Connector.
   • Office365UsersService.ts – Stellt Dienstmethoden für die Interaktion mit den Office365Users Daten bereit.

   Importieren und verwenden Sie diese Dateien in Ihrem Code wie folgt:

   import { Office365UsersService } from './generated/services/Office365UsersService';
   import type { User } from './generated/models/Office365UsersModel';
   

2. Aktualisieren Sie die App so, dass sie die nicht tabellarische Datenquelle verwendet (z. B. Office 365-Benutzer)

   Zeigen Sie für die typisierte Verbindungs-API die generierten Dateien unter den src/generated/models und src/generated/services Ordnern an.

   await Office365UsersService.MyProfile() 
   

   const profile = (await Office365UsersService.MyProfile_V2("id,displayName,jobTitle,id,userPrincipalName")).data; 
      setUser(profile); 
      if (profile?.id || profile?.userPrincipalName) { 
         // Try both id and userPrincipalName for photo 
         let photoData = null; 
         try { 
         photoData = (await Office365UsersService.UserPhoto_V2(profile.id || profile.userPrincipalName)).data; 
         } catch { 
         // fallback to userPrincipalName if id fails 
         if (profile.userPrincipalName) { 
            photoData = (await Office365UsersService.UserPhoto_V2(profile.userPrincipalName)).data; 
         } 
         } 
         if (photoData) setPhoto(`data:image/jpeg;base64,${photoData}`); 
   

3. (Optional) Aktualisieren der App für die Verwendung der tabellarischen Datenquelle (z. B. SQL)

   Zeigen Sie für die typisierte Verbindungs-API die generierten Dateien unter den src/Models und src/Services Ordnern an.

   Beispiele:

   await MobileDeviceInventoryService.create(<record>) 
   await MobileDeviceInventoryService.update(id, <record>) 
   await MobileDeviceInventoryService.delete(id) 
   await MobileDeviceInventoryService.get(id) 
   await MobileDeviceInventoryService.getall() 
   

   await MobileDeviceInventoryService.update(assetId, changedFields); 
   setAssets((prevAssets) => 
     prevAssets.map((asset) => { 
       if (asset.id === assetId) { 
   

4. Führen Sie die App lokal aus, um Änderungen zu überprüfen.

   Verwenden Sie diesen Befehl im Terminal:

   npm run dev
   

5. Die App auf Power Apps ausführen

   Erstellen Sie die App, und verwenden Sie dann pa app push, um sie zu veröffentlichen:

   npm run build
   pa app push