Es posible agilizar aún más la gestión de datos combinando pasos en la misma cadena. En esta ruta de aprendizaje conectada, repasaremos la mejor manera de reemplazar datos en una tabla Wdata, que es un proceso de dos pasos que utiliza una cadena.
Caso de uso empresarial principal | Gestión de tablas |
Objetivo de aprendizaje principal | Reemplazo de datos en una tabla Wdata mediante cadenas |
Prerrequisitos |
Configurar el conector Workiva Configurar el conector de solicitud HTTP Completar la ruta CLP | Carga de datos a una tabla Identifique el TID de tabla de la tabla de detalles de empleados de CLP |
Plantilla de apoyo | CLP | Reemplazar datos en una tabla |
Paso 1: Ejecutar la cadena
- Vaya a la cadena CLP | Cargar datos a una tabla
- Haga clic en Ejecutar y luego seleccione Ejecutar con entradas
- Agregue valores para sus entradas de tiempo de ejecución
- ID de tabla - ID de la tabla de detalles de empleados de CLP
- Nombre del archivo - cualquier nombre que desee darle al archivo, para este ejemplo, llamaremos al archivo "Detalle del empleado".
- Ubicación del archivo - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
- Haga clic en Iniciar
- Una vez completada la cadena, haga clic en el nodo Importar archivo a la tabla para verificar el éxito
- Ahora hay datos disponibles en la Tabla de detalles de empleados de CLP, que reemplazaremos con el conjunto de datos actualizado, utilizando una sola cadena para eliminar los datos antiguos y cargar los datos nuevos.
Paso 2: Crea una cadena
- Agregar una nueva Cadena
- Nombrar la cadena: CLP | Reemplazar datos en una tabla
- Salvar la cadena
Paso 3: Entradas en tiempo de ejecución
Usamos el comando de entradas en tiempo de ejecución para iniciar la cadena. Esto nos permite especificar el nombre del archivo y el ID de la tabla a la que se importará el archivo cuando ejecutemos la cadena.
- Agregue un comando Entradas de tiempo de ejecución desde Eventos de activación de cadena al área de Inicio
- Edite el evento de cadena de entradas de tiempo de ejecución haciendo doble clic en el comando
- Agregue las tres entradas a continuación:
- Entrada 1:
- Tipo: Campo de texto
- Nombre para mostrar: ID de tabla
- Obligatorio: Marcado
- Entrada 2:
- Tipo: Campo de texto
- Nombre para mostrar: Nombre del archivo
- Obligatorio: Marcado
- Entrada 3:
- Tipo: Campo de texto
- Nombre para mostrar: Ubicación del archivo
- Obligatorio: Marcado
- Entrada 1:
- Agregue las tres entradas a continuación:
- Guardar el comando
Paso 4: Listar archivos
Para eliminar el archivo antiguo de la tabla, necesitaremos el ID del archivo. Para encontrar programáticamente el FileID, utilizaremos el comando Listar archivos. Este comando utiliza el ID de la tabla para buscar todos los archivos dentro de esa tabla y nos proporciona una salida de los archivos así como información sobre esos archivos, incluido el ID del archivo.
- Agregar un comando Listar archivos al lienzo Cadena
- Conecte el evento de cadena ] Entradas de tiempo de ejecución al comando Archivos de lista
- Haga doble clic en el comando para configurarlo
- Haga clic en el campo ID de tabla
- Dentro del panel izquierdo Variables , haga clic en la flecha hacia abajo para expandir Activador
- Haga clic en la flecha hacia abajo para expandir Entradas de tiempo de ejecución
- Seleccionar ID de tabla
- Haga clic en el campo ID de tabla
- Guardar el comando
Paso 5: Anular la importación del archivo de la tabla
Similar a cargar datos a una tabla, eliminar datos de una tabla es un proceso de dos pasos. Primero será necesario mover el archivo al estado provisional antes de poder eliminarlo. Para establecer el archivo como preparado, será necesario desimportarlo. Utilizaremos el comando Dejar de importar archivo de la tabla para preparar el conjunto de datos que se eliminará.
- Agregue un comando Cancelar importación de archivo de la tabla al lienzo Cadena
- Conecte el comando Listar archivos al comando Desimportar archivo de la tabla
- Haga doble clic en el comando para configurarlo
- Haga clic en el campo ID de tabla
- Dentro del panel izquierdo Variables , haga clic en la flecha hacia abajo para expandir Activador
- Haga clic en la flecha hacia abajo para expandir Entradas de tiempo de ejecución
- Seleccionar ID de tabla
- Haga clic en el campo ID de archivo
- Dentro del panel Variables de la izquierda, haga clic en la flecha hacia abajo para expandir Listar archivos
- Seleccionar Lista de archivos
- Haga clic en la variable Lista de archivos - Lista de archivos para transformar la variable
- Haga clic en Seleccionar transformación y luego seleccione Obtener valor de JSON
- Haga clic en el signo más para agregar la transformación variable
- En el campo Valor, escriba '0' y luego presione Enter. Después de que aparezca =0, escriba 'id' y presione Enter nuevamente. La variable ahora leerá la salida JSON del comando Listar archivos y encontrará el ID del primer archivo en la tabla.
- Haga clic en el campo ID de tabla
¡Consejo! Preste especial atención a las mayúsculas y minúsculas al analizar valores JSON
-
-
-
- Haga clic en Aceptar
- Haga clic en Aceptar
-
-
- Guardar el comando
Paso 6: Descargar archivo
A continuación, podemos eliminar el archivo preparado de la tabla o podemos preparar el nuevo archivo para cargarlo. Se recomienda cargar un nuevo archivo después de desimportar el archivo anterior para garantizar que el proceso sea exitoso antes de que se eliminen oficialmente los datos. Para preparar el nuevo archivo para cargar, primero tendremos que descargar el archivo usando el comando de obtención de solicitud HTTP. Hemos alojado un archivo en línea para que Chain lo descargue para demostrar cómo descargar archivos desde la nube.
- Agregue un comando Obtener desde el conector Solicitud HTTP al lienzo de Cadena
- Conecte el comando Desimportar archivo de la tabla al comando Obtener
- Haga doble clic en el comando para configurarlo
- Haga clic en el campo URL
- Dentro del panel izquierdo Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Activador
- Haga clic en la flecha hacia abajo para expandir Entradas de tiempo de ejecución
- Seleccionar Ubicación del archivo
- Actualice el campo Tipo de contenido a: aplicación/csv
- Haga clic en el campo URL
- Guardar el comando
Paso 7: Crear archivo
Tal como lo hicimos en la ruta de aprendizaje conectada Cargar datos a la tabla, seguiremos el proceso de dos pasos para cargar datos a las tablas de Wdata. Primero será necesario crear el archivo en estado Preparado antes de poder importarlo para su uso final. Utilizaremos el comando Crear archivo para crear el archivo dentro de la tabla Wdata en el estado Preparado, lo que indica que se ha creado pero aún no se ha importado como un conjunto de datos.
- Agregue un comando Crear archivo desde el Conector Workiva al lienzo Cadena
- Conecte el comando Obtener al comando Crear archivo
- Haga doble clic en el comando para configurarlo
- Haga clic en el campo ID de tabla
- Dentro del panel izquierdo Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Activador
- Haga clic en la flecha hacia abajo para expandir Entradas de tiempo de ejecución
- Seleccionar ID de tabla
- Haga clic en el campo Archivo
- Dentro del panel izquierdo Seleccionar una variable , haga clic en la flecha hacia abajo para expandir OBTENER
- Seleccionar Respuesta
- Haga clic en el campo Nombre
- Dentro del panel izquierdo Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Activador
- Haga clic en la flecha hacia abajo para expandir Entradas de tiempo de ejecución
- Seleccionar Nombre de archivo
- Dentro del panel izquierdo Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Tiempo de ejecución
- Seleccionar Cadena.FechaHoraDeEjecución
- Escriba ".csv" después de sus dos variables
- Usamos la variable Chain.ExecutionDateTime como una forma de mostrar cuándo se generó el archivo y para garantizar que cada archivo tenga un nombre único.
- Haga clic en el campo ID de tabla
Paso 8: Importar archivo a la tabla
El segundo paso en el proceso de carga de archivos a las tablas Wdata es importar los datos para que puedan utilizarse en consultas. Este paso toma el archivo preparado y lo importa a la tabla designada como un conjunto de datos.
- Agregue un comando Importar archivo a la tabla desde el Conector Workiva al lienzo Cadena
- Conecte el comando Crear archivo al comando Importar archivo a la tabla
- Haga doble clic en el comando para configurarlo
- Haga clic en el campo ID de tabla
- Dentro del panel izquierdo Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Activador
- Haga clic en la flecha hacia abajo para expandir Entradas de tiempo de ejecución
- Seleccionar ID de tabla
- Haga clic en el campo ID de archivo
- Dentro del panel izquierdo Seleccionar una variable , haga clic en la flecha hacia abajo para expandir Crear archivo
- Seleccionar Resultado
- Haga clic en Crear archivo - Resultado para transformarlo
- En el menú desplegable Seleccionar transformación , seleccione Obtener valor de JSON
- Haga clic en el botón +
- En el campo Valor, escriba id y presione Enter
- Haga clic en ACEPTAR
- Haga clic en el campo ID de tabla
- Guardar el comando
Paso 9: Eliminar archivo
Ahora que los nuevos datos se han cargado y están listos para usarse y el antiguo conjunto de datos se ha preparado, el paso final es eliminar oficialmente los datos antiguos. Este paso utiliza el comando Eliminar archivo para eliminar el conjunto de datos de la tabla.
- Agregue un comando Eliminar archivo desde el Conector Workiva al lienzo Cadena
- Conecte el comando Importar archivo a la tabla al comando Eliminar archivo
- Haga doble clic en el comando para configurarlo
- Para asegurarnos de que estamos eliminando el mismo archivo que desimportamos, generaremos el ID del archivo de la misma manera que lo hicimos para el comando Desimportar archivo de la tabla, como se describe a continuación:
- Haga clic en el campo ID de archivo
- Dentro del panel Variables de la izquierda, haga clic en la flecha hacia abajo para expandir Listar archivos
- Seleccionar Lista de archivos
- Haga clic en la variable Lista de archivos - Lista de archivos para transformar la variable
- Haga clic en Seleccionar transformación y luego seleccione Obtener valor de JSON
- Haga clic en el signo más para agregar la transformación variable
- En el campo Valor, escriba '0' y luego presione Enter. Después de que aparezca =0, escriba 'id' y presione Enter nuevamente. La variable ahora leerá la salida JSON del comando Listar archivos y encontrará el ID del primer archivo en la tabla.
¡Consejo! Preste especial atención a las mayúsculas y minúsculas al analizar valores JSON
-
-
-
- Haga clic en Aceptar
- Haga clic en Aceptar
-
-
- Guardar el comando
Paso 10: Pruebe el ejercicio
Ahora que la cadena está completa, prueba el resultado.
- Haga clic en Ejecutar y luego seleccione Ejecutar con entradas
- Agregue valores para sus entradas de tiempo de ejecución
- ID de tabla - ID de la tabla de detalles de empleados de CLP
- Nombre del archivo - cualquier nombre que desee darle al archivo, para este ejemplo, llamaremos al archivo "Detalle del empleado".
- Ubicación del archivo - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
- Haga clic en Iniciar
- La cadena debería haber eliminado con éxito el archivo antiguo y haberlo reemplazado con el nuevo archivo en su tabla.
- Puede verificar que los datos se reemplazaron en su tabla navegando a la Tabla en Wdata y revisando los Conjuntos de datos en el panel de la derecha.
Para obtener más información sobre el uso de cadenas para optimizar la recopilación de datos, consulte el resto de Rutas de centralización de datos!