Con Cadenas, puedes automatizar las tareas rutinarias, con una integración sencilla para recuperar o enviar datos a través de múltiples sistemas de registros. Por ejemplo, puedes crear una cadena para extraer automáticamente información financiera de una fuente de datos a una tabla y, a continuación, enviar esos datos a otro sistema para generar un informe. En Generador de cadenas, ordenas y vinculas las tareas -o comandos-que debe realizar una cadena.
Nota: Solo los propietario del espacio de trabajo o cadenas pueden acceder al Generador de cadenas. De Wdata, haz clic en Cadenas, y luego haz clic en Abrir generador de cadenas.
Con los ejercicios de Empieza con las tablas y Empieza con las consultas, crearás tablas y consultas como las que se utilizan para los informes financieros. En este ejercicio, vamos a crear una cadena para ejecutar esa consulta y exportar sus resultados a Hojas de cálculo.
Paso 1. Obtener el ID y los parámetros de la consulta
Si aún no lo has hecho, descarga los datos de ejemplo y realiza los ejercicios Iniciándote en las tablas y Iniciándote en las consultas, ya que utilizarás la consulta en cadena. Toma nota del ID de la consulta, que es como identificarás la consulta en la cadena.
Nota: Cuando abres una consulta en Wdata, su ID aparece después de /queries/ en su URL.
Si creaste los filtros de la consulta con parámetros en lugar de con valores estáticos, ten en cuenta también los nombres de los parámetros. Por ejemplo:
- PY o Año_anterior
- CY o Año_actual
- Periodo_actual
Paso 2. Crear la hoja de cálculo
Antes de crear la cadena, crea una hoja de cálculo a la que exportar los resultados de la consulta.
Para evitar el uso indebido de la hoja de cálculo, identifica claramente su intención educativa en su nombre.
Después de crear la hoja de cálculo, anota su URL; la usarás para identificar dónde exportar los resultados de la consulta.
Paso 3. Crear la cadena
¡Ahora es hora de construir la cadena! Al final, incluirá comandos para ejecutar la consulta y exportar sus últimos resultados a Hojas de cálculo.
Antes de crear una cadena, verifica que has establecido el conector principal de Workiva utilizado para ejecutar sus comandos. Aunque esta cadena solo requiere un conector, las cadenas pueden utilizar varios conectores para preparar y transferir datos entre tus distintos sistemas de Registros.
Con el conector establecido, puedes añadir la cadena en Generador de cadenas:
- En Wdata, haz clic en Cadenas , Generador de cadenas.
- Haz clic en Construye, Cadenas, y luego haz clic en Añade, Crea Cadenas en la esquina inferior derecha.
-
Introduce un nombre que sea único y una descripción para ayudar a identificar la cadena.
Nota: Las Cadenas aparecen en Constructor de Cadenas para todos en el área de trabajo; nómbrelas para que los miembros entiendan claramente su intención. Consulte Práctica recomendada: Convenciones de nomenclatura para cadenas y sus objetos para más información sobre nomenclatura.
- Haz clic en Guardar.
Etapa 4. Comienza con un evento desencadenante de Entradas en tiempo de ejecución
Para que la cadena empiece pidiendo las variables que necesita para sus comandos, añade un Entradas en tiempo de ejecución evento desencadenante.
Consejo: Además de las entradas en tiempo de ejecución, puedes añadir variables para la cadena o el espacio de trabajo. Con las variables, puedes ampliar el uso de una cadena, como con cualquier consulta u hoja de cálculo de en lugar de solo una consulta u hoja de cálculo concreta.
- Haz clic en Eventos desencadenantes , mueve Entradas en tiempo de ejecución a Inicia, y haz clic en Edita .
- En Información básica, introduce un nombre que sea único y una descripción para ayudar a identificar el evento.
-
En Variables, añade variables para:
- El ID de la consulta
- Cualquiera de los valores de los parámetros de consulta
- La URL de la hoja de cálculo
Consejo: Para cada variable, haz clic en Agregar entrada, selecciona TextField, e introduce su nombre, descripción y valor predeterminado.
- Haz clic en Guardar.
Etapa 5. Añade un comando para ejecutar la consulta.
A continuación, añade un comando Ejecutar consulta para que la cadena obtenga los últimos resultados cada vez que se ejecute. Utilizarás las entradas en tiempo de ejecución para identificar el ID de la consulta y los valores de los parámetros.
- En Conectores disponibles, selecciona Workiva, y arrastra Ejecutar consulta al lienzo.
-
Arrastra un enlace desde Inicia a Ejecuta la consulta, y haz clic en el comando Edita.
Nota: Asegúrate de vincular el comando a Inicio para que pueda utilizar las entradas en tiempo de ejecución.
- En Información básica, introduce un nombre que sea único y una descripción para identificar el comando.
- Debajo de Propiedades del comando, selecciona el conector Workiva para realizar el comando.
- Para ID de consulta, selecciona la entrada en tiempo de ejecución del ID de consulta en Disparador.
-
Si los filtros de la consulta utilizan valores de parámetros, haz clic en Agregar (+) en Parámetros e introduce sus pares de clave/valor:
Clave Valor PY o Año_anterior En Disparador, selecciona la entrada de tiempo de ejecución del año anterior. CY o Año_actual En Activador, selecciona la entrada de tiempo de ejecución para el año en curso. Periodo_actual En Activar, selecciona la entrada de tiempo de ejecución para el Periodo: actual. - Haz clic en Guardar.
Etapa 6. Añade un comando para exportar los resultados
Ahora, añade un comando para exportar los resultados de la consulta a Hojas de cálculo:
- Debajo de Conectores disponibles, selecciona Workiva, y arrastra Exportar resultado de consulta al lienzo.
- Arrastra un enlace de Ejecutar consulta a Exportar resultado de consulta, y haz clic en Editar para este último.
- En Información básica, introduce un nombre que sea único y una descripción para identificar el comando.
- En Propiedades del comando, selecciona el mismo conector Workiva que Ejecutar consulta.
- Para ID del resultado de la consulta, selecciona ID para el Resultado de la consulta salida bajo Ejecutar consulta.
- Para URL de la hoja de cálculo, selecciona la entrada en tiempo de ejecución para la URL de la hoja de cálculo en Activar.
- Haz clic en Guardar.
Etapa 7. Ejecuta la cadena.
Ejecutar la cadena:
- Haga clic en Publique y, a continuación, en Publique de nuevo.
- Haga clic en Ejecutar y, a continuación, en Ejecutar con entradas.
- Introduce los valores de las entradas de tiempo de ejecución y haz clic en Comienza en.
- Para verificar que la cadena tiene éxito, comprueba en la hoja de cálculo los resultados de la consulta.
Si la cadena falla, haz clic en los comandos en el Historial de ejecución para revisar sus registros en busca de mensajes que te ayuden a solucionar el error.