search

DwayneSelsig / SomtodayOpenAPI2MicrosoftSchoolDataSync

Create Microsoft School Data Sync CSV-files using the Somtoday webservices. Somtoday is a SIS based in The Netherlands. -Dutch: Open source oplossing om Microsoft Teams te kunnen gebruiken met School Data Sync met gegevens uit Somtoday.
GNU Affero General Public License v3.0
3 stars 0 forks source link

Somtoday-Connect URL toevoegen #1

Open DennisLamers opened 1 year ago

DennisLamers commented 1 year ago

Er schijnt een URL geconfigureerd te moeten worden om te communiceren met Somtoday, deze kunnen we in deze versie niet meer configureren.

Verder moet er een overeenkomst gemaakt worden met Somtoday om de Somtoday-Connect te mogen gebruiken.

DwayneSelsig commented 1 year ago

De URL is voor iedere school hetzelfde, namelijk https://api.somtoday.nl/rest/v1. De Client id zorgt ervoor dat je alleen gegevens van jouw school kan opvragen. Een Client id kan Somtoday voor je aanmaken als je je inschrijft voor het partnerprogramma. https://som.today/somtoday-connect/contact-partnerprogramma-somtoday-connect/

Bij het inschrijven voor het partnerprogramma, zal Somtoday de verwerkersovereenkomst aanbieden. De tekenbevoegd persoon van school kan deze ondertekenen.

Het lijkt erop dat het komende schooljaar de UmService van Somtoday nog beschikbaar zal zijn. Ik raad aan om komende schooljaar nog de vorige koppeling te gebruiken. https://github.com/DwayneSelsig/Somtoday2MicrosoftSchoolDataSync

DennisLamers commented 1 year ago

Hoi Dwayne,

Dank je wel voor deze uitleg, ik ben samen met Somtoday (Topicus) aan het testen om Somtoday Connect te kunnen gaan gebruiken via een ‘test school’ (UUID). Ik heb van Topicus ook een Secret en Client ID gekregen, maar er wordt gemeld dat er 0 connectie gemaakt wordt met deze ‘test school’.

Hieronder de configuratie waarbij Topicus meldt dat er ook een URL in verwerkt zou moeten zijn, dus vandaag de vraag. Zie jij hierin verkeerde configuratie?

            <appSettings>
                           <add key="BooleanFilterBylocation" value="False" />
                           <add key="IncludedLocationCode" value="AB;CD;EF;GH" />
                           <add key="SchoolUUID" value="1349fac3-259a-44fd-a1f1-6fe5f8a2f39e" />
                           <add key="ClientId" value=****" />
                           <add key="ClientSecret" value="****" />
                           <add key="OutputFolder" value="D:\SOM2SDS-v2\CSV\" />
                           <add key="SeperateOutputFolderForEachLocation" value="True" />
                           <add key="OutputFormatUsernameTeacher" value="Emailadres" />
                           <add key="OutputFormatUsernameStudent" value="Emailadres" />
                           <add key="OutputFormatUsernameTeacher" value="gebruikersnaam" />
                           <add key="OutputFormatUsernameStudent" value="leerlingnummer" />
                           <add key="EnableGuardianSync" value="False" />
            </appSettings>

Met vriendelijke groet, Dennis Lamers | Systeembeheerder

DwayneSelsig commented 1 month ago

Ik heb een nieuwe versie gepubliceerd die kan wisselen tussen productie- en testomgeving. Door de config aan te passen wordt de juiste URL gekozen. De URLs voor het bevinden met Somtoday Connect zijn ingevoerd in de broncode: SomtodayOpenAPI2MicrosoftSchoolDataSync/Helpers/SomEnvironmentConfig.cs

Dit is dubbel vermeld:

<add key="OutputFormatUsernameTeacher" value="Emailadres" />
<add key="OutputFormatUsernameStudent" value="Emailadres" />
<add key="OutputFormatUsernameTeacher" value="gebruikersnaam" />
<add key="OutputFormatUsernameStudent" value="leerlingnummer" />

Probeer het eerst met:

<add key="OutputFormatUsernameTeacher" value="Emailadres" />
<add key="OutputFormatUsernameStudent" value="Emailadres" />