Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

MessageML

Equivalent PresentationML

Description

<mentionemail="user@domain" >

<mentionemail="user@domain" strict="false" />

<mentionuid="numericUserId" />

<span class="entity" data-entity-id="mention123456">@Pretty Name</span>

It is inconvenient for API callers to identify the correct numeric ID for a user when constructing a Mention (although API to find this from an email address does exist). It is also necessary for the pretty name provided in the PresentationML mention markup to be validated. For these reasons additional mention tags will be provided which will be mapped to equivalent PresentationML markup by the API agent.


The optional attribute strict="true|false" (defaulting to true) controls the behavior when the mentioned user can not be resolved. If strict="true", the API will throw an error. If strict="false", the convenience tag will be translated to plain text in the PresentationML.

<chime/>

<audio 

src="https://asset.symphony.com/symphony/audio/chime.mp3

autoplay="true"/>

A shorthand to allow a chime to be sent in a message.

<card iconSrc="url" class="barStyle" accent="blue">

<header>PresentationML</header><body>PresentationML</body></card>

<div class="card barStyle" data-icon-src="url" data-accent-color="blue">

<div class="cardHeader">PresentationML</div>

<div class="cardBody">PresentationML</div>

</div>

A card is a standard item in a message which has a number of visual elements and which can be opened and closed.

...