La plantilla Load Data to 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 cargar un conjunto de datos en una tabla.
Requisitos
- La tabla Wdata de destino debe crearse antes de ejecutar esta cadena.
- Esta plantilla consta de tres cadenas. Cada cadena debe ser por separado publicado a su espacio de trabajo.
- El nombre del archivo debe incluir la 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. Más información sobre recomendaciones de tamaño de archivo.
Encontrar la plantilla
La plantilla Load Data to WData se encuentra en la sección Workiva Chains de la pantalla Templates .
He aquí cómo encontrarlo:
- En Chain Builder, vaya a la pestaña Templates .
- Seleccione Workiva Chains en el menú de la parte superior.
- Busque Load Data to Wdata | Primary Chain en la parte superior derecha y abra la plantilla.
-
Tras localizar la plantilla, haga clic en Nueva cadena para desplegarla en su 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 primaria, una Cadena de reemplazo de conjunto de datos y una Cadena de adición de nuevo conjunto de datos. Cuando la cadena principal se despliega en su espacio de trabajo, las dos cadenas secundarias (Añadir/Reemplazar) se despliegan automáticamente con ella.
He aquí un análisis más detallado de cada cadena:
- Cadena primaria: Esta cadena determina si hay un conjunto de datos dentro de su tabla que tenga el mismo nombre que el conjunto de datos que está siendo cargado por 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 haya configurado para la cadena principal, redirige esos datos a una de las dos cadenas secundarias.
-
Reemplazar cadena de conjuntos de datos: Esta cadena elimina el conjunto de datos coincidente de su tabla y lo sustituye por uno nuevo. Si se produce un error durante la ejecución y se selecciona la opción de retroceso, la cadena borrará automáticamente el nuevo conjunto de datos y volverá al conjunto de datos que se iba a sustituir.
-
Añadir nuevo conjunto de datos: Esta cadena crea un nuevo conjunto de datos y lo importa a su tabla. El nuevo conjunto de datos debe tener un nombre de archivo único que no sea utilizado actualmente por ningún otro conjunto de datos de la tabla.
Cuando se añade este conjunto de cadenas a una cadena existente, las entradas de tiempo de ejecución para la Cadena Primaria deben configurarse dentro del nodo "Cadena de Ejecución". Las cadenas hijo no requieren ningún cambio ni configuración.
La configuración debería ser algo parecido a esto:
Variables
| Tipo | Nombre | Propósito |
| Variable del espacio de trabajo | wsv-WdataLoadWarningThreshold |
Esta variable actúa como un límite suave en el tamaño del archivo del conjunto de datos. Cualquier conjunto de datos que supere el umbral elegido activará una advertencia. Dado que el tiempo de procesamiento aumenta con el tamaño del archivo, los conjuntos de datos más pequeños pueden procesarse mucho más rápido. El tamaño de archivo recomendado avisa ampliamente de que su conjunto de datos puede estar acercándose al límite de tamaño de archivo de Wdata. Cuando se activa una advertencia, puede considerar refactorizar su archivo o explorar otras opciones para tener en cuenta el archivo más grande. Tamaño de archivo recomendado: 150MB-200MB |
| Variable dinámica de la cadena | dcv-Cadena Resultado | Captura el estado de la cadena en varias etapas. Es obligatorio y no debe modificarse. |
Entradas en tiempo real
| Entrada en tiempo de ejecución | Propósito | Tipo de campo | Requerido |
| ID de tabla |
Introduzca el ID de la tabla Wdata a la que se cargará 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; esto permite utilizar la plantilla en varios procesos. |
Texto | Sí |
| Nombre del archivo |
El nombre del conjunto de datos que se importará a la tabla Wdata. El nombre del archivo indica a la cadena qué datos deben sustituirse. Los requisitos de los nombres 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í |
| Fichero de datos |
El fichero 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 tabla Wdata admitidos. |
Archivo | Sí |
| Método de carga |
Determina si el archivo debe sustituir a un conjunto de datos existente o añadirse como uno nuevo. Opciones:
|
Menú desplegable |
Sí |
| Retroceso |
En caso de error, se anulan los cambios y se vuelve a importar el conjunto de datos original. Fijado en True por defecto. Sólo 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 la cadena, incluidos los errores:
- Vaya a la pestaña Monitor en Chain Builder.
-
Pase el ratón por encima del signo de interrogación para ver el estado de la ejecución de la cadena.
Si su cadena ha provocado un error o no ha podido actualizar los datos correctos, realice las siguientes comprobaciones:
- Compruebe que las tres cadenas se han publicado en su espacio de trabajo. Cada cadena debe publicarse por separado.
- Asegúrese de que el 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 utilice el método de carga Reemplazar conjunto de datos, compruebe que el nombre del archivo coincide con el nombre del archivo existente en su tabla Wdata. Si no coincide, la cadena simplemente añadirá un nuevo archivo a su tabla sin sustituir el antiguo.
- A la inversa, cuando utilice el método de carga Añadir nuevo conjunto de datos, compruebe 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úrese de que la concesión OAuth2 asociada a la conexión Workiva tiene el acceso adecuado.
- Al introducir el ID de la tabla, asegúrese de que se ha introducido el ID completo y de que no hay espacios en blanco al principio o al final.
- Comprueba las variables de marca de tiempo de ejecución. No se deben utilizar 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 su tabla.
Asignación de columnas y otras modificaciones de la cadena
Si tiene problemas con las cabeceras de las columnas al importar los datos, puede utilizar data prep u otros comandos.
Opcional: Etiquetado de conjuntos de datos importados
Se puede etiquetar al importar conjuntos de datos, pero recomendamos desplegar un conjunto adicional de cadenas a partir de la plantilla antes de realizar cualquier 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ñada las siguientes entradas de tiempo de ejecución a cada una de las tres cadenas desplegadas desde esta plantilla:
- Tag-Key (Campo de texto)
- Valor de etiqueta (campo de texto)
- Edite el Primary Chain para pasar las entradas de tiempo de ejecución a cada evento "Run Chain":
- Tanto en Replace Dataset Chain como en Add New Dataset Chain, edite el nodo de comando "Import New Dataset" para aceptar las entradas de tiempo de ejecución de etiquetas.
Una vez completado, los conjuntos de datos importados se etiquetarán con la clave y el valor de etiqueta proporcionados.