CLP - Actualizar conexiones con un parámetro

Caso de uso empresarial principal	Conectividad de datos entre Workiva y Wdata
Objetivo de aprendizaje principal	Aprenda a actualizar una conexión con un parámetro, configurando el valor del parámetro en el tiempo de ejecución de la cadena
Prerrequisitos	Configurar Conector Workiva Complete el CLP | Actualizar conexión usando ID Proporcionar permisos a la hoja de cálculo para el usuario asociado de la concesión OAuth de Workiva
Plantilla de apoyo	CLP | Actualizar conexiones con un parámetro

Paso 1: Copiar la consulta existente

Primero, necesitamos una consulta con un parámetro. Crearemos una copia de nuestra consulta existente y agregaremos un parámetro que nos permita decidir para qué país queremos ver el número total de empleados.

• Desde Wdata Home, busque la consulta Consulta de detalles de empleados CLP y abra el menú
  • Seleccionar Copiar

• Actualice el nombre de la consulta a Consulta de detalles de empleados de CLP por país

• Haga clic en Guardar consulta
• Desde la pantalla de edición de consultas, haga clic en el ícono Parámetros en el panel del extremo derecho

• 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: Crear una conexión entrante

Para aprender a actualizar una conexión usando una cadena, primero necesitamos establecer una conexión entre una consulta Wdata y una hoja de cálculo. 

• Vaya a la Hoja de cálculo de descripción general de empleados de CLP
• Agregue una nueva hoja haciendo clic en
  • Cambiarle el nombre Detalles de empleados de CLP por país
• Agregue una conexión entrante a la hoja Detalles de empleados de CLP por país:
  • Abra el panel Conexiones a la derecha haciendo clic en el ícono Conexiones
  • En la pestaña Conexiones entrantes, seleccione Agregar conexión
    • Seleccionar Consulta Wdata
    • Seleccione Consulta de detalles de empleados de CLP por país
    • Establezca el parámetro de país en Australia
    • Haga clic en Conectar

• Ahora hay dos hojas con conexiones entrantes en la hoja de cálculo de descripción general de empleados de CLP

Paso 3: Editar la cadena existente

• Vaya a Chain Builder y localice la Cadena CLP | Actualizar conexión usando ID
• 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 | Actualizar conexiones con un parámetro
• Salvar la cadena

Paso 4: Entradas en tiempo de ejecución

Usamos el comando de entradas en tiempo de ejecución para iniciar la cadena. Esto nos permite especificar qué conexión queremos actualizar en el tiempo de ejecución de la cadena, así como el parámetro cuyo valor queremos actualizar.

• 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 dos veces y agregue las siguientes entradas:
  • Entrada 1:
    • Tipo: Campo de texto
    • Nombre para mostrar: Nombre del parámetro
    • Obligatorio: Sin marcar
  • Entrada 2:
    • Tipo: Campo de texto
    • Nombre para mostrar: Valor del parámetro
    • Obligatorio: Sin marcar
• Guardar el comando

Paso 5: Actualizar la conexión

Para tener en cuenta el parámetro agregado, debemos actualizar el comando Actualizar conexiones para tener en cuenta el parámetro y el valor que se deben enviar a la consulta.

• Edite Actualizar conexión haciendo doble clic en el comando
  • ID de conexión: continúe utilizando la variable ID de conexión de las entradas de tiempo de ejecución
  • Agregar un parámetro
    • Dado que nuestros parámetros se guardan en la fuente (en la consulta), querremos completar los parámetros en la fuente. Haga clic en el botón + junto a Parámetros de origen
    • Nombre del parámetro: utilice la variable Nombre del parámetro de las entradas de tiempo de ejecución; esto nos permite enviar el valor del Nombre del parámetro especificado en el tiempo de ejecución de la cadena al comando Actualizar conexiones
      • Haga clic en el campo Nombre del parámetro
      • En el panel izquierdo, expanda el menú desplegable Disparador
      • Expandir el menú desplegable Entradas de tiempo de ejecución
      • Seleccione la variable Nombre del parámetro
    • Valor del parámetro: utilice la variable Valor del parámetro de las entradas de tiempo de ejecución: esto nos permite enviar el valor del parámetro especificado en el tiempo de ejecución de la cadena al comando Actualizar conexiones
      • Haga clic en el campo Nombre del parámetro
      • En el panel izquierdo, expanda el menú desplegable Disparador
      • Expandir el menú desplegable Entradas de tiempo de ejecución
      • Seleccione la variable Valor del parámetro
• Guardar el comando

Paso 6: 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
• Busque el ID de conexión
  • Vaya a la Hoja de cálculo de descripción general de empleados de CLP
  • En el panel Conexiones, busque la Conexión de consulta de detalles de empleados de CLP por país y haga clic en la flecha hacia arriba. Una vez que aparezca el menú desplegable, seleccione Ver propiedades

• Copia el ID de conexión: asegúrate de no omitir ningún carácter ni agregar ningún espacio.

• Regrese a Chain Builder y pegue el ID de conexión en la entrada de tiempo de ejecución del ID de conexión.
• Rellene 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 por el cual se debe filtrar la consulta; en este ejercicio, filtraremos por Brasil
    • Nota: si selecciona un valor de parámetro diferente al que ya está almacenado en la hoja de cálculo, se sobrescribirá la hoja de cálculo y veremos que nuestros datos cambian de Australia a Brasil.
• Haga clic en Inicio
• Una vez que la cadena se haya completado, regrese a la hoja de cálculo y vea que la conexión se ha actualizado correctamente.

Ejecución en cadena exitosa:

Actualización de conexión exitosa:

Obtenga más información sobre cómo actualizar conexiones mediante cadenas completando la siguiente ruta: Actualizar lista de conexiones!