Smartstaff, administrator
4,478
edits
Changes
→The Accounts Field
=Level 1 Contact and Account Fields=
There are 3 different standard fields that can be used to associate '''contacts''' with a Level 1 {{l1}} entity:
# Owner
# Person
The '''Owner''' field can also be configured to allow both external and internal owners.
* To enable external owners go to , click on the [[UTA Application Configuration pageSettings Page|Settings tab]], choose the [[UTA Settings - Entity|Entity tab]], and select the '''Enable External Owners''' check box in the Level 1 settings section.
==The Person Field==
* The '''Person''' field does not allow assignment by role.
* If the '''[[Filter Person Based on Customer''' ]] option is selected on the [[UTA Settings ]] page, the list of contacts available if when the Customer standard field is enabled will be restricted to the company/account selected as the Customer, as well as the contacts in any of the sub-companies of the Customer company.
==The Contacts Field==
When you add the '''Contacts''' field to the [[Level 1 Entity]] it will display as a section on the Level 1 Record:
:[[Image:L1ContactsL1Contacts2017.PNGpng|border|1050px]]
Clicking on the Lookup button in [[Edit mode]] brings you to a pop-up where you can select the users to be added.
If you type into the Ajax field then you will see options returned that contain matching data, as well as the option to create a new contact.
:[[Image:L1Contacts2_2017.png|border|1050px]]
You can search for contacts on any field that has been added to the [[User & Contact Settings|Contact Ajax Lookup Settings]] on the Global Settings page.
Users can also be added using the [[Import multiple contact/companies to uta objects|Import Contact]] feature, available from within the [[UTA Settings - Settings|UTA Settings]] section.
When contacts are assigned to the Level 1 entity you can select a [[Role]] to describe that contact's engagement with the [[Level 1 Entity]]. Managing which roles are available is described [[#Defining Which Roles are Available in the UTA|below]].
* For example, if the [[Level 1 Entity]] is a '''Research Project''' and you anticipate there being different '''Managers''' being responsible over time, you could create custom fields on the '''Manager''' [[role]] to track their respective start and end dates along with other information.
The fields that are visible in the '''Contacts''' section can be controlled using the '''Contact List View''' hyperlink on the [[UTA Settings page ]] in the Level 1 settings section.
* On the image above the fields in the list view are '''Index''', '''First Name''', '''Last Name''' and '''Role'''
===Groups===
If you have configured [[User Groups]], multiple contacts can be assigned to the Level 1 record at the same time by selecting the '''Groups''' radio button:
:[[Image:AddGroup2017.png|900px|border]]
Each member of the selected [[User Group|group]] will be assigned to the Level 1 record. You can either select a [[Role]] and all contacts in the group will be assigned with that role. Or you can select the '''Use Group Roles''' checkbox and the contacts will be assigned the the Level 1 with the [[role]] they are assigned in the [[User Groups|Group]].
* '''Note:''' When using the '''Use Group Roles''', the contacts will be assigned with the roles they have in the group, even if those role(s) are not enabled within the given [[UTA]].
==The Accounts Field==
When you add the Accounts field to the [[Level 1 Entity]] it will display as a section in the [[Level 1 Entity]]:
[[Image:AccountsAccounts2017.PNGpng|900px|border]]
Just as with contacts, when accounts are assigned to the Level 1 entity you can select a [[Role]] to describe that account's engagement with the [[Level 1 Entity]]. You must first define '''Company Roles''' as explained [[#Defining Which Roles are Available in the UTA|below]].
Any contacts that are associated with that account (as defined <u>outside</u> of the UTA) can thus be indirectly associated with the Level 1 item via the '''Accounts''' field.
Also, Accounts can also be added using the [[Import multiple contact/companies to uta objects|Import Organizations]] feature, available from within the [[UTA Settings - Settings|UTA Settings]] section.
==The Company (or Branch) Field==
This field allows you to select any external Company or Account.
* If the '''Filter Person Based on Customer''' option is selected on the UTA Settings page, the list of contacts available in the Person standard field (if enabled) will be restricted to the company/account selected here, as well as the contacts in any sub-companies of the Customer company.
=Level 1 Contact and Account Field Settings=
To select which Roles will be available when adding '''Contacts''' to a Level 1 record, go to the Application Configuration Page of the Security Config tab in UTASettings. In the '''Contact Assignment Role Settings''' section select the check boxes next to the [[Role|roles]] you wish to be available.
To select which Roles will be available when adding '''Accounts''' to a Level 1 record, go to the Application Configuration Page of the Security Config tab in UTASettings. In the '''Account Assignment Role Settings''' section select the check boxes next to the [[Role|roles]] you wish to be available.
===Creating Contact Roles===
# Choose '''[[Roles & Permissions''' ]] from the [[Configuration Menu|Configuration Menu]].
# Click the '''User Roles''' link.
# Add the roles you wish to be available when assigning contacts to Level 1 entities in the UTA
:[[Image:Uta133RolesList.png|link=|650px]]
These [[Role|Roles]] will be available for all UTA. There is no need to set any attributes for these [[Role|roles]] as they will only be used to reference contacts with the UTA.
As you save each role, note the UTA '''Custom Fields''' tab.:[[Image:Uta134EditRoleButtons.png|link=]]You use this tab to establish the [[Custom Field|custom fields]] that track the relationship between the person in the pertinent to this role for that Level 1.
===Creating Account Roles===
'''Note''': Company roles are only applicable within the Universal Tracking Application and should not be confused with Account Categories – the standard method for categorizing companies.
==Tabs for Contact and Account Lists==
(Settings > Auto Assignments) which automatically assigns the owner to the Level 1 Contacts section with a specified [[Role|role]].
* To implement these features, navigate to click on the [[UTA Settings > Application Configuration Page|Settings tab]], choose the [[UTA Settings - Security|Security tab]] and within the Security Settings panel, select the check boxes beside Enable UTA Contact Filter and/or Enable UTA Account Filter.
:[[Image:Filter.PNG]]
* Once the feature has been enabled for either contacts or accounts, the UTA Contact Filters and/or UTA Account Filters hyperlinks are available under on the UTA Settings page- [[UTA Settings - Settings|Settings panel]].
:[[Image:Filter2.PNG]]
* You can now configure visibility of the contacts/accounts associated with a Level 1 based on User Roles and Account Roles. For example if you have a role called "Candidate" you may want the candidate, when viewing the Level 1, to be able to see who is assigned to the case as the "Manager". To accomplish this you would enter the following settings:
* To access this feature, click on the Contact Restrictions hyperlink on the UTA Settings tab.
* The limit can be any number between 1 and 99.
* You can restrict the number of contacts belonging to a [[UTA Role|given role ]] that can be associated with a Level 1 record. <br />The following would ensure no more than 2 evaluators are assigned to a Level 1 record:
:[[Image:RoleRestriction.PNG]]
:'''''Note''': The Message box allows you to specify the error message that will be generated if the specified limit is exceeded.''
* The following combination would ensure that each contact can be assigned to the Level 1 twice, but only once per role (assuming the roles available are Candidate, Evaluator and Manager):
:[[Image:UserRoleComboContactRestrictionExample.PNGpng|link=]]
=Level 2 Contact and Account Fields=
==The Owner Field (Level 2)==
The '''Owner''' Field at Level 2 is the same as the Owner field at Level 1. If the option "Allow External Owners" is selected on the Level 1 settings, except that both external and internal owners are always will be allowed by defaulton Levels 2 and 3.<br>:''(at Level 1 you must specifically enable external owners if desired)''
==The Contact People Field==
==The Account List Field==
The '''Account List''' field at Level 2 allows you to assign companies to the Level 2 entity by company role, exactly as described for the '''Accounts''' field for Level 1 above. The [[Role|roles]] available for the companies assigned at Level 2 will be the same as those enabled for Level 1.
* In order to use the '''Account List''' field at Level 2 you must first enable '''Use Multiple Account List''' under the Level 2 settings on the Application Configuration Page[[UTA Settings - Entity|Entity tab]]. Then go to the Level 2 Standard Fields list on the same tab and enable the '''Account List''' field by entering a name in the Label field.
=Level 2 Contact and Account Field Settings=
==Multiple Contact List==
* If you enable the '''Use Multiple Contact List''' check box on the Settings > Application Configuration screen [[UTA Settings - Entity|Entity tab]] you will be able to associate and control contact associations in a similar manner to Level 1 contacts. The roles available at Level 2 will be the same as selected for Level 1 above.
* '''IMPORTANT: It is not yet possible to refer to contacts that are assigned by role at Level 2 on Web Page Views or in other Custom Fields.'''
==Contact Restrictions==
* You can limit the total number of contacts that can be assigned to the Contacts Field (or Multiple Contact List if enabled) at Level 2.
* To enable enter the desired limit into the '''Maximum Contacts - Maximum number of contacts can be assigned''' field on the Application Configuration page [[UTA Settings - Entity|Entity tab]] in the Level 2 settings section.
==Contact Filtering==
The account and contact settings are used to determine if the Level 1, 2 and 3 items should be available in other parts of [[SmartSimple]], rather than only in the [[Universal Tracking Application|Universal Tracking Application]].
[[Image:Uat16MiscSettings-AccountandContactSettings.png|link=]]
* If '''Enable Level 1, 2 and/or 3 Tab on Contact Profile''' is enabled, when viewing a contact profile there will be tab(s) listing all the records that contact is associated with.
Here is how the L2 tabs under Contact and Company profile works
L2 under User Profile<br />
* L2s with the user as L2 contact role association<br />
* L2s with the user as a (standard field) contact, assigned, or owner<br />
* L2s under any L1s with the user as the L1 owner or L1 person<br /><br />
L2 under Company Profile<br />
* L2s with associated users that is under the company<br />
* L2s with users as a contact, assigned that is under the company<br />
* L2s with users as an owner that is under the company<br />
* L2s with the company as L2 company association
<BR><BR>
=Custom Fields=
* [[Disable Default Assign]]
* [[Filter Person Based on Customer]]
* [[UTA Role]]
{| cellpadding="5" style="background-color:#F0F0F0;border-style: solid; border-width: 2px"
| [[Image:Previous.png|link=Level 1 and Level 2 Entity Settings]] [[Level 1 and Level 2 Entity Settings]]
|
| [[Terminology Settings]] [[Image:Next.png|link=Terminology Settings]]
|}
[[Category:Universal Tracking Application]][[Category:Applications]][[Category:Contacts]]
