Creación y publicación de plantillas de flujo de trabajo para Azure Logic Apps

En estos pasos se describe cómo crear y publicar una plantilla de flujo de trabajo disponible solo para los miembros de una suscripción específica de Azure.

1. En el cuadro de búsqueda de Azure Portal , busque y seleccione plantillas de aplicaciones lógicas.

2. En la barra de herramientas de la página Plantillas de Logic Apps , seleccione Crear.

3. En la página Crear una plantilla de Azure Logic Apps , en la pestaña Aspectos básicos , proporcione la siguiente información:

   Parámetro	Obligatorio	Valor	Descripción
   Suscripción	Sí	< Azure-subscription-name>	La suscripción de Azure que se va a usar con la plantilla de flujo de trabajo.
   Grupo de recursos	Sí	< resource-group-name>	Nombre del grupo de recursos de Azure que se va a usar con la plantilla.
   Nombre	Sí	< template-name>	Nombre del recurso de plantilla de flujo de trabajo.
   Región	Sí	< Región de Azure>	Región de Azure para dónde crear el recurso de plantilla de flujo de trabajo.

4. Seleccione Revisar y crear cuando haya terminado. Revise la información proporcionada y seleccione Crear.

   Azure crea el recurso de plantilla.

A continuación, elija la definición de flujo de trabajo de origen que se usará para la plantilla.

Elección de la definición del flujo de trabajo de origen

1. En el menú de recursos de plantilla, en Plantilla, seleccione Plantilla.

2. En la página Plantilla , en la pestaña Flujos de trabajo, seleccione Agregar.

3. En el panel Administrar flujos de trabajo de esta plantilla , en la pestaña Elegir flujos de trabajo , proporcione la siguiente información:

   Parámetro	Obligatorio	Valor	Descripción
   Suscripción	Sí	< Azure-subscription-name>	Nombre de la suscripción de Azure con la aplicación lógica de origen.
   Grupo de recursos	Sí	< resource-group-name>	Nombre del grupo de recursos de Azure con la aplicación lógica de origen.
   Instancia de aplicación lógica	Sí	< source-logic-app>	Nombre de la aplicación lógica de origen con el flujo de trabajo que desea usar.
   Flujos de trabajo	Sí	< flujos de trabajo de origen>	En una aplicación lógica de consumo, seleccione el único flujo de trabajo existente que se usará en la plantilla. Para una aplicación lógica estándar, seleccione al menos un flujo de trabajo que se usará en la plantilla.

4. Cuando haya acabado, seleccione Siguiente.

5. En la pestaña Configurar flujos de trabajo , proporcione la siguiente información para cada flujo de trabajo de origen seleccionado:

   Parámetro	Obligatorio	Valor	Descripción
   Nombre del flujo de trabajo	Sí	< JSON-workflow-name>	Nombre JSON del flujo de trabajo que solo puede usar letras minúsculas, números y guiones, y que solo se puede cambiar un nombre una vez.
   Estado	Sí	Con estado o sin estado	Si desea guardar y almacenar el historial de ejecución del flujo de trabajo, las entradas de operación y las salidas de la operación, de forma predeterminada.
   Resumen	Sí	< short-description>	Un breve resumen general sobre el propósito de la plantilla.
   Descripción	No	< descripción detallada>	Descripción con información más detallada sobre la plantilla.
   Requisitos previos	No	< prerrequisitos>	Cualquier requisito que necesite antes de poder usar la plantilla.

6. En la sección Imágenes de flujo de trabajo, proporcione las imágenes de vista previa del flujo de trabajo que se usarán para el panel de información general de la plantilla en la galería de plantillas. Este panel incluye otra información de plantilla.

   Imagen de flujo de trabajo	Descripción
   URL de SAS en modo claro	La dirección URL de SAS de la imagen de vista previa del flujo de trabajo con temas claros almacenada en un contenedor de blobs desde la cuenta de Azure Storage.
   Dirección URL de SAS en modo oscuro	La dirección URL de SAS de la imagen de vista previa del flujo de trabajo con temas oscuros almacenada en un contenedor de blobs desde la cuenta de Azure Storage.

7. Cuando haya acabado, seleccione Guardar.

   Puede guardar la plantilla en cualquier momento durante el proceso de creación. Cada vez que guarde el progreso, la validación se ejecuta automáticamente para determinar si existen errores, por ejemplo, acciones no admitidas o valores no parametrizados. No tiene que corregir inmediatamente los errores cuando los encuentre, pero debe corregirlos antes de publicarlos.

8. En la pestaña Conexiones , revise y confirme las conexiones que Azure extrae automáticamente de los flujos de trabajo de origen.

   No tiene que realizar ninguna otra acción.

9. Cuando esté listo, seleccione Siguiente.

Personalización de parámetros

En la pestaña Parámetros , agregue personalización para los parámetros que desee para el flujo de trabajo.

1. En la pestaña Parámetros , seleccione el icono de edición del parámetro .

2. Proporcione la siguiente información para el parámetro :

   Propiedad	Obligatorio	Descripción
   Nombre para mostrar	Sí	Nombre del parámetro que aparece en Azure Portal.
   Valor predeterminado	No	Valor predeterminado del parámetro.
   Descripción	No	Descripción del propósito del parámetro.
   Campo obligatorio	No	Si el flujo de trabajo requiere el parámetro .

3. Cuando haya acabado, seleccione Guardar.

Proporcionar información sobre la plantilla

La pestaña Perfil especifica información sobre la plantilla que aparece en la galería de plantillas, por ejemplo, el nombre para mostrar de la plantilla, el nombre del publicador, los conectores y otros metadatos.

1. En la pestaña Perfil , proporcione la siguiente información sobre la plantilla:

   Propiedad	Obligatorio	Descripción
   Nombre para mostrar	Sí	El nombre de exhibición de la plantilla de flujo de trabajo que aparece en la galería de plantillas.
   Por	Sí	Nombre del publicador de plantillas de flujo de trabajo.
   Resumen	Sí	Descripción del flujo de trabajo que crea la plantilla.
   Conectores destacados	Sí	Seleccione los tipos de conector principales en la plantilla de flujo de trabajo.
   Categoría	No	Categoría a la que pertenece la plantilla.
   Etiquetas	No	Cualquier etiqueta que quiera usar para etiquetar el flujo de trabajo.

2. Cuando esté listo, seleccione Siguiente.

3. En la pestaña Resumen , revise y confirme toda la información proporcionada.

Publicar para pruebas

Cuando esté listo para probar la plantilla, puede publicar la plantilla para realizar pruebas.

1. En la pestaña Resumen o en una pestaña anterior, en la parte inferior de la pestaña, en la lista Guardar , seleccione Guardar y publicar para realizar pruebas.

   

   Azure publica la plantilla, que muestra la etiqueta Pruebas , en la galería de plantillas.

2. Para probar la nueva plantilla, siga los pasos descritos en Creación de flujos de trabajo a partir de plantillas precompiladas , pero con estos pasos:

   1. En la lista Estado , seleccione Publicado para pruebas. En la fila de filtros, seleccione Mis plantillas.

      La plantilla aparece con la etiqueta Pruebas , por ejemplo:

      

   2. Termine de crear el flujo de trabajo, probar la plantilla y realizar los ajustes necesarios.

Publicación para producción

Para cambiar la etiqueta de plantilla de Testing a Production en la galería de plantillas, siga estos pasos:

1. En Azure Portal, busque y abra el recurso de plantilla.

2. En la barra lateral de la plantilla, en Plantilla, seleccione Plantilla.

3. En la página Plantilla , seleccione Siguiente y repita hasta que abra la pestaña Perfil .

4. En la lista Guardar , seleccione Guardar y publicar para producción.

   

Eliminación de la plantilla de la galería

Si desea quitar temporalmente o permanentemente la plantilla de flujo de trabajo personalizada de la galería de plantillas, puede cancelar la publicación de la plantilla.

1. En Azure Portal, busque y abra el recurso de plantilla.

2. En la barra lateral de la plantilla, en Plantilla, seleccione Plantilla.

3. En la página Plantilla , seleccione Siguiente y repita hasta que abra la pestaña Perfil .

4. En la lista Guardar , seleccione Guardar y cancelar la publicación de la plantilla.

   

En estos pasos se describe cómo crear y publicar una plantilla de flujo de trabajo disponible para que todos los usuarios los usen en Azure. Para este enfoque, debe crear un paquete de plantilla.

¿Qué hay en un paquete de plantilla?

La siguiente tabla describe los archivos necesarios y opcionales de un paquete de plantillas:

También puede incluir cualquier otro archivo para mantener y respaldar su plantilla, por ejemplo, archivos con datos de prueba o de muestra.

Creación de una carpeta de paquetes de plantilla

• Antes de crear la carpeta del paquete de plantillas, familiarícese con las Convenciones de nombres y estilo.

• Para que el repositorio de plantillas sea más fácil de explorar, organizar y mantener, use la siguiente sintaxis para el nombre de su carpeta y el menor número de palabras para evitar sobrepasar el límite de caracteres de las rutas de acceso a los archivos:

  < workflow-task>-<producto>-<pattern-or-protocol, si existe>

  Para ver ejemplos, consulte el repositorio de plantillas de flujo de trabajo para Azure Logic Apps en GitHub.

• Para registrar correctamente la carpeta del paquete de plantillas, debe agregar el nombre de la carpeta al archivo manifest.json de nivel raíz del repositorio.

Creación de un archivo workflow.json

El archivo workflow.json contiene la definición subyacente de un flujo de trabajo en formato JSON. Para crear el archivo workflow.json, debe copiar y guardar la definición del flujo de trabajo como un archivo denominado workflow.json.

Para obtener la mejor y más fácil definición del flujo de trabajo, cree su flujo de trabajo usando el diseñador. Asegúrese de revisar los Procedimientos recomendados de flujo de trabajo junto con las Convenciones de nombres y estilo. O bien, como punto de partida, puede usar las plantillas de flujo de trabajo precompiladas desde la galería de plantillas de Azure Portal.

A medida que crea su flujo de trabajo, el diseñador incluye automáticamente referencias a cualquier conexión incorporada, de proveedor de servicios, de API administrada o bibliotecas que se hayan agregado en la definición del flujo de trabajo subyacente.

Cuando haya terminado, copie la definición del flujo de trabajo subyacente en un archivo vacío workflow.json.

Copia de la definición del flujo de trabajo subyacente

1. En Azure Portal, en el menú flujo de trabajo, en Desarrollador, seleccione Código.

2. En la ventana de vista de código, copie toda la definición de flujo de trabajo, por ejemplo:

   

3. En un archivo vacío denominado workflow.json, guarde la definición del flujo de trabajo.

Referencias de parámetros en workflow.json

Cuando haga referencia a los parámetros en el archivo workflow.json, deberá reflejar los nombres de los parámetros que usan el sufijo _#workflowname# de la siguiente manera:

"name": "@parameters('<parameter-name>_#workflowname#')"

Por ejemplo:

"name": "@parameters('sharepoint-folder-path_#workflowname#')"

Referencias de conexión en workflow.json

Cuando haga referencia a las conexiones en el archivo workflow.json, deberá reflejar los nombres de las conexiones que usan el sufijo _#workflowname# de la siguiente manera:

"referenceName": "<connector-ID>_#workflowname#",
"connectionName": "<connector-ID>_#workflowname#"

Por ejemplo:

"referenceName": "azureaisearch_#workflowname#",
"connectionName": "azureaisearch_#workflowname#"

Para más información sobre el id. del conector, consulte Buscar el id. del conector.

Creación de un archivo manifest.json

El archivo manifest.json describe la relación entre un flujo de trabajo y los componentes relacionados. Actualmente, necesita crear manualmente este archivo, o puede reutilizar el archivo manifest.json de una plantilla precompilada existente en el repositorio de plantillas de flujo de trabajo de Azure Logic Apps en GitHub. Al crear el archivo manifest.json, asegúrese de revisar las Convenciones de nombres y estilo.

La siguiente tabla describe los atributos del archivo manifest.json:

En el archivo manifest.json de su paquete de plantillas de flujo de trabajo, agregue los mismos nombres de imágenes en la sección images sin la extensión .png del nombre del archivo, por ejemplo:

"images": {
    "dark": "workflow-dark",
    "light": "workflow-light"
}

Búsqueda del identificador del conector

Para buscar el identificador del conector que se va a usar para una conexión en el archivo manifest.json o una referencia de conexión en el archivo workflow.json, siga estos pasos:

1. En Azure Portal, abra el recurso de aplicación lógica.

2. En el menú de la aplicación lógica, en Flujos de trabajo, seleccione Conexiones.

3. Seleccione la pestaña Vista JSON.

4. En función del tipo de conexión, siga estos pasos:

   • Para una conexión de API "compartida" administrada que se hospeda y se ejecuta en Azure:

     1. Busque la sección managedApiConnections.

     2. En el atributo connection, copie y guarde el valor id, pero sustituya cualquier dato personal o confidencial con #<item>#, como el id. de suscripción, el nombre del grupo de recursos, etc:

        /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/<connection-name>

        Por ejemplo, el texto siguiente muestra el identificador del conector para el conector de SharePoint:

        /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/sharepointonline

   • Para una conexión de proveedor de servicios hospedada en el entorno de ejecución de Azure Logic Apps de un solo inquilino:

     1. Busque la sección serviceProviderConnections.

     2. Para cada conexión, busque el atributo id en el atributo serviceProvider.

     3. Copie y guarde el siguiente valor:

        /serviceProviders/<connection-name>

        Por ejemplo, el texto siguiente muestra el id. del conector para el conector de Búsqueda de Azure AI:

        /serviceProviders/azureaisearch.

Buscar las propiedades de operación 'kind' y 'type' para featuredConnections

En el archivo manifest.json , la featuredConnections sección puede incluir iconos para cualquier otra operación que quiera incluir con la galería de plantillas en Azure Portal. Para esta sección, que es una matriz, debe proporcionar los atributos kind y type para cada operación.

Para obtener estos valores de atributo, siga estos pasos en Azure Portal con el flujo de trabajo abierto:

1. En el menú de flujo de trabajo, en Desarrollador, seleccione Código.

2. En la ventana de vista de código, en la sección actions, busque la operación que quiere y después los valores kind y type.

Adición de un paquete de plantilla al repositorio de GitHub

Para publicar su paquete de plantillas en la galería de plantillas de flujo de trabajo en el portal de Azure, debe configurar su cuenta de GitHub, visitar el repositorio de plantillas de flujo de trabajo para Azure Logic Apps en GitHub, y crear una solicitud de incorporación de cambios para que el equipo de Azure Logic Apps pueda revisarla y validarla.

1. En caso de no tener una, cree una cuenta gratuita.

   Para más información, consulte Introducción a la cuenta de GitHub.

2. Vaya al repositorio de plantillas de flujo de trabajo llamado LogicAppsTemplates para Azure Logic Apps en GitHub.

3. Cree su propia bifurcación, que es una copia remota del repositorio LogicAppsTemplates en GitHub.

   Para más información, consulte Bifurcación de un repositorio.

4. Para trabajar localmente, clone la bifurcación en el equipo.

   1. Siga estos pasos para descargar, instalar y configurar Git.

   2. Vaya a la bifurcación, que tiene la siguiente dirección URL:

      https://github.com/<your-username>/LogicAppsTemplates

   3. En el equipo local, cree una carpeta denominada GitHub, si aún no tiene una. No clone en una carpeta sincronizada de OneDrive.

   4. Siga estos pasos para clonar su bifurcación, no el repositorio de producción.

   5. En el repositorio local, siga estos pasos para crear una rama de trabajo.

   6. Después de extraer del repositorio su rama de trabajo, vaya al nivel raíz en su repositorio local, y cree la carpeta del paquete de plantillas.

   7. Agregue los archivos de su plantilla a la carpeta del paquete de plantillas y actualice el archivo manifest.json del nivel raíz con el nombre de la carpeta.

   8. Cuando esté listo para confirmar los cambios en su repositorio local, que es como guardar una instantánea, ejecute los siguientes comandos usando la herramienta de línea de comandos de Git u otras herramientas:

      git add .

      git commit -m "<commit-short-description>"

   9. Para cargar su instantánea en su bifurcación remota, ejecute el siguiente comando:

      git push origin <your-working-branch>

5. En GitHub, cree una solicitud de cambios para comparar <su-rama-de-trabajo> con la rama principal en el repositorio LogicAppsTemplates.

   1. Vaya a la página Solicitudes de cambios del repositorio y seleccione Nueva solicitud de cambios.

   2. En Comparar cambios, seleccione Comparar entre bifurcaciones.

   3. Asegúrese de que la solicitud de incorporación de cambios tenga la siguiente configuración y, a continuación, seleccione Crear solicitud de cambios.

      Repositorio base	Base	Repositorio principal	Comparación
      Azure/LogicAppsTemplates	principal	< nombre-de-usuario>/LogicAppsTemplates	< su-rama- de- trabajo>

      

   4. Escriba un título y una descripción para la solicitud de incorporación de cambios. Para terminar, seleccione Crear solicitud de cambios.

   5. Espere a que el equipo de Azure Logic Apps revise la solicitud de incorporación de cambios.

   Para más información, consulte Creación de una solicitud de cambios a partir de una bifurcación.