La plantilla Cargar datos en Wdata introduce datos en una tabla Wdata sustituyendo un conjunto de datos existente o añadiendo uno nuevo. Esta plantilla se utiliza más a menudo como parte de una cadena existente, pero puede añadirse a cualquier flujo de trabajo que requiera que un conjunto de datos se cargue en una tabla.
Requisitos
- La tabla de Wdata de destino debe crearse antes de ejecutar esta cadena.
- Esta plantilla se compone de tres cadenas. Cada cadena debe publicarse por separado en tu espacio de trabajo.
- El nombre del archivo debe incluir una extensión .csv o .tsv. Por ejemplo: "Archivo_Nombre_Ejemplo.csv".
- El tamaño máximo de archivo recomendado para un conjunto de datos es de 300 mb. Obtén más información sobre las recomendaciones sobre el tamaño de los archivos.
Buscar la plantilla
La plantilla Cargar datos a Wdata 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 de Workiva desde el menú de la parte superior.
- Busca Cargar datos a Wdata | Cadena principal en la parte superior derecha y abre la plantilla.
-
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.
Configurar la plantilla
Esta plantilla consta de tres cadenas: la Cadena principal, una Cadena Reemplazar conjunto de datos y una Cadena Añadir nuevo conjunto de datos. Cuando la Cadena principal se despliega en tu espacio de trabajo, las dos cadenas secundarias (Añadir/Reemplazar) se despliegan automáticamente con ella.
Aquí tienes una visión más detallada de cada cadena:
- Cadena principal: Esta cadena determina si hay un conjunto de datos dentro de tu tabla que tenga el mismo nombre que el conjunto de datos que está cargando la cadena. Si se encuentra un conjunto de datos coincidente, la cadena captura información sobre el conjunto de datos coincidente y --en función de la entrada en tiempo de ejecución "Método de carga" que hayas configurado para la cadena padre-- redirige esos datos a una de las dos cadenas hijas.
-
Reemplazar conjunto de datos en cadena: Esta cadena elimina el conjunto de datos coincidente de tu tabla y lo Reemplaza por uno nuevo. Si se produce un error durante la ejecución y se selecciona la opción de retroceso, la cadena eliminará automáticamente el nuevo conjunto de datos y volverá al conjunto de datos que se iba a reemplazar.
-
Añadir nuevo conjunto de datos en cadena: Esta cadena crea un nuevo conjunto de datos y lo importa a tu tabla. El nuevo conjunto de datos debe tener un nombre de archivo único que no utilicen actualmente otros conjuntos de datos de la tabla.
Al añadir este conjunto de Cadenas a una cadena existente, las entradas de tiempo de ejecución de la Cadena principal deben configurarse dentro del nodo "Ejecutar Cadena". Las cadenas hijo no requieren ningún cambio ni configuración.
Tu configuración debería ser algo parecido a esto:
Variables
| Tipo | Nombre | Propósito |
| Variable Espacio de trabajo. | wsv-WdataLoadWarningThreshold |
Esta variable actúa como un límite suave en el tamaño de los archivos de tu conjunto de datos. Cualquier conjunto de datos que supere el umbral elegido activará una advertencia. Como el tiempo de procesamiento aumenta con el tamaño de los archivos, los conjuntos de datos más pequeños pueden procesarse sustancialmente más rápido. El tamaño de archivo recomendado advierte ampliamente de que tu conjunto de datos puede estar acercándose al límite de tamaño de archivo de Wdata. Cuando se active una advertencia, puedes plantearte refactorizar tu archivo o explorar otras opciones para dar cuenta del archivo más grande. Tamaño de archivo recomendado: 150MB-200MB |
| Cadena dinámica variable | dcv-Cadena Resultado | Captura el estado de la cadena en varios estados. Esto es obligatorio y no debe cambiarse. |
Entradas en tiempo de ejecución
| Entrada en tiempo de ejecución | Propósito | Tipo de campo | Obligatorio |
| ID de tabla |
Introduce el ID de Tabla de Wdata a la que se subirá el conjunto de datos. Este ID también se utilizará para determinar si hay algún conjunto de datos duplicado dentro de la tabla. Recomendamos utilizar variables de espacio de trabajo para almacenar el ID de tabla. |
Texto | Sí |
| Nombre del archivo |
El nombre del conjunto de datos que se importará a la tabla de Wdata. El nombre del archivo indica a la cadena qué datos deben ser reemplazados. Los requisitos del nombre de archivo varían en función de la cadena seleccionada:
Nota: El nombre del archivo debe incluir la extensión .csv o .tsv. Por ejemplo "Archivo_Nombre_Ejemplo.csv" |
Texto | Sí |
| Archivo de datos |
El archivo de datos que se importará en la tabla. La extensión debe ser .csv o .tsv. Nota: El archivo de datos puede utilizar cualquiera de los delimitadores de tablas de Wdata admitidos. |
Archivo | Sí |
| Método de carga |
Determina si el archivo debe sustituir a un conjunto de datos existente o agregarse como uno nuevo. Opciones:
|
Menú desplegable |
Sí |
| Retrocede |
En caso de error, se deshacen los cambios y se vuelve a importar el conjunto de datos original. Establecido en Verdadero de forma predeterminada. Solo aplicable al método de carga Reemplazar conjunto de datos. |
Booleano (Verdadero/Falso) |
Ninguno |
Solución de problemas
Para ver el historial de ejecución de tu cadena, incluidos los errores:
- Ve a la pestaña Monitor del Generador de cadenas.
-
Pasa el ratón por encima del signo de interrogación para ver el estado de la cadena ejecutada.
Si tu cadena ha provocado un error o no ha actualizado los datos correctos, realiza las siguientes comprobaciones:
- Verifica que las tres cadenas se han publicado en tu espacio de trabajo. Cada cadena debe publicarse por separado.
- Asegúrate de que tu conjunto de datos utiliza un delimitador compatible y de que el nombre del archivo incluye una extensión .csv o .tsv ("Nombre_archivo_ejemplo.csv").
- Cuando utilices el método de carga Reemplazar conjunto de datos, comprueba que el nombre del archivo coincide con el nombre del archivo existente en tu tabla Wdata. Si no coincide, la cadena simplemente añadirá un archivo nuevo a tu tabla sin reemplazar el antiguo.
- Por el contrario, cuando utilices el método de carga Agregar conjunto de datos a, comprueba que el nombre del archivo no se utiliza en ningún otro lugar de la tabla Wdata. La cadena fallará si se utiliza un nombre de archivo que se solapa.
- Asegúrate de que la concesión OAuth2 asociada a la conexión Workiva tiene el acceso adecuado.
- Al introducir el ID de tabla, asegúrate de que se ha introducido el ID completo y de que no hay espacios en blanco al principio o al final.
- Comprobación de las variables de marca de tiempo de ejecución. No deben utilizarse en los nombres de archivo, ya que crea un nombre de archivo único para cada conjunto de datos, lo que significa que la cadena no podrá identificar ningún conjunto de datos coincidente en tu tabla.
Asignaciones de columnas y otras modificaciones de las cadenas.
Si tienes problemas con los encabezados de columna al importar datos, puedes utilizar preparación de datos u otros comandos.
Opcional: Etiquetar conjuntos de datos importados
Se admite el etiquetado al importar conjuntos de datos, pero recomendamos desplegar un conjunto adicional de cadenas desde la plantilla antes de hacer ningún cambio en el original. Una vez modificada, es probable que la cadena sea difícil de reutilizar para otras tablas, a menos que los conjuntos de datos de esas tablas utilicen las mismas etiquetas.
Para añadir etiquetas a una cadena:
- Añade las siguientes entradas de tiempo de ejecución a cada una de las tres cadenas implementadas desde esta plantilla:
- Clave de etiqueta (Campo de texto)
- Tag-Value (Campo de texto)
- Edita la Cadena principal para pasar las entradas de tiempo de ejecución a cada evento de "Cadena de ejecución":
- Tanto en Reemplazar cadena de conjuntos de datos como en Añadir nueva cadena de conjuntos de datos, edita el nodo de comando "Importar nuevo conjunto de datos" para aceptar las entradas de tiempo de ejecución de las etiquetas.
Una vez completado, tus conjuntos de datos importados se etiquetarán con la clave de etiqueta y el valor de etiqueta proporcionados.