Asset Manager - Handleiding
De Asset Manager module stelt u in staat om SIKB0101 validatie-assets te beheren, inclusief XSD schema's, XSLT stylesheets en lookup tabellen.
Doel van de pagina
De Asset Manager biedt beheerders de mogelijkheid om:
- Assets uploaden: Nieuwe of bijgewerkte validatie-assets installeren
- Assets downloaden: Bestaande assets exporteren als ZIP bestand
- Versies beheren: Meerdere protocol versies onderhouden
Let op: Deze functionaliteit is bedoeld voor beheerders. Neem contact op met uw systeembeheerder als u toegang nodig heeft.
Gebruikershandleiding
Asset Package Structuur
Een SIKB0101 asset package is een ZIP bestand met de volgende structuur:
asset-package.zip
├── Lookups/
│ ├── imsikb0101 lookup v14.9.0.xml
│ └── immetingen lookup v14.9.0.xml
├── Schemas/
│ ├── imsikb0101_v14.9.0.xsd
│ ├── immetingen_v14.9.0.xsd
│ └── imsikb0101 Labaanlevering v14.9.0.xsd
└── Stylesheets/
├── functies.xsl
├── functies_API.xsl
├── LIB_Controle.xsl
├── Onderzoek_Controle.xsl
├── LabAssignment_Controle.xsl
├── Labresult_Controle.xsl
├── Melding_Controle.xsl
└── LogRecordsPresentation.xsl
Assets Uploaden
Stap 1: ZIP bestand selecteren
- Navigeer naar de Upload Asset Package sectie
- Klik op het bestandsveld of sleep een ZIP bestand
- Het geselecteerde bestand wordt getoond met bestandsgrootte
Maximum bestandsgrootte: 50 MB
Stap 2: Doelversie kiezen
Selecteer de doelversie voor de assets:
Optie A: Bestaande versie bijwerken
- Selecteer een bestaande versie uit de dropdown
- Bestaande bestanden worden overschreven
Optie B: Nieuwe versie toevoegen
- Selecteer "+ Add New Version..."
- Voer de versienummers in (Major, Minor, Revision)
Nieuwe versie aanmaken
Bij het aanmaken van een nieuwe versie:
| Veld | Beschrijving | Voorbeeld |
|---|---|---|
| Major | Hoofdversie | 14 |
| Minor | Subversie | 9 |
| Revision | Revisie | 0 |
De directory wordt automatisch benoemd naar het formaat: v14.9
Waarschuwing: Als de versie al bestaat, krijgt u een melding dat bestaande bestanden worden overschreven.
Stap 3: Upload starten
- Klik op Upload and Install
- Wacht tot de upload is voltooid
- Bekijk het resultaat
Succesvolle upload
Bij een succesvolle upload ziet u:
- Versienummer van de geïnstalleerde assets
- Aantal geëxtraheerde bestanden
- Doellocatie op de server
Mislukte upload
Bij een mislukte upload ziet u:
- Foutmeldingen met details
- Validatieresultaten (welke directories/bestanden ontbreken)
Assets Downloaden
ZIP Export maken
- Navigeer naar de Download Asset Package sectie
- Selecteer de gewenste versie uit de dropdown
- Klik op Download ZIP
Het gedownloade ZIP bestand bevat alle assets van de geselecteerde versie en kan worden gebruikt voor:
- Backup doeleinden
- Distributie naar andere systemen
- Archivering
Geïnstalleerde Versies
Versie overzicht
De Installed Versions sectie toont alle beschikbare versies:
Elk item toont:
- Directory naam: Fysieke mapnaam (bijv.
v14.9) - Versienummer: Volledige versie (bijv.
v14.9.0)
Asset locatie
Onderaan de sectie staat het pad naar de assets directory op de server. Dit is nuttig voor:
- Troubleshooting
- Handmatige bestandsbeheer
- Backup procedures
Package Vereisten
Verplichte directories
Een geldig asset package moet de volgende directories bevatten:
| Directory | Inhoud | Vereist |
|---|---|---|
| Lookups/ | XML lookup tabellen | Ja |
| Schemas/ | XSD schema definities | Ja |
| Stylesheets/ | XSLT validatie regels | Ja |
Bestandsnaamconventies
Bestanden moeten de juiste naamgevingsconventies volgen:
- Lookups:
*v14.9.0.xml - Schemas:
*v14.9.0.xsd - Stylesheets:
*.xsl
Belangrijk: Alle bestanden binnen een package moeten hetzelfde versienummer gebruiken.
Validatie van Packages
Bij het uploaden wordt het package gevalideerd:
Gecontroleerde items
| Controle | Beschrijving |
|---|---|
| Directory structuur | Aanwezigheid van Lookups, Schemas, Stylesheets |
| Bestandstelling | Aantal bestanden per directory |
| Bestandstypen | Correcte extensies (.xml, .xsd, .xsl) |
Validatie resultaten
- Groen vinkje: Directory/bestand aanwezig en geldig
- Rood kruis: Directory/bestand ontbreekt of ongeldig
Veelgestelde vragen
Kan ik meerdere versies tegelijk geïnstalleerd hebben?
Ja, de applicatie ondersteunt meerdere versies naast elkaar. Bij validatie wordt automatisch de juiste versie gebruikt op basis van het XML bestand.
Wat gebeurt er als ik een bestaande versie overschrijf?
Alle bestaande bestanden worden vervangen door de nieuwe bestanden uit het package. Zorg ervoor dat u een backup maakt voordat u overschrijft.
Hoe weet ik welke versie wordt gebruikt voor validatie?
De versie wordt automatisch gedetecteerd uit het XML bestand. In de validatieresultaten wordt de gebruikte versie getoond.
Kan ik assets handmatig toevoegen of aanpassen?
Ja, maar dit wordt niet aanbevolen. Handmatige wijzigingen kunnen leiden tot inconsistenties. Gebruik altijd de upload functie voor wijzigingen.
Tips voor beheerders
- Maak regelmatig backups: Download bestaande versies voordat u wijzigingen maakt
- Test nieuwe versies: Upload eerst naar een testomgeving voordat u productie bijwerkt
- Documenteer wijzigingen: Houd bij welke wijzigingen u aan assets maakt
- Gebruik consistente naamgeving: Volg de SIKB0101 naamgevingsconventies
Technische details
Asset opslag
Assets worden opgeslagen in de server directory structuur:
Assets/
├── v14.9/
│ ├── Lookups/
│ ├── Schemas/
│ └── Stylesheets/
└── v15.0/
├── Lookups/
├── Schemas/
└── Stylesheets/
Ondersteunde bestandstypen
| Type | Extensie | Doel |
|---|---|---|
| Lookup tabellen | .xml | Waardelijsten voor validatie |
| Schema's | .xsd | XML structuur definities |
| Stylesheets | .xsl | XSLT transformaties en validatieregels |