Differences

This shows you the differences between two versions of the page.

--- fmk:generel:extensions_til_services [2015-12-02 15:15] – [Versionering af extensions] jbu
+++ fmk:generel:extensions_til_services [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Extensions til FMK services ======
-FMK har i dag (2015-12-01) 4 snitflader i produktion, FMK 1.2.6, 1.4.0, 1.4.2 og 1.4.4. Desuden arbejdes der i øjeblikket på FMK
+:!: Bemærk: Denne side har til formål at beskrive konceptet med extensions til FMK snitflader. Indholdet på denne side er fiktiv og har kun til formål at illustrere hvad extensions er og hvordan de udvider eksisterende snitflader. For oversigten over faktiske extensions se [[fmk:extensions|Oversigt over extensions]]
-.4.6. Behovet for at kunne udvikle FMK er imidlertid større end evnen til at få integreret nye FMK versioner i alle
-systemerne. Der har været drøftet forskellige forslag til, hvordan denne udfordring kan løses. Denne høring beskriver et nyt begreb ”extensions”, der muliggør at implementere ny funktionalitet i ældre snitflader, således at specifikke features af nye snitflader, kan implementeres i ældre, allerede frigivne snitflader. Det vil ikke kun være FMK snitfladen, der kan udvides med extensions, også POR, EO, TAS og DDV vil kunne udvides med extensions.
-I det følgende beskrives det hvorledes extensions virker og hvad der kan forventes af extensions. Bemærk dette er en beskrivelse af extension, og det nævnte indhold i beskrivelsen har kun til formål at beskrive konceptet og ikke at beskrive de extension der faktuelt er eller bliver implementeret.
+FMK har i dag (2017-12-13) 4 snitflader i produktion, FMK 1.4.0, 1.4.2, 1.4.4 og FMK 1.4.6. Behovet for at kunne udvikle FMK er imidlertid større end behovet for at integrere nye FMK versioner i alle
+systemer. Der har været drøftet forskellige forslag til, hvordan denne udfordring kan løses. Et af disse forslag omhandler ”extensions”, der muliggør at implementere ny funktionalitet i ældre snitflader, således at specifikke features af nye snitflader, kan implementeres i ældre, allerede frigivne snitflader. Det vil ikke kun være FMK snitfladen, der kan udvides med extensions, men også snitfladerne for POR, EO, TAS og DDV.
+I det følgende beskrives det hvorledes extensions virker og hvad der kan forventes af extensions. Bemærk dette er en beskrivelse af extension, og det nævnte indhold i beskrivelsen har kun til formål at beskrive konceptet og ikke de extensions der faktuelt er eller bliver implementeret.
 ===== Versionering af extensions =====
 FMK snitfladerne er versionerede med et versionsnummer f.eks. 1.4.2. Dette versionsnummer er ikke teknisk
-implementeret noget sted, men versionen er associeret med en eller flere specifikke SOAPAction’s.
+implementeret noget sted, men versionen er associeret med en eller flere specifikke SOAPActions.
 Det kaldende
 system angiver i SOAPAction
@@ Line 16: / Line 18: @@
 SOAPAction
 og den logiske FMK version beskrives i snitfladen på
-http://wiki.fmk.netic.dk/doku.php?id=fmk:generel:versionering_af_services. Pt. ser oversigten for 1.4.x versionerne
+http://wiki.fmk-teknik.dk/doku.php?id=fmk:generel:versionering_af_services. Pt. ser oversigten for 1.4.x versionerne
 således ud:
@@ Line 24: / Line 26: @@
 | 1.4.4 | http://www.dkma.dk/medicinecard/xml.schema/2015/01/01# |
-Med extensions kunne ovesigten se således ud
+Med extensions kunne ovesigten se således ud:
 ^ FMK version ^ Action prefix ^
@@ Line 54: / Line 56: @@
 muligt at implementere E3, og således få ”datoer og historik i POR”, uden også at implementere eCPR. På FMK 1.4.0
 hvor E1 ikke er en mulighed, vil E3 kun indeholde ”datoer og historik i POR”.
-===== Whitelisting af extensions =====
-Denne sammenhæng bruges i forbindelse med whitelisting af hvilken snitflade et klient system er godkendt til. I
+===== Whitelisting af extensions =====
+Klientsystemer godkendes til extensions via whitelisting på samme måde som for standard snitfladerne godkendes. I
 AdmGUI knyttes hvert systems navn og version, med en bestemt snitflade.
 {{:fmk:generel:skaermbillede_2015-12-02_kl._15.03.12.png|}}
-Når der indføres nye features i en allerede frigivet snitflade, sker det ved, at der indføres et fjerde “ciffer” i versionen, således at hvis man vil bruge en ny feature i FMK 1.4.2, skal man implementere FMK 1.4.2. E1, som så er associeret med SOAPAction http://www.dkma.dk/medicinecard/xml.schema/2013/06/01/E1#
+Når der indføres nye features i en allerede frigivet snitflade, sker det ved, at der indføres et fjerde “ciffer” i versionen, således at hvis man vil bruge en ny feature i FMK 1.4.2, skal man implementere FMK 1.4.2.E1, som så er associeret med SOAPAction http://www.dkma.dk/medicinecard/xml.schema/2013/06/01/E1#
+Tager man en extention i brug SKAL hele indholdet af denne extention anvendes. Hvis f.eks. FMK 1.4.2.E1 inderholer en udvidelse af HentMedicinkort og HentMedicinkortVersion, skal begge services implementeres, og forsøg på at kalde en af disse services i en FMK 1.4.2 vil fejle.
 ===== WSDL og skemaer med extensions =====
 Hver extension får en dedikeret WSDL med tilhørende skemaer. Disse frigives separat, hvor ændringer er indført i de
@@ Line 69: / Line 72: @@
 ===== Dokumentation af extensions =====
-Dokumentationen af disse nye features i snitfladen, indføres i snitfladen, med en markering af, at denne feature kun er gældende i en senere version, f.eks. vil siden http://wiki.fmk.netic.dk/doku.php?id=fmk:1.4.2:hent_medicinkort blive ændret således at
+Dokumentationen af disse nye features i snitfladen, indføres i snitfladen, med en markering af, at denne feature kun er gældende i en senere version, f.eks. vil siden http://wiki.fmk-teknik.dk/doku.php?id=fmk:1.4.2:hent_medicinkort blive ændret således at
 {{:fmk:generel:skaermbillede_2015-12-02_kl._15.45.33.png?600|}}