Variants and Context

PresentationML

PresentationML describes the markup which controls the formatting (presentation) of a message. PresentationML V2 is a strict subset of HTML and users with an understanding of HTML5 should have no difficulty in understanding how PresentationML will be interpreted. It must be stressed that PresentationML is a strict subset of HTML5, and that this subset might be considered quite limited, there is no intent to support everything which is possible in HTML for a variety of reasons.

Messages which do not conform to the restrictions of PresentationML will be rejected by the API Agent regardless of whether they represent valid HTML5. If messages which are not valid PresentationML are submitted in encrypted form (and therefore cannot be validated on submission) will be pre-processed before rendering and invalid markup will be stripped for security and privacy reasons. The specification of HTML5 is broad and there may well be features which do not represent a privacy or security threat which are nevertheless outside the PresentationML specification. Over time it may be possible to widen the scope of PresentationML, but the processing of messages at API Ingestion time and when rendered by the UI will strip everything which is outside the PresentationML specification.

Non HTML Compatible PresentationML tags

There are a number of elements of PresentationML which are not compatible with HTML5. This markup will be deprecated by MessageML V2.

EntityML

EntityML describes the part of the MessageML V1 specification which deals with the representation of Complex Financial Objects and other structured objects. As part of the upgrade to MessageML V2 EntityML has been withdrawn. Structured Objects are represented as MessageML V2 + EntityJSON.

EntityJSON

The capabilities provided by EntityML are replaced by EntityJSON. This is a set of rules for the structure of a JSON document which make it usable by renderers from different vendors in a predictable way. This is exactly analogous to the strictures of EntityML. Note that all valid EntityJSON documents are valid JSON but not all valid JSON Is valid EntityJSON.

MessageML

MessageML describes the set of capabilities provided at the API, and includes all of the above, plus templating capabilities.


Need help? Email help@finos.org we'll get back to you.

Content on this page is licensed under the CC BY 4.0 license.
Code on this page is licensed under the Apache 2.0 license.