Knowledge Base

How to add new Active Directory fields to the Editor of CodeTwo Email Signatures for Email Clients

This article is meant for users of CodeTwo Email Signatures for Email Clients. This software has been discontinued. If your organization uses Office 365, check out CodeTwo Email Signatures for Office 365.

Problem

How to enable CodeTwo Email Signatures for Email Clients to recognize additional (custom) dynamic fields from Active Directory that are unavailable by default in Signature/Disclaimer Template Editor.

Solution

By default, CodeTwo Email Signatures for Email Clients recognizes a limited number of dynamic fields (Active Directory placeholders). However, you can also manually add non-default dynamic fields (related to additional attributes in Active Directory) to the Signature/Disclaimer Template Editor, and insert them to your signatures.

To extend the list of available dynamic fields, you need to add SchemaExtension.txt file to the installation folder of the program and then copy it to client machines that use Client Apps to deploy policies.

Please study the steps below to learn how to manually define non-default dynamic fields that will be recognized by the program:

  1. Open installation folder of CodeTwo Email Signatures for Email Clients.
  2. Create a new file called SchemaExtension.txt
  3. Inside this file, enter the name of the desirable dynamic field (it needs to be the name of an LDAP attribute of Active Directory objects corresponding to a mail sender) and its type. In this example, we choose the otherTelephone attribute which type is represented by a string. By default all entries are treated as a string. The pattern of valid entry looks as follows: nameOfLDAPEntry : type

    For more information about adding entries, please refer to this KB article.

    Email Signatures - Schema Ext file added small.
    Fig. 1. Adding and configuring SchemaExtension.txt file to the installation folder of the program.
  4. Open ADSI Edit (Active Directory Service Interfaces Editor).
  5. Edit users for whom you want to define the values of new dynamic fields. These values will later replace the additional dynamic fields inserted to signatures of particular users after processing by the program.
    1. To define values, expand your domain, and then double-click CN=Users.
    2. On the list of users, highlight the chosen user and choose Properties via right-click.
    3. Next, on the Attribute Editor tab, locate the attribute that corresponds to the dynamic field you want to add to the program, and click Edit.
    4. In the resulting window, enter the value and hit Add.
    5. Finally, confirm a new value using OK and save your configuration by clicking Apply in the user's properties window.
       
      Email Signatures - ADSI edit small.
      Fig. 2. Defining a value of AD attribute.
  6. Copy the SchemaExtension.txt file to the installation folder of Client Applications on those client machines that deploy policies using Client Applications.
    Email Signatures - Copy Schema Ext file.
    Fig. 3. Copying SchemaExtension.txt file to the installation folder of the Client Application.
  7. Restart Client Applications on the machines where you copied theSchemaExtension.txt file.
  8. From this moment, new dynamic fields will be available for use in the Signatures/Disclaimer Template Editor.
    Email Signatures - New dynamic field available.
    Fig. 4. New dynamic filed available in the Signature/Disclaimer Template Editor.

Was this information useful?