Centro de soporte de Workiva

Fondo

Cuando orquestamos procesos de elaboración de informes utilizando la Suite de Gestión de Datos, a menudo nos encontramos con complejos escenarios de flujo de trabajo. Por ejemplo, una aplicación puede necesitar ejecutar:

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

Para automatizar y gestionar eficazmente estos intrincados requisitos del flujo de trabajo, el concepto de hoja de control resulta inestimable. Una Hoja de Control actúa como una herramienta de gestión centralizada que permite predefinir las entradas para cada ejecución del flujo de trabajo. Aprovechando las Hojas de Control, los usuarios pueden especificar los parámetros y condiciones en los que debe funcionar cada flujo de trabajo, facilitando así un proceso automatizado y sin fisuras que ejecuta todos los flujos de trabajo necesarios con las entradas adecuadas, sin necesidad de intervención manual en cada paso.

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

• Definir los Valores de Entrada que se pasarán a una cadena en cada ejecución
• Definir marcas que determinarán si una cadena debe realizar determinadas operaciones
• Pasa valores, como parámetros de consulta, nombres de reglas o filtros de fecha, al flujo de trabajo del sistema cuando ejecutes una cadena o una regla.
• Realiza piezas de operaciones de siguiente ejercicio
• Gestiona los ID para artefactos dentro de Workiva
• Registra 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 sencilla. Esta hoja permitirá a los usuarios ejecutar el mismo flujo de trabajo con varios conjuntos de entradas.

Requisitos previos

• Configurar el conector de Workiva
• Configurar el conector de JSON
• Configurar el conector de asas

Paso 1: Establecer una Hoja de Control

• CREAR HOJA DE CÁLCULO dentro de la plataforma Workiva
• Concede permisos de propiedad al usuario asociado a la concesión OAuth2.
• Cambiar nombre de hoja de cálculo y hoja como 
  • Hoja de cálculo de Controles
  • Hoja de control

Etapa 2: Establecer Encabezados (Claves) para la Hoja de Control

Establece Encabezados para cada valor que vaya a ser procesado por el flujo de trabajo de Cadenas. En este ejemplo, se establecen los siguientes encabezados: 

• Active_Flag: Para determinar si esta fila debe procesarse o no
• File_Name: nombre del archivo que se va a procesar
• ID_tabla: ID de la tabla de Wdata donde se importaría 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, al leer cada línea, se introducirán los siguientes datos:

Etapa 4: Crear una cadena para recuperar los datos de las Hojas de Control

Para recuperar los datos de la hoja de control desde el cálculo, hay que crear una Cadena para leer la Hoja de cálculo. 

• Navega hasta el módulo Cadenas y crea una nueva Cadena
• Navega hasta la configuración de Cadenas y ponle un título a tu nueva cadena Obtener datos de la Hoja de Control
• Añadir dos variables Cadenas :
  • cv-SpreadsheetID
  • cv-NombreHoja
• Rellena cada variable con los valores correspondientes de SpreadsheetID y SheetName desde tu hoja de control.

   

Paso 5: Obtener datos de hoja

Para utilizar los datos dentro de tu hoja de control, debes utilizar el comando Obtener datos de la hoja. El comando lee el contenido desde una hoja de cálculo y produce una salida .csv. 

• Arrastra y suelta el comando Workiva Obtener datos de la hoja en la sección INICIO del lienzo.
• Configurar el comando
  • Cámbiale el nombre Obtén los datos de la hoja de control
  • Utiliza la variable de cadena cv-SpreadsheetID para el campo ID de Hoja de cálculo
  • Utiliza la variable de cadena cv-SheetName para el campo ID de hoja/Nombre.
  • Introduce A1: para la región
  • Deja el Estilo del Valor y la Revisión como Calculado y -1
  • Haz clic en Guardar

Etapa 6: Convertir datos de hojas a JSON

Tras recuperar correctamente los datos de la hoja de control en formato .csv, la etapa siguiente es convertirlos a JSON. Esta Conversión garantiza que los encabezados y los valores de columna se reformateen correctamente en la estructura JSON Clave-Valor. Este formato es crucial para las etapas siguientes.

• Arrastra el comando CSV to JSON al lienzo.
• Vincular el comando Obtener datos de la hoja de control al comando CSV a JSON
• Edita el comando CSV a JSON
  • En el campo Archivo de entrada, utiliza la salida Datos del desplegable Obtener datos de la hoja de control.
  • Deja el campo Delimitador como Coma (,)
  • Haz clic en Guardar

 

Etapa 7: Iterar a través de datos JSON

Ahora que los datos de la Hoja de control están en formato JSON, se puede utilizar un Grupo de comandos para iterar por cada fila de datos dentro de tu hoja de control.

• Añadir al lienzo Grupo de comandos
• Conecta el comando CSV a JSON a la parte En del grupo de comandos.
• Edita el grupo de comandos y nómbralo Iterador JSON
  • Haz clic en el símbolo de iteración situado a la derecha de la pestaña Información básica
  • Activar el iterador
  • Deja el Seleccionar tipo de modificador como Lista
  • Para la sección Iteraciones, selecciona la salida <> Archivo JSON del menú desplegable del comando CSV a JSON.
• Haz clic en Guardar

 

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

Ahora que la cadena puede iterar por cada fila de tu hoja de control, se puede utilizar un comando Manillar para previsualizar el resultado de la información.

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

• Arrastra y suelta un comando Representar texto Plantilla al lienzo.
• Vincular el comando Inicio de grupo del grupo de comandos al comando Representar plantilla de texto.
• Edita el comando y nómbralo Previsualizar los datos de la hoja de control
• Dentro del campo Plantilla, introduce lo siguiente:

ID de tabla de bandera activa de nombre de archivo 

• Para derivar los valores desde la hoja de control, hay que aplicar una transformación de variables para cada iteración JSON
• Junto a Nombre de archivo, elige Iteración de archivo JSON en la barra lateral, situada bajo el desplegable Iterador de grupo.
  • • Haz clic en el iterador de Archivos para JSON, selecciona Obtener valor de JSON.
    • En el Campo de valor, introduce el encabezado Nombre_archivo desde tu hoja de control.
      • Nota: Una buena práctica es copiar el Encabezado desde tu hoja de control directamente al campo de valor.
  • Pulsa Intro y acepta
• Repite las etapas anteriores para Active_Flag y Table_ID cabeceras de la hoja de control 
• Una vez completado, el campo de la plantilla debe tener el siguiente aspecto:

• Guardar el comando

 

Etapa 9: Ejecutando la cadena y Vista previa.

Ahora que la Hoja de Cadenas y Control está configurada, es importante asegurarse de que cada iteración de la salida del Manillar contiene datos para cada fila de la hoja de control.

• Haz clic en Publica y luego en Ejecuta la cadena
• Ejecuta la cadena.
• Una vez que la Cadena se haya ejecutado correctamente, haz clic en el comando Vista previa de los datos de la Hoja de Control y navega hasta la pestaña Registro.
  • En "Iniciar texto renderizado", debería aparecer un resultado de la primera iteración.
  • Cambia a Valor 2 en la opción situada encima de la pestaña Registro para ver los resultados de la segunda iteración.
  • Por último, pasa al valor 3 para ver los resultados de la tercera iteración
• Cada iteración debe aparecer de la siguiente manera:

Valor 1:

 

Valor 2:

 

Valor 3:

Aprovechar la bandera activa

Incorporar una lógica Condicional que utilice el valor de la marca Active es la siguiente etapa, utilizando la misma cadena que se ha construido.

• Edita la cadena y elimina el enlace entre el Iterador JSON y los Datos de la hoja de control de la vista previa
• Añade un comando Condicional y conecta el grupo Inicio del grupo de comandos al nuevo comando.
• Vincular el comando Condicional al comando Vista previa de los datos de la hoja de control
• Edita el comando Condicional
  • Nombra el comando ¿Activar marca?
  • Haz clic en el botón + Regla
  • En el campo de valor, haz clic en <> Iteración de archivos JSON desde el menú desplegable del Iterador de grupos
  • Añade una transformación de variable y utiliza como valor el encabezado Active_Flag de la hoja de control.
    • Haz clic en Aceptar
  • Cambia la condición de "está en blanco" a "=".
  • Introduce la palabra "verdadero" en el campo de expresión
  • Haz clic en Guardar 

 

 

• Como el Indicador_activo de dos de las iteraciones estaba establecido en "FALSE", el comando Vista previa de los datos de la hoja de control se ejecutó solo en la tercera iteración.
• Los comandos que sigan al comando condicional "¿Marca Activa?" 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 muy eficaz de centralizar, gestionar y automatizar los valores utilizados en la ejecución del flujo de trabajo. Se puede aplicar en varios escenarios, incluyendo: 

• Un centro para gestionar los identificadores de un sistema de origen, Workiva y elementos de Wdata
• Utilizar una marca para filtrar y tomar medidas sobre si debe ejecutarse un proceso concreto.
• Especificación de puntos finales de URL para ejecutar informes de un sistema de origen
• Definición de fechas y convenciones de nomenclatura para Archivos específicos.
• Identificar directorios de archivos para que un SFTP recupere archivos designados.