CLP - Uso de valores de una hoja de control

Caso de uso empresarial principal	Orquestación de flujos de trabajo de informes desde una ubicación centralizada Simplificando la gestión del flujo de trabajo para los usuarios finales
Objetivo de aprendizaje principal	Aprenda a utilizar valores de una hoja de control en una Cadena
Objetivos de aprendizaje secundarios	Aprenda a utilizar comandos condicionales, iteradores JSON y el conector Handlebars
Prerrequisitos	Completar el CLP | Creación y lectura de una hoja de control Configure los siguientes conectores: - JSON - Manillar
Plantilla de apoyo	CLP | Uso de valores de una hoja de control

Paso 1: Editar la cadena existente

• Vaya a Generador de cadenas y localice la Cadena CLP | Lectura desde una hoja de control
• Haga clic en el botón del lápiz para editar la cadena.
• Haga clic en Configuración de la cadena en la parte superior derecha 
  • Cambiar el nombre de la cadena: CLP | Uso de valores de una hoja de control
• Salvar la cadena

Paso 2: Convertir la hoja de control a JSON

Para utilizar eficazmente los valores en una hoja de control, convertiremos la salida del comando Obtener datos de la hoja del formato CSV a JSON. Esta conversión establece pares clave-valor entre los encabezados de la hoja de control y los valores correspondientes en las filas debajo de cada encabezado, lo que permite una iteración eficiente.

• Agregue un comando CSV a JSON desde el Conector JSON al lienzo de Cadena
• Conecte el comando Obtener datos de la hoja al comando CSV a JSON
• Haga doble clic en el comando para configurarlo
  • Nombre del comando: Convertir hoja de control a JSON
  • Haga clic en el campo Archivo de entrada
    • Dentro del panel Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Obtener datos de la hoja
    • Seleccione la salida Datos 
  • Deje el campo delimitador como Coma (,)
  • Guardar el comando
    

Paso 3: Agregar un grupo de comandos

Agregue un Grupo de comandos a la cadena para habilitar la iteración en 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 para el grupo.

• Agregar un Grupo de comandos al lienzo de Cadena
• Conecte el comando Convertir hoja de control a JSON a la sección En del grupo de comandos
• Haga doble clic en el grupo Comando para configurarlo
  • Nombre del grupo: Iterador de hoja de control
  • Vaya a la pestaña Iteradores
    • Habilite el interruptor Iteraciones y haga clic en el campo Iteraciones
      
      • Dentro del panel Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Convertir hoja de control a JSON
      • Seleccione la salida JSON
  • Guardar el comando

Ahora que se ha configurado el comando, iterará a través de cada fila de la hoja de control y proporcionará una salida para cada línea.

Paso 4: Agregar un comando condicional

Dentro de una hoja de control, los usuarios pueden determinar si desean que se ejecute una determinada fila dentro de un flujo de trabajo. Esto se aprovecha a través de 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 evento de cadena de comando condicionalal lienzo de cadena
• Conecte el grupo Inicio dentro del grupo Iterador de hoja de control al comando Condicional
  
• Haga doble clic en el comando para configurarlo
  • Nombre del comando: ¿Bandera activa?
  • Deje la condición como Y y haga clic en el botón + REGLA
  • Verifique nuevamente que el tipo de datos esté configurado en Cadena y cambie la operación de prueba de Está en blanco a =
  • Haga clic en el campo abierto en el lado izquierdo del comando (el valor a probar)
    • Desde el panel Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Iterador de grupo
    • Seleccionar <> Iteración de archivo JSON
    • Haga clic en la píldora verde Iteración de archivo JSON para transformar la variable
      • Haga clic en Seleccionar una transformación y elija Obtener valor de JSON
      • Presione el signo verde +
      • En el campo de valor, escriba el encabezado ActiveFlag exactamente como está dentro de la hoja de control y presione Enter.
      • Seleccione otra transformación y elija Minúscula
      • Presione el signo verde +
      • Haga clic en Aceptar

• • De vuelta en el comando Condicional , en el lado derecho (el valor a comparar), escriba la palabra verdadero
    • Asegúrese de que esto esté en minúsculas, ya que la transformación de variable aplicada anteriormente hace que el valor de la Bandera Activa esté en minúsculas. 
• Guardar el comando

Paso 5: Alimentar las salidas a un comando

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

• Agregue un comando Plantilla de texto de renderizado desde el conector Handlebars al lienzo de Cadena
• ¿Conectar la bandera activa? Comando para el comando Renderizar plantilla de texto
• Haga doble clic en el comando para configurarlo
  
  • Nombre del comando: Capturar valores de la hoja de control
  • En el campo Plantilla , escriba la siguiente información:
    • Fila superior: Información de la hoja de control
    • Segunda fila: Nombre del archivo:<JSON File Iteration>
      • Reemplace el <JSON File Iteration> en el panel Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Iterador de grupo
      • Seleccionar <> Iteración de archivo JSON

• • • • Haga clic en la píldora verde Iteración de archivo JSON para transformar la variable
        • Haga clic en Seleccionar una transformación y elija Obtener valor de JSON
          
          
        • Presione el signo verde +
        • En el campo de valor, escriba FileName exactamente como está dentro de la hoja de control y presione Enter.
        • Haga clic en Aceptar

• • Repita los pasos para las filas tercera, cuarta y quinta.
    • Reemplace el <JSON File Iteration> marcador de posición con la variable de la hoja de control.
      • Identificación de la tabla:<JSON File Iteration>
        • Siga los mismos pasos que antes, pero utilice TableID en lugar de FileName.
      • Identificación de la hoja de cálculo:<JSON File Iteration>
        • Siga los mismos pasos que antes, pero utilice SpreadsheetID en lugar de FileName.
      • Ubicación del archivo:<JSON File Iteration>
        • Siga los mismos pasos que antes, pero utilice FileLocation en lugar de FileName.
• Guardar el comando

Nota: Siga los pasos descritos para extraer cualquier encabezado y recuperar los valores de fila correspondientes de una hoja de control.

Paso 6: Pruebe el ejercicio

Ahora que la cadena está completa, prueba el resultado.

• Publicar la Cadena
• Haga clic en Ejecutar y luego seleccione Ejecutar cadena
• Una vez completada la cadena, haga clic en el comando Capturar valores de la hoja de control para verificar el éxito
  • Deje que la cadena se complete por completo antes de hacer clic en el comando
• Habrá un campo que indica Valor 1
  • Si hace clic en este campo, se mostrará que el comando procesó tres valores diferentes, estos valores son las tres filas de datos de la hoja de control.
• Haga clic en el campo Registro para cada valor individual y verifique que coincida con los valores dentro de la hoja de control

Valor 1:

Valor 2:

Valor 3:

Obtenga más información sobre el uso de hojas de control completando la siguiente ruta: Ejecución de procesos y registro de resultados dentro de una hoja de control!