XML

La aplicación XML permite analizar un texto con formato XML mediante el módulo XML > Parse XML y convertirlo en un paquete para que los datos estén disponibles para otros módulos. También puede convertir un paquete en texto con formato XML a través del módulo XML > Create XML

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
paquete de Adobe Workfront Cualquiera
Licencia de Adobe Workfront

Nuevo: estándar

O

Actual: Trabajo o superior

Licencia de Adobe Workfront Fusion** No se requiere licencia de Workfront Fusion
Producto

Nuevo:

  • Seleccione o paquete de Prime Workfront: su organización debe adquirir Adobe Workfront Fusion.
  • Paquete de Ultimate Workfront: Workfront Fusion está incluido.

O

Actual: Su organización debe comprar Adobe Workfront Fusion.

Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.

Para obtener información sobre las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.

Crear XML

El módulo XML > Crear XML convierte un paquete en texto con formato XML.

Data structure

La estructura de datos describe la estructura del XML resultante. Si tiene un ejemplo del XML que desea crear, puede utilizarlo para generar la estructura de datos:

  1. Haga clic en el botón Add.
  2. Haga clic en el botón Generator.
  3. Copie y pegue el XML de muestra en el campo Datos de muestra.
  4. Haga clic en el botón Save.
  5. Compruebe que la estructura de datos se haya generado correctamente.
  6. Haga clic en Save para guardar la estructura de datos.
Root element name
Introduzca el nombre del elemento raíz del XML. El valor predeterminado es root.
Doctype SYSTEM ID
Escriba el nombre de archivo que se usará en la declaración !DOCTYPE SYSTEM
Doctype PUBLIC ID
Escriba el nombre de archivo que se usará en la declaración !DOCTYPE PUBLIC
Strip Xml Declaration
Active esta opción para quitar la declaración XML <?xml ... ?> y <!DOCTYPE ... > y dejar solamente el elemento raíz XML y su contenido.
recommendation-more-help

Ejemplo:

Un caso de uso típico es transformar datos de una hoja de cálculo de Google > en XML.

  1. Coloque el módulo Google Sheets > Seleccionar filas en su escenario para recuperar los datos. Configure el módulo para recuperar filas de la hoja de cálculo de Google. Establezca el Número máximo de filas devueltas en un número pequeño, pero mayor que uno para realizar pruebas (por ejemplo, tres). Ejecute el módulo de Google Sheets haciendo clic con el botón secundario en él y eligiendo "Ejecutar este módulo solamente". Compruebe la salida del módulo.

  2. Conecte el módulo Agregador de matrices después del módulo Google Sheets. En la configuración del módulo, elija el módulo de Google Sheets en el campo Nodo de origen. Deje los demás campos tal como están por el momento.

  3. Conecte el módulo XML > Crear XML después del módulo Agregador de matrices.

    La configuración del módulo requiere una estructura de datos que describa la estructura de la salida XML. Haga clic en el botón Añadir para abrir la configuración de la estructura de datos. La forma más sencilla de crear esta estructura de datos es generarla automáticamente a partir de un ejemplo XML.

  4. Haga clic en el botón Generador y pegue el XML de ejemplo en el campo Datos de muestra:

    Campo de datos de muestra

  5. Haga clic en Guardar.

    El campo Especificación de la estructura de datos contiene ahora la estructura generada.

  6. Cambie el nombre de la estructura de datos por otro más específico y haga clic en Guardar.

    Un campo correspondiente al atributo de la matriz raíz aparece como un campo asignable en la configuración del módulo JSON.

  7. Haga clic en el botón Asignar que está al lado del campo y asígnele el elemento Array[] de la salida del Agregador de matrices:

  8. Haga clic en Aceptar para cerrar la configuración del módulo XML.

  9. Abra la configuración del módulo Agregador de matrices. Cambie la estructura de destino del campo personalizado a un campo del módulo XML correspondiente al elemento XML principal. Asigne elementos del módulo de Google Sheets a los campos apropiados.

  10. Haga clic en Aceptar para cerrar la configuración del módulo Agregador de matrices.

  11. Ejecute el escenario.

    El módulo XML genera el archivo XML correcto.

  12. Abra la configuración del módulo Google Sheets y aumente el número Máximo número de filas devueltas para que sea mayor que el número de filas de la hoja de cálculo y procesar todos los datos.

    El XML resultante se puede guardar en Dropbox, enviar como archivo adjunto por correo electrónico, subir por FTP a un servidor, etc.

Adición de atributos XML

Si desea añadir atributos a un nodo complejo (un nodo que contendrá otros nodos), debe añadir una colección con el nombre _attributes para la nota compleja en la estructura de datos personalizada. Esta colección se asignará a atributos de nodo. Si desea añadir atributos a un nodo de texto (por ejemplo: <node attr="1">abc</node>), debe añadir una colección _attributes para atributos y una propiedad de texto _value para el valor del nodo para este nodo en la estructura de datos personalizada.

{
   "name": "node",
   "type": "collection",
   "spec": [
      {
         "name": "_attributes",
         "type": "collection"
         "spec": [
            {
               "name": "attr1",
               "type": "text"
            }
         ]
      },
      {
         "name": "_value",
         "type": "text"
      }
   ]
}

Analizar XML

El módulo XML > Analizar XML analiza un texto con formato XML y genera un solo paquete que contiene toda la información extraída del XML.

Data structure

La estructura de datos describe la estructura del XML para que la salida del módulo esté disponible en el panel de asignación para los siguientes módulos.

Si tiene una muestra del XML que desea analizar, puede utilizarla para generar la estructura de datos:

  1. Haga clic en el botón Add.

  2. Haga clic en el botón Generator.

  3. Copie y pegue la muestra de XML en el campo Sample data.

  4. Haga clic en Save.

  5. Compruebe que la estructura de datos se haya generado correctamente.

  6. Haga clic en el botón Save para guardar la estructura de datos.

    Puede omitir los pasos 2-5 para proporcionar una estructura de datos vacía. Si la estructura de datos está vacía, la salida del módulo no estará disponible en el panel de asignación hasta que el módulo se haya ejecutado al menos una vez.

Para obtener más información, consulte Estructuras de datos.

Preserve numbers as text
Habilite esta opción para garantizar que los números permanezcan como valores de texto (cadena). De lo contrario, los números se convertirán en valores numéricos.
XML

Introduzca o asigne el texto con formato XML que desee analizar.

Si usa una fórmula, asegúrese de que su tipo de valor resultante sea el tipo de datos Text (o se pueda forzar automáticamente a dicho tipo de datos).

Si el tipo de valor resultante es Buffer (datos binarios), use la función toString() para convertirlo al tipo de datos de texto. Para obtener más información, vea Coerción de tipos y Tipos de datos de elementos.

Ejemplo:

Para descargar un archivo XML desde una dirección URL y analizar su contenido:

  1. Cree un nuevo escenario.

  2. Agregar el módulo HTTP > Obtener un archivo

  3. Abra la configuración del módulo y configúrelo de la siguiente manera:

    URL: URL del archivo XML (p. ej., https://siftrss.com/f/rqLy05ayMBJ)

    Ejemplo de URL del archivo XML

  4. Haga clic en Aceptar para guardar y cerrar la configuración del módulo.

  5. Añada el módulo XML > Analizar XML, conéctelo después del módulo HTTP > Obtenga un archivo y configúrelo de la siguiente manera:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Data structure
    1. Haga clic en el botón Add.
    2. Haga clic en el botón Generator.
    3. En el explorador web, abra una nueva pestaña o ventana.
    4. Coloque la dirección URL que utilizó en el tercer paso en la barra de direcciones y recupere el archivo XML.
    5. Seleccione todo el texto XML y cópielo en el portapapeles.
    6. Cierre la pestaña o la ventana y vuelva a su escenario.
    7. Pegue el texto XML copiado en el campo Datos de muestra.
    8. Haga clic en Save.
    9. Compruebe que la estructura de datos se haya generado correctamente.
    10. Haga clic en Save para guardar la estructura de datos.

    Puede omitir los pasos del 2 al 9 para proporcionar una estructura de datos vacía. Si la estructura de datos está vacía, la salida del módulo no estará disponible en el panel de asignación hasta que el módulo se haya ejecutado al menos una vez.

    XML

    Asigne el elemento Data de la salida del módulo HTTP > Get a file al campo. Utilice la función toString() para convertir su valor del tipo Buffer (datos binarios) al tipo de datos Text.

    Puede copiar y pegar el código de la fórmula en el campo: {{toString(1.data)}}

    Para obtener más información sobre los tipos de datos de texto y búfer, vea Tipos de datos de elementos.

Análisis de atributos XML

De manera predeterminada, el módulo XML > Analizar XML coloca los atributos en una colección especial _attributes como elemento secundario del nodo que tiene estos atributos. Si el nodo es un nodo de texto y tiene atributos, se añaden dos propiedades especiales: _attributes para los atributos y _value para el contenido de texto del nodo.

Ejemplo: este XML:

<root attr="1">
<node attr="ABC">Hello, World</node>
</root>

se convierte en este paquete:

XML convertido en paquete

Solución de problemas: no se pueden asignar datos del módulo Analizar XML

Asegúrese de que la estructura de datos está definida correctamente. También puede utilizar una estructura de datos vacía y ejecutar el módulo al menos una vez para procesar una entrada XML.

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3