Opladen Prestatiebestanden met behulp van een XML bestand Het is mogelijk om 1 of meerdere prestatiebestanden op te laden door middel van een XML bestand. Teneinde de inhoud en de layout van dit XML bestand te bewaken, werd een XSD schema voorzien dat, indien gebruikt bij het genereren van de XML, reeds de gewenste inhoud zal nakijken. Om u te helpen bij het van de gegevens, wordt hieronder de(verwachte) inhoud van het document besproken. 1. Inhoud 1. Inhoud... 1 2. Basis layout van het XML bestand... 2 3. Downloaden van een vooraf ingevuld prestatiebestand... 3 4. Aanvullen van een gedownload prestatiebestand... Fout! Bladwijzer niet gedefinieerd. 5. Zelf genereren van een prestatiebestand... 6 6. Extra informatie in verband met het opzoeken van de gegevens indien niet alle velden zijn ingevuld... 9 2 oktober 2012 Pagina 1
2. Basis layout van het XML bestand Een XML bestand kan aanzien worden als een boom structuur, de basis boomstructuur van het op te laden bestand is als volgt: <prestatie bestand lijst> Hoofd tak, altijd aanwezig, exact 1 element <prestatie bestand> Per prestatiebestand is een tak aanwezig, dit kunnen er meerdere zijn <prestatie lijn> 1 element per individuele fiche voor het prestatiebestand van de bovenliggende tak <dag prestatie> 1 element per ingevoerde dagprestatie per prestatielijn van de bovenliggende tak. Maximaal evenveel elementen als er dagen in de prestatiemaand aanwezig zijn 2 oktober 2012 Pagina 2
3. Downloaden van een vooraf ingevuld prestatiebestand Om reeds een aanzet te geven voor de inhoud van dit bestand, zal het mogelijk zijn om via de applicatie één of meerdere klaargezette prestatiebestanden te downloaden. In dat geval zullen alle basisgegevens per prestatiebestand reeds vooraf ingevuld worden. In het oranje zijn de basisvelden aangeduid die Ingevuld worden bij het downloaden van een prestatiebestand. De overige velden worden eveneens ingevuld indien reeds gegevens aanwezig zijn in de applicatie. Prestatiebestand: conventie nr Nummer, maximaal 5 posities Nummer van de conventie Indien niet ingevuld of ongeldig wordt het prestatiebestand niet opgeladen prestatie periode MM/YYYY Maand/ar van de uitgevoerde prestaties Indien niet ingevuld of ongeldig wordt het prestatiebestand niet opgeladen prestatie staat type I of B I : initieel bestand B : bijvoegsel Extra hulp bij het identificeren van het prestatiebestand in de applicatie Indien ingevuld, moet de waarde wel correct zijn, zoniet wordt het prestatiebestand niet opgeladen volgnr Nummer, maximaal 5 posities Volgnummer van het prestatiebestand in het systeem (altijd 1 voor een initieel bestand) Extra hulp bij het identificeren van het prestatiebestand in de applicatie Indien ingevuld, moet de waarde wel correct zijn, zoniet wordt het prestatiebestand niet opgeladen kbo nr String, 10 posities KBO nummer Informatief veld, wordt niet conventie naam String, 60 posities Naam van de conventie Informatief veld, wordt niet email1 String, 64 posities Email adres 1 te gebruiken in de Wordt indien ingevuld applicatie bij mailcommunicatie email2 String, 64 posities Email adres 2 te gebruiken in de applicatie bij mailcommunicatie Wordt indien ingevuld 2 oktober 2012 Pagina 3
Prestatielijn: Nummer, 3 posities Individu nummer van de werknemer Extra hulp bij het identificeren van de prestatielijn in de applicatie Nummer, 2 posities Individu volgnummer van de werknemer Extra hulp bij het identificeren van de prestatielijn in de applicatie Nummer, 11 posities Rijksregisternummer van de werknemer Indien niet ingevuld of ongeldig wordt deze prestatielijn niet opgeladen naam String, 30 posities Naam van de werknemer Informatief veld, wordt niet voornaam String, 30 posities Voornaam van de werknemer Informatief veld, wordt niet in dienst datum DD/MM/YYYY Datum in dienst van de werknemer Informatief veld, wordt niet uren werknemer HH:MM Het aantal te presteren uren en minuten dat voor de huidige periode voorzien is voor de werknemer Informatief veld, wordt niet uit dienst datum DD/MM/YYYY Datum uit dienst van de werknemer Wordt indien ingevuld vergoeding bedrag Nummer, 9 posities waarvan 2 decimalen, Bedrag SINE of Integratie Wordt indien ingevuld prestatie eenheid DAG, HALF of UUR Indien code werktijd = 1, hier HALF Indien code werktijd = 5, hier UUR Indien code werktijd <> 5, hier DAG Informatief veld, wordt niet 2 oktober 2012 Pagina 4
Dagprestatie: prestatie datum DD/MM/YYYY Datum van de prestatie Indien niet ingevuld of ongeldig wordt deze dagprestatie niet opgeladen voormiddag code String, 1 positie Code die het prestatietype weergeeft (X, V, C, E, T, D, G, A of N) voormiddag prestatie HH:MM Uren+Minuten gewerkt in de voormiddag namiddag code String, 1 positie Code die het prestatietype weergeeft (X, V, C, E, T, D, G, A of N) namiddag prestatie HH:MM Uren+Minuten gewerkt in de namiddag Wordt indien ingevuld (niet ingevuld = geen prestatie) Wordt indien ingevuld. = UUR. Wordt indien ingevuld (niet ingevuld = geen prestatie) = UUR of DAG. Voor prestatie eenheid HALF wordt deze code genegeerd Wordt indien ingevuld. = UUR. 2 oktober 2012 Pagina 5
4. Zelf genereren van een prestatiebestand Indien u zelf een XML wenst te genereren, gelieve rekening te houden met onderstaand overzicht van de velden die ingevuld dienen te worden teneinde deze gegevens te kunnen terugvinden in de applicatie. In het oranje zijn de velden aangeduid die minimaal dienen aanwezig te zijn teneinde de gegevens correct te kunnen identificeren in de applicatie. Prestatiebestand: conventie nr Nummer, maximaal 5 posities Nummer van de conventie Indien niet ingevuld of ongeldig wordt het prestatiebestand niet opgeladen prestatie periode MM/YYYY Maand/ar van de uitgevoerde prestaties Indien niet ingevuld of ongeldig wordt het prestatiebestand niet opgeladen prestatie staat type I of B I : initieel bestand B : bijvoegsel Extra hulp bij het identificeren van het prestatiebestand in de applicatie Indien ingevuld, moet de waarde wel correct zijn, zoniet wordt het prestatiebestand niet opgeladen volgnr Nummer, maximaal 5 posities Volgnummer van het prestatiebestand in het systeem (altijd 1 voor een initieel bestand) Extra hulp bij het identificeren van het prestatiebestand in de applicatie Indien ingevuld, moet de waarde wel correct zijn, zoniet wordt het prestatiebestand niet opgeladen kbo nr String, 10 posities KBO nummer Informatief veld, wordt niet conventie naam String, 60 posities Naam van de conventie Informatief veld, wordt niet email1 String, 64 posities Email adres 1 te gebruiken in de Wordt indien ingevuld applicatie bij mailcommunicatie email2 String, 64 posities Email adres 2 te gebruiken in de applicatie bij mailcommunicatie Wordt indien ingevuld 2 oktober 2012 Pagina 6
Prestatielijn: Nummer, 3 posities Individu nummer van de werknemer Extra hulp bij het identificeren van de prestatielijn in de applicatie Nummer, 2 posities Individu volgnummer van de werknemer Extra hulp bij het identificeren van de prestatielijn in de applicatie Nummer, 11 posities Rijksregisternummer van de werknemer Indien niet ingevuld of ongeldig wordt deze prestatielijn niet opgeladen naam String, 30 posities Naam van de werknemer Informatief veld, wordt niet voornaam String, 30 posities Voornaam van de werknemer Informatief veld, wordt niet in dienst datum DD/MM/YYYY Datum in dienst van de werknemer Informatief veld, wordt niet uren werknemer HH:MM Het aantal te presteren uren en minuten dat voor de huidige periode voorzien is voor de werknemer Informatief veld, wordt niet uit dienst datum DD/MM/YYYY Datum uit dienst van de werknemer Wordt indien ingevuld vergoeding bedrag Nummer, 9 posities waarvan 2 decimalen, Bedrag SINE of Integratie Wordt indien ingevuld prestatie eenheid DAG, HALF of UUR Indien code werktijd = 5, hier UUR Indien code werktijd = 1, hier HALF Indien code werktijd <> 5, hier DAG Informatief veld, wordt niet 2 oktober 2012 Pagina 7
Dagprestatie: prestatie datum DD/MM/YYYY Datum van de prestatie Indien niet ingevuld of ongeldig wordt deze dagprestatie niet opgeladen voormiddag code String, 1 positie Code die het prestatietype weergeeft (X, V, C, E, T, D, G, A of N) voormiddag prestatie HH:MM Uren+Minuten gewerkt in de voormiddag namiddag code String, 1 positie Code die het prestatietype weergeeft (X, V, C, E, T, D, G, A of N) namiddag prestatie HH:MM Uren+Minuten gewerkt in de namiddag Wordt indien ingevuld (niet ingevuld = geen prestatie) Wordt indien ingevuld. = UUR. Wordt indien ingevuld (niet ingevuld = geen prestatie) = UUR of DAG. Voor prestatie eenheid HALF wordt deze code genegeerd Wordt indien ingevuld. = UUR. 2 oktober 2012 Pagina 8
5. Extra informatie in verband met het opzoeken van de gegevens indien niet alle velden zijn ingevuld Prestatiebestand: Het is niet verplicht om prestatie staat type en volgnr door te geven. Echter, indien meerdere prestatiebestanden voor eenzelfde conventie/maand worden doorgegeven (in de praktijk kunnen dit enkel bijvoegsels zijn!) is het aan te raden om deze gegevens mee door te geven teneinde het juiste doelbestand terug te vinden. Prestatielijn: Het is niet verplicht om, door te geven. Volgende werkwijze wordt gehanteerd om een prestatielijn in het doelbestand terug te vinden: Veld Ingevoerd? Match gevonden?, 1 of meerdere lijnen Resultaat De eerst gevonden prestatielijn wordt als doellijn geidentificeerd en gebruikt De prestatielijn waarvoor alle gegevens overeenkomen wordt gebruikt. Geen prestatielijn gevonden in het doelbestand. Deze lijn zal niet worden opgeladen en als lijn te veel worden gemarkeerd in het eindverslag De eerst gevonden prestatielijn waarvoor eveneens overeenkomt wordt als doellijn geidentificeerd en gebruikt. Er wordt een waarschuwing genoteerd voor die verschillend is. 2 oktober 2012 Pagina 9
Veld Ingevoerd? Match gevonden? Resultaat De eerst gevonden prestatielijn wordt als doellijn geidentificeerd en gebruikt wordt niet meer gevalideerd (gezien niet gevonden werd) De eerst gevonden prestatielijn wordt als doellijn geidentificeerd en gebruikt. Er wordt een waarschuwing genoteerd voor en die niet gevonden werden. De prestatielijn wordt niet opgeladen. Er wordt niet meer naar de andere gegevens gekeken. Extra: Indien en/of niet of foutief werden doorgegeven (geen unieke identificatie van de gegevens in het doelbestand) én er meerdere lijnen werden doorgegeven voor een rijksregisternummer, zal de 1 e lijn op bovenstaande manier verwerkt worden. De daaropvolgende lijnen met hetzelfde rijksregisternummer echter zullen niet meer verwerkt worden en als foutief teruggekoppeld worden. 2 oktober 2012 Pagina 10