Skip to main content

Configuratie voor integratie met Momentopname-bestand

Het configureren van een integratie met behulp van een Momentopname-bestand is niet zo moeilijk, op voorwaarde dat je bekend bent met enkele basisprincipes van het SIS Framework en weet hoe de beoogde doelen van de integratie zich verhouden tot de levenscyclus van gegevens. Hieronder vind je een eenvoudige, op standaardwaarden gebaseerde configuratie, gevolgd door een beschrijving van de mogelijke gevolgen van aanpassing van de individuele instellingen op de werking van de integratie.

Configuratie van snapshot-flatbestanden

Ga als volgt te werk om de basisinformatie voor een integratie van een Momentopname-bestand te maken en te configureren:

  1. Ga in het Configuratiescherm voor systeembeheer naar  Integraties en selecteer Gegevensintegratie.

  2. Selecteer Integraties van studenteninformatiesysteem.

  3. Plaats de muisaanwijzer op Integratie maken en selecteer Snapshot Flat File.

Op het volgende scherm zie je de opties voor de configuratie die je kunt bewerken.

Stap 1: Eigenschappen integratie

Naam integratie

Vereist

Voer een unieke naam in voor de integratie. Dit is de naam die wordt weergegeven in de lijst met geconfigureerde integraties op de pagina Integraties van studenteninformatiesystemen.

Beschrijving

Optioneel

Typ een beschrijving voor de integratie. Dit is handig voor verdere identificatie van integraties.

Gedeelde gebruikersnaam

Vereist

De gedeelde gebruikersnaam wordt automatisch gegenereerd uit het SIS-systeem en in dit tekstvak weergegeven. Deze gebruikersnaam wordt gebruikt voor het posten van gegevens, samen met Gedeeld wachtwoord

Gedeeld wachtwoord

Vereist

Typ het wachtwoord dat is gegenereerd uit het SIS-systeem.

Scheidingsteken voor feedbestanden

Vereist

Selecteer het type scheidingsteken dat wordt gebruikt in het invoerbestand. Dit is het teken waarmee velden in het gegevensbestand van elkaar worden gescheiden. Dit zijn de beschikbare opties:

  • Komma

  • Dubbele punt

  • Pipe

  • Tab

  • Overige

Status van integratie

Vereist

Opties voor integratiestatus:

  • Inactief: Het systeem verwerkt geen aanvragen en werkt geen gegevens in de database bij.

  • Actief: Het systeem verwerkt verzoeken, werkt gegevens in de database bij en is zichtbaar voor de gebruikers.

  • Testen: Gegevens worden niet geïntegreerd in het live systeem.

Blackboard adviseert integraties eerst deze status te geven. Als je deze status selecteert, kun je de integratie eerst testen en eventuele problemen verhelpen voordat je de integratie uitrolt in de productieomgeving. Als de testfase is afgerond, moet je de status instellen op Inactief of Actief.

Als u geavanceerde configuratie wilt uitvoeren, moet een integratie zijn ingesteld op de status Testen of Actief.

Detaildetails van het logboek

Vereist

De optie Detailniveau logboeken bepaalt wat er voor deze integratie wordt vastgelegd in de SIS-logboeken.

  • Alleen fouten: eventuele fatale problemen, problemen die het maken, bijwerken, uitschakelen of opschonen van bewerkingen verhinderen.

  • Fouten en waarschuwingen: alle niet-fatale problemen, elk probleem met een individuele record of elke succesvolle bewerking waarvoor een wijziging van het record nodig was.

  • Alle diagnostische berichten: elke geslaagde activiteit, inclusief recordtypen en -aantallen, timing en gegevens.

  • Alle diagnostische en foutopsporingsberichten: alle afzonderlijke records en pogingen tot gegevenstransformatie.

Als je een detailniveau selecteert, wordt automatisch ook het onderliggende detailniveau ingeschakeld (of onderliggende detailniveaus). Als je bijvoorbeeld het detailniveau Berichten selecteert, worden er fouten, waarschuwingen en berichten vastgelegd.

Stap 2: Eigenschappen van de integratie

Gegevensbron leren

Vereist

Bepaal de databron die wordt gebruikt tijdens de integratie met Blackboard.

  • De gegevensbron van Learn gebruiken die is gedefinieerd in de inkomende gegevens

  • Gebruik dezelfde Learn-gegevensbron voor alle nieuwe binnenkomende gegevens. Selecteer Nieuwe gegevensbron in de vervolgkeuzelijst en voer de nieuwe gegevensbronsleutel in het tekstvak in.

  • Gebruik dezelfde Learn-gegevensbron voor alle nieuwe binnenkomende gegevens. Selecteer de sleutel van een bestaande gegevensbron in de vervolgkeuzelijst.

Opmerking: Gegevensbronsleutels moeten vooraf zijn gedefinieerd met behulp van de Gegevensbronbeheer Tool (zie Overzicht van gegevensbronsleutels)

Batch-UID-voorvoegsel

Optioneel

Voorkom ID-conflicten door een voorvoegsel op te geven voor objecten die worden gemaakt tijdens de integratie. Blackboard adviseert om deze instelling niet meer te wijzigen nadat er gegevens zijn gemaakt voor de integratie.

Bovenliggend hiërarchieknooppunt

Vereist

Deze optie is alleen beschikbaar voor integraties van het type IMS Enterprise 1.1, IMS Enterprise 1.1 - Vista en Momentopname-bestand.

  • Hiërarchie maken onder het hoogste niveau

  • Maak een hiërarchie onder het opgegeven knooppunt. Selecteer Knooppunt zoeken als er knooppunten beschikbaar zijn om te kiezen.

Op dit punt is de configuratie van een standaard Snapshot Flat File-integratie voltooid en kunt u deze testen door de integratiestatus in te stellen op Test en handmatig een Snapshot Flat File-gegevensbestand te uploaden - zie Snapshot Flat File Data Format voor startvoorbeelden).

Geavanceerde integratie-instellingen

Hoewel de standaardinstellingen meestal afdoende zijn, is het mogelijk dat de beoogde doelen van de integratie vereisten met zich meebrengen die verdere aanpassingen van de configuratie nodig maken. In sommige gevallen is het niet mogelijk om de gewenste doelen voor Blackboard-gegevensbeheer en Studentinformatiesysteem-gegevensbeheer op elkaar af te stemmen. De geavanceerde instellingen maken in-Framework beheer van binnenkomende gegevens mogelijk om Blackboard-gegevensdoelen af te dwingen.

Geavanceerde instellingen voor een integratie zijn mogelijk via drie punten in de beheerdersinterface voor de integratie van het studenteninformatiesysteem:

  1. Aangepaste veldtoewijzingen maken

  2. Aangepaste headers maken

  3. Geavanceerde integratie-instellingen in stap 3 van een integratieconfiguratie.

Als je meer wilt weten over het maken van veldtoewijzingen en aangepaste kopteksttoewijzingen, lees je Aangepaste veldtoewijzing voor tekstbestanden zonder opmaak van Momentopname en Koptekstbeschrijvingen van Momentopname-bestand.

Dit zijn de beschikbare geavanceerde integratie-instellingen voor invoegen en bijwerken:

  • Niet invoegen of bijwerken: negeer binnenkomende gegevens voor dit object.

  • Alleen invoegen: voeg alleen nieuwe objecten toe; Doe niets als er een object bestaat dat overeenkomt met deze externe gegevenssleutel.

  • Alleen updates: Werk alleen bestaande objecten bij; Niets doen als een object niet bestaat

  • Slimme invoegingen of updates (standaard): als er geen overeenkomend object op Blackboard staat, voeg je het toe als een nieuw object. Als er een overeenkomend object bestaat in Blackboard, werk het dan bij met binnenkomende gegevens.

Je kunt ook bepalen wat er exact moet gebeuren als er gegevens worden verwijderd:

Opmerking

Niet alle opties zijn beschikbaar voor alle gegevenstypen.

  • Niet uitschakelen of opschonen: Verwijder geen objecten in het systeem op basis van het feedbestand en markeer ze niet voor verwijdering.

  • Uitschakelen: Markeer voor verwijdering, maar verwijder geen objecten in het systeem op basis van het invoerbestand.

  • Opschonen: Verwijder het object uit het systeem op basis van het feedbestand.

  • Slim verwijderen: uitschakelen in de modi Volledig vernieuwen (of Volledig vernieuwen door DSK). Verwijderen in de verwijdermodus.

De bovenstaande instellingen kunnen worden toegepast op elk object dat wordt ondersteund door het type Momentopname-bestand (zoals wordt weergegeven in de UI). Je kunt de integratie nauwkeurig afregelen door de standaardwaarden voor deze instellingen te wijzigen en zo objectbeheer mogelijk te maken op een manier die verdergaat dan wat mogelijk is met alleen de gegevens in de beschikbare SIS-feeds.

Meer informatie