01 Getting Started

Learn how to push data from a Titan Web to Salesforce.

We will start with a project that has a form and some input fields in the form. There is also a button in the form.

  A screenshot of a Titan Web Project page

02 Create a Push

1. Click the Gear icon to open the Project Settings and click the Salesforce option. The Salesforce Integration screen opens.

Screenshot of the Project Settings menu

2. Select the Push option and click the Create New button. The Map Salesforce fields screen opens on Object Settings.

Screenshot of the Salesforce Integration window showing the Push tab

3. Use the Object in Salesforce drop-down list to find the object, for instance, Account.

4. Add a description in the Description field. This is optional but greatly helps when you have a big Web project with multiple Push and Get integration.

5. Use the drop-down to select an action. The options are as follows:
  • Create: Select this option to create a new record.
  • Update: Search for an existing record and update it. You have the option to create a record if no match is found.
  • Find: Search for an existing record. You can return values from that record to various elements in Titan. You have the option to create a record if no match is found.
  • Delete: Delete the records that match the criteria.
In this example, we select the Create action.

Note: You will click the Bulk Mode checkbox when you have a list of records to be inserted. This saves API calls.

03 The Mapping Tab

1. Click on the Mapping option on the left of the Map Salesforce fields screen. Here we will map the two fields on the form to the corresponding fields in Salesforce.
  • You can use the Filter option, especially when you have multiple fields on your Web project. You can filter Pages, Mapped Fields, or Unmapped Fields.
2. Use the Element drop-down lists to map the elements to the Salesforce fields.

A screenshot of the map salesforce fields screen with the mapping tab options displaying

04 The Messages Tab

1. If needed, click the Messages option and map any system messages. Typically, you won’t change the options that are configured by default.

Use the toggle switch to show an error message to users. Type the message in the Message field.

Type a message in the Message field to show when the form is disabled when saving. This option is on by default. A loader will be shown when the form is saved, and the form will be disabled (the user cannot change anything). In this example, we leave the default Message settings.

  Screenshot of map salesforce fields with the message tab options displaying

05 The Run Criteria Tab

1. Click on Run Criteria to configure the criteria under which the Push will run. When the Push is invoked, the criteria will be evaluated. For instance, you can select the Account Name from the Field drop-down list, select the Operator “Equals,” and type a company name in the Value field. The Push will only run if the value in the field is equal to the company name you entered. In this example, we don’t add run criteria.

A screenshot of the map salesforce fields run criteria options

06 The Advanced Options Tab

1. Let’s look at the Advanced options:
  •  Don’t override if empty
  • Validate fields
  • Ignore Assignment Rules
  • Verify CAPTCHA
  • Allow Duplicate
  • Upon payment
  • Save to My Submissions
 We will not use any of the Advanced Mode options for this tutorial.
Screenshot of Map Salesforce fields Advanced options

07 Viewing the Created ID

1. Navigate back to your Web Project.

2. Click the Gear icon and click the Salesforce option. The Salesforce Integration screen opens.

3. Click the Integrations option. You will see the new account with its record ID.

Salesforce Integration window showing the Integration Logs tab
4. Click the Account ID. The account will open in your Salesforce.
 
The account was created with the name and billing address as specified.
Screenshot showing the created account in Salesforce

08 The Where Used Tab

1. Under the Where used option, you will see where the Push integration has been used. This is very helpful when you have a big Web project.

  Screenshot of the Map Salesforce fields displaying the where used tab

09 My Push Integrations

1. Click the Apply button. The Push integration is added to the Salesforce Integration screen.

Screenshot of salesforce integration screen with the created get listed

2. Click the Close button.

3. Save the project by clicking the Save icon (top right of the toolbar).

10 Adding a Push to an Element

1. Click the button element and click the On Click Action icon. The On Click Action screen opens.

A screenshot of a button element menu

2. Hover over the Start icon with your mouse and click the + icon to open the Add Node screen.

Screenshot On Click Action screen with the add node icon

3. Select the Salesforce Action option and click the Next button.

Screenshot of the add node screen with Salesforce Action highlighted

4. Use the Process push or get dropdown list and select the Push you created.

5. Click the Next button.

Screenshot of the add node salesforce action screen with the chosen action listed

6. Add a tag if necessary and click the Insert button. The Salesforce action is added to the On Click Action screen.

Screenshot of the add a tag to the add node salesforce action screen

7. Click the Apply button.

On click action screen with the added node displayed

8. Save and Preview the project.

Preview of the created fields and form

9. Type information in the fields and click the Submit button. A loader is shown while the data is pushed to Salesforce.

11 Got Feedback?

Additional Resources