The exchange of information between two façades is done by a Message.

We send:

• an instance of template ST-0100 (Message);
• one or more instances of ST-0098 (Document) and all related data.

Also note that Things (instances of entity data types of the ISO 15926-2 data model, except Templates) are not part of a Message.

An example of a Message with an included Document is given here.

This is different from Hand-over. With Hand-over the data are physically moved from the sending façade to the receiving façade, and so does their custody. With a Message the data stay in the sending façade, and the document data that are sent are "encapsulated" in an rdf:XMLLiteral. The recipient can parse and archive them and use that data as input to his/her system(s), but the data are not populating the "data" section of that receiving façade.

Parallel with sending a Message also a rendering in PDF format is being sent. For further details refer to the gendoc API method.

For further details refer to the API methods format_message, send_message, and parse_message in the Façade section of this site.