Puedes agilizar aún más tu gestión de datos combinando etapas en la misma cadena. En esta Ruta de Aprendizaje Conectada recorreremos la mejor manera de reemplazar datos en una Tabla de Wdata, que es un proceso de dos pasos utilizando una Cadena.
| Caso de uso empresarial principal | Gestión de Tablas |
| Objetivo principal de aprendizaje | Reemplazando datos en una Tabla de Wdata usando Cadenas |
| Requisitos previos | Configurar el conector Workiva Configurar el conector de solicitud HTTP Completar CLP: cargar datos en una ruta de tabla Identificar el ID de tabla de la Tabla de detalles de empleados de CLP |
| Plantilla de ayuda | CLP - Reemplazar datos en una Tabla |
Paso 1: Ejecutar Cadenas.
- Navegue hasta CLP | Cargar datos en una Tabla Cadena.
- Haga clic en Ejecutar y, a continuación, seleccione Ejecutar con entradas.
- Introduzca valores para sus entradas de tiempo de ejecución:
- Tabla ID - ID de la tabla de detalles del empleado de CLP
Consulte este Documento para encontrar el ID. - Nombre del archivo - cualquier nombre que quiera darle al archivo, para este ejemplo, lo llamaremos "Detalle del empleado".
- Ubicación del Archivo - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
- Tabla ID - ID de la tabla de detalles del empleado de CLP
- Haz clic en Iniciar.
- Una vez que la Cadena haya tenido éxito, haga clic en el nodo Importar Archivo a Tabla para verificar el éxito.
Ahora hay datos disponibles en la Tabla de detalles de empleados de CLP, que ahora sustituiremos por el conjunto de datos actualizado, utilizando una sola cadena para eliminar los datos antiguos y cargar los nuevos.
Etapa 2: Crea una Cadena
- Agregar una nueva cadena .
- Asigne un nombre a la cadena: CLP | Reemplazar datos en una Tabla.
- Guarda la cadena.
Etapa 3: Entradas en tiempo de ejecución
Utilizamos el comando 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.
- Agregar un Tiempo de ejecución Entradas Comando de la cadena de eventos de disparo el área de inicio.
- Edite el Evento de Cadena de Runtime Inputs haciendo doble clic sobre el Comando.
Añade las tres Entradas siguientes:- Entrada 1:
- Tipo de: TextField
- Mostrar Nombre: ID de tabla: (en inglés)
- Necesario: Comprobado
- Entrada 2:
- Tipo de: TextField
- Mostrar Nombre: Nombre del archivo.
- Necesario: Comprobado
- Entrada 3:
- Tipo de: TextField
- Mostrar Nombre: Ubicación del archivo.
- Necesario: Comprobado
- Entrada 1:
- Guarda el comando.
Etapa 4: Enumerar Archivos.
Para eliminar el archivo antiguo de la Tabla, necesitaremos el ID de archivo. Para encontrar programáticamente el ID de archivo, utilizaremos el comando Listar archivos. Este comando utiliza el ID de tabla para buscar todos los archivos dentro de esa tabla y nos proporciona un resultado de los archivos, así como información sobre esos archivos, incluido el ID de archivo.
- Añade un comando Crear lista de archivos al lienzo de Cadenas
- Conecte las Entradas en tiempo de ejecución Evento en cadena al comando Listar Archivos .
- Haga doble clic en el Comando para configurarlo. y haga clic en el campo Tabla ID .
- En el panel izquierdo Variables , haga clic en la flecha hacia abajo para expandir Trigger.
- Haga clic en la flecha hacia abajo para Expandir Entradas en tiempo de ejecución.
- Seleccione TableID.
- Guarda el comando.
Etapa 5: Desimportar archivo de la tabla.
Al igual que cargando datos en una Tabla, la eliminación de datos de una Tabla es un proceso de dos pasos. Primero habrá que Mover el Archivo para que pase al Estado de Tramitación antes de poder Eliminarlo. Para establecer el archivo como Oculto provisionalmente, será necesario no importarlo. Utilizaremos el comando Desimportar Archivo de Tabla para preparar el conjunto de datos que se va a eliminar.
- Agregar un comando Desimportar Archivo de la Tabla al lienzo de la Cadena.
- Conecte el comando Listar Archivos con el comando Desimportar Archivo de la Tabla .
- Haga doble clic en el comando para configurarlo.
- Haz clic en el campo ID de tabla.
- En el panel izquierdo Variables , haga clic en la flecha hacia abajo para expandir Trigger.
- Haga clic en la flecha hacia abajo para Expandir Entradas en tiempo de ejecución.
- Seleccione TableID.
- Haz clic en el campo ID del archivo.
- Dentro del panel de Variables de la Izquierda, haga clic en la Flecha hacia abajo para Expandir List Files.
- Seleccione 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, a continuación, 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 pulse Introducir valor.
- Después de que aparezca
=0, escriba 'id' y pulse Vuelva a introducir .
La variable leerá ahora la salida JSON del comando Listar Archivos y encontrará la id del primer archivo de la tabla.¡Consejo! Preste especial atención a las mayúsculas frente a las minúsculas cuando analice valores JSON.
- Haz clic en Aceptar.
- Guardar como el Comando.
Etapa 6: Descarga de archivos.
Siguiente, podemos o bien eliminar el Archivo de la Tabla, o bien preparar el nuevo Archivo a cargar. Le recomendamos que cargue un archivo nuevo después de desimportar el archivo antiguo para asegurarse de que el proceso se realiza correctamente antes de que se borre oficialmente cualquier dato.
Para preparar el nuevo archivo para ser cargado, primero tendremos que descargar el archivo usando el comando HTTP Request Get . Hemos alojado un archivo en línea para que la Cadena lo descargue para demostrar la descarga de archivos desde la nube.
- Agregar un comando Get del conector HTTP Request al lienzo Chain.
- 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 de la Izquierda Seleccione una Variable , haga clic en la Flecha hacia abajo para Expandir Trigger.
- Haga clic en la Flecha hacia abajo para Expandir Runtime Inputs.
- Seleccione Ubicación del Archivo.
- Actualizado el campo Tipo de contenido a: application/csv.
- Haga clic en el campo URL .
- Guardar como el Comando.
Etapa 7: Crear archivo.
Al igual que hicimos en la Ruta de aprendizaje para subir datos a la tabla conectada, seguiremos el proceso de dos pasos para subir datos a las tablas de Wdata. Primero habrá que crear el archivo en el Estado de tramitación antes de importarlo para su uso final. Utilizaremos el comando Crear archivo para crear el archivo dentro de la Tabla Wdata en el estado Por etapas, lo que indica que se ha creado pero aún no se ha importado como conjunto de datos.
- Agregar un comando Crear Archivo del Conector Workiva al lienzo de la Cadena.
- Conecte el comando Obtener al comando Crear Archivo .
- Haga doble clic en el comando para configurarlo.
- Haz clic en el campo ID de tabla.
- Dentro del panel de la Izquierda Seleccione una Variable , haga clic en la Flecha hacia abajo para Expandir Trigger.
- Haga clic en la Flecha hacia abajo para Expandir Runtime Inputs.
- Seleccione Tabla ID.
- Haga clic en el campo Archivo .
- Dentro del panel de la Izquierda Seleccione una Variable , haga clic en la Flecha hacia abajo para Expandir GET.
- Seleccione Response.
- Haga clic en el campo Nombre .
- Dentro del panel de la Izquierda Seleccione una Variable , haga clic en la Flecha hacia abajo para Expandir Trigger.
- Haga clic en la Flecha hacia abajo para Expandir Runtime Inputs.
- Seleccione Nombre del archivo.
- Dentro del panel izquierdo Select a Variable , haga clic en la flecha hacia abajo para Expandir Runtime.
- Seleccione Chain.ExecutionDateTime.
- Tipo ".csv" después de sus dos variables.
La variable Chain.ExecutionDateTime se utiliza para mostrar cuándo se generó el archivo y para garantizar que cada archivo tiene un nombre único.
- Haz clic en el campo ID de tabla.
Etapa 8: Importar archivo a tabla
La Siguiente Etapa en el proceso de cargando archivos a las Tablas de Wdata es importar los datos, haciéndolos utilizables en Consultas. Este paso toma el archivo oculto provisionalmente y lo importa a la tabla designada como un conjunto de datos.
- Agregar un comando Importar Archivo a la Tabla desde el Conector Workiva al lienzo de la Cadena.
- Conecte el comando Crear Archivo con el comando Importar Archivo a Tabla .
- Haga doble clic en el comando para configurarlo.
- Para el campo Tabla ID :
- Dentro del panel de la Izquierda Seleccione una Variable , haga clic en la Flecha hacia abajo para Expandir Disparador.
- Haga clic en la flecha hacia abajo para Expandir Entradas en tiempo de ejecución.
- Seleccione Tabla ID.
- Para el campo ID de Archivo .
- En el panel izquierdo Seleccione una variable , haga clic en la flecha hacia abajo para Expandir Crear Archivo.
- Seleccione Resultados.
- Haga clic en Crear Archivo - Resultado para transformarlo.
- En el desplegable Seleccionar transformación , seleccione Obtener valor de JSON.
- Haz clic en el botón + (más).
- En el campo Valor, escriba "id" y pulse Entrar.
- Haz clic en ACEPTAR.
- Para el campo Tabla ID :
- Guardar como el comando
Etapa 9: Eliminar archivo
Ahora que los nuevos datos se han Oculto y están listos para su uso y que el antiguo conjunto de datos se ha Oculto provisionalmente, la última etapa consiste en eliminar oficialmente los datos antiguos. Esta Etapa utiliza el comando Eliminar Archivo para eliminar el conjunto de datos de la Tabla.
- Añade un comando Eliminar archivo del conector Workiva al lienzo Cadenas.
- Conecta el comando Importar archivo a tabla al comando Eliminar archivo.
- Haga doble clic en el comando para configurarlo.
Para asegurarnos de que estamos eliminando el mismo Archivo que hemos desimportado, generaremos el ID del Archivo de la misma forma que hicimos para el comando Desimportar Archivo de la Tabla:- En el campo ID de Archivo :
- En el panel izquierdo Variables , haga clic en la flecha hacia abajo para expandir Lista de Archivos.
- Seleccione Lista de Archivos.
- Haga clic en la variable Lista Archivos - Files List para transformar la variable.
- Haga clic en Seleccionar transformación y, a continuación, 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 pulse Introducir.
- Después de que aparezca
=0, escriba 'id' y pulse Vuelva a introducir .
La variable leerá ahora la salida JSON del comando Listar Archivos y encontrará la id del primer archivo de la tabla.¡Consejo! Preste especial atención a las mayúsculas frente a las minúsculas cuando analice valores JSON.
- Haz clic en Aceptar
- Guardar como el comando.xx
Etapa 10: Evaluar el Ejercicio
Ahora que la Cadena está completa, evalúa el resultado.
- Haga clic en Ejecutar y, a continuación, seleccione Ejecutar con entradas.
- Agregar valores para sus entradas de tiempo de ejecución.
- Tabla ID - ID de la tabla de detalles del empleado de CLP
Consulte este Documento para obtener ayuda para encontrar el ID - Nombre del archivo - cualquier nombre que desee dar al archivo; en este ejemplo, lo llamaremos "Detalle del empleado".
- Ubicación de los Archivos - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
- Tabla ID - ID de la tabla de detalles del empleado de CLP
- Haz clic en Inicio
- La Cadena debería haber Quitado con éxito el Archivo antiguo y Reemplazado con el nuevo archivo en su Tabla.
- Puede verificar que los datos fueron Reemplazados en su Tabla navegando a la Tabla en Wdata y revisando los Conjuntos de Datos en el panel derecho.
¡Para obtener más información sobre cómo utilizar Cadenas para agilizar la recopilación de datos, consulta el resto de las Rutas de centralización de datos!
- En el campo ID de Archivo :
- Haz clic en el campo ID de tabla.