Arbeta med data och listor

Upprepa över en lista genom att använda ett loopblock

Ett Loop Block upprepas över objekten i en lista, vilket gör att åtgärderna i den kan upprepas för varje objekt. I parametern Looplista placerar du en JSON-nod som innehåller en lista. Loopblocket bearbetar ett objekt i listan åt gången. Anta till exempel att listan ser ut så här:

      {
        "Products": {
          "Ids": [
            {
              "Id": 1
            },
            {
              "Id": 2
            }
          ]
        }
      }
    

Varje upprepning av Loop Block får ett enskilt element, kapslat i listans struktur:

{
  "Products": {
    "Ids": {
      "Id": 1
    }
  }
}    

Åtgärder inom Loop Block har åtkomst till ett element åt gången.

Anteckning

För ett Loop Block som anropar en Omnistudio Data Mapper-transformation försämrar en lista med mer än 1000 objekt prestandan. Du kan använda en personsökningsstrategi för att dela upp långa listor.

Anteckning När Omnistudios standardruntime är inaktiverad och RollbackIPChanges är inställt till sant kan loopblock i en integreringsprocess resultera i att loopar körs inom andra loopar. För att lösa detta, se till att du har en integreringsprocess som innehåller en loop som åberopar en andra integreringsprocess med en inre loop, RollbackIPChanges är inställt till falskt eller Omnistudio standardruntime är aktiverat.

Anteckning När du aktiverar inställningen Inkludera alla åtgärder som svar för en integreringsprocess kan ett loopblock i integreringsprocessen inte bearbeta en matris av poster. Detta inträffar eftersom stepResultFinal överskrider storleken 1 och resulterar i ett fel:

Cannot Write Array to Root

Du kan använda ett Loop Block för att söka efter flera poster i ett Salesforce-objekt. Låt säga att du ville söka efter Kontakter med namnet "Miller" eller Torres. Du kan placera en åtgärd för extrahering av datamappning i ett loopblock och sedan skicka in en lista över namn i indataparametrarna.

Överväg följande JSON:

{
    "names": [
        {
            "Name": "Miller"
        },
        {
            "Name": "Torres"
        }
    ]
}

För att söka efter dessa namn i ett Loop Block:

1. Skapa ett extraherat datamappningsextrakt som väljer poster med Contact.LastName LIKE Name Filter.
2. Skapa en extraheringsåtgärd för datamappning i loopblocket med names:Name Datakälla och Name Filtervärde. Ange Datamappningsnamnet till namnet på Datamappningsextraktet.

När Loop Block körs använder Extrahering av datamappning varje Name från listan names i indata-JSON för att söka i Contact.LastName.

Koppla listor genom att använda en liståtgärd

Liståtgärden kopplar flera listor genom att matcha värden för specificerade JSON-noder för listobjekt. En grundläggande koppling matchar nodnamn exakt. En avancerad koppling matchar noder som har olika namn eller finns på olika nivåer i de inkommande listorna.

Indata till en liståtgärd måste båda vara i listformat även om listan endast innehåller ett objekt. Extraheringar av Omnistudio Data Mapper som returnerar en lista med ett objekt konverterar den ofta till ett enskilt objekt. För att konvertera ett enskilt objekt tillbaka till en lista kan du använda det första exemplet i Exempel på transformation i Omnistudio Data Mapper.

För fler alternativ för listbearbetning, se Listinmatning för Omnistudio Data Mappers och funktionerna AVG, FILTER, IF, LIST, LISTMERGE, LISTMERGEPRIMARY, LISTSIZE, MAX, MIN, SORTBY och SUM i funktionsreferensen.

För att matcha noder som har olika namn eller finns på olika nivåer i inkommande listor, klicka på Avancerad koppling och specificera inställningar för noderna som ska matchas, enligt följande:

• Listnyckel: Ange namnet på JSON-listnoden där noden som ska matchas finns.
• Matchande väg: Ange sökvägen i listan till noden som ska matchas.
• Matchande grupp: Specificera samma nummer för alla noder som du vill matcha.

Till exempel visar denna figur hur man matchar för- och efternamn från två inkommande listor där noderna har olika namn.