Como conectar seu aplicativo de código a dados

Saiba como conectar seu aplicativo de código aos dados usando conectores do Power Platform, para que você possa adicionar fontes de dados e chamar serviços gerados do seu aplicativo.

Use as seguintes etapas:

1. Criar e configurar conexões com a CLI do Power Apps
2. Adicionar uma conexão a um aplicativo de código
3. Atualizar o aplicativo para fazer chamadas por conexão

Criar e configurar conexões com a CLI do Power Apps

Use a CLI Power Apps para localizar um conector e criar sua conexão. Siga as instruções em Criar uma conexão usando a CLI do Power Apps e salve o identificador da conexão retornado pelo comando.

Todos os conectores têm suporte oficial, exceto os listados na seção a seguir.

Conectores que ainda não têm suporte

• Excel Online (Negócios)
• Excel Online (OneDrive)

Obter metadados de conexão

Use pa connection list para listar suas conexões disponíveis e obter suas IDs se você não salvou a ID retornada por pa connection create:

pa connection list

O comando mostra uma tabela de conexões, incluindo a ID de conexão e o identificador do conector. Use esses valores ao adicionar uma fonte de dados.

Adicionar uma conexão a um aplicativo de código

Depois de criar ou identificar conexões existentes a serem usadas e copiar os metadados de conexão da etapa anterior, adicione essas conexões ao aplicativo.

Quando você adiciona as fontes de dados ao aplicativo, o processo gera automaticamente um modelo typeScript tipado e um arquivo de serviço no repositório. Por exemplo, a fonte de dados Usuários do Office 365 produz arquivos Office365UsersModel e Office365UsersService.

Adicionar uma fonte de dados não tabular

Adicione uma fonte de dados não tabular, como Usuários do Office 365, usando pa app add data-source.

Em uma linha de comando, execute o comando a seguir. Use o identificador do conector e a ID de conexão que você coletou das etapas anteriores.

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

Por exemplo:

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

Adicionar uma fonte de dados tabular

SQL ou SharePoint são exemplos de fontes de dados tabulares.

Use o mesmo pa app add data-source comando, mas inclua a tabela e o conjunto de dados. O esquema da fonte de dados tabular especifica esses valores. Se você ainda não tiver esses valores, consulte Descobrir conjuntos de dados e tabelas disponíveis.

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

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

exemplo de SharePoint

Para SharePoint, --table é o nome da lista e --dataset é o site SharePoint:

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

Descobrir conjuntos de dados e tabelas disponíveis

Use os pa connection comandos para descobrir conjuntos de dados, tabelas e procedimentos armazenados disponíveis para suas conexões.

Listar conjuntos de dados:

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

Listar tabelas:

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

Listar procedimentos armazenados do SQL:

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

Exemplo de fluxo de trabalho para o 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"

Adicionar um procedimento armazenado SQL como uma fonte de dados

Execute o comando a seguir em uma linha de comando. Use o identificador do conector e a ID de conexão que você coletou anteriormente.

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

Por exemplo:

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

Remover uma fonte de dados

Se necessário, você pode excluir fontes de dados depois de adicioná-las.

Use pa app remove data-source com o identificador do conector e o nome da fonte de dados.

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

Por exemplo:

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

Atualizar uma fonte de dados

Se o esquema for alterado, use pa app refresh data-source para atualizar o modelo gerado e os arquivos de serviço:

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

Usar referências de conexão para adicionar uma fonte de dados

Use referências de conexão para adicionar fontes de dados ao seu aplicativo de código. Uma referência de conexão é um componente de solução que aponta para uma conexão específica para um conector. Em vez de associar seu aplicativo diretamente a uma conexão específica do usuário, associe-o a uma referência. Essa abordagem torna a solução com reconhecimento de ambiente e portátil em ambientes Dev, Test e Prod para o gerenciamento suave do ciclo de vida do aplicativo.

Obter a ID da solução

Use o comando de lista de soluções para obter a ID da solução.

1. Abra um prompt de comando ou uma janela de terminal.

2. Execute o seguinte comando para obter uma lista de soluções no ambiente ao qual você está conectado:

   pa solution list
   

   Esse comando gera uma tabela no console com as propriedades Id, SolutionUniqueName, Version e FriendlyName da solução.

3. Copie a solução Id e salve-a para uso posterior.

Obtenha o nome da referência de conexão para a sua fonte de dados

Use a CLI Power Apps para listar as referências de conexão em uma solução:

1. Abra um prompt de comando ou uma janela de terminal.

2. Use pa connection list-references para obter a ID da solução e o nome da referência de conexão à sua fonte de dados:

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

3. A saída inclui o nome de exibição, o nome lógico e a descrição das referências de conexão na solução.

Adicione a fonte de dados ao seu aplicativo de código usando a referência de conexão

Em uma linha de comando, execute o comando a seguir. Use o ID da solução e o nome lógico de referência de conexão coletado das etapas anteriores.

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

O aplicativo agora utiliza a conexão associada à referência de conexão na sua solução Power Apps.

Atualizar o aplicativo para fazer chamadas por conexão

Depois de adicionar conexões, atualize o aplicativo para usar o modelo e o serviço gerados.

1. Importar tipos e serviços necessários

   Quando você adiciona uma fonte de dados, a CLI gera automaticamente arquivos de modelo e serviço. Ele coloca esses arquivos na /generated/services/ pasta. Por exemplo, se você adicionar Office365Users como uma fonte de dados, o portal criará os seguintes arquivos:

   • Office365UsersModel.ts – Define o modelo de dados para objetos de solicitação e resposta no Office365Users conector.
   • Office365UsersService.ts – Fornece métodos de serviço para interagir com os Office365Users dados.

   Importe e use esses arquivos em seu código assim:

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

2. Atualize o aplicativo para usar a fonte de dados não tabular (por exemplo, Usuários do Office 365)

   Para a API de conexão tipada, exiba os arquivos gerados nas pastas src/generated/models e 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) Atualize o aplicativo para usar a fonte de dados tabular (por exemplo, SQL)

   Para a API de conexão tipada, exiba os arquivos gerados nas pastas src/Models e src/Services.

   Por exemplo:

   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. Executar o aplicativo localmente para verificar as alterações

   Use este comando no terminal:

   npm run dev
   

5. Enviar por push o aplicativo para ser executado no Power Apps

   Crie o aplicativo e, em seguida, use-o pa app push para publicá-lo:

   npm run build
   pa app push