Prepare to use mail forms and restricted fields

Plan, create, and apply mail forms and restricted fields to your project.

What are mail forms and restricted fields?

Mail forms help users capture specific project information when sending or replying to correspondence. A mail form is built by adding project fields to a mail type. Mail forms and the information entered in them are visible to the senders and recipients of the mail, including those in other participating organizations.

Restricted fields can only be created by the project-owning organization, and their information is visible only to that organization. Other participating organizations cannot create their own restricted fields on the project. For example, an RFI might include discipline and area fields that everyone involved can see, while a cost impact restricted field is visible only to the project-owning organization.

  Mail forms Restricted fields
Who can create them? The project-owning organization. The project-owning organization.
Who can see the information? Senders and recipients of the mail, including those in other participating organizations. The project-owning organization only.
What are they used for? Capture project information and guide users to enter it consistently. Record structured notes against mail that are visible only to the project-owning organization.
Can the information be searched and reported on? Yes. Excluded from search, but can be used to filter search results and create reports.

Mail forms and auto-text templates: Mail forms complement auto-text templates. Moving information into structured fields can reduce the need for auto-text and make that information easier to search and report on.

Note: Mail attributes are multi-select fields that can also be used, but are visible on all mail types and cannot be relabelled.

1. Planning mail forms and restricted fields

The first step in creating useful mail forms and restricted fields is to plan them.

First, review your project’s reporting requirements. These will give you insights into the kinds of fields you’ll need to have available to report on.

There are six different types of fields in mail forms and restricted fields: Yes/No, Date, Text, Text area, Number, and Single Select List. You’ll need to choose the appropriate field in each case, and structure it to suit your project’s needs. So it’s important to think about the information you need to capture, and the best way to capture it.

You can apply a given field to as many mail types as you like. As part of your planning, think about whether you want to reuse and report on fields across different mail types.

You can put limitations on each field to shape the way project participants enter information.

As the project progresses, your mail forms will help you capture important project data, so it’s important to consider your project’s searching and reporting needs before you create the fields.

To plan your mail forms and restricted fields:

  1. Look at the mail types you’ve set for the project. Which mail types are likely to include particular data as standard?

  2. Make a list of this information for each mail type.

  3. Consider how project participants will need to use each of those pieces of information in their reporting. What limitations or specifications (e.g. units of length, dates, currencies, confidentiality etc.) will you need to put on the data to support those reporting needs?

  4. Make a note of those specifications next to each piece of information.

  5. Look for pieces of information that serve the same purpose and have the same (or very similar) specifications. Could you create a single field to capture this information, and use it across a range of mail types?

  6. Split your list of fields into single-use and reusable fields, if that’s appropriate for your project, noting which mail types each one will apply to.

  7. Create a separate list for restricted fields, which will remain confidential within your organization.

Tip!

The character limits on Mail Forms fields and tooltips are as follows:

  • Labels: 40 characters
  • Tooltips: 150 characters
  • Selectlist values: 120 characters
  • Text: 1-60 characters.

 

2. Choosing field labels

It’s important to choose your field labels very carefully.

When you come to type your label into the New Field window, you’ll see the Field Name is created for you automatically.

While the field label, which displays for your project’s participants, can be changed, this field name can’t. Once you save the field, that field name will be set—you won’t ever be able to change it.

This ensures that the Project Admin always knows what the original purpose of a field was, and can make sure it’s labeled appropriately.

For example, if you create fields named “Cost net” and “Cost gross”, changing the label of one to simply “Cost” would likely cause confusion when it comes to reporting for the project.

As you can see, it’s important to choose your field labels in the planning phase, before you begin to create the fields in Aconex.

  • Choose a name that reflects the intent of the field. For example, if the field is to be used to record costs, include that in the field name.

  • To make sure you can reuse the field across mail types, more generic names might be best (for example, Cost implication, rather than RFI cost implication).

  • Balance your need to reuse the field against your needs to track and report on specific elements of the project.

  • Remember that if you change the field label once it’s created, the new label will be applied to all the mail types in which that field is used on that project.

3. Choosing field options

Now you know what each of your fields is for, and what they’ll be called.

Next, decide how you’ll shape the information that project participants can enter for each one.

You can choose from six types of fields:

  • Yes/No

  • Date

  • Text

  • Text area

  • Number

  • Single Select List.

For each one, you can set a tooltip that gives users more information on how to complete the field.

For the text field, you can set minimum and maximum lengths. The default maximum is 60 characters, but you can set a maximum limit below that, and a minimum limit of one or more.

For the number field, you can set a data type and choose the units you’ll use.

Tip!

Note that the number of characters you can use in the Text and Text Area fields is different.

  • Text is a single line (non-expandable) field with a maximum of 60 characters. 
  • Text Area is an expandable field with a 4000 character limit.

For a single select field, you’ll need to add the options from which users can select. You can paste these in from other programs, like Word or Excel, if you wish.