La plantilla Mantener parámetros Wdata le permite mantener una lista de selección de parámetros Wdata actualizando sus valores a través de una cadena.
Consejo: Los valores de los parámetros se especifican en tiempo de ejecución y se utilizan para filtrar dinámicamente los resultados de la consulta. Las listas de selección imponen estos valores, pero deben definirse antes de ejecutar la consulta, lo que crea desafíos cuando esos valores cambian regularmente. Esta plantilla le permite mantener esos valores mediante programación.
Requisitos
- Para utilizar esta plantilla, debe tener una hoja de cálculo o una consulta de Workiva que contenga la lista de valores que necesita agregar a su lista de selección de parámetros.
- Debe generar un token OAuth y almacenar el ID y el secreto del cliente como variables del espacio de trabajo. Asegúrese de que la variable del espacio de trabajo secreto del cliente esté cifrada.
- Los siguientes conectores deben configurarse en su espacio de trabajo:
Crea tu plantilla
La plantilla Mantener parámetros Wdata se encuentra en la sección Cadenas de Workiva de la pantalla Plantillas.
Aquí te explicamos cómo encontrarlo:
- En Generador de cadenas, vaya a la pestaña Plantillas .
- Seleccione Cadenas Workiva del menú en la parte superior.
- Busque Mantener parámetros Wdata en la parte superior derecha y abra la plantilla.
Después de ubicar su plantilla, configúrela para su espacio de trabajo utilizando las entradas de tiempo de ejecución que se enumeran a continuación.
Nota: Para obtener instrucciones detalladas sobre cómo crear una cadena a partir de una plantilla, consulte el artículo Crear y administrar cadenas .
Variables
Tipo de variable | Nombre de la variable | Propósito variable |
Cadena | Límite de la lista de elementos del parámetro cv-Wdata | Almacena los límites de Wdata para la cantidad de elementos de la lista de selección. Esto se crea como una variable para permitir cualquier cambio de límite futuro. |
Variable del espacio de trabajo | URL base de wsv_API: IAM | Ruta raíz a la API de IAM. Puede encontrar este valor en nuestra documentación para desarrolladores de API. |
Variable del espacio de trabajo | URL base de wsv_API: Wdata | Ruta raíz a la API de Wdata. Puede encontrar este valor en nuestra documentación para desarrolladores de API. |
Variable del espacio de trabajo | Identificación del cliente wsv | El ID de cliente de su concesión OAuth. |
Variable del espacio de trabajo | Secreto de wsv_Client | El secreto del cliente de su concesión OAuth. Asegúrese de que esta variable esté encriptada después de ingresarla. |
Configura tu cadena
Las siguientes secciones le ayudarán a identificar los elementos configurables de esta cadena y su función.
Entradas de tiempo de ejecución
Entrada de tiempo de ejecución | Tipo | Objetivo |
Nombre del parámetro | Texto | Especifica el parámetro Wdata cuyos valores serán actualizados por esta cadena. |
Actualizar tipo | Menú desplegable | Opción para agregar nuevos valores a la lista existente o reemplazar todos los valores con los valores que se agregarán. |
Valores a agregar | Archivo | Un archivo de una sola columna que contiene los valores que se agregarán como filas. Se requiere una fila de encabezado en este archivo. Este archivo se puede crear desde una hoja de cálculo de Workiva, una consulta de Wdata o cualquier otra fuente que genere un archivo en el formato requerido. |
Tipo de parámetro | Menú desplegable | Opciones para especificar si el parámetro se define globalmente dentro del espacio de trabajo o localmente dentro de una consulta. |
ID de consulta | Texto | Obligatorio si el tipo de parámetro es local.Esto se utiliza para buscar el ID de la lista de selección asociada con el parámetro asignado a la consulta. |
Subcadenas
- Mantener parámetros Wdata | Agregar valores: Esta cadena se implementa automáticamente cuando se implementa la cadena principal.
Nota: Asegúrese de publicar esta cadena secundaria antes de ejecutar la cadena principal.
Nodos configurables
Puede modificar los campos utilizados para fines de mensajería según sea necesario para satisfacer los requisitos de su negocio:
- Cadena primaria: plantilla de texto de representación: ID de consulta no válida
- Cadena primaria: Establecer resultado de cadena: advertencia (consulta no encontrada)
- Cadena primaria: plantilla de texto de representación: parámetro no válido
- Cadena primaria: Establecer resultado de cadena: advertencia (parámetro no válido)
- Cadena secundaria (agregar valores): plantilla de texto de representación (no se proporcionó ningún ID de parámetro)
- Cadena secundaria (agregar valores): establecer resultado de cadena - advertir (ID de parámetro)
- Cadena secundaria (agregar valores): plantilla de texto de representación: tipo de modo de parámetro
- Cadena secundaria (agregar valores): establecer resultado de cadena - advertir (tipo de parámetro)
- Cadena secundaria (Agregar valores): Plantilla de texto de representación - Informativo: No hay elementos nuevos
- Cadena secundaria (Agregar valores): Plantilla de texto de representación - Advertencia: demasiados elementos
- Cadena secundaria (Agregar valores): Establecer resultado de cadena - Advertir (Reemplazar)
- Cadena secundaria (Agregar valores): Establecer resultado de cadena - Advertir (Agregar)
- Cadena secundaria (Agregar valores): Plantilla de texto de representación - Informe de estado