Ejercicio: Usar una plantilla de directiva para establecer dinámicamente la URL del host

  • 10 minutos

En este ejercicio, creará una plantilla de directiva para establecer la URL del host en la creación de la conexión. Este proceso permitirá que una conexión funcione con una prueba o en producción.

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 una 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 ContosoInvoicingPolicyTemplates_1_0_0_2.zip y luego seleccione 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. Seleccione Publicar todas las personalizaciones y espere a que se complete la publicación.

  8. Abra la solución Facturación de Contoso - Plantillas de directiva que ha importado.

    Debería ver el componente de conector personalizado Facturación de Contoso - Directiva.

    Captura de pantalla de componentes de la solución

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, por lo que también lo 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 y luego espere a que se complete la instalación.

    Captura de pantalla del proceso de instalación de 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 de la instalación del comando 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.

  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.

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

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

  7. Vuelva al símbolo del sistema y 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 pulse la tecla Intro.

  9. Solo debe aparecer un conector: Directiva de facturación de Contoso. Presione la tecla Intro de nuevo para seleccionar ese conector.

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

Tarea 4: Editar apiProperties.json para agregar la propiedad de URL del host

En esta tarea, editará el archivo apiProperties.json para configurar la propiedad hostUrl. Cuando se configura la propiedad, a los usuarios que están creando una conexión se les pedirá este valor junto con la clave de API.

  1. Vaya a la carpeta que descargó en la tarea anterior y luego abra el archivo apiProperties.json.

  2. Pegue el JSON en ConnectionParameters, antes de la propiedad api_key.

    "hostUrl": {
        "type": "string",
        "uiDefinition": {
          "constraints": {
            "required": "true"
          },
          "description": "Specify your API Url e.g. https://test.contoso.com",
          "displayName": "API URL",
          "tooltip": "Specify your API Url e.g. https://test.contoso.com"
        }
      },

    Captura de pantalla de la propiedad de URL del host

  3. Guarde los cambios.

  4. Vaya al símbolo del sistema y cambie el directorio a la carpeta que descargó.

  5. Ejecute el comando actualizar.

    paconn update --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png

  6. Seleccione el entorno correcto en el que instaló la solución.

  7. Seleccione el conector Facturación de Contoso - Directiva.

La actualización debería completarse correctamente.

Tarea 5: Agregar la directiva Establecer nombre de host

En esta tarea, configurará una plantilla de directiva Establecer nombre de host para utilizar la propiedad de conexión que configuró en la tarea anterior.

  1. Vaya a Power Apps Maker Portal y asegúrese de que tiene seleccionado el entorno correcto.

  2. Seleccione Soluciones y luego abra la solución Facturación de Contoso - Plantillas de directiva que importó.

  3. Seleccione el conector personalizado Facturación de Contoso - Directiva y luego seleccione Editar.

    Captura de pantalla de una flecha que apunta al botón para editar el conector

  4. Seleccione la pestaña Definición.

  5. Desplácese hasta la sección Directivas y seleccione + Nueva directiva.

    Captura de pantalla de una flecha que apunta al botón para agregar una nueva directiva

  6. Introduzca Directiva de URL de host como Nombre y luego seleccione Establecer URL de host como Plantilla.

    Captura de pantalla de una flecha que apunta a la selección de la plantilla de host

  7. Introduzca @connectionParameters('hostUrl') como Plantilla de URL y luego seleccione Actualizar conector.

    Captura de pantalla de una flecha que apunta al botón Actualizar conector

    El conector debería actualizarse correctamente.

  8. No se vaya de esta página.

Tarea 6: Probar

En esta tarea, creará una conexión con la nueva configuración y luego la probará.

  1. Inicie una nueva ventana del navegador y luego vaya a Contoso Invoicing.

  2. Seleccione el vínculo de la Clave de API.

  3. Copie la Clave de API.

  4. Regrese al conector.

  5. Seleccione la pestaña Prueba.

  6. Seleccione + Nueva conexión.

    Captura de pantalla de una flecha que apunta al botón para agregar una nueva conexión

  7. Introduzca https://contosoinvoicingtest.azurewebsites.net/ como URL de API, pegue la Clave de API que copió y, a continuación, seleccione Crear conexión.

  8. Seleccione Actualizar conexiones.

    Captura de pantalla de una flecha que apunta al botón para actualizar conexiones

  9. Seleccione ListInvoice > Probar operación.

    Captura de pantalla de la ventana para probar operación

    La prueba debe devolver facturas.

    Captura de pantalla del campo Cuerpo de la respuesta