This section includes the following:

Step 1: Creating the new Form

Step 2: Defining a Data Model

Quick Start-11

Step 1: Creating the New Form

Each Form is created based on a Salesforce Object called the Main Object (such as Contact, Contract, Order etc.) and relations of this Object with related Objects. The Main Object is the object from which users generate the output.

When creating a new Form you can create a new Data Model or use an existing Data Mode.

To create a new Form:
1.  In Salesforce>Docomotion click the Forms

2. In the Recent Forms area click New to display the New Form page.

3.  In the Information area, in the Name text box enter a name for the Form.

To change the name of a Form after you created it, see FAQ DESIGN 16:How do I change the name of a Form?
By default, when creating a new Form, Docomotion uses the Normal Word template on your local workstation. If you do not want to use the Normal Word template, you need to upload the Word template to Docomotion (see Uploading a Word Template) and select the Word template you uploaded using the Word Template Lookup.

4.   In the Data Model area, from the Main Object dropdown list select the main Object to use for the Form. You can start typing the object name and use the automatic search to locate the object.

5. Do one of the following:

① Select an existing Data Model:

If you want to use an existing Data Model for the Form, check Use existing Data Model.

A list of available Data Models based on the Main Object you selected appears. Select the Data Model and click Save.

②  Create a New Data Model:  Click Save and Define Data Model. See Step 2: Defining a Data Model.

6.  You can also add a description in the Description

7.  Click Save to save the new Form.

Step 2: Defining a Data Model

Data Model

A Data Model is a Data tag list based on Salesforce fields. Data Models enable users, in the Designer, to create forms with variable data tags that will be populated with the Salesforce fields data in runtime when generating output from the Form.

Each Data Model is created based on a Salesforce Object called the Main Object (such as Contact, Contract, Order etc.) and relations of this Object with related Objects. The Main Object is the object from which users generate the output.

Data Models can be created as standalone entities or as part of a new Form. More than one Form can be based on each Data Model.

Docomotion enables adding to a Data Model three types of Data Tags:

  • Data tags derived from Salesforce fields that are fixed (cannot be changed).
  • Data tags derived from Salesforce fields that are interactive and can be changed by responders to interactive forms.
  • Interactive Data tags that are used to collect feedback data received from interactive forms without the need to change / update / add Salesforce data. For example, a survey that uses elements such as radio buttons, checkboxes, dropdown lists etc, to collect the end user feedback. This information is stored and analyzed in Docomotion.
Docomotion does not support generation from Salesforce Big Objects.

To define a new Data Model:

1.  In Salesforce>Docomotion click the Data Models

2.  In the Data Model Home page click New.

3.  In the Data Model Creation page, enter a name for the Data Model in the Data Model Name

4.  From the Main Object dropdown list select the Main Object for the Data Model.

Once the Data Model is saved, you cannot change the Main Object of a Data Model.

5.  When you finish entering information click Save and define Data Model. The Define Data Model page is displayed.

The green bar under Available Fields enables you to see your location in the tags tree and go back to any location.

6. Add fields from the Available Fields pane to the Selected Fields pane.

The fields you selected are removed from the Available Fields pane, added to the Selected Fields pane and added to the Data Model in a parent-child tree format.

Click To…
I_select Select a Salesforce field as a fixed data tag
I_interactive Select a Salesforce field as an interactive data tag. Interactive data tags are added with the notation “Interactive”
I_open Drill down

Selecting fields from the record’s related list:

You can click Children Relations  and add fields from Objects’ related lists to the main Object. See Data Model  Children Relations.

7. To remove tags: Check the fields you want to remove in the Selected Fields pane ① and click Remove all selected ② to remove the selected fields from the selection.

8.  Click Save.

Add Fields to a Data Model – Example

We will now add fields to a Data Model with Contacts as the Main Object. We will also add to the Data Model relation tags to the Notes Object.

Step 1:
Add fields from the Contact Fields. Click the icons next to the field name. We will add Birthdate, Contact ID Last Name and First Name as Fixed by clicking the I_select icon, and add Assistant’s Name and Email as Interactive fields by clicking the I_interactive icon.

Step 2:
Add fields from the Account. We will click the icon to expand the group and add the Account ID and Account Phone as Fixed, and Account Rating as Interactive.

Step 3:
Add Relations. Go back to Contacts (click the green bar under Available Fields). Click Children relations to display all Objects with relations to Contacts. Click the icon next to Notes to expand the Group. Click the icon next to Created date and Note ID to add the tags as Fixed.

Step 4:
Your Data Model is defined. Click Save to save the data Model and exit.

To edit an existing Data Model, click the Data Model in the Data Models tab, and in the page of the Data Model click Define Data Model.
You can now add or remove tags.