Cómo conectar tu aplicación de código a los datos

Obtenga información sobre cómo conectar la aplicación de código a los datos mediante conectores de Power Platform, por lo que puede agregar orígenes de datos y llamar a servicios generados desde la aplicación.

Siga estos pasos:

1. Creación y configuración de conexiones con la CLI de Power Apps
2. Añadir una conexión a una aplicación de programación
3. Actualiza la aplicación para realizar llamadas a conexiones

Nota:

Siga estos pasos después de inicializar la aplicación mediante pa app init.

Creación y configuración de conexiones con la CLI de Power Apps

Use la CLI de Power Apps para buscar un conector y crear su conexión. Siga Creación de una conexión desde la CLI de Power Apps y guarde el identificador de conexión devuelto por el comando .

Todos los conectores se admiten oficialmente, excepto los enumerados en la sección siguiente.

Conectores que aún no se admiten

• Excel Online (Empresa)
• Excel Online (OneDrive)

Sugerencia

Para obtener una guía paso a paso sobre cómo conectar la aplicación de código a Azure SQL, consulta Cómo: Conectar la aplicación de código a Azure SQL.

Obtención de metadatos de conexión

Utilice pa connection list para listar sus conexiones disponibles y obtener sus identificadores si no ha guardado el identificador devuelto por pa connection create:

pa connection list

El comando muestra una tabla de conexiones, incluido el identificador de conexión y el identificador del conector. Use estos valores al agregar un origen de datos.

Añadir una conexión a una aplicación de programación

Después de crear o identificar las conexiones existentes que se van a usar y copiar los metadatos de conexión del paso anterior, agregue esas conexiones a la aplicación.

Al agregar los orígenes de datos a la aplicación, el proceso genera automáticamente un modelo de TypeScript tipado y un archivo de configuración de servicio en el repositorio. Por ejemplo, el origen de datos de Usuarios de Office 365 genera archivos Office365UsersModel y Office365UsersService.

Adición de un origen de datos no tabular

Agregue un origen de datos no tabular, como Usuarios de Office 365, mediante pa app add data-source.

Desde una línea de comandos, ejecute el siguiente comando. Use el identificador del conector y el identificador de conexión que recopiló de los pasos anteriores.

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

Por ejemplo:

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

Adición de un origen de datos tabular

SQL o SharePoint son ejemplos de orígenes de datos tabulares.

Use el mismo pa app add data-source comando, pero incluya la tabla y el conjunto de datos. El esquema del origen de datos tabular especifica estos valores. Si aún no tiene estos valores, consulte Detección de conjuntos de datos y tablas disponibles.

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

Ejemplo de SQL

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" 

ejemplo de SharePoint

Para SharePoint, --table es el nombre de la lista y --dataset es el sitio de SharePoint:

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

Detección de conjuntos de datos y tablas disponibles

Use los pa connection comandos para detectar conjuntos de datos, tablas y procedimientos almacenados disponibles para las conexiones.

Enumerar conjuntos de datos:

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

Enumerar tablas:

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

Enumeración de procedimientos almacenados de SQL:

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

Flujo de trabajo de ejemplo para 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"

Sugerencia

Copie los valores exactos name de la salida del comando cuando los use con pa app add data-source. Los nombres son sensibles a mayúsculas y minúsculas y pueden contener caracteres especiales.

Adición de un procedimiento almacenado de SQL como origen de datos

Ejecute el siguiente comando desde una línea de comandos. Use el identificador del conector y el identificador de conexión que recopiló anteriormente.

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

Por ejemplo:

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

Quitar un origen de datos

Si es necesario, puede eliminar orígenes de datos después de agregarlos.

Use pa app remove data-source con el identificador del conector y el nombre del origen de datos.

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

Por ejemplo:

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

Actualizar un origen de datos

Si el esquema cambia, use pa app refresh data-source para actualizar los archivos de servicio y modelo generados:

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

Usar referencias de conexión para agregar un origen de datos

Usa referencias de conexión para añadir orígenes de datos a tu aplicación de código. Una referencia de conexión es un componente de solución que apunta a una conexión específica para un conector. En lugar de enlazar la aplicación directamente a una conexión específica del usuario, enlazarla a una referencia. Este enfoque hace que la solución sea compatible con el entorno y sea portátil en entornos de desarrollo, pruebas y prod para una administración fluida del ciclo de vida de las aplicaciones.

Nota:

En esta sección se supone que tiene conocimientos básicos de las soluciones en Power Apps y las referencias de conexión. Debe tener una solución ya existente y una referencia de conexión dentro de esa solución para el origen de datos. Si no lo hace, siga los pasos descritos en los vínculos de la sección siguiente para crear uno.

• Descubre soluciones en Power Apps.
• Aprende sobre las referencias de conexión y qué las hace útiles para tus Power Apps.

Obtención del identificador de la solución

Use el comando lista de soluciones para obtener el identificador de la solución.

1. Abra un símbolo del sistema o una ventana de terminal.

2. Ejecute el siguiente comando para obtener una lista de soluciones en el entorno al que está conectado:

   pa solution list
   

   Este comando muestra una tabla en la consola con las propiedades de la solución Id, SolutionUniqueName, Version y FriendlyName.

3. Copie la solución Id y guárdela para su uso posterior.

Obtenga el nombre de la referencia de conexión al origen de datos.

Use la CLI de Power Apps para enumerar las referencias de conexión en una solución:

1. Abra un símbolo del sistema o una ventana de terminal.

2. Use pa connection list-references para obtener el identificador de solución y el nombre de la referencia de conexión al origen de datos:

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

3. La salida incluye el nombre para mostrar, el nombre lógico y la descripción de las referencias de conexión en la solución.

Añade el origen de datos a tu app de código mediante la referencia de conexión

Desde una línea de comandos, ejecute el siguiente comando. Utilice el identificador de solución y el nombre lógico de referencia de conexión recopilados de los pasos anteriores.

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

La aplicación ahora utiliza la conexión asociada a la referencia de conexión en tu solución de Power Apps.

Actualiza la aplicación para realizar llamadas a conexiones

Después de agregar conexiones, actualice la aplicación para usar el modelo y el servicio generados.

Nota:

También puede realizar estos cambios mediante un agente en el IDE. Por ejemplo, en Visual Studio Code, puede usar el modo de agente de GitHub Copilot para que los cree automáticamente después de agregar los orígenes de datos.

1. Importación de tipos y servicios necesarios

   Al agregar un origen de datos, la CLI genera automáticamente archivos de modelo y servicio. Coloca estos archivos en la /generated/services/ carpeta . Por ejemplo, si agrega Office365Users como origen de datos, el portal crea los siguientes archivos:

   • Office365UsersModel.ts : define el modelo de datos para objetos de solicitud y respuesta en el Office365Users conector.
   • Office365UsersService.ts : proporciona métodos de servicio para interactuar con los Office365Users datos.

   Importe y use estos archivos en el código de la siguiente manera:

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

2. Actualice la aplicación para usar el origen de datos no tabular (por ejemplo, Usuarios de Office 365)

   Para la API de conexión tipada, puede ver los archivos generados en las carpetas src/generated/models y 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. (Opcional) Actualice la aplicación para usar el origen de datos tabular (por ejemplo, SQL).

   Para la API de conexión tipada, puede ver los archivos generados en las carpetas src/Models y src/Services.

   Por ejemplo:

   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. Ejecución local de la aplicación para comprobar los cambios

   Use este comando en el terminal:

   npm run dev
   

5. Push la aplicación para que se ejecute en Power Apps

   Compile la aplicación y después úsela pa app push para publicarla:

   npm run build
   pa app push