Transitionsguide Sammenstillede fildownload (EJF)

Denne side beskriver, gennem et eksempel, hvordan du som anvender af EJFs ”MedStamoplysninger” filudtræk kan hente samme data via de sammenstillede fildownload.

Situationsbeskrivelse

Dette eksempel tager udgangspunkt i en anvender som allerede bruger Datafordeleren og gør brug af Ejerskab med stamoplysning_HF.

Anvenderen har sat følgende abonnement op:

• SincePrevious = False
• RegistreringFra = NOW()
• Format = JSON
• Dagligt udtræk

Anvenderen bruger en ssh-bruger til at tilgå filudtræk.

Transition

1. Anvenderen opretter et IT-System og en OAuth-autentifikationsmetode på Datafordeler Administration.
2. Anvenderen opretter en dataadgangsansøgning til EJF-registeret og anmoder om adgang til CustomEjerskabMedStamoplysningerFileDownload.
3. EJF-registeret godkender anmodningen.
4. Anvenderen kalder metoden GetAvailableCustomFiledownloads med OAuth som autentifikationsmetode og henter de filer som hører til EjerskabMedStamoplysninger entiteten:
   

   https://api.datafordeler.dk/FileDownloads/GetCustomAvailableFileDownloads?Register=EJF&Entity=EjerskabMedStamoplysninger

    
5. Anvender ved nu hvilke filer der eksisterer for EjerskabMedStamoplysninger entiteten. Anvender finder i returværdierne filnavnet på den nyeste ikke-kommuneopdelte totaldownload fil, og noterer dette filnavn samt den dertilhørende CustomBaseDataMetadata-data.
6. Anvender henter den identificerede EjerskabMedStamoplysninger fil ved kald til GetFile endepunktet:
   

   https://api.datafordeler.dk/FileDownloads/GetFile?filename=skal-udfyldes

7. Anvender er nu i besiddelse af EJF-entiteten Ejerskab samt den CPR-data som er sammenstillet herpå.
   • Hvis anvender kun har brug for dette data, behøver anvender ikke udføres flere trin.
   • Hvis anvender derimod har brug for data fra de andre tabeller som er inkluderet i Ejerskab med stamoplysning_HF filudtrækket skal de næste trin også udføres.
8. Hvis ekstra data fra CPR, EJF eller EBR er nødvendig, bør udtræksnumrene og versionsnumrene fra det noterede CustomBaseDataMetadata-data bruges til at hente de entitetsbaserede fildownload som stemmer overens med disse numre. Hermed sikres datakonsistent på tværs af de registre som er involveret i sammenstillingen. Disse entitetsbaserede fildownload skal hentes fra GetAvailableFileDownloads og GetFile endepunkterne, som beskrevet i afsnit Sådan henter du entitetsbaserede fildownload.
9. Hvis ekstra data fra CVR, DAR eller andre registre er nødvendige, skal anvender hente et fildownload hvis generationstidspunkt stemmer nogenlunde overens med det sammenstillede fildownload generationstidspunkt. Det præcise tidspunkt som bør hentes her, kommer dog an på anvenders konkrete forretningsbehov. Denne data hentes også via GetAvailableFileDownloads og GetFile endepunkterne.