Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Hieronder staat de laatste versie van het importmedewerkergegevensbestand dat naar de klant gaat. Om dit document fatsoenlijk te kunnen verzenden doe je:

Inleiding

...

Uw onderneming heeft een start gemaakt met TriasWeb als meld-, leer- en verbetersysteem. In dit document vindt u informatie met betrekking tot de geautomatiseerde import van medewerkers vanuit uw medewerkerbeheersysteem in TriasWeb.

...

U legt eenmalig een verbinding via sFTP sftp met een map op onze FTPftp-servers in Amsterdam. In die map plaatst u, al dan niet geautomatiseerd en zo vaak u wilt, uw bestand bestanden met medewerkergegevens. Onze servers lezen elke 6 uur de map enkele malen per dag uit en verwerken de gegevens. Via onze importmodule worden nieuwe medewerkers in TriasWeb geïmporteerd, bestaande medewerkers gemuteerd en medewerkers indien de gegevens in het aangeleverde bestand afwijken van die in TriasWeb. Medewerkers die uit dienst zijn worden gedeactiveerd. Uw bestand uitgeschakeld (dat betekent dat zij niet meer kunnen inloggen).

Uw bestanden wordt bewaard onder een andere naam, zodat de geschiedenis bewaard blijft. U kunt zelf de logfiles van de import bekijken als u wilt.

 

Alleen de naam en het e-mailadres van medewerkers worden . De logfiles zijn te vinden in de map waarnaar u uw bestanden uploadt. U kunt er voor kiezen om een e-mail te ontvangen wanneer het bestand niet is aangekomen op onze server of wanneer het bestand niet verwerkt kon worden.

Alleen personeelsnummer, naam, e-mailadres en afdeling van medewerkers kunnen via deze geautomatiseerde import verwerkt worden. Er worden dus geen rollen, autorisaties , of wachtwoorden of koppelingen met afdelingen geïmporteerd, gemuteerd of gedeactiveerd.

Medewerkersbestand

Om deze geautomatiseerde import/update te realiseren dient u een bestand aan te leveren (via sFTPsftp) met daarin de te importeren e-mailadressen en de bijbehorende namen. /wijzigen gegevens.

De specificaties waaraan dit bestand dient te voldoen zijn:

...

  • De bestandsnaam moet altijd hetzelfde zijn

    .Optioneel gebruik van kopregel

    , maar een datum toevoegen aan de bestandsnaam mag wel.

  • Opgeslagen in UTF-16 (Little Endian, no BOM), ofwel in unicode.

  • Kolommen kunnen in willekeurige volgorde staan.

  • Het aantal velden in de kopregel moet gelijk zijn aan het aantal velden in de overige regels in het bestand

    .Opgeslagen in UTF-16 (Little Endian, no BOM), ofwel in UNICODE.

    .

  • Gebruik van kopregel is optioneel.

  • Er kunnen 4 velden worden ingelezen: personeelsnummer, naam, e-mailadres en de afdelingen waaraan de medewerker gekoppeld moet worden. Dit laatste is alleen relevant indien uw organisatie gebruik maakt van Autorisatiemodus.

Velden die worden ingelezen zijn afhankelijk van op basis waarvan u wilt controleren of een gebruiker al aanwezig is in TriasWeb. U kunt dat doen op basis van personeelsnummer of op basis van e-mailadres.

...

  • Personeelsnummer (tekstveld, standaard primaire sleutel)

  • Naam (tekstveld, optioneel). De naam zoals die getoond moet worden in TriasWeb op de gebruikersschermen en in de beheerschermen voor gebruikersbeheer.

  • E-mailadres (verplicht, uniek, voorheen mogelijke primaire sleutel

    ).

 

De medewerkers in dit bestand worden toegevoegd aan TriasWeb. Indien ze al in TriasWeb bekend zijn, worden ze overschreven.

 

Voorbeeld bestand met 1 kopregel

 

 

medewerkernaam;email

Appel - de Bron, J.; jan.appel.debron@uworganisatie.nl

  • , maar deze mogelijkheid wordt spoedig uitgefaseerd).

  • Gekoppelde afdelingen per gebruiker (optioneel, tekstveld met afdelingscodes gescheiden door komma, alleen indien u gebruik maakt van Autorisatiemodus)

Voorbeeldbestand met kopregel

Code Block
personeelsnummer;medewerkernaam;email;afdelingen
P123456;Appel - de Bron, J.; jan.appel-debron@uworganisatie.nl;AF2,P5,776;
J23-3333;Breezand, P.V. van der; pieter.victor.vanderbreezand@uworganisatie.nl;P5

 

 

 

Als u gebruik wilt maken van het deactiveren van medewerkers die uit dienst zijn, dient u een tweede bestand aan te leveren volgens de specificaties hierboven. Op basis van de naam van het bestand beslist onze import service of de medewerkers geactiveerd of gedeactiveerd moeten worden. Zie kopje ‘workflow’.

Verwerken van gegevens

Nieuwe medewerkers

Het e-mailadres is de sleutel van het bestand. Ofwel, onze importfunctionaliteit kijkt of het e-mailadres al bestaat binnen TriasWeb. Als dat niet zo is, dan gaat het om een nieuwe medewerker. Het e-mailadres en de naam van de medewerker worden opgeslagen in TriasWeb. De nieuwe gebruiker krijgt standaard de rol van Melder. Als een medewerker een andere rol moet hebben, moet dat handmatig door een beheerder gewijzigd worden. Ook moet de koppeling van een gebruiker aan een afdeling (bij afdelingshoofden) handmatig gedaan worden. Zie hiervoor de beheerdershandleiding in TriasWeb, onder het menukopje ‘Beheer’.

 

Bestaande medewerkers

De update van bestaande medewerkers gaat op basis van e-mailadres. Indien het e-mailadres bekend is in TriasWeb (de gebruiker is dan al eerder in TriasWeb ingevoerd), wordt de bijbehorende naam in TriasWeb overschreven met de naam die in het bestand staat. Het e-mailadres wordt niet gewijzigd. Ook worden bestaande rollen, autorisaties en koppelingen met afdelingen van bestaande medewerkers niet gewijzigd.

 

Medewerkers uit dienst

...

Waarschuwingse-mails

U kunt ervoor kiezen om, indien de verwerking van de gegevens niet slaagt of als er geen bestand bij ons is aangekomen, daarvan een waarschuwingse-mail te laten verzenden naar een e-mailadres naar keuze.

Beveiliging

Indien gewenst kan de sftp-verbinding opgezet worden met public key-authenticatie. Diverse algoritmes worden ondersteund.

Workflow

Om deze import tot stand te brengen moet er communicatie zijn tussen de technische afdeling van Triaspect en de ICT-dienst van uw organisatie. Hieronder kunt u zien wat u op welk moment moet aanleveren en wat wij er dan mee doen.

 

Stappenplan Import/wijziging van Medewerkergegevens

Uw organisatie…

Triaspect…

1)      levert een testbestand aan met medewerkergegevens (de volgorde van de gegevens en het al dan niet gebruik maken van ‘header-regels’ ligt dan vast).

 

 

2)      controleert het testbestand en doet een import in de testomgeving.

3)      geeft aan

Geeft aan

  • over welk IP-adres uw uitgaande verkeer gaat.

  • wat de definitieve naam is van het importbestand.

  • wat de definitieve naam is van het importbestand met te deactiveren gebruikers (indien gewenst).
  •  

     

    4)      zet een sFTP
    • of u de e-mail 'bestand niet ontvangen' wilt ontvangen, en zo ja, op welk e-mailadres

    • of u de e-mail 'bestand niet verwerkt' wilt ontvangen, en zo ja, op welk e-mailadres

    • of u alle gebruikers die niet in het bestand staan de toegang tot TriasWeb wilt ontzeggen (vooraf deactiveren)

    • of u alle medewerkers die in het aangeleverde bestand staan toegang in TriasWeb wilt geven (op actief wilt zetten).

    • of u e-mailadres of personeelsnummer als unieke sleutel wilt gebruiken

    Whitelist dit IP-adres

    Optioneel: stuurt een public key

    Zet een sftp-configuratie op en stuurt u uw inloggegevens voor de test-upload.

    5)      doet

     Doet een upload van een willekeurig bestand naar de

    sFTP

    sftp-server van Triaspect.

     

     

    6)      controleert

    7)      wijzigt de gegevens in de sFTP-client.

    Uw geautomatiseerde import is gerealiseerd.

     

    Controleert de upload.

    Stuurt u de uiteindelijke gegevens voor upload (denk aan een nieuw en veiliger wachtwoord)

    Upload een bestand met medewerkergegevens

    Doet een upload in een testomgeving

    Controleert de gegevens

    • zet de gegevens import op de live omgeving

    • stuurt de factuur