La plantilla Cargar datos en Wdata introduce datos en una tabla Wdata ya sea reemplazando 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 agregarse a cualquier flujo de trabajo que requiera cargar un conjunto de datos en una Tabla.
Requisitos
- La Tabla Wdata de destino debe estar creada 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 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. Más información sobre recomendaciones de tamaño de archivos.
Encontrar la plantilla
La plantilla Cargar datos en WData se encuentra en la sección Cadenas de Workiva de la pantalla Plantillas .
He aquí cómo encontrarlo:
- En Chain Builder, vaya a la pestaña Templates .
- Seleccione Workiva Chains en el menú de la parte superior.
- Buscar Cargar datos en Wdata | Cadena Primaria arriba a la derecha y abrir la plantilla.
-
Después de Buscar la plantilla, haga clic en Nueva cadena para desplegarla en su espacio de trabajo.
Nota: Una vez configurada, cada cadena en esta plantilla debe publicarse en el espacio de trabajo.
Configurar la plantilla
Esta plantilla consta de tres cadenas: la Cadena Principal, una Cadena de Reemplazar Conjunto de Datos y una Cadena de Agregar Nuevo Conjunto de Datos. Cuando la Cadena Principal se despliega en su espacio de trabajo, las dos cadenas secundarias (Agregar/Reemplazar) se despliegan automáticamente con ella.
He aquí un análisis más detallado de cada cadena:
- Cadena Principal: 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 Quita el conjunto de datos coincidente de su 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.
-
Agregar 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 esté siendo utilizado por ningún otro conjunto de datos de la tabla.
Al añadir este conjunto de cadenas a una cadena existente, las entradas de tiempo de ejecución para la cadena principal deben configurarse dentro del nodo "Ejecutar cadena". 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 limita el tamaño del archivo 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 de los archivos, los conjuntos de datos más pequeños pueden procesarse mucho más rápido. El Tamaño de Archivo recomendado le avisa 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-Chain Resultados | Captura el Estado de la cadena en varias etapas. Es obligatorio y no debe modificarse. |
Entradas en tiempo real
Entrada en tiempo real | 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 |
Nombre del conjunto de datos que se importará a la Tabla Wdata. El nombre del archivo indica a la cadena qué datos deben ser reemplazados. Los requisitos del nombre del 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 |
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 tabla Wdata admitidos. |
Archivo | Sí |
Método de carga |
Determina si el Archivo debe Reemplazar a un conjunto de datos existente o agregarse como uno nuevo. Opciones:
|
Menú desplegable |
Sí |
Retroceso |
En caso de error, se deshacen 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 producido un error o no ha actualizado 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 su 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 agregará un nuevo Archivo a su Tabla sin Reemplazar el anterior.
- Por el contrario, cuando utilice el método de carga Agregar 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 todo el ID y de que no hay espacios en blanco al principio ni 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 su Tabla.
Asignaciones de columnas y otras modificaciones de la cadena
Si tiene problemas con los Encabezados de las Columnas al Importar 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 desde 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 Agregar etiquetado a una cadena:
- Agregar las siguientes entradas de tiempo de ejecución a cada una de las tres cadenas desplegado desde esta plantilla:
- Tag-Key (Campo de Texto)
- Etiqueta-Valor (Campo de Texto)
- Editar la Cadena Primaria 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 Agregar nueva cadena de conjuntos de datos, edite el nodo de comando "Importar nuevo conjunto de datos" 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.