Plan for FMK 1.6.0 mini-teknikermøder

[Claus Hemberg Jørgensen]

Som annonceret på seneste FMK teknikermøde planlægger vi en række korte, virtuelle teknikermøder om konkrete emner vedr. den kommende 1.6.0 snitflade. Formålet er at få en dialog i gang vedr. erfaringer fra brugen af de eksisterende snitflader indenfor de specifikke områder, samt at få noget feedback til de oplæg, som vi forbereder indenfor de respektive emner.

Bemærk at emnerne er rent tekniske, og oplæggene vil være på snitfladeniveau med gennemgang af xml-eksempler. Der vil ikke være emner med klinisk indhold på disse møder.

Planen for møderne kan ses her:

• Tirsdag den 14. december kl. 14-1430: ændrede modifikatorer
• Tirsdag den 21. december kl. 14-1430: ny responseheader
• Tirsdag den 4. januar kl. 14-1430: paginering
• Tirsdag den 11. januar kl. 14-1430: generisk fejlhåndtering

Mødet foregår på zoom - link til mødet findes herunder.

Mvh FMK Teamet


https://trifork.zoom.us/j/96812895456?pwd=eWpVK3Q3NVJKVDZVTTUyT21DYytLUT09
Meeting ID: 968 1289 5456
Passcode: 253269
One tap mobile
+4532701206,,96812895456#,,,,*253269# Denmark
+4532713157,,96812895456#,,,,*253269# Denmark
Dial by your location
        +45 32 70 12 06 Denmark
        +45 32 71 31 57 Denmark
        +45 32 72 80 10 Denmark
        +45 32 72 80 11 Denmark
        +45 47 37 25 75 Denmark
        +45 89 88 37 88 Denmark

[Claus Hemberg Jørgensen]

Vedhæftet findes slides fra tirsdagens mini-teknikermøde vedr. ændringer vedr. modifikatorer i 1.6.0 snitfladen. Der blev desuden stillet nogle supplerende spørgsmål, som jeg vil gentage her for evt. interesserede:

• Spørgsmål: vil der blive foretaget validering af værdierne for Rolle? Svar: ja, det må klart forventes. Det er vanskeligt at gøre skema-mæssigt, men der skal eksempelvis valideres imod brug af rollen "System" samtidig med anvendelse af <AuthorisedHealtcareProfessional>. Reglerne for de forskellige kombinationer af roller og typen af accepterer modifikatorer vil blive dokumenteret.
• Spørgsmål: er AuthorisedBy egentlig placeret korrekt i skemaet? Svar: efter at have set lidt på det igen, så ja. Der er i slides blevet tilføjet et ekstra xml eksempel, inkl. brug af AuthorisedBy. En AuthorisedBy, altså den person der har autoriseret en given handling, er knyttet direkte til enten CreatedBy, ModifiedBy eller ReportedBy og bør dermed være indeholdt i modifikator-elementet. I forhold til de slides jeg viste på mødet, er der  indsat et ekstra eksempel på dette i de vedhæftede slides
• Spørgsmål: Alle eksemplerne i slides anvender SOR-id som source for organisations-id'er. Er der taget beslutning om, at SOR id er det eneste der kan anvendes i FMK 1.6.0) Svar: Nej, ikke på nuværende tidspunkt. Der er i FMK gradvist blevet åbnet for, at flere og flere enhedstyper kan indberetette på SOR-Id, og helt overordnet set bevæger alle sig jo i retning mod SOR, men der er altså ikke truffet nogen beslutning om ren anvendelse af SOR.

Næste mini-teknikermøde afholdes tirsdag den 21. december kl. 14.

Mvh FMK Teamet

[Claus Hemberg Jørgensen]

Vedhæftet slides fra dagens oplæg til ny responseheader i FMK 1.6.0.

Endvidere et par kommentarer fra dagens møde:

• Spørgsmål: set fra EPJ'ernes synspunkt er det meget sent i arbejdsgangen, hvis der indsættes advarsler/opmærksomhedspunkter, som man ikke allerede er blevet advaret om tidligere, fx via beslutningsstøtte. Svar: advarslerne skal ikke være en reimplementation af beslutningsstøtte, men advarsler af mere teknisk karakter. Det kunne fx være information om, at en udvidet validering er blevet ramt, men ignoreret da det var valgt i requestet.
• Spørgsmål: er der mulighed for at ændre HTTP statuskode ved fejl, således at der svares 500 ved tekniske fejl såsom DCC problemer o.lign. hvor der kan gensendes, men 400 ved valideringsfejl, hvor brugeren aktivt skal gøre noget? Svar: (fundet efter mødet) I henhold til DGWS standarden er der kun mulighed for at svare enten 200 OK eller 500 ved fejl, så det kan vi næppe ændre på.
• Spørgsmål: er der planer om at indføre HL7 i 1.6.0 snitfladen? Svar: nej ikke som det ser ud lige nu.

Næste mini-teknikermøde afholdes tirsdag den 4. januar kl. 14.

Mvh FMK Teamet

[Claus Hemberg Jørgensen]

Vedhæftet slides fra dagens oplæg vedr. paginering hvor der blev præsenteret 2 mulige måder at repræsentere generel paginering af flere entiteter i et svar på. Den ene baseret på ParentId og Element type, den anden baseret på ElementPath som også er kendt fra fejlhåndteringen.

Flg. kommentarer fremkom under præsentationen:

• Paginering på flere niveauer samtidigt bliver nok for komplekst
• Forbedrede muligheder for filtrering af svar vha. parametre på Get...Requests kan reducere behovet for paginering
• I stedet for TotalNumber så en Remaining
• Mulighed for valg af sorteringsnøgle og retning asc/desc?
• Brugen afhænger selvfølgelig af hvordan klienterne er implementeret. Flere nævnte, at alle data hentes før skærmbilledet vises, der bliver ikke læst efterfølgende

Næste møde vedr. fejlhåndtering er tirsdag den 11. januar kl. 14.

Mvh FMK Teamet

[Claus Hemberg Jørgensen]

Vedhæftet slides fra dagens oplæg om mulige tiltag vedr. fejlhåndtering, validering osv. i FMK 1.6.0 snitfladen.
Flg. kommentarer blev fremsat under præsentationen:

• Det er en god ide at definere skemaer for indholdet af soap faults, da det i dag er håndkodet til lejligheden, og det er sjældent pænt/let at vedligeholde. Automatiseret klientkode generering ud fra skema vil være en forbedring.
• Vedr. positiv tilvalg af bløde valideringer: EPJ'er vil typisk selv have foretaget de ekstra valideringer (fx kald til beslutningsstøtte) der kunne være relevante, så derfor giver det ikke så meget mening lige for et konkrete tilfælde, da det blot vil være dobbelt validering af det samme. Kunne muligvis være relevant for "smallere" klientsystemer uden denne funktionalitet?
• Spørgsmål: skal muligheden for at foretage et kald der ikke bliver udført, men kun valideret, ses som en del af indsatsen for at kunne give brugerne en tidligere besked om mulige fejl i ordinationer, doseringer mv. Svar: ja, helt klart.

Mvh FMK Teamet

[Claus Hemberg Jørgensen]

Alle 4 planlagte miniteknikermøder, med fokuseret indhold af rent teknisk karakter, er nu afholdt. Det er slet ikke utænkeligt, at der bliver afholdt flere møder af samme slags i den kommende tid, efterhånden som vi bliver mere detaljerede mht. hvad FMK 1.6.0 skal indeholde.

FMK Teamet vil forinden derfor sætte stor pris på, hvis I vil give en kort tilbagemelding herunder mht hvad I synes om den form, de er blevet afviklet på, om miniteknikermøderne er en god ide, og om det er noget man får noget ud af.

På forhånd tak for konstruktiv feedback.
Mvh FMK Teamet