Centro de soporte de Workiva

Fondo

Al orquestar procesos de informes utilizando Data Management Suite, a menudo nos encontramos con escenarios de flujo de trabajo complejos. Por ejemplo, una aplicación podría necesitar ejecutar:

• Un único flujo de trabajo varias veces con entradas variadas
• Múltiples flujos de trabajo distintos
• Varios flujos de trabajo simultáneos, cada uno con entradas específicas
• Flujos de trabajo de integración del sistema de origen que requieren parámetros específicos, como fechas, nombres de archivos o nombres de reglas

Para automatizar y gestionar de manera eficiente estos complejos requisitos de flujo de trabajo, el concepto de una Hoja de control resulta invaluable. Una Hoja de Control actúa como una herramienta de gestión centralizada que permite predefinir entradas para cada ejecución del flujo de trabajo. Al aprovechar las hojas de control, los usuarios pueden especificar los parámetros y las condiciones bajo las cuales debe operar cada flujo de trabajo, facilitando así un proceso automatizado y continuo que ejecuta todos los flujos de trabajo necesarios con las entradas adecuadas sin la necesidad de intervención manual en cada paso.

Al crear y aprovechar una Hoja de Control, los usuarios pueden:

• Define valores de entrada que se pasarán a una cadena en cada ejecución
• Definir indicadores que determinarán si una cadena debe realizar ciertas operaciones
• Pasar valores, como parámetros de consulta, nombres de reglas o filtros de fechas, al flujo de trabajo del sistema al ejecutar una cadena o ejecutar una regla.
• Realizar partes de operaciones de avance
• Administrar los ID para artefactos dentro de Workiva
• Registrar el estado de ejecución de un flujo de trabajo

Este artículo guiará a los usuarios a través del proceso de creación de una hoja de control simple. Esta hoja permitirá a los usuarios ejecutar el mismo flujo de trabajo con varios conjuntos de entradas.

Requisitos previos

• Configurar el Conector Workiva
• Configurar el conector JSON
• Configurar el Conector del manillar

Paso 1: Configuración de una hoja de control

• Crea una hoja de cálculo dentro de la plataforma Workiva
• Asignar permisos de propiedad al usuario asociado con la concesión OAuth2 .
• Cambie el nombre de la hoja de cálculo y la hoja como
  • Hoja de cálculo de control
  • Hoja de control

Paso 2: Configuración de encabezados (claves) para la hoja de control

Establecer encabezados para cada valor que será procesado por el flujo de trabajo de Cadena. En este ejemplo, se configuran los siguientes encabezados:

• Active_Flag: Para determinar si esta fila debe procesarse o no
• File_Name: Nombre del archivo a procesar
• Table_ID: ID de la tabla Wdata donde se importará el archivo

Paso 3: Asignar valores a los encabezados en la hoja de control

• En este ejemplo, se han definido tres valores para cada par clave/valor. Por lo tanto, a medida que se lee cada línea, se alimentarán los siguientes datos:

Paso 4: Crear una cadena para recuperar datos de la hoja de control

Para recuperar los datos de la hoja de control de la hoja de cálculo, se debe crear una cadena para leer la hoja de cálculo. 

• Navegue hasta el módulo Cadenas y cree una nueva Cadena
• Vaya a la configuración de la cadena y titule su nueva cadena Obtener datos de la hoja de control
• Agregue dos variables de cadena :
  • cv-Hoja de cálculoID
  • cv-NombreHoja
• Complete cada variable con los valores SpreadsheetID y SheetName correspondientes de su hoja de control.

   

Paso 5: Obtener datos de la hoja

Para poder utilizar los datos dentro de su hoja de control, debe utilizar el comando Obtener datos de la hoja . El comando lee el contenido de una hoja en una hoja de cálculo y produce una salida .csv . 

• Arrastre y suelte el comando Workiva Obtener datos de la hoja en la sección INICIO del lienzo
• Configurar el comando
  • Cambiarle el nombre Obtener datos de la hoja de control
  • Utilice la variable de cadena cv-SpreadsheetID para el campo ID de la hoja de cálculo
  • Utilice la variable de cadena cv-SheetName para el campo ID/nombre de la hoja
  • Ingrese A1: para la región
  • Deje el estilo de valor y la revisión como Calculado y -1
  • Haz clic en Guardar

Paso 6: Convertir los datos de la hoja a JSON

Después de recuperar con éxito los datos de la hoja de control en formato .csv, el siguiente paso es convertirlos a JSON. Esta conversión garantiza que los encabezados y los valores de las columnas se reformateen correctamente en la estructura JSON Clave-Valor . Este formato es crucial para los pasos que siguen.

• Arrastre el comando CSV a JSON al lienzo
• Vincula el comando Obtener datos de la hoja de control al comando CSV a JSON
• Editar el comando CSV a JSON
  • En el campo Archivo de entrada , utilice la salida Datos del menú desplegable Obtener datos de la hoja de control
  • Deje el campo Delimitador como Coma (,)
  • Haz clic en Guardar

 

Paso 7: Iterar a través de datos JSON

Ahora que los datos de la hoja de control están en formato JSON, se puede usar un grupo de comandos para iterar a través de cada fila de datos dentro de su hoja de control

• Agregar Grupo de comandos al lienzo
• Conecte el comando CSV a JSON a la parte En del grupo Comando
• Edite el grupo de comandos y asígnele el nombre Iterador JSON
  • Haga clic en el símbolo de iteración a la derecha de la pestaña Información básica
  • Habilitar el iterador
  • Deje el Seleccionar tipo de modificador como Lista
  • Para la sección Iteraciones , seleccione la salida <> Archivo JSON del menú desplegable del comando CSV a JSON
• Haz clic en Guardar

 

Paso 8: Vista previa de cada iteración de datos

Ahora que la cadena puede iterar a través de cada fila de la hoja de control, se puede utilizar un comando Handlebars para obtener una vista previa de la salida de la información.

Nota: El comando Handlebars sirve como marcador de posición para revisar los valores en este artículo, pero también se pueden usar otros comandos para procesar los valores.

• Arrastre y suelte el comando Render Text Template en el lienzo
• Vincula el Inicio de grupo del grupo de comandos al comando Render Text Template
• Edite el comando y asígnele el nombre Vista previa de datos de la hoja de control
• Dentro del campo Plantilla, ingrese lo siguiente:

Nombre de archivo ID de tabla de banderas activas 

• Para derivar los valores de la hoja de control, se debe aplicar una transformación de variable para cada iteración JSON
• Al lado de Nombre de archivo, elija Iteración de archivo JSON en la barra lateral, ubicada debajo del menú desplegable Iterador de grupo .
  • • Haga clic en Iteración de archivo JSON, seleccione Obtener valor de JSON
    • En el campo Valor, ingrese el encabezado Nombre_de_archivo de su hoja de control
      • Nota:  Una buena práctica es copiar el encabezado de su hoja de control directamente en el campo de valor
  • Presione Enter y Aceptar
• Repita los pasos anteriores para los encabezados Active_Flag y Table_ID de la hoja de control 
• Una vez completado, el campo de plantilla debería verse de la siguiente manera:

• Guardar el comando

 

Paso 9: Ejecutar la cadena y obtener una vista previa

Ahora que la cadena y la hoja de control están configuradas, es importante asegurarse de que cada iteración de la salida del manillar contenga datos para cada fila de la hoja de control.

• Haga clic en Publicar y luego en Ejecutar la cadena
• Ejecutar la cadena
• Una vez ejecutada la cadena correctamente, haga clic en el comando Vista previa de datos de la hoja de control y navegue hasta la pestaña Registro .
  • En "Iniciar texto renderizado", debería ser visible una salida para la primera iteración.
  • Cambie al Valor 2 en la opción sobre la pestaña Registro para ver los resultados de la segunda iteración
  • Finalmente, cambie al valor 3 para ver los resultados de la tercera iteración.
• Cada iteración debería aparecer de la siguiente manera:

Valor 1:

 

Valor 2:

 

Valor 3:

Aprovecha la bandera activa

El siguiente paso es incorporar una lógica condicional que utilice el valor del indicador activo , utilizando la misma cadena que se ha construido.

• Edite la cadena y elimine el vínculo entre el Iterador JSON y los Datos de la hoja de control de vista previa
• Agregue un comando Condicional y conecte el Inicio de grupo del Grupo de comandos al nuevo comando
• Vincula el comando Condicional al comando Vista previa de datos de la hoja de control
• Editar el comando condicional
  • Nombra el comando ¿ Bandera activa?
  • Haga clic en el botón + Regla
  • En el campo de valor, haga clic en <> Iteración de archivo JSON en el menú desplegable de Iterador de grupo
  • Agregue una transformación variable y use el encabezado Active_Flag de la hoja de control como valor
    • Haga clic en Aceptar
  • Cambie la condición de “Está en blanco” a “=”
  • Introduzca la palabra “true” en el campo de expresión
  • Haga clic en Guardar

 

 

• Dado que Active_Flag para dos de las iteraciones se estableció en "FALSO", el comando Vista previa de datos de la hoja de control se ejecutó solo para la tercera iteración.
• Los comandos que siguen al comando condicional "Active Flag?" se omitirán si su iteración en la hoja de control tiene un valor de "FALSO".

Casos de uso adicionales

La Hoja de Control ofrece una forma altamente efectiva de centralizar, administrar y automatizar los valores utilizados en la ejecución del flujo de trabajo. Se puede aplicar en diversos escenarios, entre ellos:

• Un centro central para administrar los identificadores de un sistema de origen, Workiva y elementos Wdata
• Utilizar una bandera para filtrar y tomar medidas si se debe ejecutar un proceso específico
• Especificación de puntos finales de URL para ejecutar informes desde un sistema de origen
• Definición de fechas y convenciones de nomenclatura para archivos específicos
• Identificación de directorios de archivos para que un SFTP recupere los archivos designados