Mappning av data i APIcenter

Tänk dig olika appar som måste fungera tillsammans, men de är som pusselbitar som måste passa ihop. Det är där datakartläggning kommer in i bilden. Det är som en smart tolk som ser till att apparna förstår varandra, trots att de egentligen talar olika “språk” under ytan. Det här inlägget tar dig med på en upptäcktsresa genom datakartläggningens värld. Vi tittar på exakt vad det är, hur utvecklare använder det och hur APIcenter hjälper till. Vi tittar också på vilka typer av appar som APIcenter kan få att fungera tillsammans och hur du kan anpassa datamappning till de specifika behoven i ditt projekt. Kort sagt, en titt bakom kulisserna på hur man länkar appar!

Datakartläggning vid applikationslänkar

Datamappning används ofta i länkar mellan applikationer. Detta beror på att två olika applikationer har skrivits av två olika utvecklare. Det innebär att två applikationer kan se likadana ut, men under ytan kan de vara skrivna på helt olika sätt. Detta skapar ett stort gap när man försöker länka samman dessa applikationer. För att lösa detta problem måste utvecklaren som skapar integrationen skapa relationer mellan informationen i de två applikationerna. Detta är inte så svårt, men när du måste göra det för mer än 60+ applikationer blir det en omöjlig uppgift. I det här inlägget förklarar vi vad datamappning är, hur det används, hur APIcenter hanterar det, vilka typer av APIcenter som stöds och hur du kan anpassa datamappningen så att den bättre passar din arbetsprocess.

Kartläggning av källa och mål

På APIcenter tar vi alltid vårt eget perspektiv när vi designar ett dataflöde (flow). Det innebär att vi konsekvent tittar på två sidor. Å ena sidan har vi “get”-sidan (GET), där information hämtas. Å andra sidan har vi “skicka”-sidan (SEND), som tar emot information. För att förtydliga detta koncept kan vi ta en webbshop som exempel på mottagarsidan och en bokföringsapplikation på sändningssidan. I exemplen i det här inlägget används dessa två sidor för att illustrera principerna för mappning av källa och mål.

Punktnotation

Dot-notation är en teknik i programmeringsspråk som gör data tydliga och tillgängliga. Det gör det möjligt för användare att navigera genom komplexa datastrukturer utan djupgående programmeringskunskaper. På APIcenter använder vi dot-notation för att göra datastrukturer i både källapplikationen och målapplikationen begripliga. [Naam van het object][Naam van het attribuut] Ett standardformat för punktnotation är strukturerat enligt följande: . . . Om vi till exempel vill hämta namnet (name) på en kund (customer), skriver vi det som: customer.name. Den här metoden gör det också möjligt för oss att gå flera lager djupt. Om en kund t.ex. har en adress (address) med en gata (street), skulle detta noteras som: customer.address.street. Dessutom kan information innehålla flera objekt. Ett illustrativt exempel är när en kund har flera kontakter (contacts), vilket representeras av ett kolon (:). Till exempel: customer.contacts:name. Kolonet antyder att attributet “name” kan förekomma 0, 1 eller flera gånger.

Typer av datamappning i APIcenter

APIcenter använder tre typer av datamappning: ” direkt“, ” additiv“, ” transformativ” I exemplen nedan hämtas information från en webbshop och informationen skickas till ett redovisningssystem.

D irekt I den här typen av datamappning är data direkt relaterade till varandra. Som ett exempel har vi här en produkt med ett namn:

Tilläggsinformation, i den här typen, kopieras till andra fält för att ge ytterligare information till bokföringsprogrammet. Som exempel kan nämnas när leveransadressen saknas på kunden:

Detta görs för att ge så mycket information som möjligt till den sida som sänder. Även om den informationen inte används i slutändan.

TransformativDetta är när information läggs till, dras ifrån eller ändras i allmänhet. Till exempel när priserna på en order inte stämmer överens (inklusive eller exklusive skatt):

I datamappningen ovan framgår det tydligt att fälten inte är direkt angränsande, vilket kan leda till utmaningar när man skickar webbshoppsinformation direkt till bokföringen. APIcenter löser dock detta genom att beräkna det exklusiva skattepriset med hjälp av både det inkluderade skattepriset och skattebeloppet. Detta gör att värdefull information kan genereras för bokföringen, även om vissa uppgifter inte är lättillgängliga i webbshoppen. Detta tillvägagångssätt säkerställer att integrationen går smidigt utan att orsaka problem i bokföringen.

Datamappning på APIcenter: Ett unikt tillvägagångssätt

På APIcenter har vi en särskild strategi för att hantera datamappning. Istället för att mappa enskilda applikationer individuellt, relaterar APIcenter alla applikationsfält till sin egen datamodell. (En datamodell är en strukturerad representation av en enhet, t.ex. en produkt eller en kund). När det gäller webbshoppen, där informationen kommer från, ser datamappningen ut så här. APIcenter strävar efter att ansluta så många fält som möjligt till vår datamodell. Detta tillvägagångssätt säkerställer att en omfattande uppsättning information är tillgänglig för den andra applikationen, i det här fallet redovisning. Genom att följa denna metodik säkerställer APIcenter att en uppsjö av relevanta data finns tillgängliga för sömlös integration med andra applikationer.

För redovisning, dit informationen skickas, kan datamappningen se ut så här. Här väljs bara den information som behövs.

Efter att kunden (eller partnern) har valt vilka 2 applikationer de vill ha, slås de 3 datamodellerna samman. Detta kan sedan användas av APIcenter för att hämta och vidarebefordra information. Detta ser då ut så här:

Anpassningar av datamappning på APIcenter: Flexibilitet för din arbetsprocess

Som användare av APIcenter har du möjlighet att göra justeringar i datamappningen av ditt flöde. Även om APIcenter gör sitt yttersta för att fylla i båda sidor av länken så bra som möjligt, kan det hända att vissa fält inte passar sömlöst in i vår standardiserade datamodell. Dessutom kan anpassade fält ha skapats i kundmiljön som APIcenter kanske inte har kunnat identifiera. I sådana situationer erbjuder vi möjligheten att ändra de sammanslagna datamappningarna på en flödesbaserad basis. Ett konkret exempel på detta är när en kund föredrar att titeln på en produkt ska associeras med fältet “ProductDescription” istället för “Name”. En möjlig ändring av datamappningen skulle kunna se ut på följande sätt:

För att underlätta anpassningsprocessen har vi lagt till alla möjliga (standard) fältnamn som vi känner till eller kunde hitta. När du börjar skriva i inmatningsrutan söker APIcenter automatiskt efter möjliga fält som kan vara relevanta.

Anpassade applikationsfält

För anpassade fält som kan ställas in i kundens applikation känner vi inte automatiskt till deras existens. Men om du känner till programmeringsnamnet för ett sådant anpassat fält (som eventuellt är synligt i applikationen) kan du enkelt lägga till det i datamappningen.

Tullar/fria fält

För fält som inte har någon plats i APIcenters standardmodell introducerar vi “anpassade fält” (custom fields). I det här avsnittet kan du lägga till godtyckliga fält på båda sidor. Detta kan se ut så här:

Observera att vi erbjuder två typer av fria fält: “string” för fält med text och “value” för numeriska fält. Detta ger dig friheten att anpassa datamappningen och uppnå en sömlös integration som passar dina specifika behov.

Slutsats

För APIcenter är datakartläggning en mycket viktig del av den övergripande processen. Datamappningsprocessen gör det möjligt för oss att få flera applikationer att kommunicera smidigt med varandra. Eftersom fälten är sammanlänkade blir resultatet alltid detsamma efter en installation. Detta skapar stabilitet, minskar antalet fel och frigör tid för viktigare uppgifter.