Adding Attributes to a Stationery Layout

Document created by user.oxriBaJeN4 Employee on Sep 9, 2015Last modified by user.oxriBaJeN4 Employee on Mar 27, 2017
Version 8Show Document
  • View in full screen mode

Your stationery layouts can include specific user information obtained from your Active Directory. Provided Mimecast has access to your Active Directory, you can use attributes to your stationery layouts, that are populated with the relevant user information. This requires you to:

  1. Query the Active Directory using thDirectory Browser to return the list of attributes in use.
  2. Create a list of the attributes in the Administration Console. See the Managing Attributes page for further details.
  3. Run a directory synchronization to return the attribute data to Mimecast. See the Directory Synchronization page for further details.

 

To add an attribute to a stationery layout:

  1. Log in to the Administration Console.
  2. Click on the Administration menu item.
  3. Select the Stationery | Layouts menu item.
  4. Open a Stationery Layout.
  5. Add the HTML tags in the HTML Editor (see below).
  6. Add the HTML tags in the Plain Text version of the same stationery layout (see below).
  7. Click the Save button.

 

It is important to test that the attributes display correctly after you have added the tags to the stationery layout. Although the HTML tags may be added correctly, the attribute data may not have been populated resulting in the attribute data not being displayed.

As a cloud service, Mimecast does not apply signatures and disclaimers to internal emails.

Available Attributes

 

All attributes are added to a stationery layout using the following HTML Tag syntax:

 

<MC Type="Variable" Source="From" Attribute="cn">


where:

  • MC Type="Variable" = The Mimecast HTML tag for attributes.
  • Source="From" or Source="To" = The attribute's source (i.e. FROM the sender or TO the recipient).
  • Attribute="cn" = The attribute's common name in your Active Directory from which the data needs to be returned.

 

For example:

 

ExampleDescription
<MC Type="variable" source="from" attribute="Given-Name">Adds the sender's name.
<MC Type="variable" source="from" attribute="Department">Adds the sender's department name.
<MC Type="variable" source="from" attribute="Telephone-Number">Adds the sender's telephone number.
<MC Type="variable" source="from" attribute="Title">Adds the sender's job title.
<MC Type="variable" source="from" attribute="Full Name">Adds the sender's full name.
<MC Type="variable" source="to" attribute="Promotion Code">Adds the recipient's promotion code.

Your directory is unlikely to have details for the recipient. Therefore source="to" is not likely to be valid.

You can also add attributes derived directly from a user's email address. They do not need to be created as an attribute in Mimecast, as this data is already present. In this case, the attribute="email" value changes to variable="email". Take the following examples:

 

ExampleDescription
<MC Type="variable" source="from" variable="email" link="mailto"/>Adds the sender's email address. Including the link="mailto"/ value makes the email address a clickable link.
<MC Type="variable" source="to" variable="email" link="mailfrom"/>Adds the recipient's email address. Adds the sender's email address. Including the link="mailfrom"/ value makes the email address a clickable link.
<mc type="variable" source="from" variable="domain">Adds the sender's domain name.
<mc type="variable" source="to" variable="domain">Adds the recipient's domain name.
<mc type="variable" source="from" variable="name">Adds the sender's distinguished name.
<mc type="variable" source="to" variable="name">Adds the recipient's distinguished name.
<mc type="variable" variable="subject">Adds the email's subject.
<mc type="variable" variable="messagedate">Adds the email's sent date.
<mc type="variable" variable="date" format="dd-MM-yyyy">

Adds the current date in the format dd-MM-yyyy. The supported date formats are YYYY-MM-DD, DD-MM-YYYY, or MM-DD-YYYY.

<mc type="variable" variable="time">Adds the current time.
<mc type="variable" variable="datetime">Add the current date and time.

 

Conditional Attributes

 

If an email user doesn't have an attribute populated in the email directory, you can add a condition to the HTML tag. For example, a user may not have a company mobile. In these cases the signature caters for this by not including any text indicating a mobile number. There are two methods of accommodating this:

    1. Do not display an attribute if it is not populated in the email directory. In the example below  if a user has no mobile telephone number, the “Mobile” text is not included.

      <cc type="conditional" source="from" attribute="mobile" condition="notempty">

      Mobile :

      <mc type="variable" source="from" attribute="mobile">

      </cc>

    2. Display a default telephone number. In the example below, if a user has no mobile telephone number, the default number (0876876876) is used.

      Mobile :

      <mc type="variable" source="from" attribute="mobile" default="0876876876">

 

See also...

 

Attachments

    Outcomes