Page History

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 på Datafordeler Administration.
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 endepunktetmetoden:
   

   https://api.datafordeler.dk/FileDownloads/v1.0/GetFile?filename=

   skal

   <skal-

   udfyldes

   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 For Customfildownload: Hvis man ønsker andet data fra registrene CPR , EJF eller og 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 metoderne GetAvailableFileDownloads og GetFile endepunkterne, som beskrevet i afsnit afsnittet Sådan henter du entitetsbaserede fildownload.
9. Hvis ekstra man ønsker data fra registre, som ikke har Customfildownload, eksempelvis CVR, DAR eller andre registre er nødvendigeMAT eller BBR, skal anvender hente et fildownload hvis generationstidspunkt stemmer nogenlunde overens med det sammenstillede fildownload 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 endepunkternemetoderne.