XML

Die XML-App ermöglicht es, einen im XML-Format formatierten Text über das XML > Parse XML-Modul zu analysieren und in ein Bundle zu konvertieren, um die Daten für andere Module verfügbar zu machen. Sie können ein Bundle auch über das Modul XML > XML erstellen in einen Text im XML-Format konvertieren

Zugriffsanforderungen

Erweitern Sie , um die Zugriffsanforderungen für die -Funktion in diesem Artikel anzuzeigen.

Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Paket Beliebig
Adobe Workfront-Lizenz

Neu: Standard

Oder

Aktuell: Arbeit oder höher

Lizenz für Adobe Workfront Fusion** Keine Workfront Fusion-Lizenzanforderung
Produkt

Neu:

  • Prime oder Workfront auswählen: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.
  • Ultimate Workfront-Paket: Workfront Fusion ist enthalten.

Oder

Aktuell: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.

Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.

Informationen zu Adobe Workfront Fusion-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.

XML erstellen

Das Modul XML > XML erstellen konvertiert ein Bundle in einen Text im XML-Format.

-Datenstruktur

Die Datenstruktur beschreibt die Struktur der resultierenden XML. Wenn Sie über ein Beispiel für die XML verfügen, die Sie erstellen möchten, können Sie damit die Datenstruktur generieren:

  1. Klicken Sie auf die Schaltfläche Hinzufügen.
  2. Klicken Sie auf die Schaltfläche Generator.
  3. Kopieren Sie das XML-Beispiel und fügen Sie es in das Feld Beispieldaten ein.
  4. Klicken Sie auf die Schaltfläche Speichern.
  5. Stellen Sie sicher, dass die Datenstruktur erfolgreich generiert wurde.
  6. Klicken Sie auf Speichern, um die Datenstruktur zu speichern.
Stammelementname
Geben Sie den Namen des XML-Stammelements ein. Der Standardwert lautet root.
DOCTYPE SYSTEM-ID
Dateinamen eingeben, der in der !DOCTYPE SYSTEM verwendet werden soll
DOCTYPE PUBLIC ID
Dateinamen eingeben, der in der !DOCTYPE PUBLIC verwendet werden soll
Strip XML-Deklaration
Aktivieren Sie diese Option, um die XML-Deklaration <?xml ... ?> und <!DOCTYPE ... >zu entfernen und nur das XML-Stammelement und dessen Inhalte zu belassen.
recommendation-more-help

Beispiel:

Ein typischer Anwendungsfall besteht darin, Daten aus einer Google > Tabelle in XML umzuwandeln.

  1. Platzieren Sie das Modul Google Sheets > Zeilen auswählen in Ihrem Szenario, um die Daten abzurufen. Richten Sie das -Modul ein, um Zeilen aus Ihrer Google Tabelle abzurufen. Legen Sie ​ Maximale Anzahl der zurückgegebenen Zeilen auf eine kleine Anzahl fest, die zu Testzwecken jedoch größer als 1 ist (z. B. drei). Führen Sie das Google Sheets Modul aus, indem Sie mit der rechten Maustaste darauf klicken und "Nur dieses Modul ausführen auswählen. Überprüfen Sie die Ausgabe des Moduls.

  2. Verbinden Sie das Array Aggregator-Modul nach dem Google Sheets. Wählen Sie im Setup des Moduls das Google Sheets im Feld Source-Knoten aus. Lassen Sie die anderen Felder so, wie sie für den Moment sind.

  3. Verbinden Sie das Modul XML > XML erstellen nach dem Modul Array Aggregator.

    Die Einrichtung des Moduls erfordert eine Datenstruktur, die die Struktur der XML-Ausgabe beschreibt. Klicken Sie auf Hinzufügen, um die Einrichtung der Datenstruktur zu öffnen. Die einfachste Möglichkeit, diese Datenstruktur zu erstellen, besteht darin, sie automatisch aus einem XML-Beispiel zu generieren.

  4. Klicken Sie auf Generator und fügen Sie Ihr XML-Beispiel in das Feld Beispieldaten ein:

    Beispieldatenfeld

  5. Klicken Sie auf Speichern.

    Das Feld Spezifikation in der Datenstruktur enthält jetzt die generierte Struktur.

  6. Ändern Sie den Namen Ihrer Datenstruktur in etwas Spezifischeres und klicken Sie auf Speichern.

    Ein Feld, das dem Stamm-Array-Attribut entspricht, wird im Setup des JSON-Moduls als zuordnungsfähiges Feld angezeigt.

  7. Klicken Sie auf Map-Schaltfläche neben dem Feld und ordnen Sie das Array[] aus der Ausgabe des Array zu:

  8. Klicken Sie OK, um die Einrichtung des XML-Moduls zu schließen.

  9. Öffnen Sie das Setup des Moduls Array Aggregator. Ändern Sie die Zielstruktur von Benutzerdefiniert in das Feld eines XML-Moduls, das dem übergeordneten XML-Element entspricht. Ordnen Sie Elemente aus dem Google Sheets-Modul den entsprechenden Feldern zu.

  10. Klicken Sie OK, um die Einrichtung des Array Aggregator-Moduls zu schließen.

  11. Führen Sie das Szenario aus.

    Das XML-Modul gibt die richtige XML-Datei aus.

  12. Öffnen Sie die Einrichtung des Google Sheets und erhöhen Sie die Maximale Anzahl zurückgegebener Zeilen um größer als die Anzahl an Zeilen in Ihrer Tabelle zu sein, um alle Daten zu verarbeiten.

    Die resultierende XML kann in Dropbox gespeichert, als Anhang per E-Mail gesendet, per FTP auf einen Server hochgeladen usw. werden.

XML-Attribute hinzufügen

Wenn Sie Attribute zu einem komplexen Knoten (einem Knoten, der andere Knoten enthalten wird) hinzufügen möchten, müssen Sie eine Sammlung mit dem Namen _attributes für die komplexe Anmerkung in Ihrer benutzerdefinierten Datenstruktur hinzufügen. Diese Sammlung wird Knotenattributen zugeordnet. Wenn Sie Attribute zu einem Textknoten hinzufügen möchten (z. B.: <node attr="1">abc</node>), müssen Sie eine _attributes für Attribute und eine Texteigenschaft _value für den Knotenwert für diesen Knoten in Ihrer benutzerdefinierten Datenstruktur hinzufügen.

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

XML analysieren

Das Modul XML > Parse XML analysiert einen XML-formatierten Text und gibt ein einzelnes Bundle aus, das alle aus der XML extrahierten Informationen enthält.

-Datenstruktur

Die Datenstruktur beschreibt die Struktur der XML, um die Ausgabe des Moduls im Zuordnungsbereich für die folgenden Module verfügbar zu machen.

Wenn Sie über ein Beispiel für die XML verfügen, die Sie parsen möchten, können Sie sie zum Generieren der Datenstruktur verwenden:

  1. Klicken Sie auf die Schaltfläche Hinzufügen.

  2. Klicken Sie auf die Schaltfläche Generator.

  3. Kopieren Sie das XML-Beispiel und fügen Sie es in das Feld Beispieldaten ein.

  4. Klicken Sie auf Speichern.

  5. Stellen Sie sicher, dass die Datenstruktur erfolgreich generiert wurde.

  6. Klicken Sie auf die Schaltfläche Speichern, um die Datenstruktur zu speichern.

    Sie können die Schritte 2-5 überspringen, um eine leere Datenstruktur bereitzustellen. Wenn die Datenstruktur leer ist, ist die Ausgabe des Moduls erst dann im Zuordnungsbereich verfügbar, wenn das Modul mindestens einmal ausgeführt wurde.

Weitere Informationen finden Sie unter Datenstrukturen.

Zahlen als Text beibehalten
Aktivieren Sie diese Option, um sicherzustellen, dass Zahlen als Text-(String-)Werte erhalten bleiben. Andernfalls werden Zahlen in Zahlenwerte umgewandelt.
XML

Geben Sie den XML-formatierten Text ein, den Sie analysieren möchten, oder ordnen Sie ihn zu.

Wenn Sie eine Formel verwenden, stellen Sie sicher, dass ihr Ergebniswerttyp der Datentyp Text ist (oder automatisch konvertiert werden kann).

Wenn der Ergebniswerttyp Buffer (Binärdaten) ist, konvertieren Sie ihn mit der Funktion toString() in den Datentyp Text . Weitere Informationen finden Sie unter Typzwang und Datentypen.

Beispiel:

So laden Sie eine XML-Datei von einer URL herunter und analysieren ihren Inhalt:

  1. Erstellen Sie ein neues Szenario.

  2. Fügen Sie das Modul HTTP > Datei ​" hinzu

  3. Öffnen Sie die -Konfiguration des Moduls und konfigurieren Sie sie wie folgt:

    URL: URL der XML-Datei (z. B. https://siftrss.com/f/rqLy05ayMBJ)

    Beispiel für URL einer XML-Datei

  4. Klicken Sie auf OK, um die Konfiguration des Moduls zu speichern und zu schließen.

  5. Fügen Sie das Modul XML > Parse XML hinzu, verbinden Sie es nach dem Modul HTTP > Datei abrufen und konfigurieren Sie es wie folgt:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    -Datenstruktur
    1. Klicken Sie auf die Schaltfläche Hinzufügen.
    2. Klicken Sie auf die Schaltfläche Generator.
    3. Öffnen Sie in Ihrem Webbrowser eine neue Registerkarte oder ein neues Fenster.
    4. Fügen Sie die im dritten Schritt verwendete URL in die Adressleiste ein und rufen Sie die XML-Datei ab.
    5. Wählen Sie den gesamten XML-Text aus und kopieren Sie ihn in die Zwischenablage.
    6. Schließen Sie die Registerkarte oder das Fenster und kehren Sie zu Ihrem Szenario zurück.
    7. Fügen Sie den kopierten XML-Text in das Feld Beispieldaten ein.
    8. Klicken Sie auf Speichern.
    9. Stellen Sie sicher, dass die Datenstruktur erfolgreich generiert wurde.
    10. Klicken Sie auf Speichern, um die Datenstruktur zu speichern.

    Sie können die Schritte 2 bis 9 überspringen, um eine leere Datenstruktur bereitzustellen. Wenn die Datenstruktur leer ist, ist die Ausgabe des Moduls erst dann im Zuordnungsbereich verfügbar, wenn das Modul mindestens einmal ausgeführt wurde.

    XML

    Ordnen Sie das Data Element aus der Ausgabe des Moduls HTTP > Datei abrufen dem Feld zu. Verwenden Sie die toString()-Funktion, um ihren Wert vom Datentyp Buffer (Binärdaten) in den Datentyp Text zu konvertieren.

    Sie können den Code der Formel kopieren und in das Feld einfügen: {{toString(1.data)}}

    Weitere Informationen zu den Datentypen „Puffer“ und „Text“ finden Sie unter Elementdatentypen.

Analysieren von XML-Attributen

Standardmäßig fügt das Modul XML > Parse XML Attribute in eine spezielle _attributes ein, die dem Knoten untergeordnet ist, der diese Attribute aufweist. Wenn es sich bei dem Knoten um einen Textknoten handelt und er über Attribute verfügt, werden zwei spezielle Eigenschaften hinzugefügt: _attributes für Attribute und _value für den Textinhalt des Knotens.

Beispiel: Diese XML:

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

wird in dieses Bundle konvertiert:

XML in Bundle konvertiert

Fehlerbehebung: Daten aus dem Modul XML analysieren“ können nicht ​ werden

Stellen Sie sicher, dass die Datenstruktur korrekt definiert ist. Alternativ können Sie eine leere Datenstruktur verwenden und das Modul mindestens einmal ausführen, um eine XML-Eingabe zu verarbeiten.

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