Centro de soporte de Workiva

Esta guía proporciona instrucciones paso a paso para implementar la plantilla Ejecutar consulta y descargar resultados con hoja de control. Esta plantilla sirve como alternativa al comando Ejecutar consulta, que anteriormente requería que los usuarios introdujeran manualmente los parámetros en las cadenas antes de la implementación y ejecución.

Con el uso de una hoja de control, los usuarios pueden añadir varios ID de consulta y definir parámetros, como Lista desplegable o Selección múltiple, de forma dinámica. Esta plantilla suele integrarse en las cadenas existentes, pero también se puede usar en cualquier flujo de trabajo que requiera resultados de consulta en formato CSV.

Requisitos previos

Los siguientes conectores deben estar habilitados y configurados en tu espacio de trabajo.

• Configurar el conector de Workiva
• Configurar el conector de JSON
• Configurar el conector de asas
• Configura el conector de solicitud HTTP
• Configura el conector de transformación tabular

Se deben crear las siguientes variables de espacio de trabajo dentro de tu espacio de trabajo:

• wsv_API URL base - IAM
• wsv_Client ID
• wsv_Client Secret
• wsv_API URL base - Wdata

Buscar la plantilla

La plantilla Ejecutar consulta y descargar resultados con hoja de control se encuentra en la sección Workiva Chains de la pantalla Plantillas.

Aquí te explicamos cómo encontrarlo:

1. En Generador de cadenas, ve a la pestaña Plantillas dynamic_feed.
2. Selecciona Cadenas de Workiva desde el menú de la parte superior.
3. Busca 0.0 Ejecutar una consulta | Orquestación de nivel superior en la parte superior derecha y abre la plantilla.

4. Tras localizar la plantilla, haz clic en Nueva Cadena para desplegarla en tu espacio de trabajo. 

   Nota: Una vez configurada, cada cadena de esta plantilla debe publicarse en el espacio de trabajo.

    

Variables

Entradas en tiempo de ejecución

Configurar la plantilla

Esta plantilla consta de dos cadenas, 0.0 Ejecutar una consulta | Orquestación de nivel superior y 0.1 Ejecutar una consulta | Descargar resultados. Cuando se implementa la cadena principal en tu espacio de trabajo, el chain secundario se implementa automáticamente con él. 

• Orquestación de nivel superior: según la información de la hoja de control, esta cadena determina si una consulta usa un único tipo de parámetro (ya sea Lista desplegable o Selección múltiple) o varios tipos de parámetros (tanto Lista desplegable como Selección múltiple).
• Ejecutar una consulta | Descargar resultados: esta cadena ejecuta una consulta usando los parámetros especificados y obtiene los datos correspondientes. Una vez ejecutada la consulta, los resultados se descargarán en formato CSV para su posterior análisis o uso.

Una vez que la hoja de control está configurada y la plantilla de cadenas está implementada en tu espacio de trabajo, solo necesitas el ID de hoja de cálculo y el ID de hoja de la hoja de control.

Estos valores deben añadirse como entradas de tiempo de ejecución para la cadena de orquestación de nivel superior.

Configuración de la hoja de control por tipo de parámetro

La forma de configurar la hoja de control depende de los tipos de parámetros definidos en tu consulta de Wdata. Si una consulta incluye varios tipos de parámetros (por ejemplo, tanto Lista desplegable como Selección múltiple), cada parámetro debe definirse en una fila independiente usando el mismo ID de consulta. Si una consulta usa un único tipo de parámetro, la hoja de control requiere una única fila para esa consulta.

Los siguientes ejemplos ilustran ambos escenarios.

Ejemplo: consulta con varios tipos de parámetros

Para una consulta que requiere parámetros de Lista desplegable y Selección múltiple, la hoja de control debe incluir filas independientes para cada parámetro, todas usando el mismo ID de consulta.

Nota: La columna Clave hace referencia al nombre de parámetro definido en la consulta de Wdata.

Ejemplo de configuración:

Ejemplo: consulta con un único tipo de parámetro

Para una consulta que usa solo un tipo de parámetro, la hoja de control debe contener una única fila para ese ID de consulta.

Por ejemplo, si la consulta solo usa un parámetro de lista desplegable:

Asegúrate de configurar correctamente la hoja de control, ya que una configuración incorrecta puede provocar incidencias posteriores.

Carga de datos en una tabla

Puedes automatizar el proceso de carga de tu resultado directamente en una tabla. Para cargar los datos de resultado en una tabla, considera usar la plantilla «Cargar datos en Wdata». Esto se puede activar como parte de tu proceso añadiendo un evento Ejecutar cadena en el conector HTTP que descarga los resultados.

Solución de problemas

Para ver el historial de ejecución de tu cadena, incluidos los errores:

1. Ve a la pestaña Monitor del Generador de cadenas.
   

2. Pasa el ratón por encima del signo de interrogación para ver el estado de la cadena ejecutada.

      

Si tu cadena generó un error o falló al descargar un resultado de consulta, realiza las siguientes comprobaciones:

• Verifica que ambas cadenas se hayan publicado en tu espacio de trabajo. Cada cadena debe publicarse por separado.
• Asegúrate de que la consulta en Wdata esté actualizada a la última versión.
• Al introducir el ID de consulta, el tipo, las claves y el valor en la hoja de control, asegúrate de que se haya introducido el ID completo y de que no haya espacios en blanco al principio ni al final. Además, confirma que las claves y los valores coincidan correctamente con los parámetros usados en Wdata.
• Asegúrate de que la concesión OAuth2 asociada a la conexión Workiva tiene el acceso adecuado.
• Asegúrate de que todos los parámetros usados en una consulta estén incluidos en la hoja de control.

Recursos adicionales

• Conector de Workiva
• Conector de utilidades de archivo
• Conector JSON
• Conector de transformación de tablas
• Ejecutar una cadena dentro de otra cadena ("Ejecutar eventos en cadena")
• Concesiones de OAuth2
• Función de Wdata y límites de API