Criar uma conexão pela CLI (versão prévia)

Use o comando biblioteca de cliente do Power Apps para aplicativos de códigocreate-connection para criar uma conexão com um conector diretamente da linha de comando, sem sair do terminal nem abrir o Power Apps, como descrito em Como conectar seu aplicativo de código aos dados.

A partir da versão 1.2.7, use o list-connectors comando para ver os conectores disponíveis em seu ambiente.

Pré-requisitos

Um aplicativo de código inicializado do Power Apps. Confira o Início Rápido: Criar um aplicativo de código usando a CLI do npm.

Listar conectores disponíveis

Antes de criar uma conexão, use o list-connectors comando para ver quais conectores estão disponíveis em seu ambiente do Power Platform e para localizar o identificador de API de um conector. Esse é o valor que você passa para a create-connection opção de comando api-id .

O list-connectors comando lista os conectores do ambiente do Power Platform que seu aplicativo de código está direcionando no momento. Este é o ambiente definido em power.config.json quando você executou power-apps init.

Uso

Execute o comando na raiz do seu projeto de aplicativo de código:

power-apps list-connectors [--search <term>] [--json]

Opções

Use as opções a seguir com list-connectors.

Opção Alias Obrigatório Description
--search -s No Filtre os resultados para conectores cujo nome ou nome de exibição corresponde ao termo de pesquisa.
--json — No Exiba a lista completa de conectores em JSON para cenários de script.

Saída

Por padrão, o comando imprime uma tabela com duas colunas:

Coluna Description
Nome de Exibição O nome amigável do conector, por exemplo, Office 365 Outlook.
Conector O nome exclusivo do conector/identificador de API, por exemplo, shared_office365. Esse é o valor que você passa para a create-connection opção de comando --api-id .

Quando você executa o comando em um terminal interativo, ele retorna resultados em páginas de 20 linhas. Pressione Enter para mostrar a próxima página ou Esc/q para sair. Quando você redireciona a saída (não interativa) ou passa --json, o comando emite a lista completa ao mesmo tempo.

A saída --json inclui campos adicionais para cada conector, além das duas colunas da tabela:

Campo Description
id O ID do conector.
name O nome exclusivo do conector (identificador de API), por exemplo shared_office365.
displayName O nome de exibição amigável ao usuário do conector.
description A descrição do conector.
isTabular Indica se o conector dá suporte a operações de dados tabulares (tabela).

Exemplos

Liste todos os conectores disponíveis no ambiente atual:

power-apps list-connectors

Pesquise conectores por nome:

power-apps list-connectors --search teams

Emita a lista completa de conectores como JSON. Isso é útil em scripts e CI (integração contínua):

power-apps list-connectors --json

Criar a conexão

Use o create-connection comando para criar uma conexão para um conector diretamente da linha de comando, sem sair do terminal ou abrir o portal do criador de Power Apps.

A conexão é criada no ambiente do Power Platform que seu aplicativo de código tem como destino no momento. Esse ambiente é definido em power.config.json quando você executa power-apps init.

Uso

Execute o comando na raiz do seu projeto de aplicativo de código:

power-apps create-connection --api-id <connectorId> [--display-name <name>] [--json]

Opções

Use as opções a seguir com create-connection.

Opção Alias Obrigatório Description
--api-id -a Yes Identificador da API do conector (por exemplo, shared_office365, shared_teams).
--display-name -n No Nome de exibição opcional para a nova conexão. Se não for especificado, um padrão será usado.
--json — No Gere o resultado como JSON para cenários de script.

Exemplos

Criar uma conexão Office 365:

power-apps create-connection --api-id shared_office365

Crie uma conexão do Teams com um nome de exibição personalizado:

power-apps create-connection --api-id shared_teams --display-name "My Teams"

Crie uma conexão e emita uma saída JSON. Isso é útil em scripts e CI (integração contínua):

power-apps create-connection --api-id shared_office365 --json

Com êxito, o comando imprime a ID da nova conexão. Em seguida, você pode referenciar essa ID de conexão ao adicionar o conector como uma fonte de dados ao seu aplicativo de código.

  • Last updated on