Instellen
- Selecteer op de pagina IPSIS-beheer het tabblad Configuratie.
- Ga als volgt te werk om uw integratie te configureren:
- Controleer de instellingen en bewerk deze en voltooid de toewijzingen.
- Personen
- Instructeur en cursist worden standaard ingesteld, maar kunnen worden verwijderd.
- Klik op + Rol toevoegen om extra SIS-specifieke rolnamen toe te voegen die aan de Brightspace®-rol moeten worden toegewezen. Hieronder volgen de rollen die beschikbaar zijn in OneRoster:
- Beheerder
- Assistent
- Voogd
- Bovenliggend item
- Surveillant
- Familielid
- Cursist
- Cursussen en secties
- Hieronder volgen de organisatietypen die beschikbaar zijn in OneRoster:
- Nationaal
- Staat
- Lokaal
- District
- School
- Als u klaar bent, selecteert u Bronsysteem maken.
- Zodra het bronsysteem is gemaakt, kunnen beheerders kiezen uit OAuth1a of OAuth2 als de gewenste verificatiemethode.
- Ga als volgt te werk om SFTP-aanmeldingsgegevens te genereren:
- Klik op SFTP-site maken.
- Klik op Wachtwoord genereren.
- Adres, gebruikersnaam en wachtwoord opslaan
- SFTP-referenties worden gebruikt om bestanden te uploaden.
- Het wachtwoord is verborgen en kan niet meer worden hersteld nadat de pagina is opgeslagen. Het wachtwoord kan opnieuw worden gegenereerd. SFTP-referenties moeten worden bijgewerkt bij het overbrengen van het zipbestand naar de SFTP.
Opmerking: Wachtwoordloze verificatie met een openbare SSH-sleutel kan momenteel niet worden geconfigureerd.
- Selecteer Klaar.
U wordt naar het OneRoster CSV-dashboard geleid. Het dashboard is de landingspagina van de IPSIS-beheerinterface. Klik hier om de Brightspace® Help-onderwerpen te openen voor nadere details.
Gegevens van academische sessies gebruiken voor de start- en einddatums van cursussen
Op de IPSIS-beheerpagina kunt u met het selectievakje Datums cursusedities gebruiken gegevens van academische sessies gebruiken voor de start- en einddatums van cursusedities. Dit selectievakje is standaard ingesteld op uit. Met deze optie kunt u kiezen of datums van een academische sessie (semester, onderwijsperiode, schooljaar of beoordelingsperiode) worden gekoppeld aan de cursuseditie (deze optie wordt standaard ingesteld op onderwijsperiode). De start- en einddatum van een cursus kunnen ook worden verschoven met een opgegeven aantal dagen. Als er meerdere academische sessies zijn ingesteld voor één cursuseditie, wordt de eerste academische sessie die van het SIS is ontvangen, gebruikt voor de start- en einddatum.
CSV-bestanden verwerken
Elk CSV-bestand moet worden gezipt. Zipmappen kunnen op twee manieren naar Brightspace® worden geüpload:
- Handmatig door een zip-archief van uw computer met slepen en neerzetten te verplaatsen naar de gebruikersinterface die u vindt in IPSIS-beheer - Dashboard
- Programmatisch door een zip-archief met de CSV-bestanden te uploaden naar de SFTP-site die tijdens de eerste installatie is opgegeven. Brightspace® controleert de SFTP-site met intervallen van tien minuten op nieuwe ZIP-mappen.
Inhoud van een cursus naar nieuwe cursus kopiëren
Brightspace® biedt de mogelijkheid om inhoud van een bestaande organisatie-eenheid te kopiëren bij het maken van een nieuwe cursus.
- Blader vanuit IPSIS-beheer – Configuratienaar beneden naar Cursussen en secties.
- Bij de vraag Wanneer u een nieuwe cursus maakt, inhoud kopiëren van een bestaande organisatie-eenheid? selecteert u Ja.
- Sjabloon voor bovenliggende cursus van de nieuwe cursus
- Inhoud wordt gekopieerd van de cursussjabloon op het bovenliggende niveau naar de nieuwe cursuseditie op het onderliggende niveau.
- Cursus op hetzelfde niveau waarbij de code van de organisatie-eenheid overeenkomt met de bovenliggende sjabloon
De inhoud wordt gekopieerd van een hoofdcursuseditie naar de cursuseditie op hetzelfde niveau wanneer de hoofdcursuseditie en de cursussjabloon dezelfde code voor de organisatie-eenheid delen.
Bestanden worden niet gedupliceerd bij het kopiëren van een cursus.
Problemen oplossen
Het dashboard geeft de verwerkingsstatus van de laatste batch weer. Zowel op de pagina's Dashboard als Batches wordt een laatste indicator weergegeven als de batch met succes is voltooid of als er fouten zijn opgetreden. Elke batch heeft een snelkoppeling naar het controlelogboek en indien voltooid met fouten naar foutmeldingen.
Bekijk alle logboeken om te controleren of alle bestanden zijn verwerkt zoals verwacht. Als er foutmeldingen zijn opgeslagen, vouwt u de fout uit om de vastgelegde metadata te bekijken om de fout te identificeren, corrigeert u de gegevens in uw SIS en exporteert u een nieuwe zipmap met een CSV-bestand dat alleen de noodzakelijke wijzigingen bevat om de fouten te corrigeren. Het doel is om de batches zonder fouten te laten voltooien.
Veelvoorkomende fouten
- ArgumentException-uitzondering tijdens het verwerken van het bericht.
- Uitzonderingsbericht: ongeldige TypeName voor aanvraag opgegeven. Geen toewijzing gevonden voor Type:district in bronsysteem:27. Parameternaam: TypeName
- Type uitzondering: System.ArgumentException
- Dit gebeurt gewoonlijk wanneer er toewijzingen van het type organisatie-eenheid ontbreken in de configuratie-UI en er een aanvraag van dat type is verzonden.
- CourseCreationException-uitzondering tijdens het verwerken van het bericht.
- Uitzonderingsbericht: ongeldige code
- Type uitzondering: D2L.LP.OrgUnits.Courses.CourseCreationException
- Treedt gewoonlijk op wanneer de groepsaanvraag ongeldige tekens bevat in het veld classCode. Als classCode niet is opgegeven, staan de ongeldige tekens in het titelveld.
Ongeldige tekens: \ : * ? " " < > | ' # , % &
- RoleMappingNotFoundException-uitzondering tijdens het verwerken van het bericht.
- Uitzonderingsbericht:geen roltoewijzing gevonden voor bronsysteem: OneRoster - id voor slepen en neerzetten: guardian
- Type uitzondering: D2L.IM.Platform.Exceptions.RoleMappingNotFoundException
- Dit gebeurt gewoonlijk wanneer er roltoewijzingen ontbreken in de configuratie-UI en er een aanvraag van dat type is verzonden.
- DataNotFoundException-uitzondering tijdens het verwerken van het bericht.
- Uitzonderingsbericht: kan RoleMapping niet vinden voor guardian
- Type uitzondering: D2L.Data.DataNotFoundException
- Dit gebeurt gewoonlijk wanneer er roltoewijzingen ontbreken in de configuratie-UI en er een aanvraag van dat type is verzonden.
- DataNotFoundException-uitzondering tijdens het verwerken van het bericht.
- Uitzonderingsbericht: ReplaceEnrollmentReadIMHandler.Process - IMExternalOrgUnitInfo is null.
- Type uitzondering: D2L.Data.DataNotFoundException
- RecordType: inschrijving
- Treedt gewoonlijk op wanneer een onjuiste code voor de groep of gebruiker naar het LMS is gestuurd.
- JsonReaderException-uitzondering tijdens het verwerken van het bericht.
- Uitzonderingsbericht: kan tekenreeks niet converteren naar DateTime: 4/30/2016T00:00:00.000Z. Pad 'StartDateUtc', lijn 1, positie 183.
- Type uitzondering: Newtonsoft.Json.JsonReaderException
- Dit gebeurt gewoonlijk wanneer de datumnotatie van een van de velden Date of DateTime niet de juiste notatie volgt.
- Ondersteunde notatie: jjjj-mm-ddThh:mm:ssZ
- OrgUnitMappingNotFoundException-uitzondering tijdens het verwerken van het bericht.
- Uitzonderingsbericht: geen toewijzing organisatie-eenheid gevonden voor bronsysteem: 27 id: SOMETHING
- Type uitzondering: D2L.IM.Platform.Exceptions.OrgUnitMappingNotFoundException
- Treedt gewoonlijk op wanneer de aanvraag een type organisatie-eenheid heeft waarvoor geen toewijzing is geconfigureerd in het bronsysteem. Voorbeeld: De aanvraag om een district te maken wordt ontvangen door het bronsysteem maar District is aan niets toegewezen.