Utilizar plantillas de cadenas

Al crear una plantilla, puede utilizar una cadena publicada como base o crear una nueva secuencia de comandos y eventos desde cero.

Estas plantillas le permitirán crear una secuencia preestablecida de comandos y eventos para utilizarla como en otras cadenas. Por ejemplo, con las plantillas puedes:

• Proporcionar una ventaja para facilitar la creación de cadenas.
• Estandarice los flujos de trabajo comunes, por ejemplo para extraer datos de su sistema de registro.

Nota: Puede utilizar una plantilla con múltiples cadenas, espacios de trabajo y Entornos en Chain Builder.

Crear una plantilla a partir de una cadena existente

Crear una plantilla a partir de una cadena existente ofrece una serie de ventajas:

• Puedes utilizar la primera cadena como punto de partida para crear otras cadenas.
• Puede compartir la cadena con otras personas utilizando Chain Builder-incluidas las de otras organizaciones, como en la Comunidad Workiva. 

Para crear una plantilla a partir de una cadena existente:

1. Desde Cadenas, haga clic en Constructor de Cadenas.
2. Seleccione la pestaña Cadenas  device_hub y, a continuación, Editar Crear para la cadena.
3. En el menú de tres puntos de la cadena, arriba a la derecha, seleccione Crear plantilla.
   
4. Introduzca un nombre único y una descripción para ayudar a identificar la plantilla...
   
5. En Carpetas, seleccione dónde desea guardar la plantilla.
6. Haz clic en Guardar.
7. Si la cadena tiene alguna variable, configure cada variable de plantilla:
   
   
   • Introduzca el nombre por defecto para la variable de plantilla...

     Sugerencia: Para ayudarle a identificar el valor que debe utilizar con una variable, le recomendamos que incluya un prefijo con su nombre. Por ejemplo, WSV- para una variable de espacio de trabajo, CV- para una variable de cadena, DCV- para una variable de cadena dinámica, o Resource- para un recurso de espacio de trabajo.

   • Para facilitar la portabilidad y la reutilización, elimine los valores por defecto.
   • Seleccione si una variable de cadena dinámica o un recurso del espacio de trabajo proporcionará el valor.
     

     Nota: Si una variable de cadena, variable de espacio de trabajo o variable de tiempo de ejecución proporciona el valor, no seleccione ni Dinámico ni Recurso.

8. Haga clic en Guardar como y Publicar.

 

Crear una plantilla desde cero

Para construir una nueva secuencia de comandos y eventos como marco reutilizable para cadenas, sigue estas secuencias de pasos.

Etapa 1: Agregar la plantilla

1. En Chain Builder, en la pestaña Templates dynamic_feed , haga clic en Crear => Template en la parte superior derecha.
2. Para crear la plantilla en otro lugar que no sea la carpeta Por defecto , haga clic en Editar editar para su carpeta, seleccione la carpeta para guardar la plantilla y haga clic en Mover.
3. Introduzca un nombre único y una descripción para ayudar a identificar la plantilla y su intención.

   Consejo: Para ayudar a identificar si una plantilla proporciona una secuencia para una cadena completa o parcial, incluya un prefijo con su nombre. Por ejemplo, Full- para una cadena completa, o Part- para una cadena parcial o fragmento.

Etapa 2: Configurar las variables de la plantilla

Para facilitar la personalización y la reutilización, las plantillas contienen variables como marcadores de posición de los valores necesarios para las variables de sus comandos o los recursos del espacio de trabajo. Al crear una cadena a partir de la plantilla, las variables y recursos de la cadena reemplazan a las variables de la plantilla.

Para cada variable a incluir en la plantilla:

1. En Variables de plantilla, haga clic en Agregar.
2. Introduzca el nombre de la variable y su valor por defecto.

   Consejo: Para ayudar a identificar el valor a utilizar con una variable de plantilla, le recomendamos que incluya un prefijo con su nombre. Por ejemplo, WSV- para una variable de espacio de trabajo, CV- para una variable de cadena, DCV- para una variable de cadena dinámica, o Resource- para un recurso de espacio de trabajo.

3. En Tipo, seleccione si una variable de cadena dinámica o un recurso del espacio de trabajo proporcionará el valor de la variable.
   

   Nota: Si una variable de cadena, variable de espacio de trabajo o variable de tiempo de ejecución proporciona el valor, no seleccione ni Dinámico ni Recurso.

Después de Agregar todas las variables para la plantilla, haga clic en Guardar.

Nota: Para Quitar una variable de la plantilla, haga clic en su X bajo Acciones.

Etapa 3: Definición de los nodos de la plantilla

A medida que construyas una plantilla, configura y enlaza los nodos en su secuencia:

• Comandos o tareas ejecutadas por cadenas creadas a partir de la plantilla, como por ejemplo para interactuar con la plataforma Workiva u otra fuente de datos.
• Eventos que se producen dentro de la plantilla, como habilitar un flujo de trabajo de aprobación o la carga manual de archivos.
• Eventos desencadenantes, como entradas en tiempo de ejecución para establecer variables -como a cuentas, regiones o periodos de tiempo específicos- cuando ejecute cadenas creadas a partir de la plantilla, o para iniciar automáticamente la cadena en función de los cambios en los Orígenes (.) conectados.

Nota: Para Habilitar la personalización y la reutilización, los comandos de una plantilla no utilizan conexiones, ejecutores o variables establecidas en la cadena o espacio de trabajo; los especificará cuando cree una cadena a partir de la plantilla.

Cuando agregue un nodo, muévalo al lugar donde aparece en la secuencia y vincúlelo a sus etapas Siguiente y Anterior.

• Para agregar el primer nodo de la plantilla, muévelo a Comienza.
• Para agregar un nodo como inicio de una nueva rama de un árbol lógico, vincule la etapa anterior de la plantilla al primer nodo de las múltiples ramas.
• Para ejecutar comandos en paralelo entre sí o juntos como parte de un proceso en serie, crear un grupo de comandos como la Etapa.

Nota: Por defecto, un nodo se ejecuta cuando el nodo anterior enlazado tiene éxito. Para Habilitar la lógica condicional, como para ejecutar un nodo sólo cuando el nodo anterior falla, haga doble clic en el enlace y seleccione su condición-éxito  check_circle, fallo  error, advertencia  warning, o cualquier  check_circle.

Una vez definidos los nodos de la plantilla, haga clic en Publicar.

Editar la configuración de una plantilla

Para ajustar el nombre o la descripción de una plantilla, o para gestionar sus variables:

1. En Chain Builder, en la pestaña Templates dynamic_feed , haga clic en el nombre de la plantilla y Template Settings.
2. Edite el nombre, la descripción o las variables de la plantilla según sea necesario.
3. Haga clic en Guardar como y Publicar.

Ver cadenas que utilizan una plantilla

Para ver qué cadenas se crean a partir de una plantilla, vaya a la pestañaPlantillas dynamic_feed y, a continuación, haga clic en Ver para la plantilla en Cadenas utilizando.

En el panel En uso , aparecen las cadenas creadas a partir de la plantilla. Para abrir una cadena, haz clic en su nombre. 

Consejo:Para encontrar una cadena concreta, busque por su nombre.

Copiar plantillas

Para utilizar una plantilla como punto de partida de otra nueva, cree una copia de ella. En Chain Builder, en la pestaña Templates dynamic_feed , haga clic en Copy file_copy para la plantilla.

Compartir plantillas con otros

Para ayudar a otros a crear cadenas, puedes compartir enlaces a plantillas publicadas con otras personas que utilicen Chain Builder-incluidos los de otras organizaciones, como en la Comunidad Workiva. 

1. En Chain Builder, desde la pestaña Templates dynamic_feed , haga clic en su Get shareable link open_in_new.
   
2. Haga clic en Copiar al portapapeles file_copy y Cerrar.
3. Pega y comparte el enlace con los demás si es necesario.

Tenga en cuenta que las plantillas dependen de que ambos espacios de trabajo tengan acceso a los mismos conectores y comandos. Al compartir una plantilla con otro espacio de trabajo, la cadena importada no funcionará a menos que estén habilitados todos los conectores necesarios.

Al importar una cadena, tendrá la oportunidad de configurar los conectores que falten:

Revocar el acceso a una plantilla compartida

Para revocar el acceso de otros a una plantilla compartida, actualice su URL para crear un nuevo enlace:

1. En Chain Builder, en la pestaña Templates dynamic_feed , haga clic en Get shareable link open_in_new para la plantilla.
2. Haga clic en Regenerar token Actualizar y Cerrar.

Plantillas de archivo

Ninguno de ellos es necesario. En Chain Builder, haga clic en Templates dynamic_feed, y haga clic en Archive archive para la plantilla.

Nota: Para ver una plantilla archivada de Plantillas, haga clic en Archivadas.