Ejercicio: Crear un conector personalizado certificado

  • 6 minutos

En este ejercicio usará la CLI paconn 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: Contoso Invoicing Triggers. Seleccione el botón de descarga en la parte central derecha de la pantalla.

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 - Open Source.

Instalar la CLI de conectores de Microsoft Power Platform

La CLI de conectores de Microsoft Power Platform 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 el botón 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.

  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

  6. Espere a que termine la instalación.

Descargar el conector localmente

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

  1. Ejecute el comando paconn login.

  2. Copie el Código proporcionado.

  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.

  6. Vuelva al símbolo del sistema, donde 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. Presione la tecla Entrar en el teclado.

  9. Proporcione el número del conector Contoso Invoicing - Open Source y luego presione la tecla Entrar.

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

Validar el conector, corregir errores y agregar metadatos

En esta tarea validará el conector, corregirá algunos errores comunes y agregará los metadatos de conector necesarios.

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

  2. 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]

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

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

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

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

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

  7. 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.

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

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

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

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

    paconn download

  12. Cuando se le solicite que seleccione un entorno, introduzca el número para el entorno donde instaló la solución. Presione la tecla Entrar en el teclado.

  13. Proporcione el número del conector Contoso Invoicing - Open Source y luego presione la tecla Entrar.

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

  15. 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]

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

  16. Vaya a la carpeta del conector que ha descargado y abra el archivo apiDefinition.swagger.json con el editor de texto que prefiera, por ejemplo el Bloc de notas.

  17. 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"
}

  18. 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"
  }
],

  19. Seleccione Archivo y Guardar para guardar los cambios.

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

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

Ahora, el conector debería validarse correctamente.

Ha preparado correctamente el conector para crearlo como código abierto y luego certificarlo. Si estuviese creando un conector real, pasaría ahora a la publicación del conector en GitHub.