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 en bruger på Datafordeler Administration med et IT-System og en OAuth-autentifikationsmetode.
2. Anvenderen opretter en dataadgangsansøgning til EJF-registeret og anmoder om adgang til CustomEjerskabMedStamoplysningerFileDownload i Datafordeler Administration.
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/v1.0/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 metoden:
   

   https://api.datafordeler.dk/FileDownloads/v1.0/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. For Customfildownload: Hvis man ønsker andet data fra registrene CPR og EBR, 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 metoderne GetAvailableFileDownloads og GetFile, som beskrevet i afsnittet Sådan henter du entitetsbaserede fildownload.
9. Hvis man ønsker data fra registre, som ikke har Customfildownload, eksempelvis CVR, MAT eller BBR, skal anvender hente et fildownload hvis generationstidspunkt stemmer nogenlunde overens med det sammenstillede fildownloads 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 metoderne.