Ejercicio: Usar acciones de GitHub para Microsoft Power Platform

  • 15 minutos

En este ejercicio, exportará una solución que contiene un conector personalizado a GitHub mediante el uso de Acciones de GitHub para Microsoft Power Platform.

Importante

Utilice un entorno de prueba con Microsoft Dataverse aprovisionado. Si no dispone de ninguno, puede suscribirse al Plan de la comunidad. También se necesita una cuenta de GitHub para completar el ejercicio. Puede suscribirse para obtener una gratis en GitHub.com.

Nota

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

Tarea 1: Importar 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 y luego Importar solución.

  3. Seleccione Examinar.

  4. Seleccione la solución ContosoInvoicingALM_1_0_0_0.zip y luego 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. Seleccione la solución Contoso Invoicing - ALM que ha importado.

    Debería ver el componente de conector personalizado Contoso Invoicing - ALM.

  9. En la esquina superior derecha de la pantalla, seleccione el icono Configuración y luego Detalles de la sesión.

    Captura de pantalla en la que se muestra cómo seleccionar los detalles de la sesión

  10. En el cuadro de diálogo de detalles de la sesión de Power Apps, seleccione el valor URL de la instancia y cópielo para usarlo más adelante en el ejercicio.

    Captura de pantalla en la que se muestran los detalles de la sesión y dónde encontrar el valor URL de la instancia

Tarea 2: Crear un repositorio de GitHub

Para crear un repositorio de GitHub, siga estos pasos:

  1. Vaya a GitHub y seleccione Crear repositorio.

  2. Escriba ContosoInvoiceALM para el nombre del repositorio.

  3. Seleccione Agregar un archivo LÉAME.

  4. Seleccione Crear repositorio.

  5. En el nuevo repositorio, seleccione el icono de Ajustes.

  6. Expanda la sección Secretos y variables y seleccione Acciones. Los secretos son variables de entorno que están cifradas. Cualquiera con acceso de colaborador a este repositorio puede usar estos secretos para las acciones de GitHub. Creará tres secretos que garantizarán que la acción que cree no incluya información confidencial.

  7. Seleccione Nuevo secreto de repositorio.

  8. Escriba entorno en el campo Nombre.

  9. Pegue la URL del entorno que copió en la tarea anterior en el campo Secreto.

    Captura de pantalla en la que se muestra cómo agregar un nuevo secreto de acción

  10. Seleccione Agregar secreto.

  11. Agregue otro secreto con el nombre de usuario con el Secreto**, que incluye el correo electrónico de la cuenta que utiliza para acceder al entorno.

  12. Agregue otro secreto con el nombre de contraseña con el Secreto que incluye la contraseña de la cuenta que utiliza para acceder al entorno.

  13. Una vez que haya agregado los secretos, la lista de valores debería tener el mismo aspecto que en la siguiente captura de pantalla.

    Captura de pantalla en la que se muestran las tres acciones que ha agregado: entorno, contraseña y usuario

  14. Expanda Acciones y seleccione General

    Captura de pantalla con el botón Vínculo general de acciones

  15. Vaya hacia abajo, hasta la sección Permisos de flujo de trabajo; seleccione Permiso de lectura y escritura y luego seleccione Guardar.

    Captura de pantalla con la sección Permisos de flujo de trabajo

Tarea 3: Crear una acción de GitHub

Para crear una acción de GitHub, siga estos pasos:

  1. En la navegación del repositorio, seleccione el elemento de menú Acción.

    Captura de pantalla en la que se muestra cómo seleccionar las acciones

  2. Seleccione la opción Configurar un flujo de trabajo usted mismo.

    Captura de pantalla en la que se muestra cómo se selecciona la opción Configurar su propio flujo de trabajo

  3. Abra el archivo export-and-branch-solution.yml proporcionado y pegue el contenido en el área Editar archivo nuevo.

    Captura de pantalla en la que se muestra cómo se pegan los nuevos pasos de la acción

  4. Ha agregado los siguientes cuatro pasos: 1) Acción Quién-soy-yo para probar la conexión, 2) Exportar la solución, 3) Desempaquetar la solución y 4) Crear una rama y registrar los archivos de la solución.

    Captura de pantalla en la que se muestran los pasos descritos anteriormente

  5. Seleccione Iniciar confirmación en el lado derecho y luego seleccione Confirmar nuevo archivo. Este paso guardará la acción que creó.

    Captura de pantalla en la que se muestra cómo se seleccionan las acciones Iniciar confirmación y Confirmar nuevo archivo

Su acción se ha guardado y está lista para ejecutarse.

Tarea 4: Ejecutar la acción de exportación

Para ejecutar la acción de exportación, siga estos pasos:

  1. Vaya al repositorio Acciones.

    Captura de pantalla en la que se muestra cómo seleccionar las acciones para ver la lista

  2. Seleccione la acción export-and-branch-solution y luego seleccione Ejecutar flujo de trabajo.

    Captura de pantalla en la que se muestra cómo seleccionar la acción que ha creado y la opción para ejecutar el flujo de trabajo

  3. En la sección Usar flujo de trabajo de, seleccione la rama principal y luego Ejecutar flujo de trabajo.

    Captura de pantalla en la que se muestra cómo seleccionar la opción para ejecutar el flujo de trabajo

  4. Supervise el progreso del flujo de trabajo hasta que se haya completado correctamente.

    Captura de pantalla en la que se muestra cómo supervisar el progreso de la ejecución del flujo de trabajo

  5. Seleccione Código en la navegación y luego ramas.

    Captura de pantalla en la que se muestran la opción Código, el número de ramas y la selección de la lista de ramas

  6. Debería ver la rama que la implementación de la acción GitHub ha creado. Actualmente, esta rama no está fusionada con la rama principal. Seleccione Nueva solicitud de incorporación de cambios para iniciar el proceso de fusión.

    Captura de pantalla en la que se muestra cómo seleccionar una nueva solicitud de incorporación de cambios para la rama que se ha creado recientemente

  7. En el área de comentarios, introduzca Versión inicial del conector.

  8. Seleccione la opción Crear solicitud de incorporación de cambios.

  9. En este punto, alguien revisaría y fusionaría, pero debido a que solo usted está haciendo el ejercicio, debe aprobar usted mismo la solicitud de incorporación de cambios.

  10. Amplíe la opción Fusionar solicitud de incorporación de cambios y luego seleccione Fusión mediante combinación con "squash".

    Captura de pantalla en la que se muestra cómo seleccionar la solicitud de fusión

  11. Seleccione Fusión mediante combinación con "squash" y luego Confirmar fusión mediante combinación con "squash".

    La rama con los cambios ya se ha fusionado.

  12. Seleccione Código y luego solutions/ContosoInvoiciningALM. Esta carpeta incluye los archivos de solución que se crearon. Puede examinar el contenido de esta carpeta para determinar qué se extrajo de la solución y se almacenó como archivos individuales.

    Captura de pantalla en la que se muestra el contenido del repositorio después de la fusión

Tarea 5: Cambiar y registrar definiciones de conectores

Para cambiar y registrar las definiciones de conectores, siga estos pasos:

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

  2. Seleccione Soluciones y luego la solución Facturación de Contoso - ALM.

  3. Seleccione los puntos suspensivos (…) situados junto al componente de conector personalizado y luego elija Editar.

    Captura de pantalla en la que se muestra cómo editar el conector para realizar un cambio

  4. Cambie Color de fondo de icono a #0066ff y luego seleccione Actualizar conector.

    Captura de pantalla en la que se muestra cómo seleccionar el conector de actualización después de cambiar el color

  5. Repita los pasos 1-12 de la Tarea 4 para ejecutar el flujo de trabajo, cree una nueva solicitud de incorporación de cambios y combine el código en la rama principal.

  6. Seleccione Código en la navegación y luego el nombre de la solicitud de incorporación de cambios para abrir los detalles.

    Captura de pantalla de la solicitud de incorporación de cambios

  7. Compruebe el cambio registrado en el color del icono de #007ee5 a # 0066ff.

    Captura de pantalla en la que se muestra el cambio de color del icono en la diferencia

Nota

Se pueden aplicar otros cambios automáticos al guardar el conector, por ejemplo, el formato del icono puede cambiar de JPEG a PNG.

Ahora ya tiene un proceso automatizado para exportar y registrar los cambios de su conector personalizado en un sistema de control de origen.