Creación de una conexión desde la CLI (versión preliminar)

Use el comando Power Apps biblioteca cliente para aplicacionescreate-connection de código para crear una conexión para un conector directamente desde la línea de comandos, sin salir del terminal ni abrir Power Apps tal como se describe en Cómo: Conectar la aplicación de código a los datos.

A partir de la versión 1.2.7, use el list-connectors comando para ver los conectores disponibles en su entorno.

Prerequisites

Una aplicación de código Power Apps inicializada. Consulte Inicio rápido: Creación de una aplicación de código mediante la CLI de npm.

Enumeración de conectores disponibles

Antes de crear una conexión, use el list-connectors comando para ver qué conectores están disponibles en el entorno de Power Platform y para buscar el identificador de API de un conector. Este es el valor que se pasa a la create-connection opción de comando api-id .

El list-connectors comando enumera los conectores del entorno de Power Platform que la aplicación de código tiene actualmente como destino. Este es el entorno establecido en power.config.json cuando ejecutó power-apps init.

Uso

Ejecute el comando desde la raíz del proyecto de aplicación de código:

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

Options

Use las siguientes opciones con list-connectors.

Opción Alias Obligatorio Description
--search -s No Filtre los resultados para mostrar solo los conectores cuyo nombre o nombre para mostrar coincida con el término de búsqueda.
--json No Muestre la lista de conectores completa como JSON para escenarios de scripting.

Output

De forma predeterminada, el comando imprime una tabla con dos columnas:

Columna Description
Nombre para mostrar El nombre descriptivo del conector, por ejemplo, Office 365 Outlook.
Conector El nombre único o el identificador de API del conector, por ejemplo, shared_office365. Este es el valor que se pasa a la create-connection opción de comando --api-id .

Al ejecutar el comando en un terminal interactivo, devuelve resultados en páginas de 20 filas. Presione Entrar para mostrar la página siguiente o Esc/q para salir. Cuando se redirige la salida (no interactiva) o se pasa --json, el comando emite la lista completa a la vez.

La --json salida incluye campos adicionales para cada conector más allá de las dos columnas de tabla:

Campo Description
id Identificador del conector.
name Nombre único del conector (identificador de API), por ejemplo shared_office365.
displayName Nombre para mostrar fácil de identificar del conector.
description Descripción del conector.
isTabular Indica si el conector admite operaciones de datos tabulares (tabla).

Ejemplos

Enumere todos los conectores disponibles en el entorno actual:

power-apps list-connectors

Busque conectores por nombre:

power-apps list-connectors --search teams

Emita la lista de conectores completa como JSON. Esto es útil en scripts e integración continua (CI):

power-apps list-connectors --json

Creación de la conexión

Use el create-connection comando para crear una conexión para un conector directamente desde la línea de comandos, sin salir del terminal ni abrir el portal de Power Apps maker.

La conexión se crea en el entorno de Power Platform que la aplicación de código tiene como destino actualmente. Este entorno se establece en power.config.json cuando se ejecuta power-apps init.

Uso

Ejecute el comando desde la raíz del proyecto de aplicación de código:

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

Options

Use las siguientes opciones con create-connection.

Opción Alias Obligatorio Description
--api-id -a Yes Identificador de API del conector (por ejemplo, shared_office365, shared_teams).
--display-name -n No Nombre para mostrar opcional para la nueva conexión. Si no se especifica, se usa un valor predeterminado.
--json No Genera el resultado como JSON para escenarios de scripting.

Ejemplos

Cree una conexión Office 365:

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

Crear una conexión con Teams con un nombre para mostrar personalizado:

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

Cree una conexión y emita una salida JSON. Esto es útil en scripts e integración continua (CI):

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

Si se ejecuta correctamente, el comando imprime el identificador de la nueva conexión. A continuación, puede hacer referencia a ese identificador de conexión al agregar el conector como origen de datos a la aplicación de código.