Introduktion till Custom data

Grundläggande koncept

Varje Plugboard-objekt har ett set av fält som representerar det specifika objektet, som Produkt, Order, Faktura och så vidare. Plugboard-objektet kan bytas ut med externa system via Connectors. Varje Connector har transformatorlogik för att tolka det externa systemets representation av objektet till Plugboard-objektet, i båda riktningarna.

När data finns på ett objekt (eller i relation till objektet) i ett externt system, kan det finnas situationer där data inte har någon motsvarande logisk plats i ett Plugboard-objekt. I sådana fall kan Anpassad data användas.

Illustration

Om vi zoomar in mellan Connectorn och Manipulator-kedjan i följande exempel ser vi ett Order-objekt. Här är ett exempel på hur vi kan importera order från ett externt system:

1. Plugboard läser ordern från det externa systemet via en Connector.
2. Connectorn tolkar ordern från det externa systemet till ett Plugboard-objekt.
3. Viss ytterligare data som inte kan lagras i det generiska Plugboard-objektet lagras som Anpassad data.
4. Objektet behandlas sedan av Manipulator-kedjan.
5. Slutligen lagras ordern i Plugboard, och väntar på vidare åtgärder.

Anatomie

För att ge ett mer tekniskt exempel på hur anpassad data kan se ut, kan vi titta på följande:

{
  "customData":{
    "5377568eb7e165e3b38af6eece4a0001|connector.woocommerce|meta._wc_klarna_environment":{
      "connectionId":"5377568eb7e165e3b38af6eece4a0001",
      "moduleId":"connector.woocommerce",
      "key":"meta._wc_klarna_environment",
      "type":"string",
      "value":"test"
    },
    "5377568eb7e165e3b38af6eece4a0001|connector.woocommerce|meta._wc_klarna_country":{
      "connectionId":"5377568eb7e165e3b38af6eece4a0001",
      "moduleId":"connector.woocommerce",
      "key":"meta._wc_klarna_country",
      "type":"string",
      "value":"SE"
    }
  }
}

Post

Varje tillgänglig anpassad data-post lever i customData-fältet med en unik sträng för att identifiera och komma åt den.

Modul-ID
Det modul-ID som denna post tillhör.

Nyckel
En unik nyckel inom modulen.

Typ
Datatypen för värdet. Det kan vara en av följande:

• string
• bool
• integer
• decimal
• json

Värde
Det specifika värdet som den anpassade datan ska hålla.

Vidare läsning

Läs mer om Custom data i Plugboard API och även hur du använder Data view  för att effektivt arbeta med anpassad data på objekt. Anpassad data kan också användas tillsammans med Processing rules.