1177 Inkorg - DocBook formatering av meddelande
Den här sidan har flyttats till https://inera.atlassian.net/wiki/spaces/OIIK/pages/3590029598 . Denna sida uppdateras inte längre och kommer att tas bort den 15 maj 2024. Om du har lagt till sidan som en favorit i webbläsaren eller i Confluence, se till att byta ut den till den rätta länken https://inera.atlassian.net/wiki/spaces/OIIK/pages/3590029598 . Om du har blivit länkad hit, rapportera gärna till e-tjänsternas support var länken finns så att nationella förvaltningen kan kontakta sidans ägare. Här kan du kontakta supporten: https://etjanster.inera.se/oversikt/flow/4221
I AddMessage.Message.text kan konsumerande system styra formateringen av ett meddelande, genom att ange formateringsinformation enligt det standardiserade layout-formatet ”DocBook” version 5.0 (Oasis standard).
Denna standard medger ett rikligt format som skapar nästan oändligt med tänkbara kombinationer. Det är därför omöjligt för inkorgen i 1177 att ge ett fulländat stöd för en dylik standard. Därför väljs ett antal delar, en delmängd av element och attribut, ur standarden för att kunna skapa väl formaterade och innehållsmässigt korrekta meddelanden. De element och attribut som stöds, samt dess möjliga kombinationer, framgår av tabellen nedan.
Notera att även 1177 Tidbok har stöd för DocBook, men att antalet element och attribut som stöds är mindre än för 1177 Inkorg. Se jämförelse här:
DocBook stöd i 1177 Inkorg
Nedanstående lista visar en komplett lista med element ur DocBook-standarden stöds av 1177 Inkorg. Dessa skall alltså anges i AddMessage.Message.Text-element för att formatera meddelande till invånaren. Notera även att endast DocBook är tillåtet som formatering.
Element, attribut | Parent | Child |
article | NA | info, para, section, bibliography, variablelist |
info | article, section | title |
section | article | info, title, para, bibliography, variablelist |
para | article, section | ulink, link, emphasis |
bibliography | article, section | NA |
variablelist | article, section | title, varlistentry |
title | info, section, variablelist | emphasis |
ulink * | para | url, type |
link | para | url, type |
varlistentry | variablelist | term, listitem |
term | varlistentry | NA |
listitem | varlistentry, itemizedlist | NA |
url | ulink, link | NA |
type | ulink, link | NA |
emphasis | para, title | role (bold, italics, underline, collapsible, bgcolor, information, observe) |
role | emphasis | NA |
itemizedlist | article, section | listitem, mark (bullet, hyphen) |
listitem | itemizedlist | NA |
* ulink är inte en del av DocBook 5.0 och stöds endast för bakåtkompabilitet mot befintliga integrationer. Använd link för nya implementationer.
Entity encoding
Texten i elementet ska vara i s.k. ”entity encoding” så att DocBook-elementen inte uppfattas som del av SOAP-meddelandets XML-struktur när meddelandet tas emot av konsumenten. Konsumenten behöver sedan återskapa ursprunglig XML från innehållet i elementet. Det finns många exempel på open-source-bibliotek som kan användas av producenten för att göra ”entity encoding” och av konsumenten för att återställa till XML. Ett exempel är Apache Commons Lang StringEscapeUtils: (se metoderna escapeXml respektive unescapeXml).
Här finns exempel på hur DocBook ser ut i 1177 Inkorg:
För att vara säker på hur 1177 Inkorg renderar ett meddelande baserat på DocBook så bör man använda testmiljöer som Inera förvaltar:
Stödet för DocBook uppdateras löpande av förvaltningen för 1177 Vårdguidens e-tjänster, baserat på inkomna krav och önskemål, och denna dokumentation följer dessa uppdateringar. Här finns release notes för 1177 Vårdguidens e-tjänster: