Los parámetros en las consultas Wdata son los que hacen que las consultas sean dinámicas y utilizables en todos los períodos de informes. En esta ruta de aprendizaje conectada, modificaremos nuestra consulta agregando un parámetro, haciéndola dinámica, y luego editaremos nuestra cadena para tener en cuenta el parámetro. Luego exportaremos los resultados de la consulta a una hoja de cálculo de Workiva.
| Caso de uso empresarial principal | Informes sobre los datos almacenados en Wdata |
| Objetivo de aprendizaje principal | Ejecutar una consulta con un parámetro de una cadena |
| Objetivos de aprendizaje secundarios | Crear un parámetro en una consulta |
| Prerrequisitos |
Configurar el conector Workiva Completar el CLP | Crear una consulta con un campo calculado Completar el CLP | Ejecutar una consulta y exportar resultados Identificar el ID de consulta de la consulta de detalles de empleados de CLPOpcional: identifique la URL de una hoja de cálculo existente para escribir los resultados. |
| Plantilla de apoyo | CLP | Ejecutar una consulta con un parámetro |
Paso 1: Editar la consulta existente
Primero, necesitamos editar nuestra consulta de detalles de empleados CLP para agregar un parámetro. Crearemos un parámetro que nos permita decidir para qué país queremos ver el número total de empleados.
- Desde Wdata, abra la Consulta Consulta de detalles de empleados CLP para editarla
- Siga las instrucciones CLP | Crear una consulta con un campo calculado para crear la consulta
- En el panel del extremo derecho, haga clic en el icono Parámetros
- Haga clic en Agregar parámetros y seleccione Crear nuevo parámetro
- Nombre del parámetro: País
- Cambiar la lista de selección a habilitado
- En el cuadro Opciones de lista, enumere los siguientes países, cada país en su propia línea:
- Australia
- Brasil
- Italia
- Kenia
- Estados Unidos
- Actualizar el valor predeterminado a Ninguno
- Haga clic en Crear
- Para que el Parámetro controle los resultados de nuestra Consulta, necesitamos conectar el Parámetro a la columna en los datos de origen usando Filtros. Vaya a la pestaña Filtros en la Consulta.
- Localice la columna País de los Datos de origen a la izquierda y haga clic y arrástrela al área de filtros en el lado izquierdo
- Haga clic en el valor del filtro, donde dice Cadena vacía, para completar el valor del filtro.
- A la derecha del campo de valor del filtro, haga clic en el botón de parámetros
- Seleccione País
- Haga clic en Aplicar
-
- Ahora tiene una consulta con un parámetro para el país. Cuando haga clic en Ejecutar consulta, se le preguntará qué país desea que se muestren los resultados de la consulta.
- Haga clic en Guardar
Paso 2: Editar la cadena existente
- Vaya a Chain Builder y localice la cadena CLP | Ejecutar una consulta y exportar resultados
- Haga clic en el botón del lápiz para editar la cadena.
- Haga clic en Configuración de la cadena en la parte superior derecha
- Cambiar el nombre de la cadena: CLP | Ejecutar una consulta y con un parámetro
- Salvar la cadena
Paso 3: Entradas en tiempo de ejecución
Usamos el evento de cadena de entradas de tiempo de ejecución para iniciar 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 donde escribir los resultados. El campo URL de la hoja de cálculo es opcional; si se deja en blanco, se creará una nueva hoja de cálculo.
- Edite el evento de cadena de entradas de tiempo de ejecución haciendo doble clic en el comando
- Haga clic en el botón Agregar entrada y agregue la siguiente entrada:
- Tipo: Campo de texto
- Nombre para mostrar: Valor del parámetro de consulta
- Obligatorio: Marcado
- Opcionalmente, arrastre y suelte esta nueva entrada para que aparezca después de la entrada de ID de consulta y antes de la entrada de URL de la hoja de cálculo.
- Guardar el comando
Paso 4: Ejecutar consulta
Para recuperar los datos más recientes, primero es necesario ejecutar la consulta. Una vez que la consulta se haya ejecutado correctamente, podemos exportar los resultados de la consulta para usarlos en informes más adelante o para enviarlos a otros sistemas externos. Utilizaremos el comando Ejecutar consulta para ejecutar la consulta Wdata.
- Haga doble clic en el comando Ejecutar consulta para configurarlo
- Haga clic en el botón AGREGAR en la sección Parámetros
- En el campo Nombre , escriba el Nombre del Parámetro de Consulta, en este caso nuestro Parámetro se llama País
- En el campo Tipo , seleccione el Tipo de parámetro de consulta, en este caso nuestro tipo de parámetro es Texto
- Haga clic en el campo Valor
- Dentro del panel Variables de la izquierda, haga clic en la flecha hacia abajo para expandir el disparador.
- Haga clic en la flecha hacia abajo para expandir las entradas de tiempo de ejecución
- Haga clic en Valor del parámetro de consulta
- Guardar el comando
Paso 5: 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
- Agregue valores para sus entradas de tiempo de ejecución
- ID de consulta - ID de la consulta de detalles de empleados de CLP en Wdata
- Valor del parámetro de consulta : el valor que desea que se filtre en su consulta
- En este ejemplo, filtramos los datos a Brasil
- URL de la hoja de cálculo : URL completa de la hoja de cálculo a la que desea exportar los resultados de la consulta
- Una vez que la cadena se haya completado con éxito, vea 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.
- Puede verificar que los datos se exportaron a su hoja de cálculo y se filtraron correctamente navegando a la URL de la hoja.
Para obtener más información sobre el uso de cadenas para optimizar la centralización de datos, consulte el resto de Rutas de recopilación de datos.