CLP - Reemplazar datos en una tabla – Centro de asistencia

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 de Workiva Configurar el conector de solicitud HTTP Completo CLP: carga de datos a 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.

Navega hasta la Cadena CLP | Cargar datos en una tabla.
Haz clic en Ejecutar y, a continuación, selecciona Ejecutar con entradas.
Introduce valores para tus Entradas en tiempo de ejecución:
- ID de tabla - ID de la tabla de detalles de empleados de CLP
  Consulta este documento para obtener ayuda sobre cómo encontrar el ID.
- Nombre de archivo - cualquier nombre que quieras darle al archivo; para este ejemplo, llamamos al archivo "Detalle del empleado".
- Ubicación del archivo - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
Haz clic en Iniciar.
Una vez que se haya completado la Cadena, haz clic en el nodo Importar archivo en la 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

Añade una nueva Cadena .
Ponle un Nombre a la Cadena: CLP | Reemplazando 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.

Añade un comando Entradas en tiempo de ejecución desde Eventos de activación de cadena el área de Inicio.
Edita el Evento en Cadena de Entradas en Tiempo de Ejecución haciendo doble clic en 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
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
Conecta el Evento en Cadena de Entradas en Tiempo de Ejecución al Comando Archivos de la Lista.
Haz doble clic en el comando para configurarlo. y haz clic en el campo ID de tabla.
En el panel izquierdo Variables, haz clic en la flecha hacia abajo para expandir Activador.
1. Haz clic en la flecha hacia abajo para expandir Entradas de tiempo de ejecución.
2. Selecciona TableID.
Guarda el comando.

Etapa 5: Desimportar archivo de la tabla.

De forma similar a subir datos a una Tabla, eliminar datos de una Tabla es un proceso de dos etapas. 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 la tabla para preparar el conjunto de datos que se va a eliminar.

Añade un comando Archivo para desimportar de la tabla al lienzo Cadena.
Conecta el comando Archivos conectados al comando Archivo no importado de la tabla.
Haz clic dos veces en el comando para configurarlo.
1. Haz clic en el campo ID de tabla.
  1. En el panel izquierdo Variables, haz clic en la flecha hacia abajo para expandir Activador.
  2. Haz clic en la flecha hacia abajo para expandir Entradas de tiempo de ejecución.
  3. Selecciona TableID.
2. Haz clic en el campo ID del archivo.
  1. Dentro del panel izquierdo de Variables, haz clic en la flecha hacia abajo para expandir Lista de Archivos.
  2. Selecciona Lista de Archivos.
  3. Haz clic en Lista de archivos - Variable de la lista de archivos para transformar la variable.
    1. Haz clic en Seleccionar transformación y luego selecciona Obtener valor de JSON.
    2. Haz clic en el signo más para añadir/agregar la transformación variable.
    3. En el Campo de valor escribe '0' y pulsa Introduce.
    4. Después de que aparezca =0, escribe 'id' y pulsa Introduce de nuevo.
      La variable leerá ahora la salida JSON del comando Listar Archivos y encontrará la id del primer archivo de la tabla.
      ¡Consejo! Presta especial atención a las mayúsculas y minúsculas cuando analices valores JSON.
    5. Haz clic en Aceptar.
3. Guardando el comando.
Etapa 6: Descarga de archivos.

A continuación, podemos o bien eliminar el archivo preparado de la Tabla, o bien preparar el nuevo archivo para cargarlo. Recomendamos subir un nuevo archivo después de desimportar el archivo antiguo para garantizar que el proceso se realiza correctamente antes de que se elimine oficialmente cualquier dato.

Para preparar el nuevo archivo para la carga, primero tendremos que descargar el archivo utilizando el Comando HTTP Solicitud Obtener. Hemos alojado un archivo en línea para que la Cadena lo descargue para demostrar la descarga de archivos desde la nube.
1. Añade un comando Obtener desde el conector Solicitud HTTP al lienzo Cadena.
2. Conecta el comando Desimportar archivo de la tabla al comando Obtener.
3. Haz clic dos veces en el comando para configurarlo.
  1. Haz clic en el campo URL.
    1. En el panel izquierdo Selecciona una variable, haz clic en la flecha hacia abajo para expandir Activador.
    2. Haz clic en la flecha hacia abajo para ampliar Entradas en tiempo de ejecución.
    3. Selecciona Ubicación del Archivo.
  2. Actualiza el campo Tipo de contenido a: application/csv.
4. Guarda 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.
1. Añade un comando Crear archivo desde el conector Workiva al lienzo Cadena.
2. Conecta el Comando Obtener con el Comando Crear Archivo.
3. Haz clic dos veces en el comando para configurarlo.
  1. Haz clic en el campo ID de tabla.
    1. En el panel izquierdo Selecciona una variable, haz clic en la flecha hacia abajo para expandir Activador.
    2. Haz clic en la flecha hacia abajo para ampliar Entradas en tiempo de ejecución.
    3. Selecciona ID de tabla.
  2. Haz clic en el campo Archivo .
    1. Dentro del panel izquierdo Seleccionar un variable, haz clic en la flecha hacia abajo para expandir GET.
    2. Selecciona Respuesta.
  3. Haz clic en el campo Nombre.
    1. En el panel izquierdo Selecciona una variable , haz clic en la flecha hacia abajo para expandir Activador.
    2. Haz clic en la flecha hacia abajo para ampliar Entradas en tiempo de ejecución.
    3. Selecciona Nombre de Archivo.
    4. En el panel izquierdo Selecciona un variable , haz clic en la flecha hacia abajo para expandir Tiempo de ejecución.
    5. Selecciona Chain.ExecutionDateTime.
    6. Escribe ".csv" después de tus dos variables.
      La variable Chain.ExecutionDateTime se utiliza como forma de mostrar cuándo se generó el archivo y para garantizar que cada archivo tiene un nombre único.
Etapa 8: Importar archivo a tabla

El siguiente paso en el proceso de subir archivos a tablas 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.
1. Añade un comando Importar archivo a la tabla desde el conector Workiva al lienzo Cadena.
2. Conecta el Comando Crear Archivo al Comando Importar Archivo a Tabla.
3. Haz clic dos veces en el Comando para configurarlo.
  - Para el campo ID de tabla:
    1. En el panel izquierdo Selecciona una variable , haz clic en la flecha hacia abajo para expandir Activador.
    2. Haz clic en la flecha hacia abajo para ampliar Entradas de tiempo de ejecución.
    3. Selecciona ID de tabla.
  - Para el campo ID de archivo.
    1. Dentro del panel izquierdo Selecciona una Variable , haz clic en la flecha hacia abajo para expandir Crear Archivo.
    2. Selecciona Resultado.
    3. Haz clic en Crear archivo - Resultado para transformarlo.
      1. En la lista desplegable Seleccionar transformación, selecciona Obtener valor desde JSON.
      2. Haz clic en el botón + (más).
      3. En el campo Valor, escribe "id" y pulsa Introduce.
      4. Haz clic en ACEPTAR.
4. Guardando 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. Este paso utiliza el comando Eliminar archivo para eliminar el conjunto de datos de la Tabla.
1. Añade un comando Eliminar archivo del conector Workiva al lienzo Cadenas.
2. Conecta el comando Importar archivo a tabla al comando Eliminar archivo.
3. Haz clic dos veces en el comando para configurarlo.
  Para asegurarnos de que estamos eliminando el mismo archivo que desimportamos, generaremos el ID del archivo del mismo modo que hicimos para el comando Desimportar archivo de la tabla:
  - En el campo ID del archivo:
    1. En el panel izquierdo Variables, haz clic en la flecha hacia abajo para expandir Lista de archivos.
    2. Selecciona Lista de Archivos.
    3. Haz clic en la variable Lista de Archivos - Files List para transformar la variable.
      1. Haz clic en Seleccionar transformación y luego selecciona Obtener valor de JSON.
      2. Haz clic en el signo más (+) para añadir la transformación de variable.
        
        En el campo Valor escribe "0" y pulsa Entra en.
        
        Después de que aparezca =0, escribe "id" y pulsa . Vuelve a introducir .
        La variable leerá ahora la salida JSON del comando Listar Archivos y encontrará la id del primer archivo de la tabla.
        ¡Consejo! Presta especial atención a las mayúsculas y minúsculas cuando analices valores JSON.
        
        Haz clic en Aceptar
        
        Guardando el comando.xx
        
        Etapa 10: Evaluar el Ejercicio
        
        Ahora que la Cadena está completa, evalúa el resultado.
        
        Haz clic en Ejecuta y luego selecciona Ejecutar Con Entradas.
        
        Agrega valores para tus Entradas de tiempo de ejecución.
        
        ID de tabla - ID de la tabla de detalles de empleados de CLP
        Consulta este documento para obtener ayuda para encontrar el ID
        
        Nombre de archivo - cualquier nombre que quieras darle al archivo; para este ejemplo, llamaremos al archivo "Detalle del empleado".
        
        Ubicación de los Archivos - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
        
        Haz clic en Inicio
        
        La Cadena debería haber eliminado correctamente el archivo antiguo y haberlo sustituido por el archivo nuevo en tu Tabla.
        
        Puedes verificar que los datos se sustituyeron en tu tabla navegando hasta la Tabla en Wdata y revisando los Conjuntos de datos en el panel de la derecha.
        
        ¡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!

Soporte técnico

Comunidad

Centro de soporte de Workiva