Plantilla de Cadenas: Cargando datos a Wdata

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 dynamic_feed.
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 de 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: Agregar nueva cadena de conjunto de datos: el nombre del archivo no debe utilizarse en ninguna otra parte de esa tabla. Reemplazar cadena de conjuntos de datos - El nombre del archivo debe coincidir con el conjunto de datos que se va a reemplazar. 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: Reemplazar conjunto de datos Agregar nuevo conjunto de datos	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.