Para que nuestras Conexiones puedan utilizarse trimestre a trimestre y año a año sin hacer ajustes en la Consulta, es necesario utilizar Parámetros. En esta Ruta de Aprendizaje Conectada, aprenderemos a actualizar nuestra Cadena para actualizar una conexión con un parámetro entre la Plataforma Workiva y una Consulta Wdata utilizando el ID de conexión.
| Caso de uso empresarial principal | Conectividad de datos entre Workiva y Wdata |
| Objetivo principal de aprendizaje | Aprende a actualizar una conexión con un parámetro, estableciendo el valor del parámetro en tiempo de ejecución de la cadena |
| Requisitos previos |
Configurar el conector de Workiva Completa el CLP | Actualizar conexión utilizando ID Conceder permisos de : A hoja de cálculo para el usuario asociado Workiva OAuth Grant |
| Plantilla de ayuda | CLP | Actualizar conexiones con un parámetro. |
Paso 1: Copiar consulta existente
Primero, necesitamos una Consulta con un Parámetro. Crearemos una copia de nuestra Consulta existente y añadiremos un Parámetro que nos permita decidir de qué País queremos ver el recuento total de empleados.
- Desde la página principal de Wdata, localiza la consulta Consulta de detalles del empleado CLP y abre el menú.
- Selecciona Copiar
- Se ha actualizado el Nombre de la consulta a Consulta sobre el detalle de los empleados de CLP por países.
- Haz clic en Guardar consulta ?
- Desde la pantalla Edición de consultas, haz clic en el icono Parámetros del panel del extremo derecho
- Haz clic en Añadir parámetros y selecciona Crear un nuevo parámetro.
- Nombre del parámetro: País
- Cambia la lista de selección a habilitada
- En el cuadro Opciones de lista, enumera los siguientes países, cada país en su propia línea:
- Australia
- Brasil
- Italia
- Kenia
- Estados Unidos
- Actualiza el valor predeterminado a Ninguno
- Haz clic en Crear
- Para que el Parámetro controle los resultados de nuestra Consulta, tenemos que conectar el Parámetro a la columna de los datos de origen utilizando Filtros. Navega hasta la pestaña Filtros de la Consulta.
- Localiza la columna País de los Datos de Origen de la izquierda y haz clic en ella y arrástrala al área de filtros de la izquierda.
- Haz clic en el valor de filtrado, donde dice Cadena vacía, para rellenar el valor de filtrado.
- A la derecha del Campo de valor filtrando, haz clic en el botón de parámetros
- Selecciona País
- Haz clic en Aplicando
-
- Ahora tienes una Consulta con un Parámetro para el País, cuando hagas clic en Ejecutar consulta, se te preguntará qué País quieres que muestren los resultados de tu Consulta.
- Haz clic en Guardando ?
Etapa 2: Crear una conexión entrante.
Para aprender a actualizar una Conexión mediante una Cadena, primero tenemos que establecer una conexión entre una Consulta a Wdata y una Hoja de cálculo.
- Navega a la página Visión general de los empleados de CLP Hoja de cálculo
- Agrega una nueva hoja a haciendo clic en
- Cambia nombre de CLP Detalles del empleado por país
- Agregar una conexión entrante a la hoja CLP Detalles del empleado por país:
- Abre el panel Conexiones de a la derecha haciendo clic en el icono Conexiones .
- En la pestaña Conexiones entrantes, selecciona Añadir conexión
- Seleccionar Consulta de Wdata
- Selecciona la consulta CLP Detalle del empleado por país .
- Establece el parámetro País en Australia
- Haz clic en Conectar
- Abre el panel Conexiones de a la derecha haciendo clic en el icono Conexiones .
- Ahora hay dos hojas con Conexiones entrantes en la Hoja de cálculo del resumen de empleados de CLP.
Etapa 3: Editar la Cadena Existente
- Navega hasta el Generador de cadenas y localiza la Cadena CLP | Actualizar conexión mediante ID.
- Haz clic en el botón del lápiz para editar la cadena
- Haz clic en Configuración de Cadenas en la parte superior derecha
- Cambiando nombre de la Cadena: CLP | Actualizar conexiones con un parámetro.
- Guardar la cadena
Etapa 4: Entradas en tiempo de ejecución
Utilizamos el comando Entradas en tiempo de ejecución para iniciar la cadena. Esto nos permite especificar qué Conexión queremos actualizar en tiempo de ejecución de la Cadena, así como el Parámetro cuyo valor queremos actualizar.
- Edita el Evento de la Cadena de Entradas en Tiempo de Ejecución haciendo clic dos veces en el comando
- Haz clic en el botón Añadir Entrada dos veces y añade las siguientes entradas:
- Entrada 1:
- Tipo: TextField
- Nombre para mostrar: Nombre del parámetro
- Obligatorio: Desmarcado
- Entrada 2:
- Tipo: TextField
- Nombre para mostrar: Valor del parámetro
- Obligatorio: Desmarcado
- Entrada 1:
- Guardar el comando
Etapa 5: Actualizar conexión .
Para tener en cuenta el Parámetro Añadido, tenemos que actualizar el Comando Actualizar Conexiones para tener en cuenta el Parámetro y el Valor que deben introducirse en la Consulta.
- Edita Actualizar conexión haciendo doble clic en el comando
- ID de conexión:: Continúa utilizando la variable ID de conexión: desde Entradas en tiempo de ejecución.
- Agregar un parámetro
- Como nuestros Parámetros se guardan en el origen (en la Consulta), querremos rellenar los Parámetros en el origen. Haz clic en el botón situado junto a Parámetros de origen
- Nombre del parámetro: utiliza la variable Nombre del parámetro de las entradas en tiempo de ejecución; esto nos permite pasar el valor Nombre del parámetro especificado en tiempo de ejecución de la cadena al comando Actualizar conexiones
- Haz clic en el campo Nombre del parámetro
- En el panel izquierdo, despliega el desplegable Activador
- Despliega el desplegable Entradas en tiempo de ejecución
- Selecciona la variable Nombre de parámetro
- Valor del parámetro: utiliza la variable Valor del parámetro de entradas en tiempo de ejecución; esto nos permite pasar el valor del parámetro especificado en tiempo de ejecución de la cadena al comando Actualizar conexiones
- Haz clic en el campo Nombre del parámetro
- En el panel izquierdo, despliega el desplegable Activador
- Despliega el desplegable Entradas en tiempo de ejecución
- Selecciona la variable Valor del parámetro
- Guardar el comando
Paso 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
- Busca el ID de conexión
- Navega hasta la Hoja de cálculo general de empleados CLP
- En el panel de Conexiones, busca el enlace CLP Employee Detail by Country Query Connection y haz clic en la flecha hacia arriba. Cuando aparezca el desplegable, selecciona Ver propiedades .
- Copia el ID de conexión: asegúrate de que no te falte ningún carácter ni añadas espacios
- Navega de nuevo al Generador de cadenas y pega el ID de conexión en la Entrada de tiempo de ejecución ID de conexión:.
- Rellenar las entradas de parámetros
- Nombre del Parámetro: el nombre del Parámetro en la Consulta - en este ejercicio el Nombre del Parámetro es País
- Valor del parámetro: el valor sobre el que hay que filtrar la consulta - en este ejercicio filtraremos a Brasil
- Nota: al seleccionar un valor de parámetro distinto del que ya está almacenado en la Hoja de cálculo, se sobrescribirá la Hoja de cálculo, veremos que nuestros datos cambian de Australia a Brasil.
- Haz clic en Iniciar
- Una vez completada la Cadena, navega de nuevo a la Hoja de cálculo y comprueba que la conexión se ha actualizado correctamente.
Ejecución de cadenas correcta:
Se ha actualizado la conexión correctamente:
Obtén más información sobre cómo actualizar conexiones utilizando cadenas completando la siguiente ruta: Actualizar lista de conexiones