Beheerdersdocumentatie

Gegevensreeksen LTI

Brightspace®-gegevensreeksen voor LTI zijn afhankelijk van externe leermiddelen. Als u deze tool in- en uitschakelt tijdens de queryperiode voor gegevensreeksen, kan er onverwachte of ontbrekende inhoud in uw gegevensreeksen zijn.

Diagram voor relaties tussen entiteiten

Het volgende diagram toont de relaties tussen entiteiten die worden gebruikt om Brightspace®-gegevensreeksen voor LTI te maken. Als u het diagram wilt vergroten, klikt u met de rechtermuisknop op de afbeelding en selecteert u Afbeelding openen in een nieuw tabblad.

Diagram voor relaties tussen entiteiten voor LTI

LTI Advantage-implementatiecontrole

In de Brightspace® gegevensreeks LTI Advantage-implementatiecontrole worden details vastgelegd van elke keer dat een gebruiker een LTI-implementatie maakt, bijwerkt of verwijdert. In de gegevensreeks worden gebeurtenissen sinds oktober 2019 vastgelegd.

Versie Historie	Veld	Beschrijving	Type	Grootte	Sleutel
9.7	Actie	De actie die is voltooid door de gebeurtenis: Geïmplementeerd, Bijgewerkt of Verwijderd.	nvarchar	10
9.7	DeploymentID	Unieke id van de LTI Advantage-implementatie.	nvarchar	36	PK
9.7	ClientID	Unieke id die wordt gebruikt in OAuth2-verificatie, toegewezen door het platform wanneer de LTI-tool wordt geregistreerd.	nvarchar	36	FK
9.7	DeploymentName	De naam voor de implementatie.	nvarchar	200
9.7	IsDeploymentEnabled	Indien onwaar, is het niet mogelijk om deze tool te starten of API-aanroepen voor de extensies te doen.	bit	1
9.7	HasAssignmentsAndGrades	Indien waar, is de extensie AGS (Services voor opdrachten en scores) ingeschakeld voor deze implementatie.	bit	1
9.7	HasDeepLinking	Indien waar, is de extensie Deep Linking ingeschakeld voor deze implementatie.	bit	1
9.7	HasNamesAndRoles	Indien waar, is de extensie NPRS (Services voor naam- en rolinrichting) ingeschakeld voor deze implementatie.	bit	1
9.7	HasSubmissionReview	Indien waar, is de extensie Indiening controleren ingeschakeld voor deze implementatie.	bit	1
9.7	HasActivityItemProfile	Indien waar is de extensie Activiteitsitemprofiel ingeschakeld voor deze implementatie.	bit	1
9.7	HasPlatformNotificationService	Indien waar, is de Platform Notification Service ingeschakeld voor deze implementatie.	bit	1
9.7	HasContextCopy	Indien waar, is de melding Contextkopie ingeschakeld voor deze implementatie. Ook de Platform Notification Service moet zijn ingeschakeld.	bit	1
9.7	ModifiedBy	De id van de Brightspace®-gebruiker die de implementatierecord heeft gewijzigd.	bigint	8	FK
9.7	Anoniem	Indien waar, wordt er geen gebruikersinformatie verzonden tijdens het starten.	bit	1
9.7	PreProvisioningEnabled	Indien waar, worden alle gebruikers in de cursus opgenomen, ongeacht of ze een start hebben uitgevoerd of niet. Indien onwaar, worden alleen gebruikers opgenomen die een start hebben uitgevoerd voor NRPS- en AGS-services.	bit	1
9.7	SendOrgUnitInfo	Indien waar, kunnen id van de organisatie-eenheid, de cursusnaam, de cursuscode, het type organisatie-eenheid, het LIS Course Offering Sourcedid en LIS Course Section Sourcedid worden opgenomen in de startbewerking.	bit	1
9.7	SendUserFirstName	Indien waar, kan de voornaam van de gebruiker worden verzonden tijdens het starten.	bit	1
9.7	SendUserMiddleName	Indien waar, wordt de tweede voornaam van de gebruiker opgenomen in de gegevens die via NPRS worden verzonden.	bit	1
9.7	SendUserLastName	Indien waar, kan de achternaam van de gebruiker worden verzonden tijdens het starten.	bit	1
9.7	SendUserEmail	Indien waar, kan het e-mailadres van de gebruiker worden verzonden tijdens het starten.	bit	1
9.7	SendBrightspaceUserID	Indien waar, kan de D2L®-gebruikers-id worden verzonden tijdens het starten.	bit	1
9.7	SendBrightspaceUsername	Indien waar, wordt de D2L®-gebruikersnaam verzonden tijdens het starten.	bit	1
9.7	SendBrightspaceOrgDefinedId	Indien waar, kan door D2L®-organisatie gedefinieerde id worden verzonden voor deze implementatie.	bit	1
9.7	SendLinkTitle	Indien waar, wordt de titel van de LTI-koppeling verzonden tijdens de startbewerking.	bit	1
9.7	SendLinkDescription	Indien waar, wordt de beschrijving van de LTI-koppeling verzonden tijdens de startbewerking.	bit	1
9.7	OpenAsExternal	Indien waar, wordt het merendeel van de nieuwe koppelingen die onder de implementatie zijn gemaakt, geopend in een extern venster. Indien onwaar, worden nieuwe koppelingen inline geopend.	bit	1
9.7	AutoMigrateLinks	Indien waar, kan automatische migratie plaatsvinden voor koppelingen die overeenkomen met deze implementatie.	bit	1
9.7	IsSharedToManyOrgUnits	Indien waar, wordt de implementatie gedeeld met meerdere organisatie-eenheden.	bit	1
9.7	AutoCreateGrades	Indien waar is de instelling Automatisch score-onderdelen maken ingeschakeld.	bit	1
9.7	IncludeInFinalGrade	Indien waar, worden scores die door LTI-koppelingen voor deze implementatie zijn gemaakt, opgenomen in de berekening van de eindscore.	bit	1
9.7	Timestamp	Datum en tijdstip (UTC) waarop de gebruiker de implementatie heeft gemaakt of gewijzigd.	datetime2	8	PK

LTI Advantage-registratiecontrole

In de Brightspace® gegevensreeks LTI Advantage-registratiecontrole worden de details vastgelegd van elke keer dat een gebruiker een registratie maakt, bijwerkt of verwijdert. In de gegevensreeks worden gebeurtenissen sinds juni 2019 vastgelegd.

Versie Historie	Veld	Beschrijving	Type	Grootte	Sleutel
9.7	Actie	De actie die is voltooid door de gebeurtenis: Geregistreerd, Bijgewerkt of Verwijderd.	nvarchar	10
9.7	ClientId	Unieke klantgerichte identificatie die door het platform wordt toegewezen bij registratie van de LTI-tool.	nvarchar	255	PK
9.7	ToolName	De naam van de externe cursustool.	nvarchar	200
9.7	Domein	Domein voor de geregistreerde tool.	nvarchar	2083
9.7	RedirectURLs	Lijst met omleidings-URL's die door de tool worden geleverd, opgemaakt als een CSV-lijst (door komma's gescheiden waarden). De lijst wordt afgekapt tot de maximale lengte die is toegestaan in het veld BDS.	nvarchar	2083
9.7	KeysetURL	De URL van de sleutelset is nodig om het starten te voltooien. De waarde wordt afgekapt tot de maximale lengte die is toegestaan in het veld BDS. Veld kan null zijn.	nvarchar	255
9.7	LoginURL	Het eindpunt van de initiële LTI-aanmeldingsaanvraag zoals deze door de tool wordt gedaan. De waarde wordt afgekapt tot de maximale lengte die is toegestaan in het veld BDS.	nvarchar	255
9.7	LTIVersion	Geeft aan of de registratie voor LTI 1.1 of LTI 1.3 is.	varchar	12
9.7	IsRegistrationEnabled	Indien waar, is de toolregistratie ingeschakeld voor de organisatie.	bit	1
9.7	SendInstitutionRole	Indien waar, omvat de registratie zowel contextuele als institutionele rollen. Indien onwaar, omvat de registratie alleen contextuele rollen.	bit	1
9.7	TargetLinkURI	Optionele doelkoppeling-URI die wordt gebruikt tijdens de Deep Linking-workflow wanneer de tool geen start-URL biedt voor de geretourneerde LTI-bronkoppeling. Veld kan null zijn.	nvarchar	255
9.7	ModifiedBy	De id van de Brightspace®-gebruiker die de toolregistratiegegevens heeft bijgewerkt.	bigint	8	FK
9.7	HasAssignmentAndGradeServices	Indien waar, is de extensie Services voor opdrachten en scores ingeschakeld voor deze registratie.	bit	1
9.7	HasSubmissionReview	Indien waar, is de extensie Indiening controleren ingeschakeld voor deze registratie.	bit	1
9.7	HasDeepLinking	Indien waar, is de extensie Deep Linking ingeschakeld voor deze registratie.	bit	1
9.7	HasNamesAndRoleProvisioningServices	Indien waar, is de NPRS-extensie (Names and Roles Provisioning Services) ingeschakeld voor deze registratie.	bit	1
9.7	HasActivityItemProfile	Indien waar, is de extensie Activiteitsitemprofiel ingeschakeld voor deze registratie.	bit	1
9.7	HasPlatformNotificationService	Indien waar, is de Platform Notification Service ingeschakeld voor deze registratie.	bit	1
9.7	Timestamp	Datum en tijdstip (UTC) waarop de gebruiker de registratie heeft gemaakt of gewijzigd.	datetime2	8	PK

LTI-startbewerkingen

De Brightspace® gegevensreeks LTI-start legt steeds logboekdetails vast wanneer een gebruiker een LTI-koppeling in de organisatie start.

Versie Historie	Veld	Beschrijving	Type	Grootte	Sleutel
5.5	LTILaunchId	Unieke id voor elke afzonderlijke startbewerking.	uniqueidentifier	16	PK
5.5	Gebruikers-id	De gebruiker die deze startbewerking heeft uitgevoerd.	int	4
5.5	IMSRoleNames	Een lijst met de IMS-rollen van de gebruiker.	nvarchar	10000
5.5	ImpersonatingUserId	De imiterende gebruiker die deze startbewerking heeft uitgevoerd. Veld kan null zijn.	bigint	8
5.5	ImpersonatingUserIMSRoleName	Een lijst met de IMS-rollen van de imitator. Veld kan null zijn.	nvarchar	10000
5.5	LaunchDate	De UTC-tijd waarop deze startbewerking plaatsvond.	datetime2	8
5.5	OrgUnitId	Id van de organisatie-eenheid waar deze startbewerking plaatsvond.	bigint	8
8.9 – Beschrijving gewijzigd	LTILinkId	De id van de koppeling die werd gebruikt voor de LTI-startbewerking. Veld kan null zijn.	bigint	8	FK
5.5	DeploymentId	De unieke id van de koppeling die werd gebruikt voor de LTI-startbewerking. Dit is alleen beschikbaar voor LTI 1.3-koppelingen. Veld kan null zijn.	uniqueidentifier	16
5.5	ClientId	De unieke id van de registratie van de koppeling die werd gebruikt voor de LTI-startbewerking. Dit is alleen beschikbaar voor LTI 1.3-koppelingen. Veld kan null zijn.	uniqueidentifier	16
5.5	ToolProviderId	De id van de toolprovider van de koppeling die werd gebruikt voor de LTI-startbewerking. Dit is alleen beschikbaar voor LTI 1.1-koppelingen. Veld kan null zijn.	nvarchar	300
5.5	ContentTopicId	Id van het onderwerp van inhoud waar deze startbewerking plaatsvond. Veld kan null zijn.	bigint	8
5.5	ParentModuleId	Id van de bovenliggende module waar deze startbewerking plaatsvond. Veld kan null zijn.	bigint	8
5.5	Placement	Plaatsingstype van deze startbewerking. Veld kan null zijn.	nvarchar	10
5.5	MessageVersion	LTI-berichtversie van deze startbewerking. Veld kan null zijn.	nvarchar	10
5.5	RequestType	LTI-aanvraagtype van deze startbewerking. Veld kan null zijn.	nvarchar	30

LTI-linkmigratie-audit

De Brightspace®-gegevensreeks LTI-linkmigratie-audit registreert alle geprobeerde LTI-link migraties. Elke rij in de gegevensset vertegenwoordigt een poging tot linkmigratie van LTI 1.1 naar LTI 1.3.

Versie Historie	Veld	Beschrijving	Type	Grootte	Sleutel
7.14 / 8.0	LTIMigrationId	Unieke identificatie voor elke individuele link migratie	uniqueidentifier	16	PK
7.14 / 8.0	Gebruikers-id	ID van de persoon die de migratie heeft geïnitieerd	bigint	8	FK
7.14 / 8.0	MigrationDate	De datum waarop de migratie heeft plaatsgevonden voor deze koppeling (UTC)	datetime2	8
7.14 / 8.0	OrgUnitId	Id van de organisatie-eenheid waar deze startbewerking plaatsvond	bigint	8	FK
7.14 / 8.0	LinkId	Id van de koppeling die is gemigreerd	bigint	8	FK
7.14 / 8.0	LinkURL	Start-URL voor de koppeling	nvarchar	2000
7.14 / 8.0	LinkName	Naam van de koppeling	nvarchar	200
7.14 / 8.0	ClientId	ID van de registratie waar deze koppeling naar is gemigreerd. Veld kan null zijn.	nvarchar	255
7.14 / 8.0	RegistrationDomain	Domein van de registratie waar deze link naar is gemigreerd. Veld kan null zijn.	nvarchar	2083
7.14 / 8.0	DeploymentId	Id van de implementatie van de koppeling die werd gebruikt voor de LTI-migratie. Veld kan null zijn.	uniqueidentifier	16
7.14 / 8.0	JobId	Id voor de job waaronder deze link is gemigreerd.	bigint	8
7.14 / 8.0	Status	Statusresultaat voor deze linkmigratie. Mogelijke waarden: 0 = Succesvol 1 = Fout 2 = Niet gevonden	smallint	2
7.14 / 8.0	FailureCode	Foutcode voor mislukte migraties. Mogelijke waarden: 0 = Registratie niet gevonden 1 = Implementatie niet ingeschakeld 2 = Implementatie niet gevonden 3 = Koppeling niet gevonden 4 = Koppeling niet verouderd 5 = URL van koppeling ongeldig 6 = Onbekend 7 = Automatische migratie is niet ingeschakeld in de implementatie Veld kan null zijn.	smallint	2
7.14 / 8.0	MigrationType	Hoe de migratie is getriggerd. Mogelijke waarden: 0 = Link-API 1 = Cursus kopiëren 2 = Knop cursusmigratie 3 = Cursusmigratie-API	smallint	2
9.4	VerouderdeURL	Het verouderde domein van waaruit de koppeling is gemigreerd. Wordt alleen ingevuld als het verouderde domein afwijkt van het registratiedomein. Veld kan null zijn.	nvarchar	2083

LTI-koppelingen

De Brightspace®-gegevensreeks LTI-koppelingen haalt de lijst op van LTI-koppelingen die in de organisatie bestaan. Koppelingen die na oktober 2023 zijn verwijderd, worden aangeduid met de kolom IsDeleted. Koppelingen die vóór oktober 2023 zijn verwijderd, worden niet in de gegevens opgenomen.

Versie Historie	Veld	Beschrijving	Type	Grootte	Sleutel
3.6 / 4.1	LtiLinkId	Unieke id voor de LTI-koppeling.	bigint	8	PK
4.7 / 5.1 – Beschrijving bijgewerkt	OrgUnitId	Id voor de organisatie-eenheid waar de koppeling is gemaakt.	int	4	FK
5.7 / 6.0 – Kolomgrootte gewijzigd	Titel	De titel van de koppeling.	nvarchar	200
3.6 / 4.1	LinkType	Het type koppeling, ofwel een basis LTI-startbewerking ofwel een CIM/Deep Linking-startbewerking om inhoud van een tool op te halen. (0 = basis LTI-startbewerking, 1 = Content Item Message of Deeplinking).	int	4
5.7 / 6.0 – Kolomgrootte gewijzigd	LTIVersion	Geeft aan of de koppeling LTI 1.1 of LTI 1.3 is.	varchar	12
8.13 / 9.2 – Kolomgrootte gewijzigd	URL	De URL die tijdens het starten wordt gebruikt. Veld kan null zijn.	nvarchar	2000
3.6 / 4.1	Beschrijving	Beschrijving van de LTI-koppeling. Veld kan null zijn.	nvarchar	1000
3.6 / 4.1	IsVisible	Bepaalt of de koppeling wordt weergegeven wanneer deze wordt toegevoegd aan de cursusinhoud in de cursus. Voor LTI 1.1 wordt dit in de gebruikersinterface IsVisible genoemd.	bit	1
3.6 / 4.1	SendTCInfo	Indien waar, bepaalt dit of de tool_consumer-variabelen mogen worden opgenomen in de LTI-startbewerking. Alleen LTI 1.1.	bit	1
3.6 / 4.1	SendContextInfo	Indien waar, bepaalt of de variabelen context_id, context_title, context_label en context_type worden opgenomen in de LTI-startbewerking. Alleen LTI 1.1.	bit	1
3.6 / 4.1	SendCourseInfo	Indien waar, bepaalt of LISSourcedId wordt opgenomen in de startbewerking. Alleen LTI 1.1.	bit	1
3.6 / 4.1	SendOrgUnitInfo	Indien waar, bepaalt of de id van de organisatie-eenheid, de cursusnaam, de cursuscode, het type organisatie-eenheid, het LIS Course Offering Sourcedid en LIS Course Section Sourcedid worden opgenomen in de LTI-startbewerking. Alleen LTI 1.3. Veld kan null zijn.	bit	1
3.6 / 4.1	SendUserID	Indien waar, bepaalt een unieke id voor de gebruiker, die wordt gegenereerd bij de eerste keer opstarten van de gebruiker. Alleen LTI 1.1. Dit wordt altijd naar LTI 1.3 verzonden en kan niet worden uitgeschakeld tenzij anonieme startbewerking wordt gebruikt.	bit	1
3.6 / 4.1	SendUserName	Indien waar, bepaalt of voor- en achternaam (eerste als laatste) van de gebruiker worden verzonden tijdens de startbewerking.	bit	1
3.6 / 4.1	SendUserEmail	Indien waar, bepaalt of het primaire e-mailadres van de gebruiker wordt verzonden tijdens de startbewerking.	bit	1
3.6 / 4.1	SendLinkTitle	Indien waar, bepaalt of de titel van de LTI-koppeling wordt verzonden tijdens de startbewerking. Alleen LTI 1.1.	bit	1
3.6 / 4.1	SendLinkDescription	Indien waar, bepaalt of de beschrijving van de LTI-koppeling wordt verzonden tijdens de startbewerking. Alleen LTI 1.1.	bit	1
3.6 / 4.1	SendD2LUserName	Indien waar, bepaalt of de Brightspace®-gebruikersnaam wordt verzonden tijdens de startbewerking.	bit	1
3.6 / 4.1	SendD2LOrgDefinedId	Indien waar, bepaalt of OrgDefinedId van Brightspace® wordt verzonden tijdens de startbewerking.	bit	1
3.6 / 4.1	SendD2LOrgRoleId	Indien waar, bepaalt of de aangepaste D2L®-rol van Brightspace® wordt verzonden tijdens de startbewerking. Alleen LTI 1.1.	bit	1
3.6 / 4.1	SendBrightspace®UserId	Indien waar, bepaalt of de gebruikers-id van D2L® wordt verzonden tijdens de startbewerking. Alleen LTI 1.3. Veld kan null zijn.	bit	1
3.6 / 4.1	Anoniem	Indien waar, wordt er geen gebruikersinformatie verzonden tijdens de startbewerking. Alleen LTI 1.3. Veld kan null zijn.	bit	1
3.6 / 4.1	Gedeeld	Geeft aan of de koppeling wordt gedeeld met extra organisatie-eenheden of niet. Veld kan null zijn.	bit	1
3.6 / 4.1	UseToolProviderSecuritySettings	Indien waar, gebruikt de beveiligingsinstellingen van de Toolprovider versus de beveiligingsinstellingen van de koppeling op basis van domeinvergelijking. Alleen LTI 1.1.	bit	1
3.6 / 4.1	LastModifiedDate	De laatste keer dat een koppeling is bijgewerkt. Veld kan null zijn.	datetime2	8
5.7 / 5.1	OuAvailabilitySetId	Unieke id voor delen. Kan worden gebruikt om deel te nemen op gedeelde LTI-koppelingen. Veld kan null zijn.	bigint	8
8.13 / 9.2	LastModifiedBy	Gebruikers-id van de gebruiker die de LTI-koppeling het laatst heeft gewijzigd.	int	4	FK
8.13 / 9.2	IsDeleted	Geeft aan of de LTI-koppeling is verwijderd.	bit	1
9.14	CreatedDate	De datum waarop de koppeling is gemaakt (UTC). Veld kan null zijn.	datetime2	8
9.14	DeploymentId	Implementatie-id waartoe de koppeling behoort. Veld kan null zijn.	uniqueidentifier	36	FK
9.14	LinkSubType	Aanvullende informatie over de koppeling. Mogelijke waarden: 1 = Basisstart 2 = Widget 3 = Diepe koppeling QuickLink 4 = Diepe koppeling Insert Stuff® 5 = Diepe koppeling Testbouwer 6 = Diepe koppeling Testvraag 7 = Navigatiebalk 8 = Toewijzingen activa processor 9 = Rapport toewijzingsprocessor 10 = EULA toewijzingsprocessor 11 = Instellingen toewijzingsprocessor Veld kan null zijn.	int	4