====== GetMessageBySubject ======

To be used when multiple documents need to be merged in the mapping.((See also function [[en:transformation:mappings:funktionen:abfragefunktionen:loaddocumetnbyoid|LoadDocumentByOid]]() which however needs an oid to load the document.))\\ 

{{:images:sign_warning.png?nolink|}}**Note:**The function **GetMessageBySubject()** returns the same result as the function [[en:transformation:mappings:funktionen:allgemein:getmessage|GetMessage()]]


The **GetMessageBySubject()** function can be used to search for the subject of the message. 
Search parameters for the subject are:
  * equals: "searchstring"
  * starts with: ***** appended to the end of the expression (e.g. "searchstring*"). 
  * contains: if there is a ***** at the beginning and at the end of the string ("*Suchstring*"). 

From the message the first document is taken and loaded.