EDU-DEX ↔ opleidersportaal: veldkoppeling
Kort samengevat: In dit artikel zie je hoe de velden uit je EDU-DEX-feed corresponderen met de velden die je bij een training in het opleidersportaal ziet. Geïmporteerde trainingen zijn in het portaal alleen-lezen; je beheert de inhoud dus via je EDU-DEX-feed.
Elke veldverwijzing hieronder wijst naar een node binnen één
<program> in je EDU-DEX-XML. Omdat je geïmporteerde trainingen
niet in het portaal kunt bewerken, zie je altijd de “statische” versie van
elk onderdeel.
1. Onderdelen op de trainingspagina
Een training in het portaal is opgebouwd uit de volgende onderdelen:
- Informatie
- Over de training
- Agenda
- Categorieën
- Prijs
- Standaard registratie
- Data & Locaties
- Details aanvraag
- Instellingen
2. Informatie
| Veld in portaal | EDU-DEX-veld | Toelichting |
|---|---|---|
| Naam |
programDescriptions/programName
|
Per taal gelokaliseerd (xml:lang); afgekapt op de
maximale titellengte.
|
| Afbeelding | – | Wordt niet uit EDU-DEX geïmporteerd. |
| Planningstype |
Afgeleid van programSchedule/programRun +
programAdmission/startDateDetermination
|
Flexibel als er geen runs met datum zijn (e-learning, directe start, in overleg af te spreken startdatum); anders Gepland. |
| Type training |
programClassification/programType +
programForm +
programCurriculum/instructionMode
|
Gecombineerd tot één van: klassikale training, e-learning, blended, virtual classroom, webinar, workshop, coaching, examen, thuisstudie, overig. |
| Taal |
programCurriculum/instructionLanguage/languageCode
|
Valt terug op Nederlands (nl) als de taal ontbreekt
of niet wordt ondersteund. Bepaalt ook welke xml:lang-variant
van alle teksten wordt geïmporteerd.
|
| Vereist opleidingsniveau |
programAdmission/requiredLevel
|
Gekoppeld als: bachelor → HBO, academic bachelor → WO, mbo → MBO, hbo master → HBO Master, post-hbo → Post-HBO. |
| Trainingsniveau | – |
Wordt niet geïmporteerd (programLevel wordt genegeerd).
|
| Trainingsduur |
programClassification/programDuration + het bijbehorende
unit-attribuut
|
Bijv.
<programDuration unit="day">1</programDuration>.
|
| Trainers | – |
programCurriculum/teacher wordt niet geïmporteerd.
|
| Type certificaat |
programClassification/degree
|
Bij degree = "certificate" wordt je eigen bedrijf
als certificerende instantie ingesteld en verschijnt “Certificaat
van opleider”.
|
| Keurmerken | – | Worden op dit moment nooit geïmporteerd. |
| Educatieve punten | – | Worden niet geïmporteerd. |
| Extern ID leeritem |
programClassification/programId
|
Wordt gebruikt als extern ID om trainingen te matchen en bij te werken. |
Let op: programClassification/orgUnitId moet
gelijk zijn aan het EDU-DEX-ID dat op jouw opleideraccount is ingesteld.
Zo niet, dan wordt het programma volledig overgeslagen.
3. Over de training
Dit ene veld in het portaal wordt opgebouwd uit meerdere EDU-DEX-nodes, in deze volgorde:
-
programDescriptions/programSummaryHtml(fallbackprogramSummaryText) — alleen als “summary” is ingeschakeld in je importinstellingen. -
programDescriptions/programDescriptionHtml(fallbackprogramDescriptionText) — altijd; inline base64-afbeeldingen worden verwijderd. -
programDescriptions/subjectText-blokken — elk blok is een vetgedrukte kop plusdescriptionHtml(fallbackdescriptionText).
De subjectText-blokken die onder
Over de training terechtkomen, gebruiken deze koppen:
| # |
<subject>-waarde
|
Kop |
|---|---|---|
| 1 |
description
|
Over de training |
| 2 |
student profile
|
Voor wie? |
| 3 |
objectives
|
Wat ga ik leren? |
| 4 |
characteristics
|
Waarom deze opleiding? |
| 5 |
graduation
|
Diploma |
| 6 |
admission
|
Toelating |
| 7 |
library
|
Materiaal |
| 8 |
instruction modes
|
Studiewijze |
| 9 |
after graduation
|
Na afstuderen |
Welke subjects worden geïmporteerd, is per opleider instelbaar; uitgeschakelde subjects worden weggelaten. Wil je dit aanpassen? Neem contact op met opleidersupport@studytube.nl.
4. Agenda
De Agenda werkt op dezelfde manier, met de “agenda”-subjects (programDescriptions/subjectText):
| # |
<subject>-waarde
|
Kop |
|---|---|---|
| 1 |
program guide
|
Programma |
| 2 |
curriculum
|
Programma |
| 3 |
course schedule
|
Planning |
| 4 |
program start
|
Start programma |
| 5 |
study load
|
Studielast |
5. Categorieën
| Veld in portaal | EDU-DEX-veld |
|---|---|
| Categorie |
programClassification/theme
|
| Subcategorieën |
programClassification/theme (dezelfde node)
|
De waarde van theme wordt via een vaste tabel gekoppeld; onbekende
of ontbrekende waarden komen standaard op Overig. Slechts
een paar thema’s leveren ook een subcategorie op:
[VERIFIËREN: verschijnen deze categorie- en subcategorienamen in het portaal in het Nederlands, of blijven ze Engels? Onderstaande waarden zijn overgenomen uit de koppeling en nog niet gelokaliseerd.]
EDU-DEX theme
|
Categorie | Subcategorie |
|---|---|---|
| automation and it | Automation | – |
| change management | Management | Change management |
| coaching | Management | Coaching |
| communication | Communication | – |
| entrepreneurship | Management | Entrepreneurship |
| finance | Financial | – |
| health and safety | Health and safety | – |
| care and personal care | Healthcare | – |
| hobbies and leisure | Hobbies and leisure | – |
| human resources | HR | – |
| internet and media | Internet and media | – |
| languages | Languages | – |
| law | Legal | – |
| leadership | Management | Leadership |
| management | Management | – |
| marketing | Marketing | – |
| personal development | Personal efficiency | Personal development |
| personal effectiveness | Personal efficiency | – |
| manufacturing engineering and construction | Production and engineering | – |
| procurement and logistics | Purchasing and logistics | – |
| property and real estate | Real estate | – |
| quality and project management | Quality and project management | – |
| sales | Sales | – |
| secretarial and office work | Secretarial and administration | – |
| sports and vitality | Sport and vitality | – |
| training and education | Training and education | – |
| other / anything else | Other | – |
6. Prijs
Alle kosten komen uit <cost>-nodes. Welke set kosten wordt
gebruikt, wordt bepaald in deze voorkeursvolgorde: de kosten van de eerste
aankomende programRun →
programSchedule/genericProgramRun//cost → de kosten van de meest
recente afgelopen programRun → een willekeurige
//cost in het programma.
| Veld in portaal | EDU-DEX-veld |
|---|---|
| Prijs training (excl. btw) |
cost met costType = "tuition fee" →
de bijbehorende prijsnode
|
| Btw-soort | Afgeleid van het btw-bedrag op diezelfde kostennode; 0% als dit ontbreekt |
| Bijkomende kosten |
Elke andere cost met isRequiredCost = true
en een positieve prijs → naam uit
summaryText (anders de vertaalde costType),
bedrag en btw %
|
| (korting op de prijs) |
Elke andere cost met isRequiredCost = true
en een negatieve prijs → een korting gelijk
aan de absolute waarde van die kosten (incl. btw)
|
| Samenvatting | Berekend: prijs + bijkomende kosten − kortingen |
Let op: een programma zonder prijs wordt volledig overgeslagen bij de import.
7. Standaard registratie
| Veld in portaal | EDU-DEX-veld |
|---|---|
| Maximaal aantal deelnemers |
programAdmission/maxNumberOfParticipants
|
| Minimaal aantal deelnemers |
programAdmission/minNumberOfParticipants
|
| Sluit inschrijving | – (een portaalinstelling, niet uit EDU-DEX) |
8. Details aanvraag
| Veld in portaal | EDU-DEX-veld |
|---|---|
| Vereiste deelnemerinformatie | – komt uit de configuratie van je XML-integratie, niet uit de feed zelf |
9. Data & Locaties (sessies)
Elke programSchedule/programRun wordt één sessie. Een run geldt
als online wanneer
programClassification/programType gelijk is aan
virtual classroom of webinar, wanneer
programClassification/fullyOnline waar is, of wanneer de run
zelf fullyOnline = true heeft. Anders is het een locatiesessie.
| Veld in portaal | EDU-DEX-veld |
|---|---|
| Data |
programRun/courseDay/date (fallback
programRun/startDate)
|
| Starttijd / eindtijd |
programRun/courseDay/startTime en endTime
(eindtijd valt terug op starttijd)
|
| Locatie |
De eerste beschikbare location-node:
courseDay/location →
genericCourseDay/location → module/location
→ genericModule/location →
programRun/location →
genericProgramRun/location →
programClassification/programLocation. Gebruikt
locationName (of id), address,
zipcode, city, country.
|
| Link online sessie |
programDescriptions/media/url (alleen bij online
sessies)
|
| Status |
programRun/status — canceled of
application closed betekent dat de inschrijving gesloten
is
|
| Deelnemers |
Min./max. uit programAdmission/minNumberOfParticipants
en maxNumberOfParticipants (voor alle sessies gelijk)
|
Let op: de hele training wordt gearchiveerd wanneer
alle programRun/status-waarden
canceled / application closed zijn, of wanneer
programAdmission/applicationOpen onwaar is. Zodra dat niet meer
het geval is, wordt de training automatisch weer uit het archief gehaald.
10. Niet als trainingsveld zichtbaar, maar wel relevant
| EDU-DEX-veld | Effect |
|---|---|
programClassification/orgUnitId
|
Moet overeenkomen met het EDU-DEX-ID in je integratie-instellingen, anders wordt het programma overgeslagen. |
programClassification/programId
|
Extern ID waarmee de training wordt aangemaakt of bijgewerkt. |
instructionLanguage/languageCode
|
Bepaalt welke xml:lang-variant van alle teksten
wordt geïmporteerd.
|
programRun / genericProgramRun
|
Er moet er minstens één aanwezig zijn, anders wordt het programma overgeslagen. |
Vragen over hoe je feed wordt geïmporteerd, of wil je aanpassen welke onderdelen of subjects worden geïmporteerd? Mail ons via opleidersupport@studytube.nl, dan helpen we je graag verder.