Legacy:Salesforce:Express Entry Component

← Legacy:Clean Suite for CRM:Salesforce

Clean Suite provides an ExpressEntry component that integrates address auto completion within Salesforce. To begin installing this component, access your Setup menu.

Here’s a guide to find this within Salesforce: https://help.salesforce.com/HTViewHelpDoc?id=basics_nav_setup.htm&language=en_US

Method #1 – Override New/Edit Actions

1. In Setup, go to Customize -> Contacts -> Buttons, Links, and Actions:

   

   Customize > Contacts > Buttons, Links, and Actions

2. Click the blue Edit link next to New in the Label column:

   

   Edit link

3. Next to Override With, select Visualforce Page and then select MD_expressContactEdit from the dropdown:

   

   Select MD_expressContactEdit

   Click Save. You can also repeat steps 2 & 3 for the Edit action.

4. Create a new contact in Salesforce. When creating a new contact, ensure that you see apex/MD_expressContactEdit somewhere in your URL to make sure that the Visualforce page selected in step 3 is being used.

   For example:

   

   Create a new contact

5. On the New contact page, we will now begin mapping the fields on this page. To map in the Mailing address fields, start off by getting the ID’s of each input element. Getting the ID’s will differ between browsers. As an example, in Chrome you can right click on the text field then click on Inspect element. This will bring up a panel in Chrome where you can find the id (id=”….) in the selected element:

   

   Inspect Element

6. On a separate browser window or tab, go to the tab Clean Suite Express Entry Maps and then click on the New button to create a new Express Entry map:

   

   Clean Suite Express Entry Maps

7. On the Express Entry Map Edit page, give the new mapping a name (something like Contact MailingStreet) and then for Object Prefix enter in apex. For the street, city, state, zip & country fields, copy and paste in the id’s that you’ve extracted from the other browser tab/window as detailed back in step 5. Save the mapping when finished:

   

   Contact MailingStreet

8. After saving the mapping, if you now reload the new contact page or create a new contact, clicking on the Mailing Street field will now auto populate the Mailing Country field with the default country specified in Clean Suite Administration->Express Entry->Default country. Typing in the Mailing Street field will return suggestions based on the country entered in the Mailing Country field. Double clicking on the street field will clear out input fields. If this all works, then you have set up Express Entry successfully. For the Contact object, you can create a new Express Entry map for the Other address fields. Simply just follow the same steps that was done in this tutorial for the Mailing address fields.

Method #2 – Add component to page layout

If overriding the New/Edit actions of your objects is not a viable option, the other method is to add an Express Entry component in to your Salesforce object’s page layout (what you see when you view the record). Using the Contact object as an example:

1. In Setup, go to Customize -> Contacts ->Page Layouts:

   

   Customize > Contacts > Page Layouts

2. Edit the page layout that you want to add the Express Entry component to:

   

   Edit the page layout

3. On the Edit Page Layout page, you’ll most likely want to create a new 1-Column Visualforce Page section in your page layout to contain the ExpressEntry component:

   

   Create a new 1-Column Visualforce Page

4. From the Visualforce Pages category, drag and drop MD_expressEntry to the new section created in the previous step:

   

   Drag and drop MD_expressEntry

   Save the page layout.

5. On a separate browser window or tab, go to the tab Clean Suite Express Entry Maps and then click on the New button to create a new Express Entry map:

   

   Clean Suite Express Entry Maps

6. The Visualforce page that we added into the page layout back in step 4 contains two instances of the Express Entry Visualforce component (one for Mailing and another for Other). Therefore, create two mappings as such depicted below:

   Contact Mailing

   

   Contact Mailing

   Contact Other

   

   Contact Other

7. After creating and saving both of these mappings, if you now view a Contact record the Express Entry components will now function:

   

   Express Entry Components

Mobile

ExpressEntry is also available as a Salesforce1 mobile component. Using the Contact object as an example:

1. Under Salesforce’s setup menu, go to Customize -> Contacts -> Page Layouts:

   

   Page Layouts

2. Edit the page layout that you want to add the Express Entry mobile component to:

   

   Contact Page Layouts

3. Go to the Buttons category and drag and drop ExpressEntry Mobile into the Custom Buttons section. Save the changes made to the layout:

   

   Buttons > ExpressEntry Mobile

4. On a separate browser window or tab, go to the tab Clean Suite Express Entry Maps and then click on the New button to create a new Express Entry map:

   

   Clean Suite Express Entry Maps

5. The Visualforce page that we added into the page layout back in step 4 contains two instances of the Express Entry Visualforce component (one for Mailing and another for Other). Therefore, create two mappings as such depicted below:

   Contact Mailing

   

   Contact Mailing

   Contact Other

   

   Contact Other

6. Go into Salesforce1 and try viewing a Contact. You will now see ExpressEntry mobile as one of the buttons available for Contacts:

   

   ExpressEntry Mobile Contacts

7. Clicking on the button will bring up the ExpressEntry component which you can then begin to type an address into:

   

   ExpressEntry Mobile