326 lines
11 KiB
Markdown
326 lines
11 KiB
Markdown
# Studentvaardigheden
|
|
|
|
## Overview
|
|
|
|
Deze sectie beschrijft hoe je studentvaardigheden uit het Open-ICT competentiekader kunt ophalen. Het framework bevat tien kernvaardigheden die worden beoordeeld in het Open-ICT curriculum, elk met vier niveaus die oplopende complexiteit en zelfstandigheid representeren.
|
|
|
|
## Beschikbare Vaardigheden
|
|
|
|
De volgende tien vaardigheden zijn beschikbaar:
|
|
|
|
1. **Juiste kennis ontwikkelen**: Het vermogen om relevante kennis te identificeren, te verwerven en toe te passen
|
|
2. **Kwalitatief product maken**: Het vermogen om producten te maken die voldoen aan kwaliteitscriteria
|
|
3. **Overzicht creëren**: Het vermogen om informatie te verzamelen en overzichtelijk weer te geven
|
|
4. **Kritisch oordelen**: Het vermogen om verkregen informatie te verwerken en onderbouwde conclusies te trekken
|
|
5. **Samenwerken**: Het vermogen om effectief samen te werken in teams
|
|
6. **Boodschap delen**: Het vermogen om informatie en ideeën duidelijk te communiceren
|
|
7. **Plannen**: Het vermogen om activiteiten te plannen en te organiseren
|
|
8. **Flexibel opstellen**: Het vermogen om flexibel te reageren op veranderende omstandigheden
|
|
9. **Pro-actief handelen**: Het vermogen om proactief te handelen en initiatief te nemen
|
|
10. **Reflecteren**: Het vermogen om te reflecteren op eigen handelen en leerproces
|
|
|
|
## Workflow Scenarios
|
|
|
|
### Scenario 1: Overzicht en Onderzoek (VERPLICHT: Alle Vaardigheden Ophalen)
|
|
|
|
**Wanneer te gebruiken:**
|
|
|
|
- Wanneer het nog niet duidelijk is aan welke vaardigheid er wordt gewerkt
|
|
- Wanneer de gebruiker wilt weten welke vaardigheden relevant zijn voor een bepaald bewijsstuk
|
|
- Wanneer je een overzicht nodig hebt van alle beschikbare vaardigheden en hun niveaus
|
|
- Bij het analyseren van bewijsstukken om te bepalen welke vaardigheden van toepassing zijn
|
|
|
|
**VERPLICHTE WORKFLOW:**
|
|
|
|
1. **VOER UIT**: `python scripts/vaardigheden.py` (zonder enige argumenten of filters)
|
|
2. **GEBRUIK ALLEEN**: De data die wordt gereturned door het script
|
|
3. **VERBODEN**: Het is **NIET TOEGESTAAN** om zelf criteria voor vaardigheden in te vullen of te verzinnen
|
|
4. **VERBODEN**: Het is **NIET TOEGESTAAN** om alleen een subset van vaardigheden op te halen in dit scenario
|
|
5. **ANALYSEER**: Gebruik de volledige dataset om te bepalen welke vaardigheden relevant zijn
|
|
|
|
**Voorbeeld gebruik:**
|
|
|
|
```bash
|
|
python scripts/vaardigheden.py
|
|
```
|
|
|
|
**Resultaat**: JSON object met alle tien vaardigheden, elk met alle vier niveaus (1-4). Gebruik deze volledige dataset om te analyseren welke vaardigheden relevant zijn.
|
|
|
|
### Scenario 2: Specifieke Vaardigheid Bekend
|
|
|
|
**Wanneer te gebruiken:**
|
|
|
|
- Wanneer er al duidelijk is aan welke specifieke vaardigheid wordt gewerkt
|
|
- Wanneer de gebruiker expliciet vraagt naar een specifieke vaardigheid
|
|
- Wanneer je alleen informatie nodig hebt over één of meerdere specifieke vaardigheden
|
|
|
|
**WORKFLOW:**
|
|
|
|
#### 2a. Één Specifieke Vaardigheid
|
|
|
|
**Wanneer**: Er is één specifieke vaardigheid bekend
|
|
|
|
**VOER UIT**:
|
|
|
|
```bash
|
|
python scripts/vaardigheden.py --skill "Vaardigheidsnaam"
|
|
```
|
|
|
|
**BELANGRIJK**:
|
|
|
|
- Gebruik de exacte vaardigheidsnaam zoals vermeld in de lijst hierboven
|
|
- Voeg **GEEN** `--level` filter toe tenzij expliciet gevraagd naar een specifiek niveau
|
|
- Haal alle niveaus op voor de vaardigheid, tenzij expliciet anders gevraagd
|
|
|
|
**Voorbeeld:**
|
|
|
|
```bash
|
|
python scripts/vaardigheden.py --skill "Samenwerken"
|
|
```
|
|
|
|
**Resultaat**: JSON object met alleen de "Samenwerken" vaardigheid, inclusief alle vier niveaus.
|
|
|
|
#### 2b. Meerdere Specifieke Vaardigheden
|
|
|
|
**Wanneer**: Er zijn meerdere specifieke vaardigheden bekend
|
|
|
|
**VERPLICHTE WORKFLOW:**
|
|
|
|
1. **VOER MEERDERE REQUESTS UIT**: Maak voor elke vaardigheid een aparte request naar het Python script
|
|
2. **GEEN COMBINATIE**: Je kunt niet meerdere vaardigheden in één request ophalen
|
|
3. **VOOR ELKE VAARDIGHEID**: Voer `python scripts/vaardigheden.py --skill "Vaardigheidsnaam"` uit
|
|
|
|
**Voorbeeld bij 3 vaardigheden:**
|
|
|
|
```bash
|
|
python scripts/vaardigheden.py --skill "Samenwerken"
|
|
python scripts/vaardigheden.py --skill "Kritisch oordelen"
|
|
python scripts/vaardigheden.py --skill "Reflecteren"
|
|
```
|
|
|
|
**Resultaat**: Drie aparte JSON objecten, één voor elke vaardigheid met alle vier niveaus.
|
|
|
|
#### 2c. Specifiek Niveau (Alleen Wanneer Expliciet Gevraagd)
|
|
|
|
**Wanneer**: De gebruiker vraagt expliciet naar een specifiek niveau (bijv. "niveau 2", "level 3")
|
|
|
|
**VERPLICHTE WORKFLOW:**
|
|
|
|
1. **GEBRUIK `--level` FILTER**: Voeg `--level` toe aan de command alleen wanneer expliciet gevraagd
|
|
2. **COMBINEER MET `--skill`**: Als er ook een specifieke vaardigheid bekend is, combineer beide filters
|
|
3. **GEEN NIVEAU FILTER**: Als er geen specifiek niveau wordt genoemd, haal alle niveaus op
|
|
|
|
**Voorbeelden:**
|
|
|
|
```bash
|
|
# Specifieke vaardigheid op specifiek niveau (expliciet gevraagd)
|
|
python scripts/vaardigheden.py --skill "Reflecteren" --level 3
|
|
|
|
# Alle vaardigheden op specifiek niveau (expliciet gevraagd)
|
|
python scripts/vaardigheden.py --level 2
|
|
|
|
# Specifieke vaardigheid zonder niveau (geen niveau genoemd)
|
|
python scripts/vaardigheden.py --skill "Samenwerken"
|
|
```
|
|
|
|
## Kritieke Regels
|
|
|
|
### VERPLICHT: Gebruik Alleen Gereturned Data
|
|
|
|
**KRITIEK**: Je MOET alleen de data gebruiken die wordt gereturned door het Python script.
|
|
|
|
**VERBODEN:**
|
|
|
|
- ❌ Het verzinnen of invullen van criteria voor vaardigheden
|
|
- ❌ Het gebruik van kennis over vaardigheden die niet in de gereturned data staat
|
|
- ❌ Het aannemen van wat een vaardigheid zou moeten zijn zonder de data te raadplegen
|
|
|
|
**VERPLICHT:**
|
|
|
|
- ✅ Gebruik alleen de `title` en `info` velden uit de gereturned JSON
|
|
- ✅ Baseer alle analyses en conclusies op de daadwerkelijke data
|
|
- ✅ Raadpleeg altijd de volledige dataset wanneer onzekerheid bestaat
|
|
|
|
### VERPLICHT: Scenario 1 bij Onzekerheid
|
|
|
|
**KRITIEK**: Wanneer het niet duidelijk is welke vaardigheid relevant is, MOET je Scenario 1 gebruiken (alle vaardigheden ophalen).
|
|
|
|
**VERBODEN:**
|
|
|
|
- ❌ Het gissen naar welke vaardigheid relevant zou kunnen zijn
|
|
- ❌ Het ophalen van alleen een subset van vaardigheden "omdat je denkt dat die relevant zijn"
|
|
- ❌ Het overslaan van het ophalen van alle data bij onzekerheid
|
|
|
|
**VERPLICHT:**
|
|
|
|
- ✅ Bij twijfel: gebruik altijd Scenario 1
|
|
- ✅ Haal alle vaardigheden op wanneer je moet bepalen welke relevant zijn
|
|
- ✅ Analyseer de volledige dataset om te bepalen welke vaardigheden van toepassing zijn
|
|
|
|
### VERPLICHT: Meerdere Requests voor Meerdere Vaardigheden
|
|
|
|
**KRITIEK**: Wanneer je meerdere specifieke vaardigheden nodig hebt, maak je meerdere aparte requests.
|
|
|
|
**VERBODEN:**
|
|
|
|
- ❌ Het proberen om meerdere vaardigheden in één request te combineren
|
|
- ❌ Het ophalen van alle vaardigheden wanneer je alleen specifieke nodig hebt (tenzij Scenario 1 van toepassing is)
|
|
|
|
**VERPLICHT:**
|
|
|
|
- ✅ Maak voor elke vaardigheid een aparte request
|
|
- ✅ Voer elk script commando apart uit
|
|
- ✅ Verwerk de resultaten van elke request afzonderlijk
|
|
|
|
### VERPLICHT: Niveau Filter Alleen bij Expliciete Vraag
|
|
|
|
**KRITIEK**: Gebruik de `--level` filter alleen wanneer de gebruiker expliciet vraagt naar een specifiek niveau.
|
|
|
|
**VERBODEN:**
|
|
|
|
- ❌ Het toevoegen van `--level` "omdat je denkt dat het handig is"
|
|
- ❌ Het filteren op niveau zonder expliciete vraag van de gebruiker
|
|
- ❌ Het aannemen van een niveau zonder dat dit wordt genoemd
|
|
|
|
**VERPLICHT:**
|
|
|
|
- ✅ Gebruik `--level` alleen wanneer expliciet gevraagd (bijv. "niveau 2", "level 3", "op niveau 4")
|
|
- ✅ Haal standaard alle niveaus op voor de geselecteerde vaardigheid(en)
|
|
- ✅ Laat de gebruiker alle niveaus zien tenzij specifiek anders gevraagd
|
|
|
|
## Script Gebruik
|
|
|
|
### Basis Commando
|
|
|
|
Het Python script `scripts/vaardigheden.py` wordt gebruikt om vaardigheden op te halen:
|
|
|
|
```bash
|
|
python scripts/vaardigheden.py [--skill SKILL] [--level LEVEL]
|
|
```
|
|
|
|
### Argumenten en Opties
|
|
|
|
- `--skill SKILL`: De naam van een specifieke vaardigheid om op te halen
|
|
|
|
- Als niet opgegeven: haalt alle vaardigheden op (Scenario 1)
|
|
- Moet exact overeenkomen met een van de tien geldige vaardigheidsnamen
|
|
- Hoofdlettergevoelig
|
|
|
|
- `--level LEVEL`: Filter op specifiek niveau (1, 2, 3, of 4)
|
|
|
|
- **ALLEEN gebruiken wanneer expliciet gevraagd naar een specifiek niveau**
|
|
- Optioneel: kan gecombineerd worden met `--skill`
|
|
- Als niet opgegeven: haalt alle niveaus op voor de geselecteerde vaardigheid(en)
|
|
|
|
- `-h` of `--help`: Toont gebruiksinformatie en sluit af
|
|
|
|
### Response Formaat
|
|
|
|
**Scenario 1 - Alle vaardigheden (zonder argumenten):**
|
|
|
|
```json
|
|
{
|
|
"Juiste kennis ontwikkelen": {
|
|
"1": {
|
|
"title": "Student bepaalt welke kennis..."
|
|
},
|
|
"2": {
|
|
"title": "niveau 1 + \n\nStudent kijkt naar gangbare..."
|
|
},
|
|
"3": {
|
|
"title": "niveau 2 + \n\nStudent kijkt zelfstandig..."
|
|
},
|
|
"4": {
|
|
"title": "niveau 3 + \n\nStudent laat zien..."
|
|
}
|
|
},
|
|
"Kwalitatief product maken": {
|
|
"1": { "title": "..." },
|
|
"2": { "title": "..." },
|
|
"3": { "title": "..." },
|
|
"4": { "title": "..." }
|
|
},
|
|
...
|
|
}
|
|
```
|
|
|
|
**Scenario 2a - Specifieke vaardigheid (zonder niveau filter):**
|
|
|
|
```json
|
|
{
|
|
"Samenwerken": {
|
|
"1": { "title": "..." },
|
|
"2": { "title": "..." },
|
|
"3": { "title": "..." },
|
|
"4": { "title": "..." }
|
|
}
|
|
}
|
|
```
|
|
|
|
**Scenario 2c - Specifieke vaardigheid op specifiek niveau:**
|
|
|
|
```json
|
|
{
|
|
"Reflecteren": {
|
|
"3": {
|
|
"title": "..."
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Sommige niveaus kunnen ook een `info` veld bevatten met aanvullende informatie, links naar bronnen, of voorbeelden.
|
|
|
|
## Validatie en Foutafhandeling
|
|
|
|
### Validatie
|
|
|
|
Het script valideert automatisch:
|
|
|
|
1. **Vaardigheidsnaam**: Controleert of de opgegeven naam exact overeenkomt met een van de tien geldige vaardigheden
|
|
2. **Niveau**: Controleert of het niveau een geldige waarde is (1, 2, 3, of 4)
|
|
3. **Data bestand**: Controleert of het benodigde JSON bestand bestaat
|
|
|
|
### Foutmeldingen
|
|
|
|
**Ongeldige vaardigheidsnaam:**
|
|
|
|
```
|
|
Error: Invalid skill: Ongeldige naam
|
|
Valid skills: Juiste kennis ontwikkelen, Kwalitatief product maken, ...
|
|
```
|
|
|
|
**Ongeldig niveau:**
|
|
|
|
```
|
|
Error: Invalid level: 5 (must be 1-4)
|
|
```
|
|
|
|
**Ontbrekend data bestand:**
|
|
|
|
```
|
|
Error: Data file not found: /path/to/vaardigheden-nl.json
|
|
```
|
|
|
|
**Geen resultaten:**
|
|
|
|
```
|
|
No skills found with the specified filters
|
|
```
|
|
|
|
Alle foutmeldingen worden naar stderr geschreven. Het script eindigt met exit code 1 bij fouten.
|
|
|
|
## Exit Codes
|
|
|
|
- `0`: Succesvol uitgevoerd
|
|
- `1`: Fout opgetreden (ongeldige input, ontbrekend bestand, geen resultaten)
|
|
|
|
## Best Practices Samenvatting
|
|
|
|
1. **Bij onzekerheid**: Gebruik altijd Scenario 1 (alle vaardigheden ophalen)
|
|
2. **Gebruik alleen gereturned data**: Verzin geen criteria, gebruik alleen wat het script retourneert
|
|
3. **Meerdere vaardigheden**: Maak meerdere aparte requests
|
|
4. **Niveau filter**: Alleen gebruiken wanneer expliciet gevraagd
|
|
5. **Exacte namen**: Vaardigheidsnamen zijn hoofdlettergevoelig en moeten exact overeenkomen
|
|
6. **Alle niveaus**: Haal standaard alle niveaus op tenzij expliciet anders gevraagd
|