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

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)

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.

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.

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

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

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

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.

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"

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]" 

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.

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
   

   Mit diesem Befehl wird eine Tabelle mit den IdEigenschaften , SolutionUniqueNameVersion und FriendlyName Lösungseigenschaften 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.

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.

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