Guide til integrationsdesign
Formål
BitaBIZ API gør det muligt at integrere med ERP-systemer, HR-platforme, Business Intelligence-løsninger, datavarehuse og egne applikationer.
Denne guide beskriver de anbefalede integrationsmønstre, så integrationer bliver effektive, stabile og belaster platformen mindst muligt.
Grundprincipper
Hent kun de data, der er nødvendige.
Undgå at hente uændrede data igen.
Gem (cache) stamdata lokalt, hvor det er relevant.
Minimér antallet af API-kald.
Design integrationen, så den håndterer midlertidige fejl og genforsøg.
Første synkronisering
Ved første integration kan der foretages en fuld synkronisering af relevante data, f.eks. medarbejdere, afdelinger, teams, projekter, jobkoder og historiske registreringer. En fuld synkronisering bør normalt kun udføres én gang.
Løbende synkronisering
Efter den første import bør integrationen kun hente nye eller ændrede data. Fuld synkronisering bør kun udføres, hvis der er et konkret forretningsmæssigt behov.
Medarbejderstamdata
Stamdata ændrer sig sjældent. Vi anbefaler derfor synkronisering én gang dagligt eller kun ved forventede ændringer.
Tidsregistreringer
Importer historiske registreringer én gang. Synkronisér herefter kun relevante perioder eller ændrede data. Det er normalt ikke nødvendigt at hente mange års historik hver dag.
Business Intelligence og rapportering
Ved integration til Power BI eller datavarehuse anbefales én historisk import, lokal lagring af historikken og derefter kun inkrementelle opdateringer.
Planlægning af synkroniseringer
For at sikre den bedst mulige oplevelse for alle kunder anbefaler BitaBIZ, at planlagte synkroniseringer og større dataeksporter placeres uden for platformens spidsbelastningsperiode.
Platformen har typisk størst belastning på hverdage mellem kl. 08:00 og 10:00.
Det gælder især fulde synkroniseringer, historiske dataudtræk, Power BI-opdateringer, datavarehus-synkroniseringer og andre større batchjob. Forretningskritiske integrationer kan naturligvis afvikles, når behovet opstår.
Effektive integrationer
Hent kun nødvendige data.
Undgå gentagne forespørgsler på de samme data.
Undgå unødvendige historiske dataudtræk.
Synkronisér kun relevante perioder.
Genbrug allerede synkroniserede data.