Automatizar las actualizaciones de conexión es esencial para optimizar la centralización y el movimiento de datos en la plataforma Workiva, especialmente cuando existen múltiples conexiones. En esta ruta de aprendizaje conectada, aprenderemos cómo crear una cadena que actualice una lista de conexiones entre Wdata y la plataforma Workiva usando una ID de hoja de cálculo. Esta cadena generará una lista de conexiones en una sola hoja de cálculo y luego nos proporcionará la lista de ID de esas conexiones, para que podamos automatizar la actualización de cada conexión en la hoja de cálculo.
| Caso de uso empresarial principal | Conectividad de datos entre Workiva y Wdata |
| Objetivo de aprendizaje principal | Aprenda a actualizar una lista de conexiones mediante cadenas |
| Objetivos de aprendizaje secundarios | Aprenda los conceptos básicos de los iteradores de grupo |
| Prerrequisitos |
Configurar el conector Workiva Completar CLP | Actualizar conexiones con un parámetro Proporcionar permisos a la hoja de cálculo para el usuario de concesión OAuth asociado |
| Plantilla de apoyo | CLP | Actualizar lista de conexiones |
Paso 1: Crea una cadena
- Agregar una nueva Cadena
- Nombre de la cadena: CLP | Actualizar lista de conexiones
- Salvar la cadena
Paso 2: Entradas en tiempo de ejecución
Usamos el comando de entradas en tiempo de ejecución para iniciar la cadena. Esto nos permite especificar para qué hoja de cálculo queremos actualizar todas las conexiones.
- Agregar un Entradas de tiempo de ejecución Evento de cadena desde Eventos de activación de cadena al nodo de inicio
- Edite el evento de cadena de entradas de tiempo de ejecución haciendo doble clic en el comando
- Tipo: Campo de texto
- Nombre para mostrar: ID de la hoja de cálculo
- Obligatorio: Marcado
- Guardar el comando
Paso 3: Enumere las conexiones
Utilizaremos el comando Listar conexiones para recuperar la lista de ID de conexión asociadas a la ID de la hoja de cálculo. La salida del comando Listar conexiones será un archivo JSON que consta de cada conexión en la hoja de cálculo con detalles relacionados con la conexión, incluido el ID de la conexión.
- Agregue un comando Listar conexiones desde el Conector Workiva al lienzo Cadena
- Conecte el comando Entradas de tiempo de ejecución al comando Conexiones de lista
- Haga doble clic en el comando para configurarlo
- Tipo de destino: Hoja de cálculo
- ID de destino: utilice la variable ID de hoja de cálculo de las entradas de tiempo de ejecución; esto nos permite enviar el valor especificado en el tiempo de ejecución de la cadena al comando Actualizar conexiones
- Haga clic en el campo ID de destino
- En el panel izquierdo, expanda el menú desplegable Activador
- Expandir el menú desplegable Entradas de tiempo de ejecución
- Seleccione la variable ID de hoja de cálculo
- Guardar el comando
Paso 4: Grupo de mando
Utilizaremos un grupo de comandos para permitir la iteración en cada conexión. El iterador de grupo impulsará cada conexión en la hoja de cálculo a través de los siguientes pasos, uno por uno.
- Agregar un Grupo de comandos al lienzo de Cadena
- Conecte el comando Listar conexiones a la sección En del grupo de comandos
- Haga doble clic en el comando para configurarlo
- Nombre del grupo: Conexiones Iteración
- 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 Conexiones de lista
- Seleccione la salida Conexiones
- Habilite el interruptor Iteraciones y haga clic en el campo Iteraciones
- Salvar al grupo de mando
Paso 5: Actualizar la conexión
Utilizaremos el comando Actualizar conexión para actualizar nuestras conexiones usando el ID de conexión de la iteración.
- Agregue un comando Actualizar conexión desde el Conector Workiva al lienzo Cadena
- Conecte la sección Inicio del iterador de grupo al comando Actualizar conexión
- Haga doble clic en el comando para configurarlo
- ID de conexión: utilice el ID de conexión del iterador de grupo - Iteración de conexiones. Esto nos permite enviar la ID de la iteración actual al comando Actualizar conexiones.
- Haga clic en el campo ID de conexión
- En el panel izquierdo, expanda el menú desplegable Iterador de grupo
- Expandir el menú desplegable Iteración de conexiones
- Seleccione la variable ConnectionId
- Usar parámetros de fuente anteriores: Marcado
- Esto nos permite actualizar una conexión utilizando los valores de parámetros anteriores de la fuente; en nuestro caso, la consulta con el parámetro de país aún se actualizará con Brasil como valor de filtro.
- ID de conexión: utilice el ID de conexión del iterador de grupo - Iteración de conexiones. Esto nos permite enviar la ID de la iteración actual al comando Actualizar conexiones.
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 con entradas
- Encuentra el ID de la hoja de cálculo
- Vaya a la Hoja de cálculo de descripción general de empleados de CLP
- 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/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Regrese a Chain Builder y pegue la ID de la hoja de cálculo en el campo ID de la hoja de cálculo
- Haga clic en Inicio
- Una vez que la cadena se haya completado, regrese a la hoja de cálculo y vea que ambas conexiones se han actualizado correctamente.
Ejecución exitosa de cadena con dos iteraciones:
Actualización de conexión exitosa:
Para obtener más información sobre el uso de cadenas para optimizar la recopilación de datos, consulte el resto de Rutas de centralización de datos!