Voor OneRoster 1.1 REST-integraties kunt u het ophalen van gegevens uit het studentinformatiesysteem van uw organisatie plannen om de vereiste roostergerelateerde gegevens (waaronder scholen, klassen, gebruikers, inschrijvingen en andere) in te vullen in Brightspace®. De gebruikersinterface voor IPSIS-beheer bevat een schema waarmee u het tijdstip van de dag kunt configureren waarop de gegevens worden opgehaald.
Gebruikte REST-eindpunten:
|
Type
|
URL
|
|
Organisaties
|
ims/oneroster/v1p1/orgs
|
|
Academische sessies
|
ims/oneroster/v1p1/academicSessions
|
|
Cursussen
|
ims/oneroster/v1p1/courses
|
|
Groepen
|
ims/oneroster/v1p1/classes
|
|
Gebruikers
|
ims/oneroster/v1p1/users
|
|
Inschrijvingen
|
ims/oneroster/v1p1/enrollments
|
Voordat u de OneRoster REST 1.1-integratie kunt gebruiken om informatie uit uw SIS naar Brightspace® te importeren, moet u de volgende eerste installatie- en configuratietaken uitvoeren.
IPSIS-beheer en IPSIS-platform inschakelen
Voordat u IPSIS-rolmachtigingen kunt toewijzen en toegang kunt krijgen tot IPSIS-beheer, moet u eerst de tools IPSIS-beheer en IPSIS-platform inschakelen.
Vereiste tools inschakelen
- Klik in het menu Beheertools op Organisatietools.
- Schakel op de pagina Beschikbaarheid tool de optie IPSIS-beheer en IPSIS-platform in.
Definieer een gebruikersrol en wijs machtigingen voor IPSIS-beheer toe
Nadat u IPSIS -beheer en IPSIS -platform hebt ingeschakeld, moet u uw gebruikersrol (of andere rollen) instellen en machtigingen toewijzen om ervoor te zorgen dat u IPSIS kunt beheren in Brightspace®.
|
Tip: U kunt machtigingen voor specifieke rollen aanpassen. U kunt bijvoorbeeld een bepaalde rol toestaan om alles te doen behalve de configuratieopties van IPSIS-beheer beheren. Raadpleeg Rollen en machtigingen beheren voor meer informatie over het maken van rollen. |
Gebruikersrollen instellen voor IPSIS-beheer
- Klik in het menu Beheertools op Rollen en machtigingen.
- Maak of selecteer een rol voor het beheer van IPSIS.
- Wijs op de pagina Machtigingen bewerken de volgende machtigingen voor IPSIS-beheer toe aan de rol:
- Toegang tot IPSIS-beheerconsole: Hiermee stelt u in of een gebruiker IPSIS-beheer kan zien in het menu Beheertools onder het gedeelte SIS-integratie.
- Bulksgewijze IPSIS-bewerkingen beheren: hiermee kunnen gebruikers bestanden uploaden voor verwerking en log- en probleemoplossingsdetails van eerdere uitvoeringen bekijken.
- IPSIS-configuratieopties weergeven: hiermee kunnen gebruikers het tabblad Configuratie openen op de pagina IPSIS-beheer.
- IPSIS-configuratieopties beheren: hiermee kunnen gebruikers de instellingen op het tabblad Configuratie bewerken, inclusief IPSISSFTP-accountbeheer.
- Aanmelden voor batchtaakmeldingen: hiermee kunnen gebruikers zich aanmelden voor meldingen die naar hen worden verzonden wanneer een batchtaak is voltooid.
- Wijs de volgende aanvullende machtigingen toe:
- Vertrouwelijkheid gebruikersinformatie > Zie gebruikersnamen
- Vertrouwelijkheid gebruikersinformatie > Zie door organisatie gedefinieerde id's
- Editor type organisatie-eenheid > Kan organisatie-eenheidtypen maken en bewerken
- Beveiliging > Zie rollen en machtigingen
E-mailmeldingen instellen voor OneRoster REST-verwerkingstaken
U kunt een e-mailmelding instellen om u te waarschuwen wanneer de OneRoster REST-integratie een taak uit het SIS verwerkt.
|
Opmerking:
- D2L® raadt het gebruik aan van e-mailmeldingen in plaats van SMS, omdat de e-mail meer informatie bevat over de SIS-uitvoering (successen, mislukkingen en samenvatting). Het SMS-bericht geeft alleen aan dat een taak is uitgevoerd.
- E-mails worden bezorgd vanuit de NotificationEmail-instellingen voor uw omgeving. Als u problemen ondervindt bij het ontvangen van de e-mail en hebt gecontroleerd of uw e-mailadres juist is, raadt D2L® u aan contact op te nemen met het D2L®-ondersteuningsteam voor hulp bij het controleren of uw omgeving correct is ingesteld voor e-mail. Afhankelijk van uw e-mailprovider moet u mogelijk de map met ongewenste e-mail controleren.
|
Ga als volgt te werk om e-mailmeldingen in te stellen
- Klik in de navigatiebalk op het pictogram van uw gebruikersprofiel en selecteer Meldingen.
- Controleer onder Contactmethoden > Emailadres of uw e-mailadres is vermeld.
- Schakel onder Onmiddellijke meldingen > IPSIS-platform - Overzicht batchvoltooiing het selectievakje E-mail in.
Exportopties voor scores filteren tijdens de configuratie van OneRoster REST-integratie
Wanneer u een OneRoster 1.1 REST-integratie configureert om scores op te nemen in een dagelijkse geplande update, kunt u:
-
Alleen scores vanuit actieve cursussen exporteren. Alle cursussen die op inactief zijn ingesteld, worden genegeerd en wijzigingen in scores binnen inactieve cursussen worden uitgesloten.
-
Alleen scores exporteren van cursussen die zijn gestart en niet zijn geëindigd. U kunt cursussen die zijn gesynchroniseerd buiten de begin- en einddatum ervan opnemen. Met deze optie kunnen beheerders beginnen met het synchroniseren van scores voordat een cursus begint en doorgaan met exporteren na de einddatum van een cursus om ervoor te zorgen dat late wijzigingen in scores worden opgenomen in de export.
De bron voor het exporteren van scores beperken tot alleen actieve cursussen
- Klik op Beheertools.
- Selecteer onder SIS-integratie de optie IPSIS-beheer.
- Klik op SIS toevoegen om een nieuwe OneRoster REST-integratie toe te voegen.
- Selecteer OneRoster 1.1 - REST onder Systeemtype selecteren.
- Selecteer een SIS-provider en klik op Volgende.
- Blader op de pagina Uw integratie configureren omlaag naar het gedeelte Scores exporteren.
- Ga als volgt te werk om de export van scores te beperken tot alleen actieve cursussen:
- Selecteer Exporteer alle scores naar het studentinformatiesysteem tijdens de geplande dagelijkse update.
- Selecteer Alleen scores van actieve cursussen exporteren.
Afbeelding: Selecteer Exporteer alleen scores van actieve cursussen om het exportereen van scores te beperken tot het studentinformatiesysteem.
- Klik op Bronsysteem maken om uw integratieconfiguratie te voltooien.
|
Opmerking: Alle cursussen die zijn ingesteld op inactief worden genegeerd en wijzigingen in de cijfers binnen inactieve cursussen worden uitgesloten.
|
Uw One Roster 1.1 - REST-integratie is ingesteld om alleen cijfers van actieve cursussen naar het studentinformatiesysteem te exporteren.
Het exporteren van scores beperken tot cursussen die zijn gestart en niet zijn geëindigd
- Blader op de pagina Uw integratie configureren omlaag naar het gedeelte Scores exporteren.
- Selecteer Exporteer alle scores naar het studentinformatiesysteem tijdens de geplande dagelijkse update.
- Selecteer Exporteer alleen scores van cursussen die zijn gestart en niet zijn geëindigd en voer desgewenst het volgende uit:
- Stel het aantal dagen in voor of na het begin van een cursus om te beginnen met het exporteren van scores.
- Stel het aantal dagen voor of na het einde van een cursus in om te beginnen met het exporteren van scores.
Afbeelding: Voer het aantal dagen in en selecteer voor of na.
- Klik op Bronsysteem maken om uw integratieconfiguratie te voltooien.
Uw integratie met One Roster 1.1 - REST is ingesteld om alleen scores te exporteren van cursussen die zijn gestart en niet zijn geëindigd.