Legacy Document Tracer

Favrskov Kommunes avancerede API til sporing af dokumentidentifikatorer gennem hele ESDH-migrationskæden: KMD → Get Organized → WorkZone

Beskrivelse

Denne service leverer et avanceret API til at spore dokumentidentifikatorer gennem hele ESDH-migrationskæden: KMD → Get Organized → WorkZone. Systemet bruger DuckDB til at tilgå multiple Parquet-datasæt og inkluderer sofistikeret fil-hash opslag, intelligent søgning på tværs af systemer, og automatisk domæne-baseret omdirigering.

Core Funktionalitet

Avancerede Features

API Endpoints

Intelligent Lookup (Hybrid Søgning)

GET /lookup?q={sag-/dokumentnummer eller GO-link}

Returnerer en avanceret HTML-side med intelligent hybrid-søgning. Systemet udfører:

  1. Primær GO→WZ konvertering: Forsøger først direkte konvertering hvis input indeholder GO-identifikator
  2. Fallback krydssystem-søgning: Hvis direkte konvertering fejler, søger på tværs af GO→WZ og KMD→GO datasæt (op til 5 resultater fra hver)
  3. Intelligent parsing: Bruger samme avancerede URI sniffer som API'et
  4. Type-identifikation: Resultater er mærket med kildesystem

Hent Get Organized Link

GET /{sagstype}/{kmd_identifier}?redirect={true|false}

Returnerer et link til Get Organized for en specifik sagstype og KMD-identifikator. Hvis redirect er sat til true (standard), vil API'et omdirigere direkte til Get Organized-linket. Hvis redirect er sat til false, vil API'et returnere et JSON-svar med linkoplysningerne.

Parametre:

Eksempel:

GET /S/710-2007-518?redirect=false

Svar:

{
  "kmd_identifier": "710-2007-518",
  "sagstype": "S",
  "go_identifier": "EMN-2020-00384",
  "go_link": "https://go.favrskovkommune.dk/_layouts/15/CaseApp/Case/JumpTo.aspx?ID=EMN-2020-00384"
}

Søg efter KMD til GO mappings

GET /search/kmd2go?term={search_term}&limit={max_results}&page={page_number}

Søger efter KMD- til Get Organized mappings. Resultaterne er pagineret i henhold til parametrene limit og page.

Parametre:

Eksempel:

GET /search/kmd2go?term=710&limit=5&page=1

Søg efter GO til WZ mappings

GET /search/go2wz?term={search_term}&limit={max_results}&page={page_number}

Søger efter Get Organized- til WorkZone mappings. Resultaterne er pagineret i henhold til parametrene limit og page.

Parametre:

Eksempel:

GET /search/go2wz?term=1&limit=5&page=1

Konverter GO-link til WorkZone-link (Multi-Source)

GET /go2wz?go_identifier={go_id}&redirect={true|false}

Konverterer et GO-identifikator til et WorkZone (WZ) link gennem intelligent multi-source opslag. Systemet søger automatisk gennem:

Understøttede GO-identifikator formater:

Parametre:

Eksempel:

GET /go2wz?go_identifier=EMN-2020-00384&redirect=false

Svar:

{
  "go_identifier": "EMN-2020-00384",
  "wz_identifier": "12345",
  "wz_link": "https://favrskov.workzone.cloud/app/client/#/Records/12345"
}

Catch-all GO til WZ-omdirigering

GET /{any_path_containing_go_id}?redirect={true|false}

Fallback-endpoint, der detekterer en GO-identifikator hvor som helst i forespørgselsstien og omdirigerer eller returnerer JSON som ovenfor.

Ved anmodninger via domænet go.favrskovkommune.dk opfanges enhver GO-identifikator i den fulde URL (sti eller forespørgselsstreng) og sendes videre til /go2wz-endpointet.

Redirectet bygges på den oprindelige anmodnings skema (http/https) og host, så middleware’en virker uanset om brugeren anvender HTTP eller HTTPS.

Middleware’en springer desuden anmodninger til /go2wz-ruten over for at undgå uendelige redirects.

API Dokumentation

Når applikationen kører, kan du få adgang til den interaktive API-dokumentation på: