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

Las aplicaciones de código pueden conectarse a conectores de Power Platform.

Siga estos pasos:

1. Crear y configurar conexiones en 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

Creación y configuración de conexiones en Power Apps

Empiece por crear y configurar conexiones en Power Apps. Copie los metadatos de conexión desde allí para usarlos en pasos posteriores.

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)

Abrir la página Conexiones de Power Apps

Vaya a Power Apps y vaya a la página Connections desde el panel de navegación izquierdo.

Ejemplo: Creación de una conexión de usuarios de Office 365

Seleccione + Nueva conexión y seleccione Office 365 Usuarios. Selecciona Crear.

(Opcional) Creación de una conexión SQL (o una conexión para otro origen de datos tabular)

Obtención de metadatos de conexión para todas las conexiones creadas

Utilice uno de los métodos siguientes:

• Uso de la CLI de PAC
• Use Power Apps URL

Uso de la CLI de PAC

Use la CLI de Power Apps para enumerar las conexiones disponibles y obtener sus identificadores mediante el comando pac connection list.

muestra una tabla de todas las conexiones, incluido el identificador de conexión y el nombre de la API. El nombre de la API actúa como el cuando se agrega un origen de datos.

Salida de lista de la CLI de PAC que muestra el identificador de conexión y el nombre de API

Uso de la dirección URL de Power Apps

También puede obtener esta información mediante Power Apps. Al ver los detalles de una conexión, puede ver la dirección URL.

El nombre de la API y el identificador de conexión se muestran en la dirección URL:

Detalles de conexión en los que se muestran los valores del nombre de la API y el identificador de conexión

Copie el nombre de la API y el identificador de conexión de la CLI de PAC en la dirección URL de cada conexión.

Agregar una conexión a una aplicación de código

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.

Agregar un origen de datos no tabular

Para agregar un origen de datos no tabular (como Microsoft Office 365 Usuarios) a la aplicación, use el comando PAC CLI pac code add-data-source.

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

pac code add-data-source -a <apiName> -c <connectionId>

Por ejemplo:

pac code add-data-source -a "shared_office365users" -c "aaaaaaaa000011112222bbbbbbbbbbbb"

Adición de un origen de datos tabular

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

Use el mismo comando pac code add-data-source de PAC CLI, pero incluye un id. de tabla y un nombre de 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.

pac code add-data-source -a <apiName> -c <connectionId> -t <tableId> -d <datasetName> 

Por ejemplo:

pac code add-data-source `
-a "shared_sql" `
-c "aaaaaaaa000011112222bbbbbbbbbbbb" `
-t "[dbo].[MobileDeviceInventory]" `
-d "paconnectivitysql0425.database.windows.net,paruntimedb"

pac code add-data-source `
-a "shared_sql" `
-c "aaaaaaaa000011112222bbbbbbbbbbbb" `
-t "[dbo].[EmployeeInformation]" `
-d "paconnectivitysql0425.database.windows.net,paruntimedb" 

Detección de conjuntos de datos y tablas disponibles

Use comandos de la CLI de PAC para detectar conjuntos de datos, tablas y procedimientos almacenados disponibles para las conexiones. Este método es más fácil que recuperar manualmente los metadatos a través de las herramientas de desarrollo del explorador.

Enumerar conjuntos de datos:

pac code list-datasets -a <apiId> -c <connectionId>

Listar tablas:

pac code list-tables -a <apiId> -c <connectionId> -d <datasetName>

Enumeración de procedimientos almacenados de SQL:

pac code list-sql-stored-procedures -c <connectionId> -d <datasetName>

flujo de trabajo Example para SQL Server:

# Step 1: List available datasets
pac code list-datasets -a "shared_sql" -c "aaaaaaaa000011112222bbbbbbbbbbbb"

# Step 2: List tables in the dataset
pac code list-tables -a "shared_sql" -c "aaaaaaaa000011112222bbbbbbbbbbbb" `
  -d "paconnectivitysql0425.database.windows.net,paruntimedb"

# Step 3: Add the table to your code app
pac code add-data-source -a "shared_sql" -c "aaaaaaaa000011112222bbbbbbbbbbbb" `
  -t "[dbo].[MobileDeviceInventory]" `
  -d "paconnectivitysql0425.database.windows.net,paruntimedb"

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

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

pac code add-data-source -a <apiId> -c <connectionId> -d <dataSourceName> -sp <storedProcedureName> 

Por ejemplo:

pac code add-data-source `
–a "shared_sql" `
-c "33dd33ddee44ff55aa6677bb77bb77bb" `
-d "paconnectivitysql0425.database.windows.net,paruntimedb" `
-sp "[dbo].[GetRecordById]" 

Eliminación de orígenes de datos

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

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

pac code delete-data-source -a <apiName> -ds <dataSourceName> 

Por ejemplo:

pac code delete-data-source `
-a "shared_sql" `
-ds "MobileDeviceInventory" 

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

A partir de la versión 1.51.1 de la CLI de Power Apps publicada en diciembre de 2025, puede usar referencias de conexión para agregar orígenes de datos a la 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.

Obtención del identificador de la solución

Use uno de los métodos siguientes para obtener el identificador de la solución:

Use el comando de lista de soluciones de la CLI de PAC:

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:

   pac solution list --json | ConvertFrom-Json | Format-Table
   

   Este comando genera una tabla en la consola con las propiedades de la solución: , y .

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

Use el explorador de soluciones de Power Apps:

1. Inicie sesión en Power Apps.

2. En el panel de navegación izquierdo, seleccione Soluciones. Si el elemento no está en el panel lateral, seleccione Más y, a continuación, seleccione el elemento que desee.

3. Busque la solución que contiene la referencia de conexión para el origen de datos.

4. Seleccione la solución para abrirla.

5. En la dirección URL del explorador, busque el identificador de solución al final de la dirección URL. La dirección URL tiene el formato :

   https://make.powerapps.com/environments/environmentId/solutions/solutionId
   

6. Copie el identificador de solución de la dirección URL y guárdelo para su uso posterior.

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

Use uno de los métodos siguientes para obtener la referencia de conexión al origen de datos:

Use el comando de código de la CLI de PAC para enumerar las referencias de conexión en una solución:

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

2. Ejecute el siguiente comando para obtener el identificador de solución y el nombre de la referencia de conexión al origen de datos:

    pac code list-connection-references -env <environmentURL> -s <solutionID>
   

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.

Use el explorador de soluciones de Power Apps para examinar las referencias de conexión en una solución:

1. Inicie sesión en Power Apps.
2. En el panel de navegación izquierdo, seleccione Soluciones. Si el elemento no está en el panel lateral, seleccione Más y, a continuación, seleccione el elemento que desee.
3. Busque la solución que contiene la referencia de conexión para el origen de datos.
4. Seleccione Referencias de conexión en la lista de objetos del panel izquierdo.

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.

pac code add-data-source -a <apiName> -cr <connectionReferenceLogicalName> -s <solutionID>

La aplicación ahora utiliza la conexión que está asociada con la referencia de conexión dentro de su solución de Power Apps.

Actualizar la aplicación para llamar a conexiones

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

1. Importación de tipos y servicios necesarios

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

   • : define el modelo de datos para objetos de solicitud y respuesta en el conector.
   • : proporciona métodos de servicio para interactuar con los 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. Actualizar 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 y .

   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 y .

   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

   Use este comando en el terminal:

   npm run build | pac code push