Support

Tabell: ITA

Lanserad i version: 2.3.10

Integrationstabeller är kopplingen mellan en integration (Ex. Shopify) och en tabell i Atynios. Här definieras vad som ska importeras/exporteras, när det ska utföras och hur det ska utföras. Detta används sedan för Atynios integrationsmotor.

Skapa en ny integrationstabell

Börja med att gå till den integration du önskar hantera. Välj sedan plustecknet för att få upp dialogrutan.

För att skapa en ny integration mot en tabell behöver följande anges:

Tabell - Vilken tabell i Atynios som ska integreras. Om någon tabell är ljusgrå saknas stöd i aktuell integration
Scope - Ange en förutbestämd inställning för integrationen. För den avancerade inställningen välj Empty och bygg/konfigurera precis som du önskar. Eller välj en förvald mall. Denna går även att skräddarsy efter att den skapats. En beskrivning av valt scope ses under.
Schemalagd aktivitet - Ange om det i samband med skapandet av kopplingen även ska schemaläggas att integrationen ska köras. Exemepelvis att artiklar ska syncas en gång per dygn.
"Schemalägg inte" - Skapar förslag på scheman för integrationen men intervall för körning behöver sättas. Använd detta om du vill förhandsgranska/justera integrationen före sync.
"Schemalägg och starta" - Skapar förslag på scheman med en intervall samt initerar körningen direkt. Det gör att syncen startar direkt och börjar hämta/exportera data. Används om du är nöjd med standardinställningen. Beroende på volymen som ska syncas kan detta steg ta lite tid.

När du är nöjd tryck på knappen "Sätt upp integration". Systemet kommer att börja arbeta. Observera att det kan ta långt tid om även sync mot källan utförs.

Olika typer av kopplingar

ITA - Integration Table
IPS - Import Posts Schedule

Atynios avgör själv vilken typ av koppling som kommer ske utifrån vilken tabell som integreras. För kundorder (COR) och inköpsorder (VPO) används alltid IPS. För alla andra typer används ITA.

Övervaka och administrera

All hantering av integrationstabellerna kräver förhöjd behörighet. Var observant på att göra förändringar - det kan leda till att data skrivs över i Atynios eller det externa systemet på ett oavsiktligt sätt.

Allmänt

Den första fliken, allmänt, är tillgänglig för både ITA och IPS-kopplingar.

Här ses generell information såsom senaste sync och antal kopplade poster, men även mer detaljerad information om schemalagda aktivteter.

Schemalagda aktivteter

En integrationstabell kan ha en eller flera schemalagda aktivteter. Aktivitet ställs in att köras en viss tidpunkt och utföra en åtgärd:

Alla (Syncar om alla poster mellan Atynios och den externa källan)
Endast nya ändringar (Syncar bara om de som ändrats sedan senaste körningen).
Alla lagersaldon (Endast för tabellen ART). Överför lagersaldo från Atynios till den externa källan.

Åtgärd kan endast sättas för ITA-poster, inte för IPS-poster.

Det går att lägga till nya aktiviteter genom + tecknet.

Logg

Varje körning genererar en post i loggen. Här ses tidsstämpel, eventuella fel, trigger (vem som initerade körningen), scope (omfattningen av syncen) samt körtid i sekunder. Logg över antal skapade, uppdaterade, ignorerade och felaktiga poster ses. Klicka på de tre prickarna längst till höger för att kunna ladda ner en komplett körfil för importen. Loggar och loggfiler raderas efter en viss tid.

Inställningar

Fliken inställningar har tre underflikar. När någon inställning ändras sätts de inte i produktion direkt utan du kan göra flera ändringar i lugn och ro - när du sedan är redo att sätta de i produktion trycker du på den stora gröna knappen längst ner på sidan under inställningar. Denna knapp ses inte om inga ändringar har skett.

Inställningar allmänt (Endast ITA)

Ange om data ska importeras och/eller exporteras från aktuell instans av Atynios till den externa källan. Följande inställningar finns sedan för import respektive export:

Regel för poster

Regel för hantering av poster - Ange en beräkning i FileMaker syntax. Det utvärderas i kontexten till målimporten. Om värdet är 1 / True kommer posten att hanteras. 0 / False hanteras den inte. Om ingen beräkning anges kommer alla poster att hanteras.
Skapa poster - Ja: Nya poster får skapas
Uppdatera poster - Ja: Poster får uppdateras.
Inaktivera poster - Ja: Poster får inaktiveras (Exemeplvis ej aktiva artiklar i Shopify blir inaktiverade i Atynios)

Regel för fält

Överför tomma värden - Om värdet som ska importeras/exporteras är tomt, skriver det inte över värdet på andra sidan.
Skriv över befintliga värden - Om fältet som ska skrivas över redan innehåller ett värde (dvs ej tomt) skrivs det inte över.

Inställningar fält (Endast ITA)

Här anges vilka fält som ska importeras/exporteras. Listan består av alla fält som finns i Atynios för tabellen.

Välj status för import/export för varje post genom de tre prickarna:

Brun: Ignorerar posten
Grön: Importerar värdet
Blå: Jämför och importerar värdet. (Endast import). Dvs vid import görs först en sökning på importvärdet från den externa källan. Om en träff finns kopplas posten ihop med den externa datakällan. Om inte skapas en ny post som kopplas. Flera fält kan anges som blåa.

Observera att om en eller flera fält för import är blåa (Jämför och importera värdet) måste samtliga dessa fält ha ett värde från extern källa. I annat fall kan inte en jämförelse ske som kan avgöra om posten redan finns eller inte. Exempelvis sync av artiklar mot Shopify där Shopify SKU ofta är en jämförelsefält i Atynios - men Shopify kräver inte att SKU måste anges för att skapa en variant.

För blåa eller gröna fält kan man även ange en beräkning, klicka på ikonen för matematiska tecken. Här kan en FileMaker syntax anges. Det används för att ersätta som ska importeras/exporteras eller göra om värdet.

I extern datakälla anges sökvägen / fältnamn. Följande används:

Shopify

GraphQL utifrån följande:

ART: productVariant
ORG: companies

Fel

Ett importfält skulle kunnat raderas och/eller byta namn i en framtida version av Atynios. I så fall går det inte att sätta aktuell ändring i produktion på grund av referensefel. För att hitta vilken eller vilka fält som är felaktigt, tryck på uppdatera högst upp till höger. Fält som är felaktiga blir markerade som röda. Dessa måste raderas (genom det röda krysset). Om fältet används kan inställningarna migreras till ett annat fält innan det tas bort.

Uppdatera fälten är även bra för att fånga upp fält som lagts till efter att importen skapades.

Underhåll & radera (Endast ITA)

Här kan du radera hela kopplingen mot tabellen för integrationen. Observera att inga sammankopplade poster eller importerade poster kommer raderas (Ex. skapade Artiklar).

Här ses även vilken inställning/scope som användes samt om det är justerat sedan det skapades. Det går att uppdatera schemat mot de inställningar som finns i scoopet. Eventuella manuella ändringar kommer då förvunna/återställas.

Kopplade poster (Endas ITA)

Här ses en lista över samtliga poster som har en koppling mot den externa datakällan, listade som AtyniosID. Du kan välja att gå till en enskild post eller se alla poster.

Spåra fältändringar

Alla fältändringar som sker loggas i sin måltabell. Ändras exempelvis artikelns namn via integrationen från Shopify så sparas det ersatta värdet i artikelns loggbok tillsammans med tidsstämpel och integrationsID. Denna funktion är bara aktiv för ITA-poster.

Funktioner som ännu inte stöds

Integrationsmotorn är under utveckling och än så länge har fokus lagt på skalbarhet och stabilitet mer än att fylla på med alla funktioner som är intressanta. Detta kommer utvecklas löpande efter behov. Här finns en aktuell lista över planerad funktionalitet:

Pagination av resultat från mottagarsidan (Idag kan max 250 poster hämtas)
Export av data till external källa
Beräkning av importfält stödjer inte ingående värde
Import/Export av relaterad data (Child posts)

03 Integrationstabeller