Los parámetros en las Consultas de Wdata son los que hacen que las Consultas sean dinámicas y utilizables en todos los Periodos de Informes. En esta Ruta de aprendizaje conectada, modificaremos nuestra Consulta añadiendo un Parámetro, haciéndola dinámica, y luego editaremos nuestra Cadena para tener en cuenta el Parámetro. A continuación, exportaremos los resultados de la Consulta a una Hoja de cálculo Workiva.
| Caso de uso empresarial principal | Informes sobre datos almacenados en Wdata. |
| Objetivo principal de aprendizaje | Ejecutar una consulta con un parámetro de una cadena |
| Objetivos de aprendizaje secundarios | Crear un parámetro en una consulta |
| Requisitos previos |
Configurar el conector Workiva Completa el CLP | Crear una consulta con un campo calculado Completa la CLP | Ejecuta una consulta y exporta los resultados. Identificar el ID de consulta de la consulta detallada de empleados de CLPOpcional - Identificar la URL de una Hoja de cálculo existente en la que escribir los resultados. |
| Plantilla de ayuda | CLP | Ejecutar una consulta con un parámetro. |
Paso 1: Editar Consulta Existente
Primero, tenemos que editar nuestra Consulta detallada de empleados de CLP para añadir un parámetro. Crearemos un Parámetro que nos permita decidir para qué País queremos ver el recuento total de empleados.
- Desde Wdata, abre la Consulta CLP Consulta de detalles del empleado para editarla.
- Sigue el enlace CLP | Crear una consulta con un Campo calculado para crear la consulta.
- En el panel del extremo derecho, haz clic en el icono Parámetros
- 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 Aplicar
-
- 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: Editar la Cadena Existente
- Navega hasta el Generador de cadenas y localiza la Cadena CLP | Ejecuta una consulta y exporta los resultados.
- 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 Cadenas: CLP | Ejecutar una consulta y con un parámetro.
- Guardar la cadena
Etapa 3: Entradas en tiempo de ejecución
Utilizamos el Evento de la Cadena de Entradas en Tiempo de Ejecución para poner en marcha la Cadena. Esto nos permite solicitar el ID de la Consulta a ejecutar, el valor de su Parámetro y la URL de una Hoja de cálculo existente en la que escribir los resultados. El campo URL de la Hoja de cálculo es opcional
- 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 y añade la siguiente entrada:
- Tipo: TextField
- Mostrar Nombre: Valor del parámetro de consulta
- Necesario: comprobado
- Opcionalmente, arrastra y suelta esta nueva entrada para que aparezca después de la entrada ID de consulta y antes de la entrada URL de la hoja de cálculo.
- Guardar el comando
Etapa 4: Ejecutar consulta.
Para recuperar los datos más recientes, primero hay que ejecutar la Consulta. Una vez que la consulta se ha ejecutado correctamente, podemos exportar los resultados de la consulta para utilizarlos en informes posteriores o para enviarlos a otros sistemas externos. Utilizaremos el comando Ejecutar consulta para ejecutar la Consulta de Wdata.
- Haz clic dos veces en el comando Ejecutar consulta para configurarla.
- Haz clic en el botón AÑADE en la sección Parámetros
- En el campo Nombre, escribe el nombre del parámetro de consulta, en este caso nuestro parámetro se llama País
- En el campo Tipo, selecciona el Tipo de parámetro de consulta, en este caso nuestro Tipo de parámetro es Texto.
- Haz clic en el campo Valor
- Dentro del panel izquierdo de Variables, haz clic en la flecha hacia abajo para expandir Activar
- Haz clic en la flecha hacia abajo para ampliar las Entradas de tiempo de ejecución
- Haz clic en Valor del parámetro de consulta
- Guardar 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 con Entradas.
- Agrega valores para tus Entradas de tiempo de ejecución.
- ID de consulta - ID de la consulta de detalle del empleado de CLP en Wdata
- Valor del parámetro de consulta - el valor al que quieres que filtre tu consulta.
- En este ejemplo, estamos filtrando los datos a Brasil
- URL de la hoja de cálculo - URL completa de la hoja de cálculo a la que quieres exportar los resultados de la consulta.
- Una vez que la Cadena se haya completado correctamente, visualiza la Hoja de cálculo para verificar los resultados
- La cadena debería haber ejecutado correctamente la consulta y exportado los resultados a la hoja de cálculo.
- Puedes verificar que los datos se exportaron a tu Hoja de cálculo y se filtraron correctamente navegando hasta la URL de la Hoja.
Para obtener más información sobre cómo utilizar cadenas para agilizar la centralización de datos, consulta el resto de las rutas de recopilación de datos