A field is a wild card string that helps to insert user customised information into the signature. The fields do a look up into your Directory and pull out the desired information.
Crossware Mail Signature uses an exclamation mark (!String!) to perform this function.
These fields can extract information from your Active Directory (AD) or can be the result of C# script that returns a string.
<strong>We have already done the hard-work for you and configured all possible fields supported by Microsoft Office 365. So, all you have to do is expand the 'field' twistie and add the desired field to your signature.</strong></div>
Creating a New Field
To create a new field, click on Admin> select Fields on the left hand side menu.
Then click on the 'Create New' link.
The following "Create a new field" dialog box will appear, prompting to select the type of field to create.
Select your option and click on continue.
Create a new field type
a. Field (from Active Directory):
Extracts information from your Active Directory (AD). AD Lookup
This is a C# Script that returns a text value.Formula Lookup
Retrieves an image either from the Image Library or from your AD.Image Lookup
Following is an overview of different components of the Field Configuration document.
This is the name given for the field lookup.
This field is populated automatically depending on your selection for "Create a new field" - Field (From Active Directory), Formula, Image.
The Name of the field in Active Directory
Lookup Key Type
Your lookup field key can either be a text field or an existing lookup field, in case you are editing or modifying the existing lookup field.
If you change the key from 'Text' to 'Use another field' you will see that the field 'Lookup Key' populates with drop down arrow for fields to select from.
Text List Separator
This setting controls how Text Lists are formatted when returned. By default, text lists will be on separate lines when inserted into the email.
When look-up fields are used in other look-up e.g. In Formula lookup; then a Carriage Return/Line Feed is not suitable. Therefore a different separator can be used.
Let us have a look at the various Text list separators:
a. Carriage Return-Line Feed (Default):
This is the default text list separator which ensures that each entry will be on a new line.
Text items will be separated by a colon.
Text items will be separated by a tab character.
Exclude From Caching
You can select a Yes or No for this field depending upon your requirements. The best practice is to not exclude the configurations from caching, so that future requests for that data or field can be served faster.
Testing Lookup Configuration
Once you've finished creating your lookup, click on the 'Save' button. Then click on the 'Send Test Email' button and send an email to your external account to test whether your lookup is working or not.. This e-mail will be processed by Crossware Mail Signature as it passes through your Exchange server where Crossware Mail Signature has been installed.
In the above example, we are sending a test email to a Hotmail account to see if the 'DisplayName' lookup is working fine.
As you can see that the lookup is working as desired. It has pulled the information from the AD and populated it in the test email.