Centro de soporte de Workiva

En esta Ruta de aprendizaje conectada, crearemos una Cadena que ilustra cómo convertir un archivo XML a CSV. Además, exploraremos cómo comparar conjuntos de datos para aislar las diferencias.

Paso 1: Crea una Cadena

1. Añade una nueva Cadena , y nombra la Cadena: CLP | Acceso a datos XML.
2. Crea dos variables de Cadena como sigue:
   1. Debajo de Variables en cadena, haz clic en el signo más (+) dos veces.
   2. Utiliza los siguientes nombres y valores para las variables:
      • Variable XML
        • Nombre: cv-XML-Empleado
        • Valor: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employees.xml
      • Variable CSV
        • Nombre: cv-CSV-Empleado
        • Valor: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
3. Guarda la cadena.
   

Etapa 2: Recuperar datos en formato CSV

Utiliza el conector HTTP para recuperar datos relacionados con el recuento en formato CSV. En etapas posteriores, recuperaremos información similar sobre los recuentos en formato XML y, a continuación, compararemos los conjuntos de datos para identificar las diferencias.

1. Añade un comando GET desde el conector HTTP al nodo Inicio.

2. Configura el comando utilizando los siguientes valores:

   Nombre	GET - Recuento en formato CSV
   Nombre de usuario	<leave>
   Contraseña	<leave>
   Certificado CA	<leave>
   Certificado	<leave>
   Certificado Clave Privada	<leave>
   Mostrar respuesta	Comprobado
   dirección URL|URL	cv-CSV-Empleado Variable de cadena
   Cadena de consulta	<leave>
   Tipo de contenido	texto/csv
   Respuesta	<leave>

3. Guarda el comando.
   

Etapa 3: Recuperar datos en formato XML

Utiliza el conector HTTP para recuperar datos relacionados con el recuento en formato XML. Como se indicó en la etapa 2, en una etapa posterior compararemos el conjunto de datos XML con el conjunto de datos CSV para identificar las diferencias.

1. Añadir un comando GET desde el conector HTTP a la cadena.
2. Conecta el nodo Inicio (OBTENER - Recuento en formato CSV) al comando OBTENER.

3. Configura el comando utilizando los siguientes valores:

   Nombre	GET - Recuento en formato XML
   Nombre de usuario	<leave>
   Contraseña	<leave>
   Certificado CA	<leave>
   Certificado	<leave>
   Certificado Clave Privada	<leave>
   Mostrar respuesta	Comprobado
   dirección URL|URL	cv-XML-Employee Variable de cadena
   Cadena de consulta	<leave>
   Tipo de contenido	aplicación/xml
   Respuesta	<leave>

4. Guarda el comando.
   

Etapa 4: Convierte el archivo XML a Delimitado.

Utiliza el Conector XML para convertir los datos XML a un formato CSV que nos permita aprovechar comandos posteriores de la Cadena que esperan datos en un formato delimitado.

1. Añade un comando Lista de elementos a CSV desde el conector XML a la cadena.
2. Conecta el comando GET - Recuento en formato XML a la lista de elementos a CSV.
3. Configura este comando utilizando los siguientes valores:
   • Para el parámetro Archivo de entrada, selecciona el parámetro Salida de respuesta del comando GET - Recuento de personal en formato XML.
   • Deja en blanco el parámetro Entrada Texto.
   • Para el parámetro Ruta a la raíz, introduce la siguiente información de sobre:
     /employee_data/employee
   • Marca la casilla de verificación del parámetro Vista previa del resultado.

   • Para la sección Columnas, haz clic en el botón Añadir 12 veces.
     Para cada una de las columnas Agregadas, introduce el nombre del campo del registro de datos previsualizado en el paso anterior en los campos Nombre de columna y XPath. 
     Ejemplo: emp_id

     ⚠️ El campo XPath distingue entre mayúsculas y minúsculas y debe coincidir con el sobre.

   • Para el parámetro Delimitador de valores múltiples, introduce un tubo (|).
4. Guarda el comando.
   
5. Publicar, Ejecutar y Ejecutar la cadena.

6. Revisa la pestaña Log del nodo de comando Lista de elementos a CSV - Todos los empleados y confirma que se muestra una lista de empleados.

   ⚠️ No te saltes la ejecución y revisión de resultados de este paso, ya que se creará una Copia de este Comando en la Cadena y, posteriormente, habría que corregir cualquier error en varias instancias del Comando.

   

Etapa 5: Cambiar el XML convertido de delimitado por pestañas a delimitado por comas.

Utiliza el conector de transformación tabular para convertir el resultado generado desde la conversión XML de un formato delimitado por pestañas a un formato delimitado por comas.

1. Añadir un comando Cambiar Delimitador desde la transformación tabular Conector a la cadena.
2. Conecta la lista de elementos al comando CSV - Todos los empleados al comando Cambiar delimitador.
3. Configura este comando utilizando los siguientes valores:
   • Nombre..: Cambiar Delimitador - Todos los Empleados
   • Archivo de Entrada: Archivo Convertido de Salida de la Lista de Elementos a CSV - Todos los Empleados Comando
   • Delimitador de Entrada: \t
   • Delimitador de Salida:, (coma)
4. Guarda el comando.
   

Etapa 6: Comparar los Conjuntos de datos CSV y XML para identificar las diferencias

Utiliza Consulta avanzada para identificar sistemáticamente las diferencias entre los conjuntos de datos XML y CSV nativos. En este ejemplo, identifica todos los registros del conjunto de datos XML que sean diferentes o que falten del conjunto de datos CSV. Cualquier registro adicional encontrado en el conjunto de datos CSV que no esté en el conjunto de datos XML no se identificará con este ejercicio.

1. Añade un comando Consulta avanzada desde el conector de Transformación tabular a la cadena.
2. Conecta el comando Cambiar Delimitador - Todos los empleados al comando Consulta avanzada.
3. Nombre del comando: Consulta Avanzada - Todos los Empleados.
4. En la sección Tablas, haz clic en el botón Añadir para añadir una segunda pestaña.
   • Para la primera tabla:
     • Especifica el Resultado CSV Salida desde el comando Delimitador de cambios - Todos los empleados.
     • Especifica XML como Nombre de tabla .
   • Para la segunda tabla:
     • Especifica la Salida de Respuesta del Comando GET - Recuento en formato CSV.
       Especifica CSV como Nombre de tabla .
     • En el parámetro Consulta, introduce lo siguiente:
       Seleccionar * de XML EXCEPTO Seleccionar * de CSV
     • En los campos Delimitador de entrada y Delimitador de salida, especifica Coma.
     • Marca la opción Vista previa de resultados.
5. Guarda el comando.
   
6. Publicar, Ejecutar y Ejecutar la cadena. 
   

7. Revisa la pestaña Registro del nodo Consulta avanzada - Todos los empleados Comando y confirma que los ID de los empleados coinciden con los de abajo para los registros devueltos por la consulta.

   ID de empleado 01-6875791 10-4199621 38-3932553 63-0417180 78-3600453 85-6818050 97-2828467

Etapa 7: Añadir un grupo de comandos

Añadir un grupo de comandos a la cadena para organizar mejor los comandos. Aunque esta etapa es necesaria en lo que respecta a este ejercicio, no es un requisito técnico para la Cadena. Esta etapa sólo sirve para ilustrar la capacidad de organización de los nodos de una Cadena.

1. Añadir un Grupo de comandos a la Cadena.
2. Conecta el comando GET - Recuento en formato XML a la sección En del Grupo de comandos.
3. Haz clic en el Grupo de comandos y selecciona el icono del cuentagotas para cambiar el color del comando a rojo.
4. Nombre del Grupo: Empleados Activos. 
   

Etapa 8: Filtrar datos CSV solo para empleados activos

Utiliza un filtrado inteligente para conservar solo los registros de empleados en los que el empleado esté activo. Al definir el filtro, suponemos que el campo terminado (denominado) en blanco indica que un empleado está activo.

1. Añade un comando Filtro inteligente de filas desde el conector de transformación tabular a la cadena.
2. Conecta el grupo Inicia desde el grupo de comandos al comando Filtro inteligente.
3. Configura el Comando utilizando los siguientes valores:
   • Ponle Nombre al Comando: Filtrar Filtros Inteligentes - Datos CSV - Empleados Activos.
   • Para el parámetro Archivo de entrada, selecciona la Salida de respuesta del comando GET - Recuento de cabezas en formato CSV.
   • Deja en blanco el parámetro Resultado: archivo.
   • Especifica Coma como Delimitador.
   • En la sección Filtros completa los pasos siguientes:
     1. Haz clic en el botón Añadir en los filtros Text.
     2. En el parámetro Nombre de la columna, introduce denominado.
     3. Marca la opción Insensible a mayúsculas y minúsculas.
     4. Desde el desplegable Condición, selecciona Igual a.
     5. En el parámetro Comparar texto, introduce verdadero.
     6. Marca la opción No está en.
     7. Deja sin marcar la casilla Recortar.
        Este filtro identificará ahora cualquier registro en el que el campo "denominado" no contenga un valor de verdadero (es decir, que contenga "falso" o esté en blanco).
4. Deja marcada la opción Vista previa del resultado.
5. La opción Inverso permite que el Filtro Inteligente mantenga (Comprobado) o elimine (Desmarcado) todas las filas que coincidan con los criterios de filtrado. En este ejercicio, queremos conservar todas las filas en las que el campo "denominado" tenga un valor de verdadero o en blanco. 
   Para ello, marca (marca) la casilla Inversa.
6. Guarda el comando.
   

Etapa 8: Filtrar datos CSV solo para empleados activos

Utiliza un filtrado inteligente para conservar solo los registros de empleados en los que el empleado esté activo. Al definir el filtro, suponemos que el campo terminado ("terminado") está en blanco, lo que indica que un empleado está activo.

1. Añade un comando Filtro inteligente de filas desde el conector de transformación tabular a la cadena.
2. Conecta el grupo Inicia desde el grupo de comandos al comando Filtro inteligente.
3. Configura el Comando utilizando los siguientes valores:
   • Ponle Nombre al Comando: Filtrar Filas Inteligentes - Datos CSV - Empleados Activos.
   • Para Archivo de entrada, selecciona Salida de respuesta del comando GET - Recuento de personal en formato CSV.
   • Deja en blanco el parámetro Resultado: archivo.
   • Especifica Coma como Delimitador.
   • En la sección Filtros,
     1. Haz clic en el botón Añadir en los filtros Text.
     2. En el parámetro Nombre de la columna, introduce denominado.
     3. Marca la opción Insensible a mayúsculas y minúsculas.
     4. Desde el desplegable Condición, selecciona Igual a.
     5. En el parámetro Comparar texto, introduce verdadero.
     6. Marca la opción No está en.
     7. Deja sin marcar la casilla Recortar.
        Este filtro identificará ahora cualquier registro en el que el campo "termed" no contenga un valor de verdadero (es decir, que contenga "falso" o esté en blanco).
   • Deja marcada (checked) la casilla de verificación Vista previa Resultado.
   • La opción Inverso permite que el Filtro Inteligente mantenga (marcada) o elimine (desmarcada) todas las filas que coincidan con los criterios de filtrado. En este ejercicio, queremos conservar todas las filas en las que el campo denominado tenga un valor de verdadero o esté en blanco. Para conseguirlo, marca (marca) la casilla de verificación Inversa.
4. Guarda el comando.
   

Etapa 9: Filtrar datos XML al convertir a Delimitado

En esta etapa, filtramos los datos XML al convertirlos a un formato delimitado para identificar solo a los empleados activos. Este conjunto de datos se comparará posteriormente con el conjunto de datos CSV filtrado para identificar las diferencias.

1. Copia la Lista de elementos a CSV - Todos los empleados Comando.
2. Conecta el Grupo Empieza desde del Grupo de Comandos al Comando Lista de Elementos a CSV - Todos los Empleados (Copiar).
3. Edita el comando, dándole un nombre: Lista de elementos a CSV - Empleados activos.
4. En el parámetro "Ruta a la raíz", introduce lo siguiente.
   /employee_data/employee[termed!='true']
   Esto identificará ahora cualquier registro en el que el campo "termed" no contenga un valor de true (es decir, que contenga "false" o esté en blanco).
5. Guarda el comando.
   

Etapa 10: Cambia los Datos XML filtrados a Delimitados por Comas.

Al igual que con la lista de empleados completa, la lista de empleados activos filtrada que se ha convertido de XML a delimitada por pestañas debe convertirse a delimitada por comas.

1. Copia el comando Delimitador de cambios - Todos los empleados.
2. Conecta la Lista de Elementos a CSV - Comando Empleados Activos al Delimitador de Cambio de Elemento - Comando Todos los Empleados (Copiar).
3. Configura el comando utilizando los siguientes valores.
   • Nombre..: Cambiar Delimitador - Empleados Activos.
   • Modifica el parámetro Archivo de entrada para utilizar el archivo Convertido Salida del comando Lista de elementos a CSV - Empleados activos.
4. Guarda el comando.
   

Etapa 11: Comprobar las diferencias con los Empleados Activos

Al igual que con la lista de empleados completa, la lista de empleados activos filtrada que se ha convertido de XML a delimitada por pestañas debe convertirse a delimitada por comas.

1. Copia el comando Consulta avanzada - Todos los empleados.
2. Conecta el Out del Grupo de comandos al Consulta avanzada - Todos los empleados (Copiar) Comando. Si conectas el comando Consulta avanzada - Todos los empleados al Grupo de salida, te aseguras de que todo lo que esté conectado al Grupo de salida termine antes de que la cadena avance hacia los comandos del Grupo de salida.
3. Configura el Comando utilizando los siguientes valores:
   • Nombre..: Consulta Avanzada - Empleados Activos.

   • En la sección Tablas, modifica el parámetro Archivo para ambas tablas utilizando los siguientes valores:

     Tabla	Archivo
     XML	Salida de resultado CSV desde el comando Cambiar delimitador - Empleados Activos
     archivo .csv	Filtro inteligente Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro desde el Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro Filtro.

4. Guarda el comando.
   

Etapa 12: Evaluar el ejercicio

Ahora que la Cadena está completa, evalúa el resultado.

1. Publica en la Cadena.
2. Haz clic en Ejecutar y selecciona Ejecutar cadena. 
   
3. Una vez que la Cadena haya completado su ejecución, haz clic en el nodo Consulta Avanzada - Empleados Activos.
   1. En la pestaña Resultados, confirma que han salido 4 Registros.

   2. Haz clic en la pestaña Registros y confirma que los ID de los empleados coinciden con los de abajo para los registros devueltos por la consulta.

      ID de empleado 01-6875791 63-0417180 78-3600453 85-6818050

      
      

¡Para saber más sobre la transformación de datos mediante Cadenas, consulta Rutas de aprendizaje conectadas - Introducción a la transformación!