Automatizar la actualización de las conexiones es esencial para agilizar la centralización y el movimiento de datos en la Plataforma Workiva, especialmente cuando existen varias conexiones. En esta Ruta de aprendizaje conectada, aprenderemos a crear una Cadena que actualice una lista de Conexiones entre Wdata y la Plataforma Workiva utilizando un ID de hoja de cálculo. Esta Cadena generará una lista de Conexiones en una única Hoja de Cálculo y luego nos proporcionará la lista de ID de esas Conexiones, para que podamos automatizar el refresco de cada Conexión en la Hoja de Cálculo.
| Caso de uso empresarial principal | Conectividad de datos entre Workiva y Wdata . |
| Objetivo principal de aprendizaje | Aprende a actualizar una lista de Conexiones mediante Cadenas. |
| Objetivos de aprendizaje secundarios | Aprende lo esencial de los Iteradores de Grupo |
| Requisitos previos |
Configurar el conector Workiva Completa el CLP | Actualizar conexiones con un parámetro Conceder permisos a la hoja de cálculo para el usuario asociado concedido de OAuth |
| Plantilla de apoyo | CLP | Actualizar lista de conexiones . |
Paso 1: Crea una Cadena
- Añade una nueva cadena
- Ponle Nombre a la Cadena: CLP | Actualizar lista de conexiones .
- Guardar la cadena
Etapa 2: Entradas en tiempo de ejecución
Utilizamos el comando 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.
- Agrega un evento de cadena Entradas en tiempo de ejecución desde Eventos de activación de cadena del nodo Inicio
- Edita el Evento de la Cadena de Entradas en Tiempo de Ejecución haciendo clic dos veces en el comando
- Tipo: TextField
- Nombre para mostrar: ID de hoja de cálculo
- Necesario: comprobado
- Guardar el comando
Etapa 3: Enumera las conexiones .
Utilizaremos el comando Enumerar conexiones para recuperar la lista de ID de conexión asociados al ID de la hoja de cálculo. La salida del comando Listar Conexiones será un archivo JSON formado por cada Conexión de la Hoja de Cálculo con detalles relativos a la Conexión, incluido el ID de conexión.
- Agrega un comando Crear lista de conexiones del conector de Workiva al lienzo de Cadenas
- Conecta el comando Entradas en tiempo de ejecución al comando Conexiones de la lista
- Haz clic dos veces en el comando para configurarlo
- Tipo de Destino: Hoja de cálculo
- ID de Destino: Utiliza la variable ID de hoja de cálculo de Entradas en tiempo de ejecución: esto nos permite pasar el valor especificado en tiempo de ejecución de la cadena al comando Actualizar conexiones.
- Haz clic en el campo ID de Destino
- En el panel izquierdo, despliega el desplegable Trigger
- Despliega el desplegable Entradas en tiempo de ejecución
- Selecciona la variable ID de la hoja de cálculo
- Guardar el comando
Etapa 4: Grupo de comandos
Utilizaremos un grupo de comandos para permitir la iteración sobre cada conexión. El Iterador de Grupos empujará cada Conexión en la Hoja de cálculo a través de las siguientes etapas, una a una.
- Añade un grupo de comandos al lienzo de Cadenas
- Conecta el comando Crear lista de conexiones a la sección En del grupo de comandos
- Haz clic dos veces en el comando para configurarlo
- Pon nombre al grupo: Iteración de conexiones
- Navega hasta la pestaña Iteradores
- Activa el botón Iteraciones y haz clic en el campo Iteraciones
- Dentro del panel Selecciona una variable, haz clic en la flecha hacia abajo para expandir Conectando a la lista .
- Selecciona el resultado Conexiones
- Activa el botón Iteraciones y haz clic en el campo Iteraciones
- Guardando el grupo de comandos
Etapa 5: Actualizar conexión .
Utilizaremos el comando Actualizar conexión para actualizar nuestras conexiones utilizando el ID de conexión de la iteración.
- Añade un comando Actualizar conexión del conector de Workiva al lienzo de Cadenas
- Conecta la sección Inicio del Iterador de grupos al comando Actualizar conexión
- Haz clic dos veces en el comando para configurarlo
- ID de conexión: utiliza el ID de conexión desde el iterador de Grupos - Iteración de conexiones. Esto nos permite pasar el identificador de la iteración actual al comando Actualizar conexiones.
- Haz clic en el campo ID de conexión
- En el panel izquierdo, despliega el menú desplegable Iterador de grupo
- Despliega el desplegable Conexiones Iteración
- Selecciona la variable ConnectionId
- Utilizar parámetros de origen anteriores: comprobado
- Esto nos permite actualizar una Conexión utilizando los valores de los Parámetros anteriores de la Fuente - en nuestro caso, la Consulta con el Parámetro País seguirá actualizándose con Brasil como valor de filtro.
- ID de conexión: utiliza el ID de conexión desde el iterador de Grupos - Iteración de conexiones. Esto nos permite pasar el identificador de la iteración actual al comando Actualizar conexiones.
Etapa 6: Evaluar el ejercicio
Ahora que la Cadena está completa, Evalúa el resultado
- Publicar en la Cadena
- Haz clic en Ejecutar y selecciona Ejecutar con entradas
- Buscar el ID de la hoja de cálculo
- Navega hasta la Hoja de cálculo general de empleados 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, el ID de hoja de cálculo aparece en negrita aquí: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Navega de nuevo al Generador de cadenas y pega el ID de la Hoja de cálculo en el campo ID de la Hoja de cálculo.
- Haz clic en Iniciar
- Una vez completada la Cadena, navega de nuevo a la Hoja de Cálculo y comprueba que ambas Conexiones se han actualizado correctamente.
Cadenas ejecutadas correctamente con dos iteraciones:
Se ha actualizado la conexión correctamente:
¡Para obtener más información sobre cómo utilizar Cadenas para agilizar la recopilación de datos, consulta el resto de las Rutas de centralización de datos!