Introducción
La plantilla Cadena de diccionarios de datos permite a los usuarios capturar y exportar a una hoja de cálculo detalles de alto nivel sobre tablas concretas de su espacio de trabajo. Los usuarios pueden especificar una palabra clave para localizar tablas, definir el nombre de la hoja de cálculo de exportación y crear una tabla en el espacio de trabajo para almacenar el esquema de cada tabla.
Para más detalles, consulta la documentación sobre el proceso Cargar datos en Wdata para obtener una visión general completa. Se recomienda revisar esta Documentación antes de utilizar la plantilla del Diccionario de datos .
Requisitos previos
Esta plantilla asume que los siguientes objetos ya están configurados en tu aplicación Workiva:
- Concesión de API
- Para aprovechar las API de Workiva, un usuario debe establecer una Concesión de API de OAuth dentro de su espacio de trabajo. Consulta este artículo sobre prácticas líderes para gestionar la concesión de OAuth.
- Los siguientes conectores deben estar habilitados y configurados en tu espacio de trabajo:
Nota: Algunos valores de las variables pueden contener información confidencial, como nombres de usuario y contraseñas. Recomendamos utilizar la opción "Cifrado" para las variables sensibles a la información y establecer los permisos adecuados para tu hoja de cálculo.
- Configurar variables
- Para que la subcadena Cargar datos en Wdata de la plantilla funcione como se espera, debe crearse una variable de espacio de trabajo titulada wsv-WdataLoadWarningThreshold.
Nota: Es una mejor práctica establecer el valor predeterminado de esta variable en 50 (que representa 50 MB), aunque puede ajustarse si es necesario.
-
- Además, deben crearse otras cuatro variables de espacio de trabajo antes de utilizar la cadena Diccionario de datos.
A continuación se desglosa cada una de las variables que hay que establecer y rellenar:
Construye tu Cadena
La plantilla de cadenas Diccionario de datos | TODOS | Principales se encuentra en la sección Cadenas de Workiva de la pantalla Plantillas.
Aquí te explicamos cómo encontrarlo:
- En Generador de cadenas, ve a la pestaña Plantillas .
- Selecciona Cadenas Workiva desde el menú de la parte superior.
- Busca plantilla de cadenas Diccionario de datos | TODOS | Principales en la parte superior derecha y abre la plantilla
Cuando el Diccionario de Datos | TODOS | Cadena principal se despliega en un espacio de trabajo, desplegará automáticamente seis subcadenas adicionales.
Los usuarios deben asegurarse de que las siete cadenas se han desplegado y publicado en el mismo espacio de trabajo:
- Diccionario de datos | TODOS | Principal
- Diccionario de Datos | Creación de Documentos y Subsecciones | Creación de Hojas de Cálculo.
- Diccionario de Datos | Crear Documento y Subsecciones | Creación de Hojas
- Diccionario de datos | Crear tabla
- Subir datos a Wdata | Cadena principal
- Cargar datos a Wdata | Reemplazar conjunto de datos
- Cargar datos a Wdata | Agregar conjunto de datos a ...
Después de localizar tu plantilla, configúrala para tu espacio de trabajo utilizando las variables creadas en la sección anterior.
Nota: Para obtener instrucciones detalladas sobre cómo crear una cadena a partir de una plantilla, consulta el artículo Crear y gestionar cadenas.
Entradas en tiempo de ejecución
Al ejecutar esta Cadena Principal (Diccionario de Datos | TODOS | Principal), será necesario rellenar las siguientes Entradas de Tiempo de ejecución o pasarlas a través de una Cadena de llamada:
| Entrada en tiempo de ejecución | Descripción | Tipo de campo | ¿Es necesario? |
|---|---|---|---|
| SpreadsheetName | Especifica el nombre de la hoja de cálculo donde se escribirá el esquema de la tabla. | Texto | Sí |
| Buscar valor | Esta entrada se utiliza para localizar tablas que contengan la palabra clave especificada. | Texto | Sí |
| Nombre de tabla de Wdata | Especifica el nombre de la tabla del diccionario de datos creada en la ejecución inicial de la plantilla. | Texto | Sí |
Tabla de Wdata
Para utilizar esta cadena, debe existir una tabla de Diccionario de Datos Wdata dentro del espacio de trabajo. La cadena creará automáticamente esta tabla, utilizando la convención de nomenclatura "Tabla del Diccionario de Datos", a menos que un usuario especifique un nombre de tabla diferente.
El siguiente esquema de tabla se utilizará para construir la tabla de datos del diccionario:
| Nombre de la columna | Descripción de la columna | ID de columna | Tipo de columna |
|---|---|---|---|
| Table_Name | N/D | table_name | texto |
| Alias | N/D | alias|alias | texto |
| Modo | N/D | modo | texto |
| Nombre | N/D | nombre | texto |
| Tipo | N/D | tipo | texto |
Ajustes Personalizados Descargo de responsabilidad: Si los usuarios tienen problemas con las cabeceras de las columnas que no coinciden al importar sus datos a una tabla Wdata, pueden aprovechar la preparación de datos u otros comandos para corregirlo. Sin embargo, si un usuario añade algún ajuste personalizado a esta plantilla, se recomienda que haga una copia antes de hacerlo. Cualquier cambio en la plantilla dificultará su reutilización. Esto también es aplicable si se aplica una configuración de etiquetas a la plantilla.
Solución de problemas
Las etapas siguientes pueden utilizarse para solucionar incidencias con la plantilla de cadenas:
Errores de Ejecución de Cadenas
- Verifica que todas las cadenas están publicadas.
- Asegúrate de que las credenciales de OAuth2 (
wsv-Client IDywsv-Secreto de cliente) son válidas y están actualizadas. - Comprueba los permisos del espacio de trabajo para el usuario que ejecuta la cadena.
Errores al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: Se ha producido un error al importar los datos: .
- Confirma que los Encabezados de columna de tu archivo de origen coinciden con el esquema de la tabla de Wdata.
- Para las operaciones de Reemplazar conjunto de datos, asegúrate de que los nombres de los archivos coinciden con los conjuntos de datos existentes en la tabla.
- Para las operaciones de Agregar conjunto de datos a, asegúrate de que los nombres de los archivos son únicos dentro de la tabla.
Duplicar la creación de tablas u hojas de cálculo
- Utiliza nombres coherentes para
Nombre de tabla de WdatayNombre de hoja de cálculoen todas las ejecuciones.
Pantalla del monitor
- Los usuarios pueden diagnosticar la causa de un error navegando hasta la pantalla de su monitor.
- La variable DCV_Cadena Resultado captura el estado de la cadena en función del resultado final. Si se produce un error, aplicará el motivo del fallo al texto de salida de la cadena dentro de la pantalla del monitor.
Los usuarios también pueden utilizar la pantalla del monitor para determinar si su archivo se ha importado correctamente.
Mejores prácticas
-
Evita personalizar la Plantilla original:
Crea una copia si necesitas ajustes. Los cambios en la plantilla pueden dificultar la reutilización. -
Etiquetado para un contexto mejorado:
Añade entradas de tiempo de ejecución (Clave de etiquetayValor de etiqueta) a los conjuntos de datos de etiquetas, si es necesario. Actualiza los nodos de la cadena para que pasen estas Entradas. -
Gestión del Tamaño del archivo:
Supervisa el tamaño del conjunto de datos utilizando la variablewsv-WdataLoadWarningThreshold. Considera la posibilidad de dividir los conjuntos de datos grandes si se activan las advertencias.