SyncTool er et selvstændigt skrivebordsprogram (Crs Sapera SyncTool) til at overføre data mellem Sapera og omverdenen. Programmet er bygget på den tværplatforms-teknologi Avalonia og er dermed gjort til at kunne køre på flere styresystemer — i modsætning til den tidligere version, der kun virkede på Windows. Typiske anvendelser er import af produkter, kreditorer, debitorer, lagerposteringer og finanskladdeposteringer fra CSV-, Excel- eller XML-filer samt fra en SQL-database, men SyncTool kan også eksportere data og udføre avancerede handlinger som FTP-overførsler, SQL-kørsler og e-mail-afsendelse.
SyncTool kommunikerer med Sapera via de sædvanlige API'er, præcis som en bruger gør det via browseren. Det kræver et gyldigt login og de rette rettigheder — der er ingen direkte genvej forbi Saperas adgangskontrol.
SyncTool installeres og opdateres automatisk via Velopack og kan startes fra startmenuen eller et genvejsikon. Har du ikke installeret det endnu, eller er din version forældet, opdaterer programmet sig selv næste gang det åbnes, forudsat at maskinen kan nå opdateringsserveren.
---
Når SyncTool åbner, vises en loginformular med følgende felter.
Miljø angiver hvilken Sapera-instans der skal forbindes til, f.eks. `production` eller `staging`. Feltet svarer til det platform-navn Sapera er opsat med.
Tenant er kæde- eller butiksidentifikatoren, altså det domænenavn der hører til din organisation i Sapera.
Bruger er brugernavnet eller e-mailadressen på den konto der skal logges ind med.
Adgangskode er adgangskoden til den pågældende konto.
Org. enhed (valgfri) kan udfyldes hvis din konto har adgang til flere organisatoriske enheder og du vil forbinde til en bestemt. Lader du feltet stå tomt, vælger SyncTool automatisk den enhed der er standard for din bruger. Hvis kontoen har adgang til præcis én enhed, vælges den uden spørgsmål. Har du adgang til flere, beder SyncTool dig vælge.
Tryk Log ind eller Enter for at starte loginforsøget. En indlæsningsindikator vises i bunden af formularen, mens SyncTool henter et adgangstoken og initialiserer handlerlisten.
SyncTool gemmer et refresh-token på maskinen i operativsystemets sikre legitimationslager (på Windows er det Windows Credential Manager) efter et vellykket login. Det betyder, at du ved næste opstart — eller når du åbner en gemt opsætningsfil (.ssd) — kan logges ind automatisk uden at indtaste adgangskoden igen, så længe refresh-tokenet er gyldigt.
Øverst til højre på loginskærmen kan du skifte sprog mellem dansk og engelsk. Valget huskes per maskine.
Alle brugere der kan logge ind, skal have rettigheden Financial Import/Export Use tildelt i Sapera. Mangler den, afvises login med en fejlbesked om, at du ikke har adgang til SyncTool.
Visse handlinger kræver direkte adgang til SQL Server og er forbeholdt brugere der er medlem af gruppen Administrators i Sapera. Disse handlinger vises slet ikke i handlerlisten for ikke-administratorer. Det drejer sig typisk om interne driftsopgaver og er ikke relevante for normale importopgaver.
---
Når login er gennemført, skifter SyncTool til hoveddelen af programmet. Øverst er en værktøjslinje der viser det aktive miljø, tenant og eventuelt org. enhed. Her finder du også knapperne Indlæs .ssd og Gem .ssd til at åbne og gemme opsætningsfiler, en Log ud-knap samt en ?-knap der åbner en kort vejledning i selve arbejdsgangen.
Under værktøjslinjen er der to primære faner: 1. Opsætning og 2. Kør. Tanken er at du arbejder fra venstre mod højre — sæt handlingen og datakilden op, og kør den derefter.
Nederst i vinduet er en statuslinje der viser korte informationsmeddelelser, og under den er et log-panel med tre underfaner: Log, Advarsler og Fejl. Panelet er sammenfoldet til blot fanehovedet, men klik på det, eller tryk på pilen til højre, for at udvide det og se detaljerne. Log-panelet vises kun, når der faktisk er noget at vise.
---
En opsætning i SyncTool består af et eller flere steps (trin). Hvert trin er én selvstændig opgave med sin egen handling, datakilde og felttilknytning. En opsætningsfil (.ssd) kan indeholde mange trin, der køres i rækkefølge.
Til venstre i opsætningsfanen er en liste over de trin opsætningen indeholder. Knapperne over listen giver mulighed for at tilføje, fjerne, flytte op, flytte ned og rydde trin. Klik på et trin i listen for at redigere det.
Øverst til højre, når et trin er valgt, vælger du først Type og derefter Handling.
Type filtrerer handlerlisten. Vælg Indlæsning for import-handlinger (produkter, kreditorer, debitorer, lagerposteringer osv.). Vælg Avanceret for øvrige handlinger som SQL-kørsel, FTP-upload, e-mail og lignende.
Handling er den konkrete opgave trinnet skal udføre, f.eks. *Produkter*, *Kreditorer*, *Finanskladdeposteringer* eller *FTP upload*. Vælg handling i dropdown-listen. Når en handling er valgt, aktiveres de tre underfaner nedenfor.
Til højre for handling-dropdown er en ?-knap der åbner en detaljeret hjælpedialog for netop den valgte handling. Dialogen beskriver hvad handlingen gør, hvilke parametre den understøtter, og hvad de enkelte kolonner i felttilknytningen betyder. De individuelle handlinger er beskrevet i separate artikler.
Du kan give trinnet et frivilligt Step-navn der vises i listen til venstre og gør det nemmere at holde styr på en opsætning med mange trin.
Afkrydsningsfeltet Vis avanceret skjult under type/handling-rækken åbner de to avancerede parametre-faner og gør avancerede kolonne-tilknytningsfelter synlige i mappingtabellen. Disse er ikke nødvendige ved normal brug.
Her fortæller du SyncTool, hvorfra data skal hentes.
For fil-baserede handlinger trykker du på Indlæs fil... og vælger en CSV-, Excel- eller XML-fil. Herefter vises detaljer om filen: filsti, filtype og, for CSV, indstillinger til tegnsæt og separator. Afkrydsningsfeltet Første række er overskrift angiver om den første linje i filen indeholder kolonnenavne. Afkrydsningsfeltet Indbygget CSV/Excel-læser skifter til SyncTools egne filparserrutiner, som i mange tilfælde er hurtigere og mere robuste end OLE DB-driveren.
For SQL-baserede handlinger trykker du på SQL-forbindelse... og angiver en forbindelsesstreng. Du kan skrive en SQL-forespørgsel direkte i feltet SQL-forespørgsel eller bruge Opret forespørgsel automatisk til at lade SyncTool generere en standardforespørgsel ud fra handlingens kendte kolonner.
Feltet Forhåndsvisningsantal begrænser hvor mange rækker der vises i forhåndsvisningsruden nedenfor. Selve importen behandler altid alle rækker i kilden, uanset dette tal.
Når en kilde er valgt, vises en forhåndsvisning af dataene direkte i fanen. Brug knappen Vis inputdata til at opdatere forhåndsvisningen manuelt.
Felttilknytning (mapping) er stedet, hvor du kobler kildekolonnerne til de felter i Sapera som handlingen kender til.
Tabellen har en Destination-kolonne (Saperas feltnavne) og en Kilde-kolonne (en dropdown med kolonnerne fra din datafil eller SQL-forespørgsel). Vælg den kildekilde der svarer til hvert destinationsfelt. Rækker uden tilknytning vises i grå og springes over under kørslen.
Udover kilde/destination-tilknytningen har hvert felt yderligere indstillinger. Afkrydsningsfeltet Opdatér styrer om feltet opdateres, når en post i forvejen eksisterer. Spring over hvis tom lader eksisterende værdier i Sapera stå urørt, hvis kildefeltet er tomt. RegEx giver mulighed for at anvende et regulært udtryk til at transformere kildeværdien, og Værdi hvis tom angiver en standardværdi når kilden er tom.
De grundlæggende parametre for handlingen (f.eks. Tillad oprettelse og Tillad opdatering) vises som afkrydsningsfelter direkte over mapping-tabellen, så du ikke behøver skifte fane for at justere dem.
Avancerede kolonner som Præfiks, Postfiks, Kolonneudtryk og C#-udtryk er synlige, når Vis avanceret er slået til.
Disse to faner er kun synlige, når Vis avanceret er aktivt.
Step-parametre viser de avancerede parametre for det aktive trin, herunder eksportindstillinger som FTP-oplysninger, SharePoint-URL eller e-mail-modtager, alt afhængigt af hvilken handling der er valgt.
Globale parametre er parametre der deles på tværs af alle trin i opsætningen. Det er typisk forbindelsesstrenge, API-nøgler og lignende fælles konfigurationsværdier.
---
Parameterværdier som adgangskoder og forbindelsesstrenge gemmes ikke i klartekst i opsætningsfilen. SyncTool understøtter to konventioner til at holde hemmeligheder ude af filen.
§-notationen bruges i forbindelsesstrenge. Skriv `Password=§MinNøgle;` i forbindelsesstrengen, og SyncTool slår adgangskoden op under nøglen `MinNøgle` i operativsystemets sikre legitimationslager (på Windows: Windows Credential Manager), når den pågældende parameter bruges.
cred:-notationen bruges, når hele parameterværdien skal hentes fra Credential Manager. Angiv `cred:MinNøgle` som parameterværdi, og SyncTool erstatter automatisk værdien med det gem under `MinNøgle`.
Indlæser SyncTool en gammel opsætningsfil med klartekst-adgangskoder i forbindelsesstrenge, migrerer programmet dem automatisk ved første indlæsning: adgangskoden flyttes til Credential Manager, og filen opdateres med §-referencen.
På en ny maskine — for eksempel efter en reinstallation — skal du oprette legitimationsoplysningerne manuelt i operativsystemets legitimationslager. På Windows gøres det via Kontrolpanel > Legitimationshåndtering > Windows-legitimationsoplysninger > Tilføj en generisk legitimationsoplysning. Brug nøglenavnet `SyncTool_ParameterNavn` som navn og adgangskoden som værdi.
---
Fanen 2. Kør er der, hvor du faktisk udfører de opsatte trin.
Til venstre i fanen er en liste over trin med et afkrydsningsfelt ud for hvert. Sæt flueben ved de trin, der skal med i kørslen. Klik på et trin for at se dets detaljer i det store vindue til højre.
Sammenlign er en tør-kørsel der sammenligner kildedata med Saperas nuværende indhold uden at ændre noget. Resultatet vises med farver i resultattabellen: turkis for nye poster, lys gul for ændrede, grå for uændrede og rød for fejlede. Brug altid Sammenlign, inden du opdaterer, for at kontrollere at tilknytningen er rigtig.
Opdatér Sapera skriver de fundne ændringer til Sapera. SyncTool beder om bekræftelse, inden denne handling udføres.
Stop afbryder en igangværende kørsel på en kontrolleret måde.
De to knapper har også en ... (valgte)-variant i split-menuen, der kører samtlige afkrydsede trin i rækkefølge frem for kun det valgte trin.
Visse handlinger — for eksempel rene SQL-kørsler og eksporter — viser andre knapbetegnelser som Opdatér DB og Eksportér, men princippet er det samme.
Under kørslen opdateres en fremdriftslinje løbende med den procentmæssige fremdrift og statistik: totalt antal poster, nye, ændrede, uændrede, sprunget over, advarsler og fejl samt forventet afslutningstidspunkt.
Resultattabellen viser en forhåndsvisning af de behandlede rækker med farvemarkering. Knappen Kun ændrede/nye filtrerer tabellen til kun at vise poster der faktisk er forskellig fra Saperas indhold. Du kan også åbne sammenligningsfilen i dit standardprogram eller åbne mappen, den ligger i, via de tilsvarende knapper over tabellen.
---
En konfiguration — det vil sige samlingen af trin, handlinger, kildeforbindelser, felttilknytninger og parametre — kan gemmes til en .ssd-fil (Sapera sync-definition). Brug Gem .ssd i værktøjslinjen og vælg en placering. SyncTool spørger, om loginoplysninger også skal gemmes i filen.
Brug Indlæs .ssd for at åbne en gemt opsætning. Har filen loginoplysninger gemt i sig og er et refresh-token tilgængeligt på maskinen, forsøger SyncTool et stille login, så du lander direkte i opsætningsvisningen uden at udfylde loginformularen.
Fra loginskærmen er der en separat Indlæs .ssd-knap øverst til venstre, der indlæser en fil og kopierer dens loginoplysninger ind i loginformularen.
---
SyncTool kan startes fra kommandolinjen og køre en .ssd-fil uovervåget som en planlagt opgave eller som en baggrundstjeneste. Det gør det muligt at automatisere daglige eller ugentlige dataimporter. På Windows kan det for eksempel være en opgave i Windows Opgaveplanlægger eller en Windows-service, der starter SyncTool med den relevante .ssd-fil som argument på et fast tidspunkt.
I opsætningsfiler der bruges til planlagte kørsler, anbefales det at gemme loginoplysninger i filen og sikre, at adgangskoder og forbindelsesstrenge bruger §- eller cred:-referencerne, så de hentes fra Credential Manager og aldrig gemmes i klartekst.
Definitions-id-feltet i værktøjslinjen (synligt for administratorer) er et unikt navn for opsætningen og bruges til at identificere planlagte job.
---
Har du spørgsmål, er du velkommen til at kontakte supporten.
Vil du vide mere?
Læs mere i disse relaterede artikler:
SyncTool - handlinger
Oversigt over de handlinger i SyncTool, der er tilgængelige uden administrator-rettigheder. Hver handling importerer eller behandler data mellem en ekstern kilde og Sapera.
Sync
I denne artikel gennemgås opsætningen af webshop-synkronisering i Sapera
