Centro de soporte de Workiva

Paso 1: Edita la Cadena Existente

• Navega hasta el Generador de cadenas y localiza la Cadena CLP | Lectura de una hoja de control.
• Haz clic en el botón del lápiz para editar la cadena
• Haz clic en Configuración de Cadenas en la parte superior derecha 
  • Cambiando nombre de Cadenas: CLP | Utilizar valores de una hoja de control
• Guardar la cadena

Etapa 2: Convierte la hoja de control a JSON

Para utilizar eficazmente los valores de una hoja de control, vamos a convertir la salida del comando Obtener datos de la hoja del formato CSV a JSON. Esta Conversión establece pares clave-valor entre las cabeceras de la hoja de control y los valores correspondientes de las filas situadas debajo de cada cabecera, lo que permite una iteración eficaz.

• Añade un comando CSV a JSON desde el conector JSON al lienzo de Cadenas
• Conecta el comando Obtener datos de la hoja al comando CSV a JSON
• Haz clic dos veces en el comando para configurarlo
  • Ponle Nombre al Comando: Convertir Hoja de Control a JSON
  • Haz clic en el campo del Archivo de Entrada.
    • Dentro del panel Seleccionar una variable, haz clic en la flecha hacia abajo para desplegar Obtener datos de hojas.
    • Selecciona el resultado Datos
  • Deja el campo Delimitador como Coma (,)
  • Guardando el comando
    

Etapa 3: Añadir un grupo de comandos

Añade un grupo de comandos a la cadena para permitir la iteración sobre cada fila de la hoja de control. Esto nos permite empujar cada fila de la hoja de control a través de la serie de Comandos del Grupo.

• Añade un grupo de comandos al lienzo de Cadenas
• Conecta el comando Convertir hoja de control a JSON a la sección En del grupo de comandos
• Haz clic dos veces en el grupo de comandos para configurarlo
  • Pon nombre al Grupo: Iterador de hojas de control
  • Navega hasta la pestaña Iteradores
    • Activa el botón Iteraciones y haz clic en el campo Iteraciones
      
      • Dentro del panel Seleccionar una variable, haz clic en la flecha hacia abajo para desplegar Convertir Hojas de Control a JSON
      • Selecciona el JSON Resultado: . 
  • Guardar el comando

Una vez configurado el comando, iterará por cada fila de la hoja de control y proporcionará un resultado por cada línea.

Etapa 4: Añadir un comando Condicional

Dentro de una hoja de control, los usuarios pueden determinar si desean que una determinada fila se ejecute dentro de un flujo de trabajo. Esto se aprovecha mediante la columna ActiveFlag. Utilizaremos un comando Condicional para determinar si el flujo de trabajo debe continuar para cada fila de la hoja de control.

• Agregar un Comando Condicional Evento de Cadena al lienzo de Cadena
• Conecta el grupo Iniciar dentro del grupo Iterador de hoja de control al comando Condicional
  
• Haz clic dos veces en el comando para configurarlo
  • Nombra el comando: ¿Bandera activa?
  • Deja la condición como Y y haz clic en el botón REGLA
  • Comprueba dos veces que el tipo de datos está establecido como Cadena y cambia la operación a probar de Está en blanco a = .
  • Haz clic en el campo abierto a la izquierda del comando (el valor a Evaluar)
    • Desde el panel Seleccionar una variable, haz clic en la flecha hacia abajo para desplegar Iterador de grupo 
    • Selecciona <> Iteración de Archivos para JSON.
    • Haz clic en el icono verde Iteración de archivos JSON píldora para transformar la Variable.
      • Haz clic en Seleccionar una transformación y elige Obtener el valor de JSON .
      • Pulsa el signo verde +
      • En el campo de valor escribe la cabecera ActiveFlag exactamente como está dentro de la hoja de control y pulsa intro...
      • Selecciona otra transformación y elige Minúsculas .
      • Pulsa el signo verde +
      • Haz clic en Aceptar

• • De nuevo en el comando Condicional, en la parte derecha (el valor a comparar), escribe la palabra verdadero.
    • Asegúrate de que está en minúsculas, ya que la transformación de variables aplicada anteriormente hace que el valor de la Marca Activa esté todo en minúsculas. 
• Guardando el comando

Etapa 5: Alimentar un comando con los Resultados

En este punto, el iterador de la hoja de control está configurado para proporcionar valores a cualquier Comando que exista en el Grupo Inicio del Grupo de comandos. Aprovecharemos un comando Handlebars como marcador de posición para mostrar los valores recuperados, que también pueden utilizarse de forma iterativa en comandos posteriores.

• Agrega un comando Renderizar plantilla de texto desde el conector Asas al lienzo de Cadena
• Conecta el ¿Activar marca? Comando al Representar texto Comando Plantilla
• Haz clic dos veces en el comando para configurarlo
  
  • Pon nombre al comando: Capturar valores de la hoja de control
  • En el campo Plantilla, escribe la siguiente información:
    • Fila superior: Información de control en Hojas
    • Segunda Fila: Nombre del archivo: <JSON>
      • Reemplazando el <JSON> desde el panel Seleccionar una variable, haz clic en la flecha hacia abajo para expandir Iterador de grupo . 
      • Selecciona <> Iteración de Archivos para JSON. 

• • • • Haz clic en el icono verde Iteración de archivos JSON píldora para transformar la Variable.
        • Haz clic en Seleccionar una transformación y elige Obtener el valor de JSON .
          
          
        • Pulsa el signo verde +
        • En el campo de valor escribe Nombre de archivo exactamente como está dentro de la hoja de control y pulsa intro.
        • Haz clic en Aceptar

• • Repite las etapas para las filas tercera, cuarta y quinta
    • Reemplaza el marcador de posición <JSON File Iteration> por la variable desde la hoja de control.
      • ID de tabla:: <JSON>
        •  Sigue los mismos pasos que antes, pero utiliza TableID en lugar de FileName.
      • ID Hoja de cálculo: <JSON>
        •  Sigue los mismos pasos que antes, pero utiliza SpreadsheetID en lugar de FileName.
      • Ubicación de los Archivos: <JSON>
        •  Sigue los mismos pasos que antes, pero utiliza FileLocation en lugar de FileName.
• Guardar el comando

Nota: Sigue los pasos descritos para extraer cualquier Encabezado y recuperar los valores de las filas correspondientes desde una hoja de control.

Paso 6: Evaluar el ejercicio

Ahora que la Cadena está completa, evalúa el resultado.

• Publicar en la Cadena
• Haz clic en Ejecutar y selecciona Ejecutar cadena .
• Una vez finalizada la Cadena, haz clic en el comando Capturar valores de la hoja de control para verificar el éxito.
  • Deja que la Cadena se complete totalmente antes de hacer clic en el comando
• Habrá un campo que diga Valor 1
  • Si haces clic en este campo, se mostrará que el comando procesó tres valores diferentes, estos valores son las tres filas de datos desde la hoja de control
• Haz clic en el campo Registro para cada valor individual y verifica que coincide con los valores dentro de la hoja de control

Valor 1:

Valor 2:

Valor 3:

Obtén más información sobre cómo utilizar las hojas de control completando la siguiente ruta: ¡Ejecutando procesos e Iniciando sesión en una hoja de control!