Generelt Udtræk leveres som Zip-filer indeholdende udtræk i det format, som man som kunde har valgt.

Transkript

1 Udtræksformater Generelt Udtræk leveres som Zip-filer indeholdende udtræk i det format, som man som kunde har valgt. Sektioner Grundlæggende er et udtræk opdelt i tre sektioner: 1. Virksomheder indeholder data om de virksomheder der er inkluderet i udtrækket 2. Produktionsenheder indeholder data om produktionsenheder der er inkluderet i udtrækket 3. Deltagere indeholder information om deltagere for de virksomheder og produktionsenheder der er inkluderet i de øvrige sektioner Et udtræk indeholder kun de sektioner som man som kunde har valgt under definitionen af udtrækket. Alle sektioner indeholder aktive data på leveringstidspunktet. Der gælder om alle attributter under hver sektion, at de kun er med i udtrækket, hvis man som kunde har valgt dem i sin udtræksdefinition (som standard er alle elementer valgt). På grund af disse valgmuligheder, der kan foretages ved bestilling af udtræk, bør indlæsningsværktøjer som indlæser data fra udtræk være tolerante i deres forventning til data. Anbefalingen er at værktøjer ikke laver antagelser om at felter er til stede i udtrækket, og accepterer, at der kan være felter til stede i udtrækket som værktøjet ikke genkender. Dette vil også gøre det lettere at justere for kommende nyt data, som Erhvervsstyrelsen fremadrettet stiller til rådighed. Private kunder vs. offentlige kunder Udtræk til private kunder indeholder ingen eksakte beskæftigelsesoplysninger (antal ansatte) og heller ingen cpr-numre. Udtræk til offentlige kunder kan indeholde disse informationer. Feltforklaringer Hovedparten af felterne er data registreret om virksomheder og produktionsenheder, samt fra hvilken dato disse data var gældende (felter, hvis navn ender på gyldigfra ). 1

2 Modifikationsstatus Alle virksomheder, produktionsenheder og deltagere har en modifikationsstatus. Denne er interessant i forbindelse med abonnementer, da den indikerer hvorvidt virksomheden, produktionsenheden eller deltageren er ny, ændret eller udgået siden seneste leverede udtræk fra samme abonnement. ny enheden var ikke med i seneste leverede udtræk, men opfylder nu udtrækkets filter (i et abonnements første leverede udtræk er alle enheder nye) modificeret enheden er modificeret siden seneste leverede udtræk og opfylder stadig udtrækkets filter umodificeret enheden er ikke modificeret siden sidste leverede udtræk, og opfylder derfor stadig udtrækkets filter fjernet enheden var med i seneste leverede udtræk, men opfylder ikke længere udtrækkets filter fx hvis enheden er ophørt En enhed betragtes som modificeret, hvis enten datagrundlaget for enheden er modificeret, herunder enhedens egne data eller tilføjede/fjernede relationer mellem virksomhed/produktionsenhed/deltager datagrundlaget for enheden er ikke modificeret, men data der var registreret med fremtidig aktiveringsdato ved seneste levering, er i mellemtiden blevet aktive Har man som kunde valgt at leverancer kun skal indeholde Nye enheder siden sidste levering, er det kun enheder med modifikationsstatus ny der indgår i udtrækket. Virksomhed: Produktionsenheder Udtrækket for virksomheder har en liste over virksomhedens produktionsenheder. Her refereres produktionsenhedernes P-NR. Virksomhed, Produktionsenhed: Deltagere Udtrækkene for virksomheder og produktionsenheder har en liste over enhedernes fuldt ansvarlige deltagere. Her refereres deltagernes deltagernummer. Deltagere Udtrækket med deltagere indeholder ganske få oplysninger om deltageren. Deltageren vil være vist for hver virksomhed eller produktionsenhed som deltageren deltager i. Deltagernummer Identifikation af deltageren. 2

3 Cvrnr, pnr For hver deltager i udtrækket er enten cvrnr eller pnr udfyldt afhængigt af om deltageren deltager i en virksomhed eller produktionsenhed. Deltagertype, id, navn, personstatus Semantikken af disse felter afhænger af værdien i feltet deltagertype : person felterne id og navn er hhv. deltagerens CPR-NR (vises ikke for private kunder) og navn, personstatus er en informativ tekst om personens status virksomhed felterne id og navn er hhv. deltagerens CVR-NR og navn, personstatus er ikke udfyldt produktionsenhed felterne id og navn er hhv. deltagerens P-NR og navn, personstatus er ikke udfyldt andendeltager feltet navn er udfyldt XML format Dette format er dokumenteret i vedlagte skemadefinition report.xsd. XML-udtræk leveres i UTF-8 tegnsæt. Udtræk i XML formatet består af én fil, opdelt i de tre sektioner. Der indgår kun elementer i udtrækket som man som kunde har opsat i sit udtræk. Udeblivelse af elementer kan skyldes at man ikke har opsat elementet i udtrækket, eller at elementet ikke har noget indhold for den givne enhed. Det kan også forekomme at elementer har tomt indhold, det er ækvivalent med et udeladt felt. CSV format Dette format er et komma-separeret format, som grundlæggende er en flad udgave af XML formatet. CSV-formatet leveres i UTF-8 tegnsæt. I modsætning til XML formatet er der op til tre filer, én fil pr. sektion, som man som kunde har ønsket i sit udtræk. Første linje i filen er en header-linje, som viser rækkefølgen af felter. Efterfølgende er én linje pr. enhed, hvor værdierne er vist i samme rækkefølge som beskrevet i header-linjen. Alle felter man som kunde har opsat i sit udtræk (som standard er alle felter tilvalgt) vil være vist i CSV filen, uanset om felterne har indhold eller ej. Tomme felter betyder, at elementet ikke har nogen værdi for den givne enhed. Escaping Alle felter benytter escaping til at håndtere at indhold kan indeholde kommaer, som ellers betragtes som felt-separator 3

4 Der benyttes escaping i et felt, hvis elementets værdi indeholder komma, linjeskift eller anførselstegn. Her omkranses elementets værdi i anførselstegn, og alle forekomster af anførselstegn i værdien escapes med et ekstra anførselstegn. Dette felt skal escapes, da det indeholder anførselstegn og komma Bliver til Dette felt skal escapes, da det indeholder anførselstegn og komma Værktøjer som indlæser CSV filen skal selv detektere at et felt er escapet (det er omkranset af anførselstegn) og hvis det er, så skal dobbelte anførselstegn håndteres. Læs eventuel mere om komma-separerede filer med brug af escaping på Feltnavne Feltnavnene i header-linjen er opbygget ud fra navnene i XML formatet. Her er et eksempel på dette: Antag at en virksomheds beliggenhedsadresse i XML-formatet er struktureret som følger: <beliggenhedsadresse> <vejnavn/> <kommune> <kode/> <tekst/> </kommune> </beliggenhedsadresse> Så vil virksomhedens beliggenhedsadresse i CSV-formatet have header-navnene: beliggenhedsadresse_vejnavn, beliggenhedsadresse_kommune_kode, beliggenhedsadresse_kommune_tekst Som det ses af eksemplet opbygges navnene for en enheds attributter ved en sammensætning af navnene i strukturen. Feltforklaring Selvom CSV-formatet generelt indeholder samme information som XML-formatet, er der dog enkelte undtagelser. Disse er beskrevet her. 4

5 Virksomhed: Produktionsenheder Virksomheder inkluderer en liste af P-Nr. for virksomhedens produktionsenheder. Denne liste er i CSV-formatet indkodet i et enkelt felt som en komma-separeret liste omkranset af anførselstegn , , CSV-formatet indeholder i modsætning til XML-formatet ikke gyldighedsdatoer for disse relationer. Virksomhed, Produktionsenhed: Deltagere Virksomheder og produktionsenheder inkluderer en liste af deltagernumre for enhedens fuldt ansvarlige deltagere. Denne liste er i CSV-formatet indkodet i et enkelt felt som en komma-separeret liste omkranset af anførselstegn , , CSV-formatet indeholder i modsætning til XML-formatet ikke gyldighedsdatoer for disse relationer. Virksomhed: Kreditoplysning CSV-formatet indeholder i modsætning til XML-formatet højst én kreditoplysning (konkurs eller tvangsakkord). Produktionsenhed: Virksomhed Normalt kan en produktionsenhed kun være tilknyttet én virksomhed på et givent tidspunkt. Skulle det hænde ved en fejl at en produktionsenhed er tilknyttet mere end én virksomhed på samme tid, vil produktionsenheden være listet i CSV-formatet en gang pr. virksomhed, hvor felterne virksomhed_gyldigfra og virksomhed_cvrnr vil udpege den respektive virksomhed. Excel format Dette format leveres, så det kan åbnes i Excel 2007 (og senere versioner af Excel i det omfang at de er bagud kompatible med Excel 2007). Formatet består af en enkelt projektmappe (workbook) med et ark (worksheet) for hver sektion. I tilfælde af meget store udtræk kan en sektion være opsplittet i flere ark, for at undgå at overtræde tekniske begrænsninger i Excel. Indholdet af et ark er identisk med CSV-formatet, navnene i header-linjen er de samme, og der er samme indhold i felterne. Der gælder de samme undtagelser i forhold til XML-formatet. 5