Ejercicio: Utilizar la CLI para descargar un conector

  • 6 minutos

En este ejercicio usará CLI para descargar un conector, validar la definición y solucionar problemas. En este ejercicio se simula lo que debería hacer para crear y certificar un conector personalizado y de código abierto.

Este ejercicio requiere que instale Python y acceda al símbolo del sistema en la máquina que está usando para el ejercicio.

Importante

Utilice un entorno de prueba con Microsoft Dataverse aprovisionado. Si no dispone de ninguno, puede suscribirse al plan de la comunidad.

Nota

Para completar este ejercicio, descargue el siguiente archivo en su equipo local: Desencadenadores de Contoso Invoicing. Seleccione el botón de descarga en la parte central derecha de la pantalla.

Tarea 1: Importar la solución

En esta tarea, importará una solución no administrada que contiene un conector personalizado Contoso Invoicing. Usará este conector para completar las tareas de este ejercicio.

  1. Vaya a Power Apps Maker Portal y asegúrese de que se encuentra en el entorno correcto.

  2. Seleccione Soluciones > Importar solución.

  3. Seleccione Examinar.

  4. Seleccione la solución ContosoInvoicingOpenSource_1_0_0_0.zip y luego elija Abrir.

  5. Seleccione Siguiente.

  6. Seleccione Importar y espere a que se complete la importación. Una vez que se complete la importación, debería recibir un mensaje para indicar que se ha realizado correctamente.

  7. Abra la solución Contoso Invoicing - Open Source que ha importado.

    Debería ver el componente de conector personalizado Contoso Invoicing: código abierto.

    Captura de pantalla de los componentes de la solución Contoso Invoicing: código abierto

Tarea 2: Instalar Microsoft Power Platform CLI

Microsoft Power Platform CLI incluye la herramienta de línea de comandos paconn, que está diseñada para ayudar en el desarrollo de conectores personalizados de Microsoft Power Platform. La herramienta paconn usa el runtime Python, que también instalará.

  1. Vaya a Descargar Python y seleccione Descargar Python. Puede utilizar cualquier versión posterior a la 3.5.

  2. Seleccione el archivo .exe descargado para iniciar la instalación.

  3. Seleccione la casilla Agregar Python xx a la ruta, seleccione Instalar ahora y luego espere a que se complete la instalación.

    Captura de pantalla del cuadro de diálogo Instalar Python

  4. Cierre el asistente de instalación una vez que se complete la instalación.

  5. Inicie el símbolo del sistema y luego ejecute el siguiente comando para instalar paconn.

    pip install paconn

    Captura de pantalla del símbolo del sistema en la que se muestra el comando para instalar paconn

  6. Espere a que termine la instalación.

Tarea 3: Descargar el conector localmente

En esta tarea descargará los archivos de definición del conector localmente para que pueda agregar la propiedad URL de host.

  1. Ejecute el comando de inicio de sesión.

    paconn login

  2. Copie el Código proporcionado.

    Captura de pantalla de la respuesta al comando de inicio de sesión con un código para copiar

  3. En un navegador, inicie sesión con las mismas credenciales que su entorno. Vaya al inicio de sesión del dispositivo de Microsoft, pegue el Código que copió y, a continuación, seleccione Siguiente.

  4. Proporcione sus credenciales.

  5. Seleccione Continuar.

    Debería recibir un mensaje de inicio de sesión correcto.

    Captura de pantalla del mensaje de inicio de sesión correcto

  6. Vuelva al símbolo del sistema, donde debería ver un mensaje de inicio de sesión correcto.

  7. Ejecute el comando de descarga.

    paconn download

  8. Cuando se le solicite que seleccione un entorno, introduzca un número para el entorno donde instaló la solución y luego presione la tecla Entrar.

  9. Proporcione el número del conector Contoso Invoicing: código abierto y luego presione la tecla Entrar.

  10. La descarga debería completarse correctamente. Anote la ubicación donde se descargó el conector.

Tarea 4: Validar

En esta tarea validará el conector y corregirá algunos errores comunes. También agregará los metadatos del conector necesarios.

  1. Copie la ruta donde se descargó el conector.

    Captura de pantalla de la ruta del conector seleccionada en la ventana de comandos

  2. Ejecute el comando de validación mediante la ruta que copió, así como el nombre de archivo Swagger de definición de API \apiDefinition.swagger.json.

    paconn validate --api-def [Path to apiDefinition.swagger.json]

    Captura de pantalla del comando de validación en la ventana de comandos

  3. Debería obtener un error, ya que falta un resumen para el cuarto parámetro de la acción ListInvoices, así como una propiedad de contacto.

    Captura de pantalla de los errores de validación en la ventana de comandos

  4. Corrija el resumen que falta. Vaya a Power Apps Maker Portal y asegúrese de que se encuentra en el entorno correcto.

  5. Seleccione Soluciones y abra la solución Contoso Invoicing - Open Source.

  6. Seleccione el conector Contoso Invoicing - Open Source y luego seleccione Editar.

    Flecha que apunta al botón para editar el conector personalizado

  7. Seleccione la pestaña Definición y luego la acción ListInvoices.

  8. Desplácese hacia abajo hasta la sección Solicitud, seleccione el botón de puntos suspensivos (contenido adicional) del parámetro toAmount y luego elija Editar.

    Flecha que apunta al botón para editar el parámetro

  9. Introduzca Importe final en el campo Resumen y luego seleccione Actualizar conector.

    Flecha que apunta al botón Actualizar conector

  10. Espere a que termine la actualización del conector.

  11. Elimine el conector que descargó anteriormente (lo volverá a agregar en un momento). Elimine el conector que descargó de su máquina.

  12. Vuelva a descargar el conector. Vuelva al símbolo del sistema y ejecute de nuevo el comando de descarga.

    paconn download

  13. Cuando se le solicite que seleccione un entorno, introduzca el número para el entorno donde instaló la solución y luego presione la tecla Entrar.

  14. Proporcione el número del conector Contoso Invoicing: código abierto y luego presione la tecla Entrar.

  15. La descarga debería completarse correctamente. Anote la ubicación donde se ha descargado el conector.

  16. Ejecute el comando de validación indicando la ruta que ha copiado y el nombre de archivo Swagger de definición de API \apiDefinition.swagger.json.

    paconn validate --api-def [Path to apiDefinition.swagger.json]

  17. Ahora debería recibir solo un error para el parámetro de contacto que falta.

    Error de validación

  18. Vaya a la carpeta del conector que descargó y abra el archivo apiDefinition.swagger.json mediante el editor de texto que prefiera, como, por ejemplo, el Bloc de notas.

    Abrir el archivo de definición del conector

  19. Agregue una propiedad de contacto a la información después de la propiedad de descripción.

    "contact": {
  "name": "Contoso Support",
  "url": "https://contosoinvoicingtest.azurewebsites.net",
  "email": "info@Contoso.com"
}

    Captura de pantalla del parámetro de contacto agregado a la definición de Swagger con una coma al final de la propiedad de descripción

  20. Agregue metadatos del conector después de la información.

    "x-ms-connector-metadata": [
  {
   "propertyName": "Website",
   "propertyValue": "https://contosoinvoicingtest.azurewebsites.net"
  },
  {
   "propertyName": "Privacy policy",
   "propertyValue": "https://contosoinvoicingtest.azurewebsites.net"
  },
  {
   "propertyName": "Categories",
   "propertyValue": "Productivity"
  }
],

    Captura de pantalla de los metadatos del conector agregados después de la información con una coma al final de la sección de información

  21. Seleccione Archivo y luego Guardar para guardar los cambios.

  22. Ejecute el comando de validación una vez más.

    paconn validate --api-def [Path to apiDefinition.swagger.json]

  23. El conector debería validarse correctamente.

Captura de pantalla de la validación correcta del conector

Ha preparado correctamente el conector para crearlo como código abierto y luego certificarlo. Si estuviera creando un conector real, seguiría publicando el conector en GitHub.