Cómo conectar tu aplicación de código a datos (versión preliminar)

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

Nota:

Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes de una versión oficial para que los clientes puedan obtener acceso anticipado y proporcionar comentarios.

Siga estos pasos:

Creación y configuración de conexiones en Power Apps
Añadir una conexión a una aplicación de programación
Actualiza la aplicación para realizar llamadas a conexiones

Nota:

Siga estos pasos después de inicializar la aplicación con pac code init. Este es el tercer paso de cómo crear una aplicación de código desde cero

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.

Oficialmente se admiten los siguientes conectores:

Se espera que otros conectores funcionen, pero no se prueban.

Importante

Para la versión inicial, solo puede configurar aplicaciones de código para que usen conexiones existentes en Power Apps. No se pueden crear nuevas conexiones a través de comandos de la CLI de PAC. La compatibilidad con la creación de nuevas conexiones se agregará en una versión futura.

Abrir la página de Conexiones de Power Apps

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

Página Conexiones de Power Apps que muestra el botón Nueva conexión

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

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

Nota:

Si ya tiene una conexión de usuarios de Office 365, puede usarla en lugar de crear una nueva.

Creación de una conexión de usuarios de Office 365 en Power Apps

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

Sugerencia

Para obtener una guía paso a paso para conectar la aplicación de código a Azure SQL, consulte Conexión de la aplicación de código a Azure SQL.

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

Hay dos maneras de hacerlo:

Uso de la CLI de PAC
Uso de la dirección URL de Power Apps

Uso de la CLI de PAC

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

pac connection list muestra una tabla de todas las conexiones, incluido el identificador de conexión y el nombre de la API, que se utiliza como appId al agregar 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 recuperar esta información mediante Power Apps si ve la dirección URL al examinar los detalles de una conexión.

Selección de una conexión en Power Apps para ver sus detalles

Observe cómo se anexan el nombre de la API y el identificador de conexión a 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, se genera automáticamente un modelo typed TypeScript y un archivo de servicio en el repositorio. Por ejemplo, la fuente de datos de Office 365 Usuarios genera Office365UsersModel y Office365UsersService.

Añadir un origen de datos notabular

Agregue un origen de datos notabular (por ejemplo, Usuarios de Office 365) a la aplicación mediante el comando pac code add-data-source de la CLI de PAC.

Desde una línea de comandos, ejecute el siguiente comando. Use el nombre de la API y el identificador de conexión recopilados 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 los tiene, consulte Recuperación de un nombre de conjunto de datos y un identificador de tabla.

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"

Recuperación de un nombre de conjunto de datos y un identificador de tabla

Importante

Los pasos siguientes para recuperar un nombre de conjunto de datos y un identificador de tabla son una solución alternativa temporal. Tenemos previsto agregar un mecanismo más sencillo para obtener estos valores.

Si aún no tiene el nombre de la tabla y el conjunto de datos, puede obtenerlos ejecutando una aplicación de lienzo y copiando los valores del inspector de red del explorador:

Cree una nueva aplicación de Canvas en Studio.
Agregue la conexión en una aplicación de lienzo.
Enlace la conexión a un control de galería.
Publique y ejecute la aplicación.
Abra las Herramientas de desarrollo del explorador, vaya a la pestaña Red e inspeccione las solicitudes realizadas cuando se cargue la aplicación. Revise la solicitud "invocar" y diríjase a su respuesta.
Busque una solicitud de Azure API Management (APIM) con el identificador de conexión, el nombre del conjunto de datos y el identificador de tabla, y copie esos valores.

Con esta dirección URL de solicitud de datos de ejemplo a través de APIM, busque los valores <Connection ID>, <Dataset name> y <Table ID> en estos lugares de la dirección URL:
```
https[]()://{id value}.01.common.azure-apihub.net/apim/sharepointonline/<Connection ID>/datasets/<Dataset name>/tables/<Table ID>/items
```

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

Desde una línea de comandos, ejecute el siguiente comando. Use el nombre de la API y el identificador de conexión recopilados 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 agregar.

Desde una línea de comandos, ejecute el siguiente comando. Use el nombre de la API y el identificador de conexión recopilados anteriormente.

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

Por ejemplo:

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

Importante

Si cambia el esquema de una conexión, no hay ningún comando para actualizar los archivos de servicio y modelo tipado. Elimina el origen de datos y léalo en su lugar.

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, la enlazas a una referencia. Esto 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 da por supuesto 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 ha hecho, siga los pasos descritos en los vínculos siguientes para crear uno.

Obtención del identificador de la solución

Hay dos maneras de obtener el identificador de la solución:

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

Abra un símbolo del sistema o una ventana de terminal.
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: Id, SolutionUniqueName y FriendlyName.
Copie la solución Id y guárdela para su uso posterior.

Use el Explorador de soluciones de Power Apps:

Inicie sesión en Power Apps.
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.
Busque la solución que contiene la referencia de conexión para el origen de datos.
Seleccione la solución para abrirla.
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
```
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.

Hay dos maneras de 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:

Abra un símbolo del sistema o una ventana de terminal.
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>
```
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:

Inicie sesión en Power Apps.
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.
Busque la solución que contiene la referencia de conexión para el origen de datos.
Seleccione Referencias de conexión en la lista de objetos del panel izquierdo.

Añade el origen de datos a la aplicación 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 asociada con la referencia de conexión en la solución de Power Apps.

Actualizar la aplicación para llamar a conexiones

Una vez agregadas las conexiones, puede actualizar 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.

Deberá asegurarse de que se ha realizado la inicialización del SDK de Power Apps antes de las llamadas a datos

En el App.tsx archivo, implemente lógica que espere a que el SDK de Power Apps se inicialice completamente antes de realizar operaciones de datos. Esto evita errores causados por servicios no inicializados o contexto que falta. Esto solo debe hacerse una vez.

Use una función asincrónica o una administración de estado para confirmar la inicialización antes de realizar llamadas API. Por ejemplo:

useEffect(() => {
// Define an async function to initialize the Power Apps SDK
const init = async () => {
      try {
            await initialize(); // Wait for SDK initialization
            setIsInitialized(true); // Mark the app as ready for data operations
      } catch (err) {
            setError('Failed to initialize Power Apps SDK'); // Handle initialization errors
            setLoading(false); // Stop any loading indicators
      }
};

init(); // Call the initialization function when the component mounts
}, []);

useEffect(() => {
// Prevent data operations until the SDK is fully initialized
if (!isInitialized) return;

// Place your data reading logic here
}, []);

Importación de tipos y servicios necesarios

Al agregar un origen de datos, los archivos de modelo y servicio se generan y colocan automáticamente en la /generated/services/ carpeta . Por ejemplo, si agrega Office365Users como origen de datos, se crean los siguientes archivos:
- Office365UsersModel.ts : define el modelo de datos para solicitudes y objetos de respuesta en el Office365Users conector.
- Office365UsersService.ts : proporciona métodos de servicio para interactuar con los Office365Users datos.
Puede importarlos y usarlos en el código de la siguiente manera:
```
import { Office365UsersService } from './generated/services/Office365UsersService';
import type { User } from './generated/models/Office365UsersModel';
```

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

Puede ver los archivos generados en las carpetas src/generated/models and src/generated/services de la API de conexión escrita.

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}`);

(Opcional) Actualice la aplicación para usar el origen de datos tabular (por ejemplo, SQL).

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

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) {

Ejecución local de la aplicación para comprobar los cambios

Use este comando en el terminal:
```
npm run dev
```
Insertar la aplicación para que se ejecute en Power Apps

Use este comando en el terminal:
```
npm run build | pac code push
```

Oharrak

Lagungarria al da orri hau?

Last updated on 2025-12-12

Partekatu honen bidez:

Cómo conectar tu aplicación de código a datos (versión preliminar)

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

Abrir la página de Conexiones de Power Apps

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

(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

Uso de la CLI de PAC

Uso de la dirección URL de Power Apps

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

Añadir un origen de datos notabular

Adición de un origen de datos tabular

Recuperación de un nombre de conjunto de datos y un identificador de tabla

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

Eliminación de orígenes de datos

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

Obtención del identificador de la solución

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

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

Actualizar la aplicación para llamar a conexiones

Oharrak

Baliabide gehigarriak