XML

La aplicación XML le permite analizar un texto con formato XML a través del módulo XML > Analizar 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 > Crear XML

Requisitos de acceso

Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:

Adobe Workfront plan*
Pro o superior
Adobe Workfront licencia*
Plan, Trabajo
Adobe Workfront Fusion licencia**

Requisito de licencia actual: no se requiere licencia de Workfront Fusion.

O

Requisito de licencia heredado: Workfront Fusion para automatización e integración de trabajo

Product

Requisito de producto actual: si tiene el plan Select o Prime Adobe Workfront, su organización debe adquirir Adobe Workfront Fusion así como Adobe Workfront para utilizar la funcionalidad descrita en este artículo. Workfront Fusion está incluido en el plan Workfront de Ultimate.

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion y Adobe Workfront para utilizar la funcionalidad descrita en este artículo.

Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.

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

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.

Estructura de datos

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 un ejemplo del XML que desea analizar, puede utilizarlo para generar la estructura de datos:

  1. Haga clic en el botón Agregar.

  2. Haga clic en el botón Generator.

  3. Copie y pegue el ejemplo XML en el campo Sample data.

  4. Haga clic en Guardar.

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

  6. Haga clic en el botón Guardar 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, vea Estructuras de datos en Adobe Workfront Fusion.

Conservar números como texto
Active esta opción para asegurarse de que los números permanecen como valores de texto (cadena). De lo contrario, los números se convierten 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 de resultado es (o se puede forzar automáticamente) el tipo de datos Text.

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

INFO
Ejemplo: Para descargar un archivo XML desde una dirección URL y analizar su contenido:
  1. Cree un nuevo escenario.

  2. Insertar HTTP > Obtener un archivo módulo

  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)

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

  5. Agregue 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
Estructura de datos

>

  1. > Haga clic en el botón Agregar.
  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 ejemplo.
  8. > Haga clic en Guardar.
  9. > Compruebe que la estructura de datos se ha generado correctamente.
  10. > Haga clic en Guardar 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 desde la salida del módulo HTTP > Obtener un archivo 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, consulte Tipos de datos de elementos en Adobe Workfront Fusion.

Analizando 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 agregan dos propiedades especiales: _attributes para los atributos y _value para el contenido de texto del nodo.

INFO
Ejemplo: Este XML:
<root attr="1">
<node attr="ABC">Hello, World</node>
</root>

se convierte en este paquete:

Crear XML

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

Estructura de datos

La estructura Data 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 Agregar.
  2. Haga clic en el botón Generator.
  3. Copie y pegue el ejemplo XML en el campo Datos de ejemplo.
  4. Haga clic en el botón Guardar.
  5. Compruebe que la estructura de datos se ha generado correctamente.
  6. Haga clic en Guardar para guardar la estructura de datos.
Nombre del elemento raíz
Introduzca el nombre del elemento raíz del XML. El valor predeterminado es root.
Doctype ID DEL SISTEMA
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 Statement
Habilite esta opción para quitar la declaración XML <?xml ... ?> y <!DOCTYPE ... > y dejar solamente el elemento raíz XML y su contenido.
INFO
Ejemplo:
Un caso de uso típico es transformar datos de una hoja de cálculo 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 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 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 Array Aggregator después del módulo Google Sheets. En la configuración del módulo, elija el módulo Google Sheets en el campo nodo Source. 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 Agregar 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.
  1. Haga clic en el botón Generador y pegue la muestra XML en el campo Datos de ejemplo:
  1. Haga clic en Guardar. El campo Especificación (Specification) de la estructura de datos contiene ahora la estructura generada.
  2. 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 matriz raíz aparece como un campo asignable en la configuración del módulo JSON.
  3. Haga clic en el botón Map que está al lado del campo y asigne el elemento Array[] de la salida del agregador de matrices Array a él:
  4. Haga clic en Aceptar para cerrar la configuración del módulo XML.
  5. 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 Google Sheets a los campos apropiados.
  6. Haga clic en Aceptar para cerrar la configuración del módulo Array Aggregator.
  7. Ejecute el escenario.
El módulo XML genera el archivo XML correcto.
  1. Abra la configuración del módulo Google Sheets y aumente el número Máximo 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, cargar por FTP a un servidor, etc.

Adición de atributos XML

Si desea agregar atributos a un nodo complejo (un nodo que contendrá otros nodos), debe agregar 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 agregar atributos a un nodo de texto (por ejemplo: <node attr="1">abc</node>), debe agregar 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"
      }
   ]
}

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.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43