Översikt
Den här guiden vägleder er genom de steg som krävs för att konfigurera en SFTP-baserad dataintegrering mellan ert HR-system (HRIS) och Sysarb. När den är aktiv kommer er HRIS att automatiskt leverera en personalfil till Sysarbs SFTP-server enligt ett schema, vilket Sysarb sedan hämtar och importerar till er miljö.
Så fungerar det
Er HRIS (eller IT-team) genererar en strukturerad export av personaldata enligt ett schema
Filen levereras till Sysarbs SFTP-server
Sysarb hämtar filen och importerar datan till er miljö
Innan ni börjar
Den här guiden är avsedd för kunder som redan har genomfört en integrationsutvärdering och bekräftat att SFTP är rätt integreringsväg för er miljö. Om ni fortfarande utforskar era alternativ, se vår vägledning om integrationsutvärdering innan ni fortsätter.
Viktigt — om ni redan har data i Sysarb: Om personaldata redan har importerats manuellt, kontrollera att de unika person-ID:na i er HRIS matchar de som redan finns i Sysarb. En felaktig matchning resulterar i dubblerade personuppgifter.
Förutsättningar
Innan konfigurationen kan börja, bekräfta följande:
Ni har administratörsåtkomst till er HRIS, eller IT-support är tillgänglig för att konfigurera en schemalagd export
Er organisation kan ansluta till en extern SFTP-server — kontrollera med IT om ni är osäker
Ni har arbetat igenom Sysarbs lonefil-mall för att förstå vilka fält som är tillgängliga i er HRIS och hur de mappas till Sysarbs obligatoriska fält
En integrationsbegäran från Sysarb har skickats in och utvärderats
Steg 1 — Förbered exportfilen i er HRIS
Arbeta tillsammans med er HRIS-administratör eller leverantör för att konfigurera en schemalagd dataexport med följande specifikationer:
Filformat: CSV (
.csv) eller JSON, UTF-8-kodningLeverans: SFTP-överföring till Sysarbs server (detaljer i steg 2)
Schema: Enligt överenskommelse under utvärderingen (t.ex. nightly kl. 02:00)
Viktiga krav för filen:
En rad per anställning. Om en person har flera aktiva anställningar, inkludera en rad per anställning och säkerställ att varje rad innehåller lämpligt unikt ID för att länka dem till samma person
Det unika person-ID:t måste förbli konsistent över alla framtida exporter. Om en persons ID ändras mellan exporter, behandlar Sysarb dem som en ny person, vilket resulterar i dubbletter. Förutom att skapa en dubblerad post, kommer detta att ha negativ påverkan på historiska löneanalyser och anställningspostanslutningar, samt samtal (tillämpligt för Pay Management-kunder)
Kolumnrubriker rekommenderas att matcha fältnamnen i er HRIS-export — det gör fältmatchningssteget (steg 4) betydligt enklare
Datumformat:
YYYY-MM-DDTomma fält bör lämnas tomma, inte fyllas med platshållarvärden (t.ex. "N/A")
Hel populationsfil krävs: Varje leverans måste innehålla alla aktiva anställda — inte bara ändringar eller nya anställningar. Sysarb ersätter den föregående importen med varje ny fil. Om bara ändrade eller nya poster skickas, behandlas befintliga anställda som inte ingår i filen som inaktiva eller borttagna
Om er HRIS inte stöder direktöverföring via SFTP kan er IT-team behöva konfigurera ett skript eller middleware för att hantera filöverföringen.
Steg 2 — Anslut till Sysarbs SFTP-server
I Sysarb-gränssnittet, navigera till Importera data via sidomenyn och välj Integrationer som din importmetod. Från listan över tillgängliga integrationer, välj SFTP-server.
Ni kommer till autentiseringsskärmen. Ange följande anslutningsdetaljer:
Filfiltipos |
|
URL |
|
Port |
|
Användarnamn | Tillhandahålles av Sysarb |
Lösenord | Tillhandahålles av Sysarb |
För att få ert användarnamn och lösenord, kontakta Sysarb support på [email protected] innan ni påbörjar konfigurationen.
Klicka Autentisera. Om anslutningen lyckas, ser ni ett bekräftelsemeddelande. Klicka Fortsätt för att fortsätta.
Om autentiseringen misslyckas, dubbelkolla de autentiseringsuppgifter som tillhandahålles av Sysarb och säkerställ att ert nätverk tillåter utgående anslutningar till sftp.sysarb.app på port 2022.
Notering: Det är också möjligt att använda en kundhanterad SFTP-server istället, där Sysarb hämtar filen snarare än att ta emot den. Om detta är relevant för er miljö, kontakta Sysarb support på [email protected].
Steg 3 — Profil
På profilskärmen kan ni valfritt ge denna integration en titel — användbar om ni har eller förväntar er att ha flera integrationer konfigurerade (t.ex. för att skilja dem åt efter källsystem eller datatyp). Detta kan redigeras senare.
Klicka Fortsätt.
Steg 4 — Matcha fält
På fältmatchningsskärmen mappar ni kolumnerna från er SFTP-exportfil till motsvarande fält i Sysarb.
Den vänstra kolumnen visar de fält som upptäcktes från er fil
Den högra kolumnen visar Sysarb-fälten för att mappa dem till
En varningsikon (⚠️) indikerar ett obligatoriskt fält som ännu inte har matchats
En grön bockmark indikerar ett framgångsrikt matchat fält
Genom att klicka på ett Sysarb-fält visas en dataförhandsgranskning till höger, inklusive en beskrivning av vad fältet förväntar och en förhandsgranskning av värdet från er fil
Notering: Dataförhandsvisningen kräver att cachelagret är laddat. Om ni ser ett "Försök igen senare"-meddelande, använd menyn ⋮ och välj Uppdatera data. Vid initial konfiguration kan det finnas en kort bearbetningsfördröjning — detta är förväntat. Försök igen efter några minuter.
Gå igenom listan och välj motsvarande fält från er export för varje Sysarb-fält. Om ni behöver vägledning om obligatoriska kontra rekommenderade fält, hänvisa till er customer success-kontakt eller Sysarb support.
När alla tillgängliga fält är matchade, klicka Lägg till integration.
Notering: När integreringen är aktiv kan ni återvända till fältmatchningen när som helst genom att navigera till Importera data, hitta er integration, klicka på menyn ⋮ och välja Matchade fält.
Steg 5 — Testkörning
När ni har slutfört fältmatchningen och klickat Lägg till integration, kontakta Sysarb support på [email protected] för att validera integreringen från ett tekniskt perspektiv.
Er roll i testet:
Granska de importerade datan i Sysarb och bekräfta att de motsvarar era förväntningar — personuppgifter, fältvärden, organisationsstruktur
Flagga eventuella avvikelser i fältmatchning eller datakvalitet till er Sysarb-kontakt
Alla identifierade problem löses innan integreringen markeras som aktiv.
Steg 6 — Driftsättning
När testningen är godkänd:
Den schemalagda exporten körs automatiskt från och med nu
Eventuella ändringar av filformatet eller fältmatchningen måste kommuniceras till Sysarb i förväg
Ansvarsfördelning
SFTP-autentiseringsuppgifter och slutpunkt | Sysarb | Sysarb support eller customer success |
Exportkonfiguration i HRIS | Kund / HRIS-leverantör | HRIS-leverantör |
Schemalagd filöverföring till SFTP | Kund / HRIS | HRIS-leverantör |
Filformatspecifikation | Sysarb | Sysarb support eller customer success |
Fältmatchning i Sysarb-gränssnittet | Kund | Sysarb support eller customer success |
Teknisk testning | Sysarb | Sysarb support eller customer success |
Validering | Kund | Sysarb support eller customer success |
Löpande övervakad av export | Kund / HRIS | HRIS-leverantör |
Felsökning
Fil inte levererad / saknad | Kund / HRIS-administratör |
Import misslyckades i Sysarb | Sysarb support eller customer success |
Felaktig eller oväntad data | Kund (kontrollera källdata) — Sysarb support eller customer success om fältmatchningsproblem |
SFTP-anslutningsfel | Kundens IT-team, sedan Sysarb support eller customer success om olöst |
Support
Kontakta Sysarb via [email protected] eller direkt i gränssnittet. Om ni är i en aktiv implementation är er customer success-kontakt också tillgänglig för hjälp.