Smartstaff, administrator
4,478
edits
Changes
→The Accounts Field
'''Note''': The terms '''Contact''' and '''Account''' can be renamed in Global Settings.
Accordingly, they may have a different name names in your instance of [[SmartSimple]].
The functionality described below will be the same.
=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
# Contacts
There is are also 2 standard fields that can be used to associate '''accounts ''' with a Level 1 entity:
# Accounts
# Company (often renamed to Branch)
The '''Owner''', '''Contacts''', '''Person''' and '''Accounts''' fields at Level 1 are all used to control
access levels within the UTA if the [[Security Matrix]] is enabled
==The Owner Field==
* If the [[Filter Person Based on Customer]] option is selected on the [[UTA Settings]] page, the list of contacts available 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 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 your UTA is tracking '''Research Projects''', the person who is applying to have their project approved could be added to the record with a [[Role|role]] named '''Candidate'''.
* Someone else could be assigned as '''Manager''', and perhaps 3 people would be assigned as '''Evaluators'''
* A given contact could be an '''Evaluator''' for one Level 1 item and a '''Manager''' for a different Level 1 item.
* If the contact is both a '''Manager''' and '''Evaluator''' for the same Level 1 entity they can be assigned to the Level 1 twice: once as '''Manager''' and once as '''Evaluator'''.
The fields that are visible in the '''Contacts''' section can be controlled using the '''PeopleContact List View''' field also allows you to make a direct relationship between multiple people and hyperlink on the same [[UTA Settings page]] in the Level 1 Entity]]settings section. The difference between * On the image above the fields in the list view are '''Index''', ''People'First Name'' field and the ', '''ContactsLast Name''' field is that the and '''PeopleRole''' field does not allow assignment by 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==
The Standard UTA Level 1 field – '''Accounts''' is used to establish a '''direct relationship''' between multiple accounts (or companies) to the same [[Level 1 Entity]]. When you add the Accounts field to the [[Level 1 Entity]] it will display as a section in the [[Level 1 Entity]].
The fields that are visible in the '''Accounts''' section can be controlled using the '''Account List View''' on the UTA Settings page in the Level 1 settings section.
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==
If this field is added to the Level 1 it will be displayed as a pull-down menu of all the internal sub-companies/branches under of the parent company/branch.
==Creating Roles to be Used in the UTAThe Customer (or Client) Field==
=Level 1 Contact and Account Field Settings= ==Defining Which Roles are Available in the UTA== The [[Role|roles]] that have already been set-up within [[SmartSimple]] for the users of the system can be used, or you can create new roles (explained below): To select which Roles will be available when adding '''Contacts''' to a Level 1 record, go to the Security Config tab in UTA Settings. 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 Security Config tab in UTA Settings. In the '''Account Assignment Role Settings''' section select the check boxes next to the [[Role|roles]] you wish to be available. You can also create new [[Role|Roles]] specifically for use in the UTA: ===Creating Contact Roles=== # Choose the [[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.
To create the [[Role|roles]] that will be available when adding Accounts to the Level 1 record
# Choose '''Roles & Permissions''' from the [[Configuration Menu|Configuration Menu]].
# Click the '''Company Roles''' link.
# Add the roles you wish to be available when assigning Accounts to Level 1 entities in the UTA
'''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==
*If you associate a large number of contacts or accounts (companies) with to Level 1 items, you can display separate the users onto different users tabs based on roles on different tabs the [[role]] they are assigned with (and different accounts based on account roles on different tabs).
* You can access the feature within the UTA Settings tab - Contact Tabs and Account Tabs hyperlinks in the Level 1 Settings section.
:[[Image:Tabs.PNG]]
* You can create as many tabs as required, and associate as many roles with each tab as desired. Tabs can also be deleted through the same screen.
* If you do not add the '''Everyone''' to one of the tabs that you create , the system will automatically display a tab called '''Everyone''' which will include all contacts (or accounts) with roles not defined for another tab.
* If you do not wish to use tabs to separate contacts or accounts simply delete all tabs listed.
==UTA Contact Filters and UTA Account Filters==
* You can define who can see which contacts and accounts (companies) at Level 1 based on role membership. * '''Note''': when this feature is enabled, contacts that are not assigned in the '''Contacts Section''' of the Level 1 record will '''not''' be able to see any assigned contacts. The implication being that internal staff (for example) will need to be assigned to the Level 1 in order to view the contacts.<br /> * Similarly, the '''Owner''' of the Level 1 will have no visibility of the Contacts assigned if they are not also an assigned Contact in the Contacts section. If you want the owner to have visibility of Contacts you can enable an Account [[Auto Assignments|Auto Assignment]] (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 Page|Settings tab]], choose the [[UTA Settings > Application Configuration - 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 Filters hyperlinks are available under on the UTA's Settings tab 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:
:[[Image:Evaluator.PNG]]
* ''Note that because Because we have not added the "Evaluator" role to the "Candidate" filter, the candidate assigned to the Level 1 will not be able to see contacts assigned to the Level 1 as evaluators.* ''Similarly, because we have not added the "Candidate" role to the "Candidate" filter, the candidate will not be able to see his/herself, or any or any other candidates assigned to the record. * '''Note''': this filter does '''not''' impact the ability to <u>add</u> contacts. If someone is permitted to add contacts with the role "Evaluator", but is not given the filter permission to see contacts assigned as "Evaluators", when they add a new Evaluator it will be added, but will disappear from their view since they are not permitted to see Evaluators.
* The Account filter works in the exact same manner.
==Contact Restrictions==
* 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= There are 4 standard fields that can be used to associate Contacts with the Level 2 entity:# Owner# Contact People# Assigned People# Account List ==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, both external and internal owners will be allowed on Levels 2 and 3.<br> ==The Contact People Field==The '''Contact People''' standard field allows you to assign multiple contacts to the Level 2 record.
'''Note''': if the '''Contact Links''' field is also enabled on the Standard Fields page the record will display a hyperlink to the contacts listed in the Contact People field directly underneath the field.
::''To [[report]] on contacts in this field the '''Contacts''' table should be joined to the '''Tracking Application Activity''' table''
==The Assigned People Field==
The '''Assigned People''' standard field works similarly to the Contacts field above.
'''Note''': if the '''Assigned Links''' field is also enabled on the Standard Fields page the record will display a hyperlink to the contacts listed in the Assigned People field directly underneath the field
::''To [[report]] on contacts in this field the '''User''' table should be joined to the '''Tracking Application Activity''' table'' The '''Assigned People''' field will not be available if the [[#Multiple Contact List|Multiple Contact List]] is enabled. ==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 Contacts at Account List''' under the Level 2 settings on the [[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 2Contact and Account Field Settings= ==Multiple Contact List==* If you enable the '''Use Multiple Contact List''' checkbox 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.''' '''Note''': If you have enabled the [[Security Matrix]] and are using the UTA Role assignments for the matrix instead of the System Role assignments: It is the role that a contact is given at '''Level 1''' that determines their access as defined in the [[Security Matrix]]. <u>Not</u> the role they are given if they are assigned at Level 2. ==Multiple Account List==* As described [[#The Account List Field|above]] ==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 [[UTA Settings - Entity|Entity tab]] in the Level 2 settings section. ==Contact Filtering==You can restrict the selection of contacts that can be associated with Level 2 items to either a list of named contacts, or by role. <br>This is implemented on the Level 2 '''Types''' page, so you can enforce a different selection of contacts for each Level 2 Type you have defined.* Click on Settings > Types (Under Level 2 Settings) > then select the type you wish to restrict:* To restrict by specified named contacts, select the relevant contacts in the '''Specific Service Providers''' field.* To restrict by specified role(s), add the relevant roles to the '''Specific Service Provider Roles''' field. =Account and Contact Settings= 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:MiscSettings-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=
In addition to the standard contact and account fields described above, you can create additional [[Custom Fields]] to store contacts and accounts related to a case.<br>
The contacts or accounts stored in [[Custom Fields]] cannot be used to provide permissions if you are using the [[Enabling the Security Matrix|Security Matrix]], cannot be assigned to roles, nor are they related in any way to the Contact Filter or Contact Restriction features described above.
These fields are:
* [[Custom Field Type (76): Lookup – Entity and People]]* [[Custom Field Type (95): Lookup – External Entity]]* [[Custom Field Type (75): Lookup – External People]]* [[Custom Field Type (90): Select One – Internal Entity]]* [[Custom Field Type (70): Select One – Internal People]]* [[Custom Field Type: Select One - User Group]] =See Also=* [[Auto Assignments]]* [[Security Matrix]]* [[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]]
