Difference between revisions of "Dynamics:Express Entry:Custom Mapping"
(Created page with "{{DynamicsExpressEntryNav}} {{CustomTOC}} This covers how to configure Melissa’s Express Entry solution (ver. 1.5.1.16 or later) for Dynamics CRM in order to support cust...") |
|||
| Line 6: | Line 6: | ||
This covers how to configure Melissa’s Express Entry solution (ver. 1.5.1.16 or later) for Dynamics CRM in order to support custom mappings for fields and custom entities. This will help you to map the autocomplete address fields on out of box entities to different fields. | This covers how to configure Melissa’s Express Entry solution (ver. 1.5.1.16 or later) for Dynamics CRM in order to support custom mappings for fields and custom entities. This will help you to map the autocomplete address fields on out of box entities to different fields. | ||
== | ==Navigate to Configuration== | ||
1. Begin by navigating to the configuration screen. If you need more details on locating the configuration screen, see the [[Dynamics:Express Entry:Configuration|Configuration tutorial]]. | 1. Begin by navigating to the configuration screen. If you need more details on locating the configuration screen, see the [[Dynamics:Express Entry:Configuration|Configuration tutorial]]. | ||
| Line 12: | Line 12: | ||
==Advanced Mapping== | |||
2. Click the '''Advanced Mapping''' tab in order to begin the mapping process. In this tab, the custom field mappings that our custom scripts call will be assigned. | 2. Click the '''Advanced Mapping''' tab in order to begin the mapping process. In this tab, the custom field mappings that our custom scripts call will be assigned. | ||
| Line 17: | Line 18: | ||
==Load Entities== | |||
3. Click the '''Load Entities''' button. This queries the Dynamics organization for a full list of the entities that exist within your system and populates the list of attributes that are associated with the entity. | 3. Click the '''Load Entities''' button. This queries the Dynamics organization for a full list of the entities that exist within your system and populates the list of attributes that are associated with the entity. | ||
| Line 22: | Line 24: | ||
==Select Entity== | |||
4. Select the desired entity in the dropdown list. | 4. Select the desired entity in the dropdown list. | ||
| Line 30: | Line 33: | ||
==Type Field Name== | |||
5. Type the name of the desired custom or out of box field. In order to assist the field entry process, the field names should be auto-completed with only the correct field names for that entity. | 5. Type the name of the desired custom or out of box field. In order to assist the field entry process, the field names should be auto-completed with only the correct field names for that entity. | ||
| Line 45: | Line 49: | ||
==Navigate to Default Solution== | |||
6. Once this has been set, the necessary web resources and event handlers will need to be added onto the form. Navigate to the '''Default Solution''' and to the desired entity’s main form. | 6. Once this has been set, the necessary web resources and event handlers will need to be added onto the form. Navigate to the '''Default Solution''' and to the desired entity’s main form. | ||
| Line 50: | Line 55: | ||
==Access Form Properties== | |||
7. Access the '''Form Properties'''. | 7. Access the '''Form Properties'''. | ||
| Line 55: | Line 61: | ||
==Add Web Resources== | |||
8. Click the '''Add''' button to begin adding a web resource. | 8. Click the '''Add''' button to begin adding a web resource. | ||
| Line 60: | Line 67: | ||
==Search for Auto-complete== | |||
9. Search for '''<code>md_ee_autocomplete</code>'''. There should be two options available: <code>md_ee_autocomplete1</code> and <code>md_ee_autocomplete2</code>. Add both of these resources to the form properties. Dynamics requires these resources to be added one at a time. | 9. Search for '''<code>md_ee_autocomplete</code>'''. There should be two options available: <code>md_ee_autocomplete1</code> and <code>md_ee_autocomplete2</code>. Add both of these resources to the form properties. Dynamics requires these resources to be added one at a time. | ||
| Line 65: | Line 73: | ||
==Add Event Handlers== | |||
10. Once the web resources have been added to the form, the necessary event handlers will need to be added. Click the '''Add''' button in the lower section of the '''Form Properties'''. | 10. Once the web resources have been added to the form, the necessary event handlers will need to be added. Click the '''Add''' button in the lower section of the '''Form Properties'''. | ||
| Line 70: | Line 79: | ||
==Handler Properties== | |||
11. In the '''Handler Properties''' window, please add the following functions: | 11. In the '''Handler Properties''' window, please add the following functions: | ||
<ol style="list-style-type:lower-alpha"> | |||
<li>Library: md_ee_autcomplete1</li> | |||
<ol style="list-style-type:lower-roman"> | |||
<li>ExpressEntry</li> | |||
<li>ExpressEntryCity</li> | |||
<li>ExpressEntryZip</li> | |||
<li>ExpressEntryCountry</li> | |||
</ol> | |||
<li>Library: md_ee_autocomplete2</li> | |||
<ol style="list-style-type:lower-roman"> | |||
<li>ExpressEntry2</li> | |||
<li>ExpressEntryCity2</li> | |||
<li>ExpressEntryZip2</li> | |||
<li>ExpressEntryCountry2</li> | |||
</ol> | |||
</ol> | |||
[[File:Dynamics_ExpressEntry_CustomMapping_011-HandlerProperties.png|frame|none|Function Handler Properties]] | [[File:Dynamics_ExpressEntry_CustomMapping_011-HandlerProperties.png|frame|none|Function Handler Properties]] | ||
| Line 91: | Line 108: | ||
==Save Form== | |||
12. After the event handlers and web resources have been added to the form, save the form and publish these customizations. The Express Entry auto-completion service should now function properly on your entity. | 12. After the event handlers and web resources have been added to the form, save the form and publish these customizations. The Express Entry auto-completion service should now function properly on your entity. | ||
Revision as of 01:19, 10 July 2018
← Clean Suite for CRM:Dynamics
| Express Entry Navigation |
|---|
| Overview |
| Installation |
| Configuration |
| Custom Mapping |
| Tutorial |
This covers how to configure Melissa’s Express Entry solution (ver. 1.5.1.16 or later) for Dynamics CRM in order to support custom mappings for fields and custom entities. This will help you to map the autocomplete address fields on out of box entities to different fields.
1. Begin by navigating to the configuration screen. If you need more details on locating the configuration screen, see the Configuration tutorial.
Advanced Mapping
2. Click the Advanced Mapping tab in order to begin the mapping process. In this tab, the custom field mappings that our custom scripts call will be assigned.
Load Entities
3. Click the Load Entities button. This queries the Dynamics organization for a full list of the entities that exist within your system and populates the list of attributes that are associated with the entity.
Select Entity
4. Select the desired entity in the dropdown list.
If a mapping has already been established for a particular entity, the fields should automatically be populated with the previous values.
Type Field Name
5. Type the name of the desired custom or out of box field. In order to assist the field entry process, the field names should be auto-completed with only the correct field names for that entity.
The names should be the exact names that are assigned in Dynamics. These names can be viewed in the Fields section for that particular entity in your default solution.
After the field names have been filled in, please click the Save Mapping button to save your settings.
6. Once this has been set, the necessary web resources and event handlers will need to be added onto the form. Navigate to the Default Solution and to the desired entity’s main form.
Access Form Properties
7. Access the Form Properties.
Add Web Resources
8. Click the Add button to begin adding a web resource.
Search for Auto-complete
9. Search for md_ee_autocomplete. There should be two options available: md_ee_autocomplete1 and md_ee_autocomplete2. Add both of these resources to the form properties. Dynamics requires these resources to be added one at a time.
Add Event Handlers
10. Once the web resources have been added to the form, the necessary event handlers will need to be added. Click the Add button in the lower section of the Form Properties.
Handler Properties
11. In the Handler Properties window, please add the following functions:
- Library: md_ee_autcomplete1
- ExpressEntry
- ExpressEntryCity
- ExpressEntryZip
- ExpressEntryCountry
- Library: md_ee_autocomplete2
- ExpressEntry2
- ExpressEntryCity2
- ExpressEntryZip2
- ExpressEntryCountry2
The entire list of event handlers should be a total of 8 functions.
Save Form
12. After the event handlers and web resources have been added to the form, save the form and publish these customizations. The Express Entry auto-completion service should now function properly on your entity.
- Note: The out of box entities should already be set to the default values of address fields on the form and will not require configuration.