Kom igång

Introduktion till Manipulatorer

Grundläggande koncept

Manipulatorer är ett kraftfullt verktyg för att modifiera data vid import och export i Plugboard. På Connectors finns inställningar som i viss utsträckning styr hur Plugboard ska hantera, omvandla och mappa data från externa system till Plugboards representation.

Utöver detta kan du även lägga till en eller flera manipulatorer på en Connector för att lägga till ytterligare ett lager av modifiering för objekten som passerar genom den. Flera regler kan bilda en manipulationskedja, där varje regel arbetar med det aktuella objektets tillstånd i varje steg av kedjan.

Typer

Manipulatorer är indelade i flera kategorier beroende på kärnobjekt. Det innebär att det finns olika regler för exempelvis Produkter, Order och Fakturor.

Riktning

Generellt kan alla tillgängliga regler läggas till antingen vid import, export eller båda. Det beror på den specifika användningen och hur du vill att reglerna ska tillämpas i din övergripande setup.

Inställningar

Varje manipulator har en egen uppsättning inställningar. Vilka inställningar som finns beror på den specifika regeln. För en mer detaljerad beskrivning, se informationen om varje individuell manipulator.

Villkor

Konceptet villkor är viktigt i sammanhanget med manipulatorer. Ett villkor fungerar precis som det låter – det måste uppfyllas för att en regel ska tillämpas. Du kan lägga till ett eller flera villkor på en regel för att Plugboard ska veta om regellogiken ska användas för ett visst objekt. Läs mer om villkor här.

Sortering

Eftersom du kan lägga till flera manipulatorer har du även möjlighet att ändra ordningen på dem. Plugboard följer denna ordning exakt, och varje regel exekveras i den angivna ordningen. Detta är viktigt att förstå eftersom objektet kan förändras i varje steg – varje manipulator får objektets tillstånd från den föregående.

Illustrationer

Import

Vid import av data tillämpas reglerna efter att Connectorn och dess inställningar har bearbetat objektet. Det innebär att det objekt som skickas vidare till regelkedjan är i det tillstånd som Connectorn har skapat.

Manipulator_infrastructure__Import_.png

Export

Vid export av data tillämpas reglerna före att Connectorn och dess inställningar appliceras. Det innebär att det dataobjekt som skickas vidare till regelkedjan är objektets tillstånd i Plugboard innan Connectorn har bearbetat det.

Manipulator_infrastructure__Export_.png

Bästa praxis

Här är några råd:

  • Ge dina manipulatorer ett väl genomtänkt namn.
  • Skriv en kort notering om regeln – det kan vara användbart i framtiden när du eller någon annan behöver förstå vad regeln gör och varför.
  • Tänk noggrant igenom om manipulatorn bör användas på import-sidan eller export-sidan, och ta hänsyn till det stora perspektivet.

Vidare läsning

Vissa manipulatorer kan arbeta med Anpassad data, vilket är ett annat kraftfullt koncept.  Läs mer om Custom data och användning av Data view