XML

Med appen XML kan du analysera en XML-formaterad text via modulen XML > Parse XML och konvertera den till ett paket för att göra data tillgängliga för andra moduler. Du kan också konvertera ett paket till en XML-formaterad text via modulen XML > Create XML

Åtkomstkrav

Du måste ha följande åtkomst för att kunna använda funktionerna i den här artikeln:

Adobe Workfront plan*
Pro eller högre
Adobe Workfront licens*
Plan, Work
Adobe Workfront Fusion licens**

Aktuellt licenskrav: Inget Workfront Fusion-licenskrav.

eller

Gammalt licenskrav: Workfront Fusion för Automatisering och integrering av arbetet

Produkt

Aktuellt produktkrav: Om du har planen Select eller Prime Adobe Workfront måste din organisation köpa både Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln. Workfront Fusion ingår i planen Ultimate Workfront.

eller

Äldre produktkrav: Din organisation måste köpa Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln.

Kontakta Workfront-administratören om du vill ta reda på vilken plan, licenstyp eller åtkomst du har.

Mer information om Adobe Workfront Fusion licenser finns i Adobe Workfront Fusion licenser.

Parse XML

Modulen XML > Parse XML tolkar en XML-formaterad text och returnerar ett enskilt paket som innehåller all information som extraherats från XML.

Data structure

Datastrukturen beskriver XML-strukturen så att modulens utdata blir tillgängliga på mappningspanelen för följande moduler.

Om du har ett exempel på den XML som du vill analysera kan du använda den för att generera datastrukturen:

  1. Klicka på knappen Add.

  2. Klicka på knappen Generator.

  3. Kopiera och klistra in XML-exemplet i fältet Sample data.

  4. Klicka på Save.

  5. Kontrollera att datastrukturen har genererats.

  6. Klicka på knappen Save om du vill spara datastrukturen.

    Du kan hoppa över steg 2-5 för att tillhandahålla en tom datastruktur. Om datastrukturen är tom är modulens utdata inte tillgängliga på mappningspanelen förrän modulen har körts minst en gång.

Mer information finns i Datastrukturer i Adobe Workfront Fusion.

Preserve numbers as text
Aktivera det här alternativet för att säkerställa att tal förblir som textvärden (strängvärden). I annat fall byts tal ut mot talvärden.
XML

Ange eller mappa den XML-formaterade text som du vill analysera.

Om du använder en formel kontrollerar du att dess resultatvärdetyp är (eller kan tvingas till automatiskt) datatypen Text.

Om resultatvärdestypen är Buffer (binära data) använder du funktionen toString() för att konvertera den till datatypen Text. Mer information finns i Typtvång i Adobe Workfront Fusion och Objektdatatyper i Adobe Workfront Fusion.

INFO
Exempel: Så här hämtar du en XML-fil från en URL och tolkar innehållet:
  1. Skapa ett nytt scenario.

  2. Infoga HTTP > Get a file-modulen

  3. Öppna modulens konfiguration och konfigurera den enligt följande:

    URL: URL för XML-filen (t.ex. https://siftrss.com/f/rqLy05ayMBJ)

  4. Klicka på ​ OK för att spara och stänga modulens konfiguration.

  5. Lägg till XML > modulen Parse XML, anslut den efter modulen HTTP > Get a file och konfigurera den enligt följande:

table 0-row-2 1-row-2 layout-auto html-authored no-header
Data structure

>

  1. > Klicka på knappen Add.
  2. > Klicka på knappen Generator.
  3. > Öppna en ny flik eller ett nytt fönster i webbläsaren.
  4. > Placera den URL du använde i det tredje steget i adressfältet och hämta XML-filen.
  5. > Markera all XML-text och kopiera den till Urklipp.
  6. > Stäng fliken eller fönstret och gå tillbaka till ditt scenario.
  7. > Klistra in den kopierade XML-texten i datafältet Exempel.
  8. > Klicka på Save.
  9. > Kontrollera att datastrukturen har genererats.
  10. > Klicka på Save om du vill spara datastrukturen. >

Du kan hoppa över steg 2 till 9 för att tillhandahålla en tom datastruktur. Om datastrukturen är tom är modulens utdata inte tillgängliga på mappningspanelen förrän modulen har körts minst en gång.

XML

Mappa Data objektet från utdata från modulen HTTP > Get a file till fältet. Använd funktionen toString() för att konvertera dess värde från datatypen Buffer (binära data) till datatypen Text.

Du kan kopiera och klistra in formelns kod i fältet: {{toString(1.data)}}

Mer information om datatyperna Buffer och Text finns i Objektdatatyper i Adobe Workfront Fusion.

Parsing XML attributes

Som standard placerar modulen XML > Parse XML attribut i en särskild samling _attributes som underordnade noden som har dessa attribut. Om noden är en textnod och har attribut läggs två specialegenskaper till: _attributes för attribut och _value för nodens textinnehåll.

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

konverteras till det här paketet:

Skapa XML

Modulen XML > Create XML konverterar ett paket till en XML-formaterad text.

Data structure

Datastrukturen beskriver strukturen för den resulterande XML-filen. Om du har ett exempel på den XML som du vill skapa kan du använda den för att generera datastrukturen:

  1. Klicka på knappen Add.
  2. Klicka på knappen Generator.
  3. Kopiera och klistra in XML-exemplet i datafältet Exempel.
  4. Klicka på knappen Save.
  5. Kontrollera att datastrukturen har genererats.
  6. Klicka på Save om du vill spara datastrukturen.
Root element name
Ange namnet på XML-filens rotelement. Standardvärdet är root.
Doctype SYSTEM ID
Ange filnamnet som ska användas i deklarationen !DOCTYPE SYSTEM
Doctype PUBLIC ID
Ange filnamnet som ska användas i deklarationen !DOCTYPE PUBLIC
Strip Xml Declaration
Aktivera det här alternativet om du vill ta bort XML-deklarationen <?xml ... ?> och <!DOCTYPE ... > och bara lämna XML-rotelementet och dess innehåll.
INFO
Exempel:
Ett typiskt användningsfall är att omvandla data från ett Google >kalkylblad till XML.
  1. Placera modulen Google Sheets > Select rows i ditt scenario för att hämta data. Konfigurera modulen för att hämta rader från ditt Google-kalkylblad. Ställ in ​ Maximum number of returned rows på ett litet tal, men större än ett för testningsändamål (exempel, tre). Kör modulen Google Sheets genom att högerklicka på den och välja Run this module only. Kontrollera modulens utdata.
  2. Anslut modulen Array Aggregator efter modulen Google Sheets. Välj modulen Google Sheets i fältet Source node i modulens konfiguration. Låt de andra fälten vara som de är för tillfället.
  3. Anslut modulen XML > Create XML efter modulen Array Aggregator.
Modulens konfiguration kräver en datastruktur som beskriver strukturen för XML-utdata. Klicka på knappen Add för att öppna datastrukturinställningarna. Det enklaste sättet att skapa den här datastrukturen är att generera den automatiskt från ett XML-exempel.
  1. Klicka på knappen Generator och klistra in XML-exemplet i fältet Sample data:
  1. Klicka på Save. Fältet Specifikation i datastrukturen innehåller nu den genererade strukturen.
  2. Ändra namnet på datastrukturen till något mer specifikt och klicka på Save. Ett fält som motsvarar rotarrayattributet visas som ett mappningsbart fält i JSON-modulens inställningar.
  3. Klicka på knappen Map bredvid fältet och mappa Array[]-objektet från Array aggregator-utdata till det:
  4. Klicka på OK för att stänga XML-modulens inställningar.
  5. Öppna konfigurationen för modulen Array Aggregator. Ändra Target structure från anpassad till fältet i en XML-modul som motsvarar det överordnade XML-elementet.Mappa objekt från modulen Google Sheets till rätt fält.
  6. Klicka på OK för att stänga konfigurationen för modulen Array Aggregator.
  7. Kör scenariot.
XML-modulen matar ut rätt XML-fil.
  1. Öppna inställningarna för modulen Google Sheets och öka Maximum number of returned rows så att det blir större än antalet rader i kalkylbladet för att bearbeta alla data.
Resultatet av XML kan sparas i Dropbox, skickas som en bifogad fil via e-post, överföras via FTP till en server och så vidare.

Lägga till XML-attribut

Om du vill lägga till attribut i en komplex nod (en nod som ska innehålla andra noder) måste du lägga till en samling med namnet _attributes för den komplexa anteckningen i den anpassade datastrukturen. Samlingen mappas till nodattribut. Om du vill lägga till attribut i en textnod (till exempel: <node attr="1">abc</node>) måste du lägga till en samling _attributes för attribut och en textegenskap _value för nodvärdet för den här noden i din anpassade datastruktur.

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

Felsökning: Det går inte att mappa data från modulen Parse XML

Kontrollera att datastrukturen är korrekt definierad. Du kan också använda en tom datastruktur och köra modulen minst en gång för att bearbeta en XML-inmatning.

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