Gå till slutet av bannern
Gå till början av bannern

1177 Inkorg - DocBook formatering av meddelande

Hoppa till slutet på meta-data
Gå till början av metadata

Du visar en gammal version av den här sidan. Visa nuvarande version.

Jämför med nuvarande Visa sidhistorik

« Föregående Version 4 Nästa »

Nya möjligheter har lagts till i release 20 oktober 2021. Info om det kommer inom kort ..

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. 

Se denna sida för exempel på hur DocBook ser ut i 1177 Inkorg: 1177 Inkorg - DocBook exempel

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: Öppen Testmiljö och 1177 Inkorg

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, emphasis

bibliography

article, section

NA

variablelist

article, section

title, varlistentry

title

info, section, variablelist

NA

ulink

para

url, type

link

para

url, type

varlistentry

variablelist

term, listitem

term

varlistentry

NA

listitem

varlistentry

NA

url

ulink

NA

type

ulink

NA

emphasis

info, para

role (bold, italics, underline)

role

emphasis

NA

 

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: http://commons.apache.org/proper/commons-lang/javadocs/api-2.1/org/apache/commons/lang/StringEscapeUtils.html  (se metoderna escapeXml respektive unescapeXml).

  • Inga etiketter