Utilizar hojas de controles es la forma más eficaz de almacenar distintas variables utilizadas para un mismo flujo de trabajo. Las Hojas de control son valiosas para permitir a los usuarios finales especificar entradas para una Cadena sin necesidad de editar la propia Cadena. Para utilizar una hoja de control, primero tenemos que entender cómo se estructura una hoja de control y cómo se leen los datos desde la hoja de control. En esta Ruta de aprendizaje conectada, configuraremos una hoja de control y utilizaremos un Comando Workiva para recuperar datos de la hoja de control.
| Caso de uso empresarial principal |
Orquestando flujos de trabajo de informes desde una ubicación centralizada. Simplificar la gestión del flujo de trabajo para los usuarios finales |
| Objetivo principal de aprendizaje | Aprende a estructurar una hoja de control y a recuperar datos de una hoja de control utilizando Cadenas |
| Requisitos previos |
Configurar el conector de Workiva Completa el CLP | Subir datos a una ruta de tablas Completa el CLP | Actualizar lista de conexiones Conceder permisos a la Hoja de cálculo para el usuario asociado a la API de Workiva Concesión de usuario |
| Plantilla de apoyo | CLP | Lectura de una Hoja de Control |
Paso 1: Crear una Hoja de Control
Vamos a crear una hoja de control para almacenar variables utilizadas para cargar datos en una Tabla Wdata y, a continuación, actualizar las conexiones para esos datos. En lugar de especificar estas variables como Entradas en tiempo de ejecución cada vez que se ejecute la Cadena, añadiremos nuestras variables a una hoja de control que la Cadena leerá y utilizará a lo largo de su ejecución.
Aunque esta hoja de control demuestra la carga de varios archivos a una única Tabla Wdata y la actualización de conexiones en una única Hoja de cálculo, el proceso puede ampliarse para incluir varias Tablas y Hojas de cálculo, simplemente añadiendo el identificador único de la Tabla o la Hoja de cálculo a la hoja de control.
- Navega a la Plataforma Workiva para crear una nueva Hoja de cálculo.
- Haz clic en Crear y selecciona Hoja de cálculo.
- Pon nombre a la Hoja de cálculo: Hoja de Control CLP
- Nombra la primera Hoja: Hoja de control principal
- En la Hoja de control principal, crea los siguientes encabezados
- ActiveFlag
- Esta columna especifica si el flujo de trabajo debe ejecutarse para esa línea en la hoja de control
- Nombre de archivo
- Esta columna indica el nombre del conjunto de datos tal como aparecerá en la Tabla de Wdata
- TableID
- ID de la Tabla de Wdata donde se subirán los datos
- ID de hoja de cálculo
- ID de la Hoja de cálculo donde se actualizarán los datos.
- FileLocation
- Ubicación del archivo que se descargará.
- ActiveFlag
- Rellena la Hoja con los siguientes valores, rellenando la columna <TableID> con el ID de la Tabla de Detalles del Empleado CLP y la columna <SpreadsheetID> con el ID de la Hoja de Cálculo Resumen del Empleado CLP, estos ID se crearon en anteriores Rutas de Aprendizaje Conectado, consulta los requisitos previos para ver las Rutas de Aprendizaje Conectado necesarias.
ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv
Paso 2: Actualiza los permisos de la Hoja de cálculo
Para garantizar una comunicación eficaz entre un comando de Workiva y una hoja de cálculo, la concesión de API generada debe estar asociada a un usuario que posea permisos de propietario o editor en la hoja de cálculo.
- Desde el CLP Hoja de control Hoja de cálculo, haz clic en Archivo en la cinta de opciones de la parte superior.
- Haz clic en Permisos de :, y luego en Hoja de cálculo
- Conceder acceso a cualquier usuario de Workiva asociado a la Concesión de API configurada dentro de la Conexión de Workiva.
Etapa 3: Crea una Cadena
Para utilizar las Variables que hemos creado en la hoja de control, crearemos una Cadena que lea desde ella. Como siempre utilizaremos la misma hoja de cálculo y la misma hoja, estableceremos Variables en cadena para almacenar estos datos y tener un acceso coherente.
- Navegar hasta Generador de cadenas
- Crear una nueva cadena
- Ponle Nombre a la Cadena: CLP | Lectura de una Hoja de Control
- En Variables de cadena, haz clic dos veces en el signo Más para crear dos Variables de cadena y configurarlas como se indica a continuación:
- Variable 1:
- Tipo de: Cadenas variables (cv)
- Nombre: cv-ID de hoja de cálculo de control
- Valor: introduce el identificador de la Hoja de cálculo de control CLP.
- Para encontrar el ID de la hoja de cálculo, navega hasta la hoja de cálculo de hoja de control CLP
- En la URL, selecciona el ID de hoja de cálculo, que se encuentra después de "hoja de cálculo/" y antes de "/hoja".
- Por ejemplo, aquí aparece en negrita el ID de hoja de cálculo: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Para encontrar el ID de la hoja de cálculo, navega hasta la hoja de cálculo de hoja de control CLP
- Variable 2:
- Tipo de: Cadenas variables (cv)
- Nombre: cv-Nombre de la hoja de control
- Valor: Hoja de control principal
- Variable 1:
- Guardar la cadena
Paso 4: Obtener datos de hoja
Utilizamos el comando Obtener datos de hoja para iniciar la cadena. Esto nos permite recuperar información de la hoja de control para alimentar a la Cadena.
- Añadir un comando Obtener datos de la hoja del conector Workiva a la zona de inicio de la cadena.
- Haz clic dos veces en el comando para configurarlo
- Haz clic en el campo ID de la Hoja de cálculo
- Dentro del panel Seleccionar una variable, haz clic en la flecha hacia abajo para expandir Cadena
- Selecciona la cv-Control ID de hoja de cálculo Variable de cadena
- Haz clic en el campo ID de hoja/Nombre
- Dentro del panel Seleccionar una variable, haz clic en la flecha hacia abajo para expandir Cadena
- Selecciona la variable de cadena cv-Nombre de la hoja de control
- Región: no dudes en especificar una región. Si se deja como ":" el comando recuperará los datos de la Hoja de cálculo completa
- Haz clic en el campo ID de la Hoja de cálculo
- Guardando el comando
Etapa 5: 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 completada la Cadena, haz clic en el nodo Obtener datos de la hoja para verificar el éxito.
- El comando debería proporcionar un resultado .csv de los datos dentro de la Hoja especificada dentro de la Hoja de cálculo, verás el .csv haciendo clic en el icono del globo ocular
Obtén más información sobre el uso de las hojas de control completando la siguiente ruta: Utilizar valores de una hoja de control