Classic file types are no longer available for use as of January 2021. You can transition your classic files or download a PDF. Learn More

Usando plantillas de cadena

  • Last updated on

Con las plantillas de cadena, puede crear una secuencia prediseñadas de comandos y eventos para usar como un fragmento parcial o una cadena completa. Por ejemplo, con las plantillas puedes:

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

Para crear una plantilla, puede utilizar una cadena publicada como base o puede crear una nueva secuencia de comandos y eventos desde cero. Crear una plantilla a partir de una cadena existente ofrece una serie de beneficios:

  • Puede utilizar la primera cadena como punto de partida para crear otras cadenas.
  • Puede compartir la cadena con otras personas utilizando Chain Builder, incluidas aquellas 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 seleccioneEditar crear para la cadena.
  3. En el menú de tres puntos de la cadena en la parte superior derecha, seleccione Crear plantilla.
    chain-menu.png
  4. Introduzca un nombre y una descripción únicos para ayudar a identificar la plantilla.
    create-template-from-chain_01.png
  5. En Carpetas, seleccione dónde guardar la plantilla.
  6. Haz clic en Guardar.
  7. Si la cadena tiene variables, configure cada variable de plantilla:
    create-template-from-chain_02.png
    • Introduzca el nombre predeterminado para la variable de plantilla.
      Consejo: Para ayudar a identificar el valor a usar con una variable, le recomendamos incluir 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 Dynamic ni Resource.
  8. Haga clic en Guardar y Publicar.

 

Crea una plantilla desde cero

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

Paso 1: agrega 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 otro lugar que no sea la carpeta Predeterminada, haga clic en Editar editar para su carpeta, seleccione la carpeta para guardar la plantilla y haga clic en Mover.using-chain-templates_01.png
  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 un 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 recursos del espacio de trabajo. Cuando 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.using-chain-templates_02.png
  2. Introduzca el nombre de la variable y el valor predeterminado.
    Consejo: Para ayudar a identificar el valor a usar con una variable de plantilla, le recomendamos incluir 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 Escriba, 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 Dynamic ni Resource.

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 en Acciones.

Paso 3: Definir los nodos de la plantilla.

A medida que crea una plantilla, configure y vincule los nodos en su secuencia:

  • Comandoso 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.
  • Activar eventos, como entradas de tiempo de ejecución para establecer variables, como 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 basado en cambios en las fuentes conectadas.
Nota: Para habilitar la personalización y la reutilización, los comandos de una plantilla no utilizan conexiones, ejecutores ni 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 pasos anteriores y siguientes.

chain-templates-sui.gif

  • 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: éxitocheck_circle, fallaerror, advertenciaadvertenciao cualquiercheck_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 gestionar 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 usan 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, puede compartir enlaces a plantillas publicadas con otras personas utilizando Chain Builder, incluidas aquellas de otras organizaciones, como en la Comunidad Workiva. 

  1. En Chain Builder, desde la pestaña Plantillas dynamic_feed, haga clic en Obtener enlace para compartir open_in_new.
    share-templates_01.png
  2. Haga clic en Copiar al portapapeles file_copy y Cerrar.
  3. Pegue y comparta el enlace con otras personas 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 los conectores que falten:

examplee.png

Revocar el acceso a una plantilla compartida

Para revocar el acceso de otras personas 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 necesita una plantilla, puede archivarla. En Chain Builder, 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 Archivado.
¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 2
Con las plantillas de cadena, puede crear una secuencia prediseñadas de comandos y eventos para usar como un fragment...