Merge branch 'master' of https://github.com/DwayneSelsig/SomtodayOpen…

…API2MicrosoftSchoolDataSync

README.md

@@ -1,6 +1,6 @@
-# SomtodayOpenAPI2MicrosoftSchoolDataSync
-Open source oplossing om Microsoft Teams te kunnen gebruiken met School Data Sync met gegevens uit [Somtoday](https://www.som.today/). 
-Create Microsoft School Data Sync CSV-files using the Somtoday webservices. 
+# Somtoday Connect naar Microsoft School Data Sync
+Open source oplossing om Microsoft Teams te kunnen gebruiken met School Data Sync met gegevens uit [Somtoday](https://www.som.today/) via Somtoday Connect. 
+Create Microsoft School Data Sync CSV-files using the Somtoday Connect webservices. 
 
 De CSV bestanden zijn nodig, omdat een directe verbinding niet mogelijk is. Somtoday biedt **geen** ondersteuning voor de OneRoster standaard: https://www.imsglobal.org/oneroster-v11-final-specification. Zodra zij dat wel doen, is deze applicatie overbodig.
 
@@ -25,10 +25,16 @@ Tip: Maak een scheduled task aan. Het synchroniseren van leerlingegevens is alle
 ## Configuratiestappen na installatie
 Ga naar de installatie directory en bewerk SomtodayOpenAPI2MicrosoftSchoolDataSync.exe.config in een text editor.
 
+### SomOmgeving
+
+Kies hier om te verbinden met de testomgeving of de productieomgeving. Vul in:
+* PROD
+* TEST
+
 ### BooleanFilterBylocation
 
 Filter toepassen of alle vestigingen opvragen.
-* False: alle vestigingen opvragen.
+* False: alle vestigingen opvragen. (aanbevolen)
 * True: alleen onderstaande vestigingen opvragen.
 
 ### IncludedLocationCode
@@ -61,7 +67,7 @@ De CSV bestanden worden opgeslagen in deze map.
 ### SeperateOutputFolderForEachLocation
 
 Maak voor elke vestiging een eigen map aan. Dit kan gebruikt worden als je meerdere synchronisatieprofielen hebt binnen School Data Sync.
-* False: alle gegevens in bovenstaande OutputDirectory opslaan.
+* False: alle gegevens in bovenstaande OutputDirectory opslaan. (aanbevolen)
 * True: maak voor elke vestiging een eigen directory aan. Dit worden subdirectories in de OutputDirectory.
 
 
@@ -80,11 +86,19 @@ Mogelijk wil je een ander gegeven uit Somtoday gebruiken om gebruikers te herken
 
 ### EnableGuardianSync
 * True: Er worden 2 extra CSV-bestanden aangemaakt met informatie over de ouders/verzorgers.
-* False: Informatie over ouders/verzorgers wordt niet gesynct.
+* False: Informatie over ouders/verzorgers wordt niet gesynct. (aanbevolen)
 
 Let op! Leerlingen ouder dan 18 jaar kunnen ervoor kiezen dat ouders geen inzage hebben in hun schoolprestaties. Aangezien deze keuze niet wordt doorgegeven door Somtoday, moet de instelling voor de wekelijkse samenvatting per e-mail voor iedereen uitgeschakeld blijven. Standaard staat deze e-mail uit, zie deze link voor meer informatie:
 https://docs.microsoft.com/en-us/MicrosoftTeams/expand-teams-across-your-org/assignments-in-teams#weekly-guardian-email-digest
 
+
+### SdsCsvVersion
+
+Je kan kiezen voor CSV-bestanden in format [V1](https://aka.ms/sdsV1csv) of [V2.1](https://aka.ms/sdsV2dot1). School Data Sync accepteert beide formaten. Vul in:
+* 1
+* 2
+
+
 ## Volgende stappen
 
 Upload de CSV-Bestanden naar School Data Sync:
@@ -93,4 +107,4 @@ https://learn.microsoft.com/en-us/schooldatasync/data-ingestion-with-sds-v2.1-cs
 
 
 # Koppelen met Magister
-Gebruikt jouw school Magister en zoek je een koppeling tussen Magister en School Data Sync? Bezoek dan https://github.com/sikkepitje/TeamSync
+Gebruikt jouw school Magister en zoek je een koppeling tussen Magister en School Data Sync? Bezoek dan https://github.com/sikkepitje/TeamSync