CLP - Ejecución de procesos y registro de resultados en una hoja de control

Ahora es el momento de reunir todo en un flujo de trabajo de informes centralizado, donde procesaremos nuevos datos y actualizaremos las conexiones que dependen de esos datos mediante una única cadena. En esta ruta de aprendizaje conectada, utilizaremos las variables de nuestra hoja de control para ejecutar flujos de trabajo que preparan nuestros datos mientras actualizan la hoja de control con un estado, brindando a los usuarios comerciales más visibilidad sobre cuándo se completaron los flujos de trabajo más recientemente.

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 Proporcionar a los usuarios finales información sobre la finalización del flujo de trabajo
Objetivo de aprendizaje principal	Aprenda a ejecutar procesos similares utilizando valores de una hoja de control Agregar registro a la hoja de control mediante comandos de cadena
Prerrequisitos	Completar la ruta CLP | Uso de valores de una hoja de control Configure los siguientes conectores: - Utilidades de archivos - Transformación tabular
Plantilla de apoyo	CLP | Ejecución de procesos y registro de resultados en una hoja de control

Paso 1: Actualizar la hoja de control para incluir el registro

Para notificar a los usuarios finales sobre el estado y la actualización más reciente de los procesos ejecutados por la Hoja de Control, necesitamos un lugar para almacenar los detalles sobre cuándo se ejecutó el flujo de trabajo y el estado de ese flujo de trabajo. Guardaremos esta información en la hoja de control.

• Desde la Plataforma Workiva, navegue hasta Hoja de Control CLP Hoja de Cálculo
• Agregue dos nuevas columnas después de la columna FileLocation con los siguientes encabezados:
  • Estado
  • Marca de tiempo
• No agregue ningún valor debajo de los encabezados de estas columnas

Paso 2: Editar la cadena existente

• Vaya a Generador de cadenas y localice la cadena CLP | Uso de valores de 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 | Ejecución de procesos y registro de resultados dentro de una hoja de control
  • En Variables de cadena, haga clic en el signo más dos veces para crear dos variables de cadena y configurarlas como se muestra a continuación:
    
    • Tipo: Variable de cadena (cv)
      
      • Nombre: cv-Status Columna Letra
      • Valor: la letra de la columna en la que se creó el encabezado Estado
        • En el ejemplo proporcionado, el valor es F
    • Tipo: Variable de cadena (cv)
      
      • Nombre: cv-Columna de sello de tiempo Letra
      • Valor: la letra de la columna en la que se creó el encabezado Marca de tiempo
        • En el ejemplo proporcionado, el valor es G
  • La cadena ahora debería tener cuatro variables de cadena
• Salvar la cadena

Paso 3: Comando Agregar números de fila

Utilizaremos el comando Agregar números de fila para agregar automáticamente números de fila a la hoja de control. Esto nos permitirá determinar dónde debe realizarse el registro dentro de la hoja de control.

• Haga doble clic en el enlace entre el comando Obtener datos de la hoja y el comando Convertir hoja de control a JSON
  • Rompa el enlace haciendo clic en el botón Eliminar 
     
• Agregue un comando Agregar números de fila desde el conector Transformación tabular al lienzo Cadena
• Conecte el comando Obtener datos de hoja al comando Agregar números de fila
• Conecte el comando Agregar números de fila al comando Convertir hoja de control a JSON
  
• Haga doble clic en el comando Agregar números de fila para configurarlo
  • 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 del comando Obtener datos de la hoja
• Guardar el comando

• Ahora que hemos agregado números de fila al conjunto de datos, necesitamos actualizar los comandos subsiguientes para usar los datos transformados. En este caso, es necesario actualizar el comando CSV a JSON.
  • Haga doble clic en el comando Convertir hoja de control a JSON para actualizarlo
    • Haga clic en el campo Archivo de entrada y elimine la salida Obtener datos de la hoja
      • Dentro del panel Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Agregar números de fila
      • Seleccione la salida Agregar números de fila del comando Agregar números de fila
  • Guardar el comando

Paso 4: Ejecutar el proceso para cargar datos a Wdata

Ahora usaremos las variables de nuestra hoja de control para ejecutar un proceso que cargue los datos a una tabla Wdata. Haremos esto utilizando un evento Run Chain que inicia la Carga de datos a la cadena Wdata desde Carga de datos a una ruta de tabla.

• Ahora que hemos podido visualizar el uso de variables desde una hoja de control usando Handlebars, ya no necesitamos el comando Handlebars
  • Coloque el cursor sobre el comando Handlebars y haga clic en la papelera para eliminar
    
    • Confirme la eliminación del comando haciendo clic en Eliminar
• Agregar un evento Ejecutar cadena al lienzo Cadena
• Conecte el comando condicional Bandera activa al evento Cadena de ejecución
• Haga doble clic en el comando para configurarlo
  • Nombre del comando: Ejecutar cadena - Cargar datos a Wdata
  • Haga clic en el menú desplegable Cadena y seleccione Cadena CLP | Cargar datos a una tabla
  • Configure las entradas de tiempo de ejecución utilizando variables de la hoja de control:
    • Haga clic en el campo ID de tabla
      • 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 TableID exactamente como está dentro de la hoja de control y presione Enter.
        • Haga clic en Aceptar

• • • Haga clic en el campo Nombre de archivo 
      • Siga los mismos pasos anteriores para utilizar la variable de la hoja de control, utilizando el campo FileName en lugar de TableID
    • Haga clic en el campo Ubicación del archivo
      • Siga los mismos pasos anteriores para utilizar la variable de la hoja de control, utilizando el campo FileLocation en lugar de TableID
• Guardar el comando

Paso 5: Ejecutar proceso para actualizar conexiones

A continuación, utilizaremos las variables de nuestra hoja de control para ejecutar un proceso que actualice los datos en nuestras hojas de cálculo de informes, haciendo que los datos recién cargados estén disponibles para los usuarios finales. Haremos esto utilizando un evento Ejecutar cadena que inicia la cadena Actualizar lista de conexiones desde la Ruta Actualizar lista de conexiones.

• Agregar un evento Ejecutar cadena al lienzo Cadena
• Conecte el evento de cadena Run Chain - Upload Data to Wdata al evento de cadena Run Chain
• Haga doble clic en el comando para configurarlo
  • Nombre del comando: Ejecutar cadena - Actualizar conexiones
  • Haga clic en el menú desplegable Cadena y seleccione Cadena CLP | Actualizar lista de conexiones
  • Configure las entradas de tiempo de ejecución utilizando variables de la hoja de control:
    • Haga clic en el campo ID de hoja de cálculo
      • 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 SpreadsheetID exactamente como está dentro de la hoja de control y presione Enter.
        • Haga clic en Aceptar

• Guardar el comando

Paso 6: Comando para completar estado y marca de tiempo

Ahora agregaremos los comandos que se usarán para generar y completar los valores que se enviarán a la hoja de control para indicar que los flujos de trabajo fueron exitosos. El primer paso para hacer esto es crear el archivo con el estado y la hora.

• Agregue un comando Crear archivo desde el Conector de utilidades de archivo al lienzo Cadena
• Conecte el evento de cadena Ejecutar cadena - Actualizar conexiones al comando Crear archivo
• Haga doble clic en el comando para configurarlo
  • Nombre del comando: Completar estado y marca de tiempo
  • En el campo Texto , escriba la siguiente información: 

Carga y actualización de datos completada,(*<System.DateTime> *)

• • • Reemplace el marcador de posición (*System.DateTime*) con la variable de tiempo de ejecución adecuada, esto extraerá programáticamente la fecha y la hora de las cadenas.
      • Desde el panel Seleccionar una variable a la izquierda, expanda Tiempo de ejecución
      • Seleccione el valor System.DateTime
• Guardar el comando

Paso 7: Volver a escribir en la hoja de control

Ahora utilizaremos el comando Escribir datos de la hoja para escribir la información completada en el comando anterior nuevamente en la hoja de control. Esto brindará a nuestros usuarios finales visibilidad del proceso, mostrando el estado de la carga y actualización de datos, y la fecha en que se actualizaron.

• Agregue un comando Escribir datos de hoja desde el Conector Workiva al lienzo Cadena 
• Vincula el comando Completar estado y sello de tiempo con el comando Escribir datos de la hoja 
• Haga doble clic en el comando para configurarlo
  • Haga clic en el campo ID de la hoja de cálculo
    • Dentro del panel Seleccionar una variable, haga clic en la flecha hacia abajo para expandir Cadena
    • Seleccione la variable de cadena cv-Control Spreadsheet ID
  • Haga clic en el campo ID/Nombre de la hoja
    • Dentro del panel Seleccionar una variable, haga clic en la flecha hacia abajo para expandir Cadena
    • Seleccione la variable de cadena cv-Control Nombre de la hoja 
  • Haga clic en el campo Archivo de datos
    • Dentro del panel Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Completar estado y marca de tiempo
    • Seleccione la salida Archivo creado
  • El campo Región se completará con una combinación de variables de cadena y salida JSON para indicar a la cadena la celda específica en la hoja de control donde escribir para la iteración actual:
    • Haga clic en el campo Región y complételo con lo siguiente: 
       
    • Columna de estado de cv Letra - variable que se encuentra en el panel Variables bajo Variables de cadena
    • Iteración de archivo JSON : usamos el número de fila de la iteración, más 1, para especificar la región donde se escribirán los datos; agregamos uno para tener en cuenta la fila del encabezado.
      • 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 Número de fila y presione Enter
        • Seleccione otra transformación y elija Analizar número
        • Haga clic en el signo verde +
        • Seleccione otra transformación y elija Agregar
        • Haga clic en el signo verde +
        • En el campo de valor introduzca 1
        • Haga clic en Aceptar
          
    • Introduzca dos puntos después de la primera iteración del archivo JSON :
    • Columna de sello de tiempo de cv Letra - variable que se encuentra en el panel Variables en Variables de cadena
    • Iteración de archivo JSON : usamos el número de fila de la iteración, más 1, para especificar la región donde se escribirán los datos; agregamos uno para tener en cuenta la fila del encabezado. 
      • Siga los mismos pasos anteriores para la segunda iteración del archivo JSON

• Guardar el comando

Paso 8: 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, verifique que el flujo de trabajo se haya completado marcando lo siguiente:

La cadena se ejecutó correctamente:

Datos cargados exitosamente en la tabla de detalles de empleados de CLP:

Las conexiones se actualizaron correctamente en la hoja de cálculo de descripción general de empleados de CLP:

Registro agregado exitosamente a la Hoja de Control Primario:

¡Enhorabuena! Ha automatizado con éxito un flujo de trabajo que descarga datos de la fuente, carga los datos en una tabla y actualiza las conexiones que utilizan esos datos. Este flujo de trabajo utilizó valores de una hoja de control para determinar la fuente de datos, el destino de carga en Workiva y las conexiones para actualizar. Aplique estos principios a sus propios procesos para minimizar el esfuerzo manual y brindar a los usuarios finales información sobre la finalización del proceso.