Program Setup & Forms

In Dynasend, a “program” equates to a cohesive collection of email signature templates. These templates include, at a minimum, an default HTML template and a TXT template, and optionally, reply, internal, and Salesforce templates as well.

The program setup process is relatively straight-forward and infinitely flexible. When setting up a program this is the screen you will see:

email signature program setup overview

The most important aspect of the program setup is the creation of the template variables and the resulting user-facing signature profile form. This process is triggered by the Add field button in the middle of the programs form.

When you click “Add field” you will be presented with a drop-down asking you what type of field you wish to add. The following graphic illustrates the options and provides representative samples of how the various field types will appear on the user profile form.

email signature form input field types

After selecting the type of input needed, you’ll be presented with a set of options specific to your particular data field.

Form Settings - Field Type: Input

Each field type has a series of specific settings that are associated with it.

email signature form input field settings

Following it a more detailed explanation of the settings that are associated with this data type.

    1. Label

    This is the field label that will appear on the user profile form. You can use HTML font formatting, if needed, to enhance the appearance of the label.


    2. Model

    This is the variable name that you will use in your signature templates. It can include letters, numnbers, and underscores. Examples include:

    • full_name
    • title
    • title2
    • location
    • linkedin_url

    3. Type

    Options are Text and Number. If you select number, users will be limited to numbers only.


    4. Validator

    Comma separated. The most useful valid values are

    • email
    • url

    email signature form validator


    5. Placeholder / Help / Hint

    The placeholder, help and hint enable you to add messaging that may be useful to users when completing their profile form:

    email signature form placeholder help hint


    6. Hidden

    This is a setting that hides the input field from users, so when they are accessing the user profile form, to configure their signature, they cannot see the hidden fields. Hidden fields will be accessible by anyone who has been granted “manager” credentials, so these managers can edit this field for the user, as-needed. Use cases include:

    • Title, allowing HR (or another signature manager) to set the user’s title, rather than trusting them to list it honestly.
    • Awards, toggling on special award badges that are given out only to certain employees.
    • One-off features, letting you add a feature for one (or a few) users that doesn’t apply to the larger user base (and hence would only be confusing if exposed on the form).

    7. Required

    This makes a field required - the user cannot save their profile without completing this field.


    8. Visibility Rules

    Visibility rules can be used to dynamically control whether or not the user sees the field on the form they are completing. as illustrated here:

    email signature form visibility rules

    In this case the program offers a PS line that users can add to their signature. There are a number of pre-written options for the PS lines, and some of them have further data choices embedded in them. In this case, the finished PS line looks like:

    I'm proud to have been honored as a <selection is inserted from the conditional drop-down> in the past year.
    

    This particular drop-down would not appear to a user if they had selected a different PS line option.


    9. Visibility Mode

    The visibility mode is used in conjunction with visibility rules, as illustrated here:

    email signature form visibility mode


    10. SCIM Mapping Field

    SCIM mapping allows you to match data from your AD (when that sync has been configured) to the Dynasend database:

    SCIM mapping field


    11. Precedence Mode

    By setting the precedence mode (when AD sync has been configured) you are able to specify wheter AD will be the “source-of-truth” or whether the users themselves will be the source-of-truth:

    precedence mode


    Form Settings - Field Type: Checkbox

    The form settings for a checkbox are all explained under the section for “Form Type - Input”.


    Form Settings - Field Type: Location

    Most of the form settings for a location field are explained under the section for “Form Type - Input”. The one form seetting that is unique to a location field is “allow custom address”:

    email signature custom address


    Form Settings - Field Type: Select

    Most of the form settings for a location field are explained under the section for “Form Type - Input”. The one form setting that is unique to a location field is “values”:

    email signature custom address

    The ID is the database key, so if you change it after you have active users, their selection of this data item will be lost.

    The name is what the user will see in the drop-down menu that appears on the data entry form (user profile).

    The most appropriate way of utilizing this is to set an ID that you will never change and a NAME that will be useful to users in making the correct selection.

    Then, after doing this, you can setup your signature HTML to produce the desired output by using code like:

    email signature select field code


    Form Settings - Field Type: Switch

    The form settings for a switch are all explained under the section for “Form Type - Input”.


    Form Settings - Field Type: Tel Input (telephone)

    Most of the form settings for a Tel Input field are explained under the section for “Form Type - Input”. The two form setting that are unique to a Tel Input field are “countries” and “format”:

    Note: A complete list of country codes can be found here. Use the “Alpha-2” codes.

    email signature tel field


    Form Settings - Textarea

    Most of the form settings for a Textarea field are explained under the section for “Form Type - Input”. The two form setting that are unique to a Textarea field are “Max” and “Rows”:

    email signature textarea field


    Form Settings - Banner Select

    The Banner Select field is pretty much automatic - all you need to do is to give it a label.

    When a Banner Select field is included in the form users will be able to see all active banners in a drop-down menu and select whichever one they want to have appear in their signature.


    Form Settings - Signature Message Select

    This is exactly the same as the Banner Select excepty that it gives users access to signature text-based messages/notes, instead of banners.


    Form Settings - Upload

    The form settings for an uload are all explained under the section for “Form Type - Input”.