Guide pratique pour connecter votre application de code aux données

Découvrez comment connecter votre application de code aux données à l’aide de connecteurs Power Platform afin de pouvoir ajouter des sources de données et appeler des services générés à partir de votre application.

Utiliser les étapes suivantes :

1. Créer et configurer des connexions avec l’interface CLI Power Apps
2. Ajouter une connexion à une application de code
3. Mettre à jour l'application pour gérer les connexions

Note

Utilisez ces étapes après avoir initialisé l’application à l’aide pa app initde .

Créer et configurer des connexions avec l’interface CLI Power Apps

Utilisez l’interface CLI Power Apps pour rechercher un connecteur et créer sa connexion. Suivez Créer une connexion à partir de l’interface CLI Power Apps, puis enregistrez l’ID de connexion retourné par la commande.

Tous les connecteurs sont officiellement pris en charge, à l’exception des connecteurs répertoriés dans la section suivante.

Connecteurs qui ne sont pas encore pris en charge

• Excel Online (Entreprise)
• Excel Online (OneDrive)

Conseil / Astuce

Pour obtenir un guide pas à pas pour connecter votre application de code à Azure SQL, consultez Guide pratique pour connecter votre application de code à Azure SQL.

Obtenir les métadonnées de connexion

Permet pa connection list de répertorier vos connexions disponibles et d’obtenir leurs ID si vous n’avez pas enregistré l’ID retourné par pa connection create:

pa connection list

La commande affiche une table des connexions, y compris l’ID de connexion et l’identificateur du connecteur. Utilisez ces valeurs lorsque vous ajoutez une source de données.

Ajouter une connexion à une application de programmation

Après avoir créé ou identifié les connexions existantes à utiliser, puis copiez les métadonnées de connexion à l’étape précédente, ajoutez ces connexions à l’application.

Lorsque vous ajoutez les sources de données à l’application, le processus génère automatiquement un modèle TypeScript typé et un fichier de service dans le référentiel. Par exemple, la source de données Utilisateurs d’Office 365 produit des fichiers Office365UsersModel et Office365UsersService.

Conseil / Astuce

Dans un terminal interactif, exécutez pa app add data-source sans paramètres pour répondre aux invites. Pour les sources de données tabulaires basées sur un connecteur, l’interface CLI répertorie les connexions disponibles, les jeux de données et les tables. Pour Dataverse natif, entrez le nom logique de la table et l’URL de l’organisation Dataverse. En savoir plus sur l’utilisation de pa app add data-source.

Ajouter une source de données non tabulaire

Ajoutez une source de données non tabulaire, telle que Utilisateurs Office 365, à l’aide de pa app add data-source.

À partir d’une ligne de commande, exécutez la commande suivante. Utilisez l’identificateur du connecteur et l’ID de connexion que vous avez collectés à partir des étapes précédentes. Pour --connector, vous pouvez également utiliser le nom d’affichage du connecteur, tel que "Utilisateurs d’Office 365".

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

Par exemple:

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

Ajouter une source de données tabulaire

SQL ou SharePoint sont des exemples de sources de données tabulaires.

Utilisez la même pa app add data-source commande, mais incluez la table et le jeu de données. Le schéma de votre source de données tabulaire spécifie ces valeurs. Si vous n’avez pas encore ces valeurs, consultez Découvrir les jeux de données et tables disponibles.

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

Exemple SQL

Pour ajouter plusieurs tables à partir du même connecteur, connexion et jeu de données, répétez --table dans une commande :

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

Si une table individuelle échoue, la commande ajoute toujours les autres tables valides. Il signale les tables qui ont réussi et échoué, et retourne un code de sortie différent de zéro si une table échoue. En savoir plus sur pa app add data-source. Vous ne pouvez inclure qu’une seule table Dataverse native ou une procédure stockée SQL par commande.

exemple de SharePoint

Pour SharePoint, --table correspond au nom de la liste et --dataset au site SharePoint :

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

Découvrir les jeux de données et tables disponibles

Utilisez les pa connection commandes pour découvrir les jeux de données, tables et procédures stockées disponibles pour vos connexions. Dans un terminal interactif, vous pouvez également omettre --connection-id, --datasetet --table quand vous exécutez pa app add data-source. La commande répertorie les connexions et jeux de données disponibles, puis ouvre une liste de tables pouvant faire l’objet d’une recherche dans laquelle vous pouvez sélectionner une ou plusieurs tables.

Répertorier les jeux de données :

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

Tables de liste :

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

Répertorier les procédures stockées SQL :

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

Exemple de flux de travail pour 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"

Conseil / Astuce

Copiez les valeurs exactes de Nom dans la sortie de la commande lorsque vous les utilisez avec pa app add data-source. Les noms sont sensibles à la casse et peuvent contenir des caractères spéciaux.

Ajouter une procédure stockée SQL en tant que source de données

Exécutez la commande suivante à partir d’une ligne de commande. Utilisez l’identificateur du connecteur et l’ID de connexion que vous avez collectés précédemment.

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

Par exemple:

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

Ajouter des actions à partir d’un connecteur qui prend également en charge les tables

Certains connecteurs, tels que SharePoint et SQL Server, prennent en charge les tables et les actions. Lorsque vous incluez --table ou --procedure, pa app add data-source ajoute une table ou une procédure stockée. Pour ajouter les actions du connecteur à la place, incluez --as action et n’incluez pas --dataset, --table ou --procedure :

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

Vous pouvez utiliser des tables et des actions à partir du même connecteur dans votre application. Lorsque vous ajoutez des actions pour une connexion que vous avez déjà ajoutée en tant que table, l’interface CLI crée une source de données distincte dans votre application pour les actions et conserve la liaison de table existante.

Si vous n’incluez pas --as, --table ou --procedure pour l’un de ces connecteurs, la commande demande Ajouter une table ? dans un terminal interactif. En mode non interactif, tel que dans un pipeline CI/CD, la commande échoue jusqu’à ce que vous incluiez --as table ou --as action.

Supprimez une source de données.

Si nécessaire, vous pouvez supprimer des sources de données après les avoir ajoutées.

Utilisez pa app remove data-source avec l’identificateur du connecteur et le nom de la source de données.

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

Par exemple:

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

Actualiser une source de données

Si le schéma change, utilisez cette option pa app refresh data-source pour actualiser le modèle généré et les fichiers de service :

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

Utiliser des références de connexion pour ajouter une source de données

Utilisez des références de connexion pour ajouter des sources de données à votre application de code. Une référence de connexion est un composant de solution qui pointe vers une connexion spécifique pour un connecteur. Au lieu de lier votre application directement à une connexion spécifique à l’utilisateur, liez-la à une référence. Cette approche rend l'environnement de la solution sensible et portable dans les environnements Dev, Test et Prod pour une gestion fluide du cycle de vie des applications.

Note

Cette section suppose que vous disposez d’une connaissance de base des solutions dans Power Apps et des références de connexion. Vous devez avoir une solution créée et une référence de connexion dans cette solution pour votre source de données. Si ce n’est pas le cas, suivez les étapes décrites dans les liens de la section suivante pour en créer une.

• Découvrez les solutions dans Power Apps.
• Découvrez les références de connexion et ce qui les rend utiles pour vos Power Apps.

Obtenir l’ID de solution

Utilisez la commande de liste de solutions pour obtenir l’ID de votre solution.

1. Ouvrez une invite de commandes ou une fenêtre de terminal.

2. Exécutez la commande suivante pour obtenir la liste des solutions dans l’environnement auquel vous êtes connecté :

   pa solution list
   

   Cette commande affiche dans la console un tableau contenant les propriétés de la solution Id, SolutionUniqueName, Version et FriendlyName.

3. Copiez la solution Id et enregistrez-la pour une utilisation ultérieure.

Obtenir le nom de la référence de connexion à votre source de données

Utilisez l’interface CLI Power Apps pour répertorier les références de connexion dans une solution :

1. Ouvrez une invite de commandes ou une fenêtre de terminal.

2. Permet pa connection list-references d’obtenir l’ID de solution et le nom de la référence de connexion à votre source de données :

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

3. La sortie inclut le nom d'affichage, le nom logique et la description des références de connexion dans la solution.

Ajouter la source de données à votre application de code à l’aide de la référence de connexion

À partir d’une ligne de commande, exécutez la commande suivante. Utilisez l’ID de solution et le nom logique de référence de connexion collectés à partir des étapes précédentes.

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

L’application utilise désormais la connexion associée à la référence de connexion dans votre solution Power Apps.

Utilisez le nom logique de référence de connexion, et non son nom d’affichage. La sortie de pa connection list-references inclut le nom logique. Un nom logique commence par une lettre et contient uniquement des lettres, des chiffres et des traits de soulignement, tels que cr123_sharedsharepointonline_1a2b3.

Pour un connecteur qui prend également en charge les tables, telles que SharePoint, inclure --dataset et --table pour ajouter une table, ou --as action pour ajouter les actions du connecteur. Dans un terminal interactif, vous pouvez omettre --dataset et --tablepuis les sélectionner dans les jeux de données et les tables disponibles via la connexion vers laquelle pointe la référence.

Si vous exécutez pa app add data-source dans un terminal interactif sans --connection-id ou --connection-ref, la commande vous demande Utilisez-vous une référence de connexion au lieu d’un ID de connexion ? avant de répertorier vos connexions. Sélectionnez Oui, puis entrez le nom logique de référence de connexion.

Mettre à jour l'application pour gérer les connexions

Après avoir ajouté des connexions, mettez à jour l’application pour utiliser le modèle et le service générés.

Note

Vous pouvez également apporter ces modifications à l’aide d’un agent dans votre IDE. Par exemple, dans Visual Studio Code, vous pouvez utiliser le mode agent de GitHub Copilot pour les créer pour vous après avoir ajouté les sources de données.

1. Importer les types et services requis

   Lorsque vous ajoutez une source de données, l’interface CLI génère automatiquement des fichiers de modèle et de service. Il place ces fichiers dans le /generated/services/ dossier. Par exemple, si vous ajoutez Office365Users une source de données, le portail crée les fichiers suivants :

   • Office365UsersModel.ts : définit le modèle de données pour les objets de requête et de réponse dans le Office365Users connecteur.
   • Office365UsersService.ts : fournit des méthodes de service pour interagir avec les Office365Users données.

   Importez et utilisez ces fichiers dans votre code comme suit :

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

2. Mettez à jour l’application pour utiliser la source de données non tabulaire (par exemple, Utilisateurs d’Office 365)

   Pour l'API de connexion typée, consultez les fichiers générés sous les dossiers src/generated/models et src/generated/services.

   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. (Facultatif) Mettez à jour l’application pour utiliser la source de données tabulaire (par exemple, SQL)

   Pour l'API de connexion typée, consultez les fichiers générés sous les dossiers src/Models et src/Services.

   Par exemple:

   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. Exécuter l’application localement pour vérifier les modifications

   Utilisez cette commande dans le terminal :

   npm run dev
   

5. Déployer l’application pour qu’elle s’exécute sur Power Apps

   Générez l’application, puis utilisez-la pa app push pour la publier :

   npm run build
   pa app push