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. Agregar una nueva cadena , y asignarle un nombre: CLP | Acceso a datos XML.
2. Crea dos variables de Cadena como sigue:
   1. En Chain Variables, haga clic dos veces en el signo más (+).
   2. Utilice los siguientes nombres y valores para las variables:
      • Variable XML
        • Nombre: cv-XML-Employee
        • Valor: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employees.xml
      • Variable CSV
        • Nombre: cv-CSV-Employee
        • 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. Configure 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. Configure 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. Conecte el comando GET - Recuento de personal en formato XML al comando Lista de elementos en CSV .
3. Configure el Comando utilizando los siguientes valores:
   • Para el parámetro Archivo de entrada , seleccione la salida de respuesta del comando GET - Recuento en formato XML .
   • Deja en blanco el parámetro Entrada Texto.
   • Para el parámetro Path to root , introduzca la siguiente información del sobre:
     /employee_data/employee
   • Marque la casilla de verificación del parámetro Vista previa de resultados .

   • Para la sección Columnas , haga clic 12 veces en el botón Agregar .
     Para cada una de las columnas agregadas, introduzca el nombre del campo del registro de datos Introducido en la Etapa previa en los campos Column Name 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 multivalor, introduzca 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. Configure el Comando utilizando los siguientes valores:
   • Nombre: Cambiar Delimitador - Todos los Empleados
   • Archivo de entrada: Archivo convertido 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

Utilice Advanced Query 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 el 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:
     • Especifique el CSV Resultado Salida del Cambiar Delimitador - Todos los Empleados Comando.
     • Especifica XML como Nombre de tabla .
   • Para la segunda tabla:
     • Especifique la salida de respuesta del comando GET - Recuento en formato CSV .
       Especifique CSV como Nombre de la Tabla .
     • En el parámetro Consulta, introduzca lo siguiente: 
       Select * from XML EXCEPT Select * from 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.

   Identificación del 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. Configure el Comando utilizando los siguientes valores:
   • Nombre el Comando: Filtrar Filas Inteligentes - Datos CSV - Empleados Activados.
   • Para el parámetro Archivo de entrada , seleccione la salida de respuesta  del comando GET - Recuento en formato CSV.
   • Deja en blanco el parámetro Resultado: archivo.
   • Especifica Coma como Delimitador.
   • En la sección Filtros complete las siguientes etapas:
     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 true ( es decir, contiene "false" o está en blanco).
4. Deje marcada la opción Vista previa de resultados .
5. La opción Inversa permite que el Filtro Inteligente mantenga (marcada) o quite (desmarcada) todas las Filas que coincidan con los criterios del filtro. En este ejercicio, queremos conservar todas las Filas en las que el campo "denominado" tiene un valor de verdadero o en blanco.
   Para ello, marque (active) la casilla Inverse .
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 ("termed") que está 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. Configure el Comando utilizando los siguientes valores:
   • Nombre el Comando: Filtrar Filas Inteligentes - Datos CSV - Empleados Activados.
   • Para Archivo de entrada, seleccione la Salida de respuesta del comando GET - Recuento 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 true ( es decir, contiene "false" o está en blanco).
   • Deje marcada la casilla de verificación Vista previa de resultados .
   • La opción Inversa permite que el Filtro Inteligente mantenga (marcada) o quite (desmarcada) todas las Filas que coincidan con los criterios del filtro. En este ejercicio, queremos conservar todas las filas en las que el campo denominado tenga un valor de verdadero o esté en blanco. Para ello, marque (active) la casilla Inverse .
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. Copiar la Lista de Elementos a CSV - Todos los Empleados Comando.
2. Conecte el Grupo Inicio del Grupo de Comando a la Lista de Elementos a CSV - Todos los Empleados (Copiar) Comando.
3. Edite el Comando, dándole un nombre: Lista de Elementos a CSV - Empleados Activados.
4. En el parámetro "Ruta a la raíz", introduzca lo siguiente.
   /employee_data/employee[termed!='true']
   De este modo se identificará cualquier registro en el que el campo "termed" no contenga un valor de true ( es decir, contiene "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. Configure el Comando utilizando los siguientes valores.
   • Nombre: Cambiar Delimitador - Empleados Activada.
   • 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. Configure el Comando utilizando los siguientes valores:
   • Nombre: Consulta Avanzada - Empleados Activados.

   • En la sección Tablas , modifique 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 tenga completada su ejecución, haga clic en el nodo Consulta Avanzada - Empleados Activados .
   1. En la pestaña Salidas , confirme 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.

      Identificación del empleado 01-6875791 63-0417180 78-3600453 85-6818050

      
      

¡Para obtener más información sobre la transformación de datos mediante cadenas, consulte la página Connected Learning Paths - Transformation Introduction!