CLP - Creación y lectura de una hoja de control

Paso 1: Crear una hoja de control

Crearemos una hoja de control para almacenar las variables utilizadas para cargar datos a una tabla Wdata y luego actualizar las conexiones para esos datos. En lugar de especificar estas variables como Entradas de tiempo de ejecución cada vez que se ejecuta la Cadena, agregaremos nuestras variables a una hoja de control que la Cadena leerá y usará durante su ejecución. 

Si bien esta hoja de control demuestra cómo cargar varios archivos en una sola tabla Wdata y actualizar conexiones en una sola hoja de cálculo, el proceso se puede expandir para incluir varias tablas y hojas de cálculo simplemente agregando la ID única de la tabla u hoja de cálculo a la hoja de control.

• Navegue a la Plataforma Workiva para crear una nueva hoja de cálculo
• Haga clic en Crear y seleccione Hoja de cálculo
• Nombre de la hoja de cálculo: Hoja de control CLP
  • Nombre la primera hoja: Hoja de control primario
• En la Hoja de Control Primario, cree los siguientes encabezados
  • Bandera activa
    • Esta columna especifica si el flujo de trabajo debe ejecutarse para esa línea en la hoja de control
  • Nombre del archivo
    • Esta columna indica el nombre del conjunto de datos tal como aparecerá en la tabla Wdata
  • ID de tabla
    • ID de la Tabla en Wdata donde se cargarán los datos
  • Identificación de hoja de cálculo
    • ID de la hoja de cálculo donde se actualizarán los datos
  • Ubicación del archivo
    • Ubicación del archivo que se descargará
• Rellene la Hoja con los siguientes valores, completando el <TableID> columna con el ID de la tabla de detalles de empleados de CLP y el <SpreadsheetID> columna con el ID de la hoja de cálculo de descripción general de empleados de CLP, estos ID se crearon en rutas de aprendizaje conectadas anteriores, consulte los requisitos previos para ver las rutas de aprendizaje conectadas requeridas.
  • Consulte este documento para obtener ayuda para encontrar las identificaciones.

ActiveFlag,NombreDeArchivo,IDDeTabla,UbicaciónDeArchivo
VERDADERO,DetallesDeEmpleadoP01,<TableID> ,<SpreadsheetID> ,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
VERDADERO,EmployeeDetailsP02, , ,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
VERDADERO,EmployeeDetailsP03, , ,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv

Paso 2: Actualizar los permisos de la hoja de cálculo

Para garantizar una comunicación efectiva entre un comando de Workiva y una hoja de cálculo, la concesión de API generada debe estar asociada con un usuario que posea permisos de propietario o editor en la hoja de cálculo.

• Desde la Hoja de control CLP Hoja de cálculo, haga clic en Archivo en la cinta de la parte superior
• Haga clic en Permisosy luego en Hoja de cálculo
  • Proporcionar acceso a cualquier usuario de Workiva asociado con la API Grant configurada dentro de la Conexión de Workiva

Paso 3: Crea una cadena

Para utilizar las Variables que creamos en la hoja de control, crearemos una Cadena que lea desde ella. Dado que siempre utilizaremos la misma hoja de cálculo y la misma hoja de cálculo, configuraremos variables de cadena para almacenar estos detalles para un acceso consistente.

• Navegar hasta el generador de cadenas
• Crear una nueva Cadena
  • Nombrar la cadena: CLP | Lectura desde 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:
  • Variable 1:
    • Tipo: Variable de cadena (cv)
    • Nombre: cv-ID de hoja de cálculo de control
    • Valor: ingrese el ID de la hoja de cálculo de control CLP
      • Para encontrar el ID de la hoja de cálculo, navegue hasta Hoja de control CLP Hoja de cálculo
        • En la URL, seleccione el ID de la hoja de cálculo, que se encuentra después de “spreadsheet/” y antes de “/sheet”
        • Por ejemplo, el ID de la hoja de cálculo aparece en negrita aquí: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13 
  • Variable 2:
    • Tipo: Variable de cadena (cv)
    • Nombre: cv-Nombre de la Hoja de Control
    • Valor: Hoja de control primario
• Salvar la cadena

Paso 4: Obtener datos de la hoja

Usamos el comando Obtener datos de la hoja para iniciar la cadena. Esto nos permite recuperar información de la hoja de control para alimentar a la Cadena.

• Agregue un comando Obtener datos de hoja desde el Conector Workiva al área de inicio de la cadena
• 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 
  • Región: siéntete libre de especificar una región. Si se deja como :, el comando recuperará datos de toda la hoja de cálculo.
• Guardar el comando

Paso 5: 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 nodo Obtener datos de la hoja para verificar el éxito
  • El comando debe proporcionar una salida .csv de los datos dentro de la hoja especificada dentro de la hoja de cálculo, puede ver el .csv haciendo clic en el ícono del ojo.

Obtenga más información sobre el uso de hojas de control completando la siguiente ruta: Uso de valores de una hoja de control!