La plantilla Cargar datos en Wdata trae datos a una tabla Wdata reemplazando un conjunto de datos existente o agregando uno nuevo. Esta plantilla se utiliza con mayor frecuencia como parte de una cadena existente, pero se puede agregar a cualquier flujo de trabajo que requiera que se cargue un conjunto de datos en una tabla.
Requisitos
- La tabla Wdata de destino debe crearse antes de ejecutar esta cadena.
- Esta plantilla se compone de tres cadenas. Cada cadena debe publicarse por separado en su espacio de trabajo.
- El nombre del archivo debe incluir una extensión .csv o .tsv. Por ejemplo: “Nombre_de_archivo_Ejemplo.csv”.
- El tamaño de archivo máximo recomendado para un conjunto de datos es 300 MB. Obtenga más información sobre las recomendaciones de tamaño de archivo.
Encuentra la plantilla
La plantilla Cargar datos en WData se encuentra en la sección Cadenas de Workiva de la pantalla Plantillas .
Aquí te explicamos cómo encontrarlo:
- En Chain Builder, vaya a la pestaña Plantillas .
- Seleccione Cadenas Workiva del menú en la parte superior.
- Busque Cargar datos en Wdata | Cadena primaria en la parte superior derecha y abra la plantilla.
-
Después de ubicar la plantilla, haga clic en Nueva cadena para implementarla 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 principal, una cadena de reemplazo de conjunto de datos y una cadena de agregar nuevo conjunto de datos. Cuando la cadena principal se implementa en su espacio de trabajo, las dos cadenas secundarias (Agregar/Reemplazar) se implementan automáticamente con ella.
He aquí una mirada más de cerca a cada cadena:
- Cadena primaria: esta cadena determina si hay un conjunto de datos dentro de su tabla que tiene el mismo nombre que el conjunto de datos que la cadena está cargando.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 de tiempo de ejecución "Método de carga" que haya configurado para la cadena principal, redirecciona esos datos a una de las dos cadenas secundarias.
-
Reemplazar cadena de conjunto de datos: esta cadena elimina el conjunto de datos coincidente de su tabla y lo reemplaza por uno nuevo. Si ocurre un error durante la ejecución y se selecciona la opción de reversión, la cadena eliminará automáticamente el nuevo conjunto de datos y volverá al conjunto de datos que se iba a reemplazar.
-
Agregar nueva cadena de 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 en la tabla.
Al agregar este conjunto de cadenas a una cadena existente, las entradas de tiempo de ejecución para la cadena primaria deben configurarse dentro del nodo “Ejecutar cadena”.Las cadenas secundarias no requieren ningún cambio ni configuración.
Su configuración debería verse así:
Variables
Tipo | Nombre | Propósito |
Variable del espacio de trabajo | Umbral de advertencia de carga de datos wsv |
Esta variable actúa como un límite suave en el tamaño del archivo de su conjunto de datos. Cualquier conjunto de datos que supere el umbral elegido activará una advertencia. Debido a que el tiempo de procesamiento aumenta con el tamaño del archivo, los conjuntos de datos más pequeños se pueden procesar sustancialmente más rápido. El tamaño de archivo recomendado proporciona una amplia advertencia de que su conjunto de datos puede estar acercándose al límite de tamaño de archivo 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: 150 MB-200 MB |
Variable de cadena dinámica | Resultado de la cadena dcv | Captura el estado de la cadena en varias etapas. Esto es obligatorio y no debe cambiarse. |
Entradas de tiempo de ejecución
Entrada en tiempo de ejecución | Propósito | Tipo de campo | Obligatorio |
ID de tabla |
Introduzca el ID de la tabla Wdata en la que se cargará el conjunto de datos. Esta identificación también se utilizará para determinar si hay conjuntos de datos duplicados dentro de la tabla. Recomendamos utilizar variables de espacio de trabajo para almacenar el ID de la tabla; esto permite que la plantilla se utilice en múltiples procesos. |
Texto | Sí |
Nombre de archivo |
El nombre del conjunto de datos que se importará a la tabla Wdata. El nombre del archivo le indica a la cadena qué datos deben reemplazarse. Los requisitos de nombre de archivo varían según la cadena seleccionada:
Nota: El nombre del archivo debe incluir la extensión .csv o .tsv. Por ejemplo: “Nombre_de_archivo_Ejemplo.csv” |
Texto | Sí |
Archivo de datos |
El archivo de datos que se importará a 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 un conjunto de datos existente o agregarse como uno nuevo. Opciones:
|
Menú desplegable |
Sí |
Revertir |
En caso de error, esto revierte los cambios y vuelve a importar el conjunto de datos original. Establecido en Verdadero de forma predeterminada. 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 su cadena, incluidos los errores:
- Vaya a la pestaña Monitor en Chain Builder.
-
Pase el cursor sobre el signo de interrogación para ver el estado de ejecución de la cadena.
Si su cadena generó un error o no pudo actualizar los datos correctos, realice las siguientes comprobaciones:
- Verifique que las tres cadenas se hayan publicado en su espacio de trabajo. Cada cadena debe publicarse por separado.
- Asegúrese de que su conjunto de datos utilice un delimitador compatible y que el nombre del archivo incluya una extensión .csv o .tsv (“File_Name_Example.csv”).
- Al utilizar el método de carga Reemplazar conjunto de datos, verifique que el nombre del archivo coincida 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, al utilizar el método de carga Agregar nuevo conjunto de datos, verifique que el nombre del archivo no se utilice en ningún otro lugar de la tabla Wdata. La cadena fallará si se utiliza un nombre de archivo superpuesto.
- Asegúrese de que la concesión OAuth2 asociada con la conexión de Workiva tenga el acceso adecuado.
- Al ingresar el ID de la tabla, asegúrese de que se haya ingresado el ID completo y que no haya espacios en blanco al principio ni al final.
- Verifique las variables de marca de tiempo de ejecución. Estos no deben usarse en nombres de archivos, ya que crean 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.
Mapeos de columnas y otras modificaciones de la cadena
Si experimenta problemas con los encabezados de columna al importar datos, se pueden utilizar data prep u otros comandos.
Opcional: Etiquetado de conjuntos de datos importados
Para agregar etiquetas a una cadena:
- Agregue las siguientes entradas de tiempo de ejecución a cada una de las tres cadenas implementadas desde esta plantilla:
- Etiqueta-Clave (Campo de texto)
- Valor de etiqueta (campo de texto)
- Edite la Cadena primaria para pasar las entradas de tiempo de ejecución a cada evento "Ejecutar cadena":
- Tanto en Reemplazar cadena de conjunto de datos como en Agregar nueva cadena de conjunto de datos, edite el nodo de comando "Importar nuevo conjunto de datos" para aceptar las entradas de tiempo de ejecución de la etiqueta.
Una vez completado, los conjuntos de datos importados se etiquetarán con la clave de etiqueta y el valor de etiqueta proporcionados.
Recursos adicionales
- Conector de Workiva
- Conector de utilidades de archivo
- Conector JSON
- Conector de transformación de tablas
- Ejecutar una cadena dentro de otra cadena ("Ejecutar eventos de cadena")
- Subvenciones OAuth2
- Función de Wdata y límites de API