Uso de plantillas de cadena

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 luego crear una secuencia predefinida de comandos y eventos para usar como en otras cadenas. Por ejemplo, con las plantillas, puedes:

• Proporcionar una ventaja inicial para facilitar la creación de cadenas.
• Estandarice flujos de trabajo comunes, como 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 Generador de cadenas.

Crear una plantilla a partir de una cadena existente

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

• Puedes utilizar la primera cadena como punto de partida para crear otras cadenas.
• Puede compartir la cadena con otros usando Chain Builder—incluso con aquellos de otras organizaciones, como en la Comunidad Workiva. 

Para crear una plantilla a partir de una cadena existente:

1. Desde Cadenas, haga clic en Generador de cadenas.
2. Seleccione la pestaña Cadenas  device_hub y luego seleccione Editar crear para la cadena.
3. Desde el menú de tres puntos de la cadena, en la parte superior derecha, seleccione Crear plantilla.
   
4. Ingrese un nombre y una descripción únicos para ayudar a identificar la plantilla.
   
5. En Carpetas, seleccione dónde guardar la plantilla.
6. Haz clic en Guardar.
7. Si la cadena tiene alguna variable, configure cada variable de plantilla:
   
   
   • Introduzca el nombre predeterminado para la variable de plantilla.

     Consejo: Para ayudar a identificar el valor a 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 predeterminados.
   • Seleccione si una variable de cadena dinámica o un recurso de espacio de trabajo proporcionará el valor.
     

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

8. Haga clic en Guardar y Publicar.

 

Crea una plantilla desde cero

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

Paso 1: Agregar la plantilla

1. En Chain Builder, desde la pestaña Plantillas dynamic_feed , haga clic en Crear => Plantilla en la parte superior derecha.
2. Para crear la plantilla en un lugar distinto a la carpeta Predeterminada , haga clic en Editar editar para su carpeta, seleccione la carpeta para guardar la plantilla y haga clic en Mover.
3. Ingrese un nombre y una descripción únicos 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, Completo- para una cadena completa, o Parte- para una cadena parcial o fragmento.

Paso 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 para los valores necesarios para las variables de sus comandos o los recursos del espacio de trabajo. Cuando se crea una cadena a partir de la plantilla, las variables y los recursos de la cadena reemplazan 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 el valor predeterminado.

   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 de espacio de trabajo proporcionará el valor de la variable.
   

   Nota: Si una variable de cadena, una variable de espacio de trabajo o una 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 eliminar una variable de la plantilla, haga clic en su X debajo de Acciones.

Paso 3: Definir los nodos de la plantilla

A medida que crea una plantilla, configure y vincule 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 ocurren dentro de la plantilla, como para habilitar un flujo de trabajo de aprobación o la carga manual de archivos.
• Eventos desencadenadores, como entradas de tiempo de ejecución para establecer variables (por ejemplo, cuentas, regiones o períodos de tiempo específicos) cuando ejecuta cadenas creadas a partir de la plantilla, o para iniciar automáticamente la cadena en función de los cambios en las fuentes conectadas.

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

Cuando agrega un nodo, muévalo al lugar donde aparece en la secuencia y vincúlelo con sus pasos siguiente y anterior.

• Para agregar el primer nodo de la plantilla, muévalo a Inicio.
• Para agregar un nodo como inicio de una nueva rama de un árbol lógico, vincule el paso anterior en 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, cree un grupo de comandos como paso.

Nota: De forma predeterminada, un nodo se ejecuta cuando el nodo anterior vinculado tiene éxito. Para habilitar la lógica condicional, como ejecutar un nodo solo cuando falla el nodo anterior, haga doble clic en el enlace y seleccione su condición: éxito  check_circle, falla  error, advertencia  advertenciao cualquier  check_circle.

Después de definir 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 administrar sus variables:

1. En Chain Builder, desde la pestaña Plantillas dynamic_feed , haga clic en el nombre de la plantilla y en Configuración de plantilla.
2. Edite el nombre, la descripción o las variables de la plantilla según sea necesario.
3. Haga clic en Guardar 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 luego haga clic en Ver para la plantilla en Cadenas usando.

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

Consejo:Para encontrar una cadena específica, busque por su nombre.

Copiar plantillas

Para utilizar una plantilla como punto de partida para una nueva plantilla, cree una copia de la misma. En Chain Builder, desde la pestaña Plantillas dynamic_feed , haga clic en Copiar file_copy para la plantilla.

Compartir plantillas con otros

Para ayudar a otros a crear cadenas, puedes compartir enlaces a plantillas publicadas con otros usando Chain Builder—incluso con aquellos de otras organizaciones, como en la Comunidad Workiva. 

1. En Chain Builder, desde la pestaña Plantillas dynamic_feed , haga clic en su Obtener enlace para compartir open_in_new.
   
2. Haga clic en Copiar al portapapeles file_copy y Cerrar.
3. Pegue y comparta el enlace con otros según sea 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 todos los conectores necesarios estén habilitados.

Al importar una cadena, tendrás la oportunidad de configurar cualquier conector faltante:

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, desde la pestaña Plantillas dynamic_feed , haga clic en Obtener enlace para compartir open_in_new para la plantilla.
2. Haga clic en Regenerar token actualizar y Cerrar.

Plantillas de archivo

Si ya no necesitas una plantilla, puedes archivarla. En Generador de cadenas, haga clic en Plantillas dynamic_feedy haga clic en Archivar archivar para la plantilla.

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