Difference between revisions of "Types"

From SmartWiki
Jump to: navigation, search
(→‎Type Settings)
 
(51 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
'''Types''' provide a method of delineating between different types of [[Level 2 Types|Level 2]] and [[Level 3 Types|Level 3]] items.
+
'''Types''' provide a method of delineating between different varieties of [[Level 1 Types|Level 1]], [[Level 2 Types|Level 2]] and [[Level 3 Types|Level 3]] records.
−
:---> ''Types at Level 2 and Level 3 are the equivalent of [[Level 1 Templates|Templates]] at Level 1.''
 
  
  
−
'''NOTE: Level 3 Types are configured the same manner as Level 2 Types. Any differences are noted below.'''
+
'''Note: Level 3 Types are configured the same manner as Level 2 Types. Any differences are noted below.'''
  
  
−
==Creating Types==
+
 
−
You can configure Level 2 Types via the '''Types''' link on the '''Settings''' page of your [[UTA]]:<br>
+
==Creating and Editing Types==
−
[[Image:Uta91.png]]
+
You can configure Types via the '''Types''' link on the [[UTA Settings Page|Settings page]] of your [[UTA]].
−
 
+
To navigate there:
−
* '''Existing Types''' are listed on the left of the page.
+
 
−
* '''Details of each type''' are displayed on the right of the page and new types are added to the right of the page.
+
# Navigate to your [[UTA]].
−
[[Image:Uta92.png]]
+
# Select the [[UTA Settings Page|Configuration Settings Button]], signified by the gear icon.
 +
# For [[Level 1 types]], select the second tab from the left. For [[Level 2 types]], select the third tab from the left, and so on.
 +
# Select the '''Types''' link to view the types that have been created for this level entity.<br />
 +
[[Image:Types Link.png]]
 +
 
 +
Here, you will see a list of all types that have been created for this level entity. To edit or copy an existing type, simply select the '''Edit''' icon, signified by the pencil icon, beside the type. To copy a type, click the '''Save As''' button, enter the '''Name''', '''Caption''' and '''Display Order''' of the new type, and press '''Save'''. To create a new type, simply select the '''New Type''' button, signified by the plus (+) sign.
 +
[[Image:Types List.png|800px]]
 +
 
  
 
==Type Settings==
 
==Type Settings==
−
 
 
Each type of [[Level 2 Entity]] or [[Level 3 Entity]] has the following settings:
 
Each type of [[Level 2 Entity]] or [[Level 3 Entity]] has the following settings:
  
−
* '''Language''' - [[Language]] that the current Name value will apply against.
+
* '''Type ID''' - This is the unique identifier for this Type. See [[Typeid|Type ID]] for further information.
−
* '''Name''' - Display name for the Type.
+
* '''Name''' - Unique name for the Type.
−
* '''Display Order''' - The order in which the types are listed in the type combo box.
+
* '''Caption''' - Display name for the Type. See [[Caption]] for further information.
 +
* '''Display Order''' - The order in which the types are listed in the type combo box. See [[Display Order]] for further information.
 
* '''Description''' - Any comments or notes you wish to include. '''Note:''' These don't manifest anywhere except on this page.
 
* '''Description''' - Any comments or notes you wish to include. '''Note:''' These don't manifest anywhere except on this page.
−
* '''Colour Code''' - A colour code used to display different types in the list view.
+
* '''Color Code''' - A color code used to display different types in the list view.
 +
* '''Tab Label''' (Level 2 only) - Allows you to define a name for the tab if '''Display as Tab''' is selected. See [[Display as Tab]] article for details.
 
* '''People Workflow''' (Level 2 only) - Allows you to attach a '''Tracking Activity Assignment''' [[Workflow]] to this Type.
 
* '''People Workflow''' (Level 2 only) - Allows you to attach a '''Tracking Activity Assignment''' [[Workflow]] to this Type.
 +
* '''Lock on Type''' (Level 2 and Level 3) - Allows you to lock this type after creation to prevent it from being changed.
 
* '''Is Default Type''' - Allows you to select which Type will be the default when a new Level 2 or Level 3 record is created.
 
* '''Is Default Type''' - Allows you to select which Type will be the default when a new Level 2 or Level 3 record is created.
−
::* '''Note:''' if you select more than one type to be the default this will not function.
+
*:* '''Note:''' if you select more than one type to be the default this will not function.
−
* '''Lock on Type''' (Level 2 and Level 3) - Allows you to lock this type after creation to prevent it from being changed.
+
* '''Display as Tab''' - This Type will be displayed on a separate tab in the list of activities at the bottom of their parent record. See [[Display as Tab]] article for details.
−
* '''Display as Tab''' - This Type will be displayed on a separate tab in the list of Level 2 activities at the bottom of a Level 1 record. See [[#Displaying on Tabs|below]] for details.
 
−
::* ''(or in the list of Level 3 activities at the bottom of a Level 2 record)''
 
−
* '''Tab Label''' (Level 2 only) - Allows you to define a name for the tab if '''Display as Tab''' is selected. See [[#Displaying on Tabs|below]] for details.
 
 
* '''Show External''' (Level 2 only) - This check box indicates whether or not this type of activity should be shown to external [[User|users]].
 
* '''Show External''' (Level 2 only) - This check box indicates whether or not this type of activity should be shown to external [[User|users]].
−
* '''Access Roles''' - Select the [[Role]]s that can create this type of activity.
+
* '''Is Payment''' - allows the ability to use SmartSimple's [[Payment Integration]] features with this Type.
−
* '''Available Status''' - Select the Level 2 [[Status]]es that can be selected for this type.
+
* '''[[Access Roles]]''' - Sets the [[roles]] able to access records associated with this Type.
−
* '''[[Template / Type Formula|Level 2/Level 3 Formula]]''' - A set of expressions used to calculate values when the Level 2 or Level 3 item is saved.  Similar to the [[Template / Type Formula|Level 1 Template]] formula. ''(See [[Template / Type Formula]])''
+
* '''Creation Roles''' - Sets the [[roles]] that are able to create records with this Type.
−
* '''Reminder Settings''' (Level 2 only) - The subject and content of the Reminder message.  These fields are only applicable if you have included reminder standard fields in your [[Level 2 Entity]].
+
* '''Available Status''' - Select the Level 2 [[Status]]es that can be selected for this Type.
−
* '''Follow Up Settings''' (Level 2 only) - The subject and content of the '''Follow up''' message.  These fields are only applicable if you have included follow up standard fields in your [[Level 2 Entity]].
+
* '''Enhanced Quick Entry Status''' - Select the Level 2 [[Status]]es that will be displayed when creating level 2s via Quick Entry. Only available when the [[Enhanced Quick Entry|Show Enhanced Quick Entry Tab]] option is activated on the main settings page. If no statuses are defined then it will use the statuses defined in the Available Status for the specific level 2 type. If no statuses are defined there, then the Quick Entry will show all Level 2 statuses.
−
* '''Restrict Contact Assignment by Contact''' (Level 2 only) - Allows you to restrict contact assignment for this Level 2 Type to named contacts.  
+
* '''Calendar Status''' - Select the Level 2 [[Status]]es in which records of this Type will be displayed on [[Calendars]]. The option ''None'' can be selected, in which case this Type will not be displayed on any Calendar.
−
::''For example, if the Level 2 Type is "Dissertation Review", and if there are 2 people in your company that look after all dissertation reviews you would specify them here by name so that only they could be assigned to level 2 records of this type''
+
* '''Enabled on Level 1 Templates''' - Currently only available against level 2 tasks. Allows you to define the level 1 templates that the current level 2 type is associated with.
−
* '''Restrict Contact Assignment by Role''' (Level 2 only) - Allows you to define which contact [[Role]]s can be assigned to this Level 2 Type.  
+
* '''Available to Level 2 Types''' - Currently only available against level 3 tasks. Allows you to define the level 2 types that the current level 3 type is associated with.
−
::''For example, if the Level 2 Type is "Legal Contract", you may wish to specify that only contacts with the role of "Lawyer" can be assigned to records of this type.''
 
−
* '''Enabled on Level 1 Templates''' - Currently only available against level 2 tasks. Allows you to define the level 1 templates that the current level 2 type is associated with.
 
−
* '''Available to Level 2 Types''' - Currently only available against level 3 tasks. Allows you to define the level 2 types that the current level 3 type is associated with.
 
  
−
===Displaying on Tabs===
+
----
−
Selecting the '''Display as Tab''' setting for a given Level 2 (or Level 3) Type will cause that Type to be displayed on a separate tab in the list of Level 2 (or Level 3) activities at the bottom of a Level 1 (or Level 2) record.
+
* '''Associated Parent Settings - Source''' - Currently only available against level 3 tasks. Provides ability to select between 2 level two entities in the same UTA or in related provider UTAs. Used in conjunction with the [[Standard Level 3 Field List|Associated Parent]] standard field.
−
* By default the label on the tab will the be the name of the Level 2 or 3 Type.
+
* '''Associated Parent Settings - Level 2 Activity Status''' - Currently only available against level 3 tasks. Allows selection of the level 2 statuses, based on the selected source, with the selected statuses controlling what is displayed in the [[Standard Level 3 Field List|Associated Parent]] standard field.
−
* You can also use the '''Tab Label''' setting (Level 2 only) to define a custom name for the tab.
+
* '''Associated Parent Settings - Level 2 Activity Type''' - Currently only available against level 3 tasks. Allows selection of the level 2 types, based on the selected source, with the selected types controlling what is displayed in the [[Standard Level 3 Field List|Associated Parent]] standard field.
−
* If you use the same tab name for multiple Level 2 Types they will appear on the same tab, allowing you to group related Level 2 Types.
 
  
 +
----
 +
[[Image:EditTypePagePt2.png|thumb|right|link=|500px|Middle Section of Level 2 Type Edit Page]]
  
−
Once '''Display as Tab''' has been enabled you can customize the [[List View]] for the items listed on that tab:
+
* '''Disabled Transaction Types''' - See [[Attaching_Transactions_to_a_UTA_Level_1_Record#Restricting Transaction Types by Template|Disabled Transaction Types]] for detailed instructions.
−
:[[Image:TLV.png]]
+
* '''[[Template / Type Formula|Level 2/Level 3 Formula]]''' - A set of expressions used to calculate values when the Level 2 or Level 3 item is saved. Similar to the [[Template / Type Formula|Level 1 Template]] formula. ''(See [[Template / Type Formula]])''
 +
* '''ID Used''' - Used in concert with Level 2/Level 3 Formula above. Only the custom fields with [[custom field IDs|field IDs]] entered into this section will be taken into account when running a Template/Type Formula. If this section is left blank, template formulas will run, but performance may be impacted.
 +
* '''Reminder Settings''' (Level 2 only) - The subject and content of the Reminder message. These fields are only applicable if you have included reminder standard fields in your [[Level 2 Entity]].
 +
** By ''default'', if there is no '''owner standard field''' - as is the case with calendar activities - then the last person to update the activity will be set as the owner.
 +
** If there is an '''owner standard field''' enabled, then the owner will be selected when creating reminders or follow-ups.
 +
* '''Follow Up Settings''' (Level 2 only) - The subject and content of the '''Follow up''' message. These fields are only applicable if you have included follow up standard fields in your [[Level 2 Entity]].
  
−
* Types that are not displayed on their own tabs will appear on the first tab ('''Other Level 2 Types''') and will use the [[List View]] that is configured on the '''Settings''' page.
+
----
−
* If you use the same Tab Label for more than one Type (thus grouping multiple Types onto the same Tab) it will also use the [[List View]] configured on the Settings page, the same [[List View]] as the '''Other Level 2 Types''' tab.
+
[[Image:EditTypePagePt3.png|thumb|right|link=|500px|Bottom Section of Level 2 Type Edit Page]]
 +
{{RestrictContactAssignment}}
  
−
===Type Template Page===
+
See also [[Restrict Contact Assignment]].
−
After having set up (or inserted the sample templates) you will need to Activate the page and fill in the required configuration settings.
+
* '''Scheduling Prerequisite'''
−
 
 
−
You will be presented with a URL in the following format:
 
−
* '''<nowiki>http://alias.smartsimple.xxx/ex/ex_Evtpage.jsp?token=HQ0NSdsAYbZFhZRBBFfQhdQ&parentids=LevelOneIds</nowiki>'''
 
−
 
 
−
where ''LevelOneIds'' is the Opportunity ID of the Level 1 you will be creating these Level 2s under.
 
−
 
 
−
example:
 
−
<pre>http://mysite.smartsimple.com/ex/ex_Evtpage.jsp?token=HQ0gNSAYbZfdhFhZRBBFQhdQ&parentids=5551234</pre>
 
−
 
 
−
==Reminder & Follow-up Settings==
 
−
 
 
−
[[Image:Reminder_n_follow_up.jpg]]
 
−
 
 
−
* By ''default'', if there is no '''owner standard field''' - as is the case with calendar activities - then the last person to update the activity will be set as the owner.
 
−
 
 
−
[[Image:Reminder_n_follow_up_2.JPG]]
 
−
 
 
−
* If there is an '''owner standard field''' enabled, then the owner will be selected when creating reminders or follow-ups.
 
  
 
==Type Custom Fields==
 
==Type Custom Fields==
 
You can define [[Custom Fields]] that will appear only on the Level 2 or Level 3 records of a given '''Type'''.
 
You can define [[Custom Fields]] that will appear only on the Level 2 or Level 3 records of a given '''Type'''.
 +
 
* To define these fields, click on the '''Fields''' button next to the relevant '''Type'''. Then create the desired custom fields in the normal fashion.
 
* To define these fields, click on the '''Fields''' button next to the relevant '''Type'''. Then create the desired custom fields in the normal fashion.
 
* The '''Display Order''' of the [[Custom Fields]] you create on a Type works in conjunction with the '''Display Order''' on any general Level 2 or Level 3 [[Custom Fields]] that have been defined.
 
* The '''Display Order''' of the [[Custom Fields]] you create on a Type works in conjunction with the '''Display Order''' on any general Level 2 or Level 3 [[Custom Fields]] that have been defined.
−
::''For example, if you have a Custom Field on a Level 2 Type with Display order of 15, it would appear between the global Level 2 custom fields with display orders of 10 and 20.''
+
*: ''For example, if you have a Custom Field on a Level 2 Type with Display order of 15, it would appear between the global Level 2 custom fields with display orders of 10 and 20.''
 +
*
 +
 
 +
==Notes==
 +
[[Notes Overview|Notes]] can also be added to individual Types. This feature assists system administrators keep track of the functionality and changes to individual types.
  
 
==See Also==
 
==See Also==
−
* [[Restricting Level 2 Types to Specific Level 1 Templates]]
+
** [[Restricting Level 2 Types to Specific Level 1 Templates]]
−
* [[Template / Type Formula]]
+
** [[Template / Type Formula]]
−
* [[List View]]
+
** [[List View]]
 +
 
 +
 
  
 +
{| style="background-color: #f0f0f0; border-style: solid; border-width: 2px;" cellpadding="5"
 +
|-
 +
||[[Image:Previous.png|link=Level 2 Types]] &nbsp;[[Level 2 Types]]
 +
||&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
||[[Restricting Level 2 Types to Specific Level 1 Templates]] &nbsp;[[Image:Next.png|link=Restricting Level 2 Types to Specific Level 1 Templates]]
 +
|}
  
 
[[Category:Universal Tracking Application]]
 
[[Category:Universal Tracking Application]]

Latest revision as of 16:00, 30 November 2021

Types provide a method of delineating between different varieties of Level 1, Level 2 and Level 3 records.


Note: Level 3 Types are configured the same manner as Level 2 Types. Any differences are noted below.


Creating and Editing Types

You can configure Types via the Types link on the Settings page of your UTA. To navigate there:

  1. Navigate to your UTA.
  2. Select the Configuration Settings Button, signified by the gear icon.
  3. For Level 1 types, select the second tab from the left. For Level 2 types, select the third tab from the left, and so on.
  4. Select the Types link to view the types that have been created for this level entity.

Types Link.png

Here, you will see a list of all types that have been created for this level entity. To edit or copy an existing type, simply select the Edit icon, signified by the pencil icon, beside the type. To copy a type, click the Save As button, enter the Name, Caption and Display Order of the new type, and press Save. To create a new type, simply select the New Type button, signified by the plus (+) sign. Types List.png


Type Settings

Each type of Level 2 Entity or Level 3 Entity has the following settings:

  • Type ID - This is the unique identifier for this Type. See Type ID for further information.
  • Name - Unique name for the Type.
  • Caption - Display name for the Type. See Caption for further information.
  • Display Order - The order in which the types are listed in the type combo box. See Display Order for further information.
  • Description - Any comments or notes you wish to include. Note: These don't manifest anywhere except on this page.
  • Color Code - A color code used to display different types in the list view.
  • Tab Label (Level 2 only) - Allows you to define a name for the tab if Display as Tab is selected. See Display as Tab article for details.
  • People Workflow (Level 2 only) - Allows you to attach a Tracking Activity Assignment Workflow to this Type.
  • Lock on Type (Level 2 and Level 3) - Allows you to lock this type after creation to prevent it from being changed.
  • Is Default Type - Allows you to select which Type will be the default when a new Level 2 or Level 3 record is created.
    • Note: if you select more than one type to be the default this will not function.
  • Display as Tab - This Type will be displayed on a separate tab in the list of activities at the bottom of their parent record. See Display as Tab article for details.
  • Show External (Level 2 only) - This check box indicates whether or not this type of activity should be shown to external users.
  • Is Payment - allows the ability to use SmartSimple's Payment Integration features with this Type.
  • Access Roles - Sets the roles able to access records associated with this Type.
  • Creation Roles - Sets the roles that are able to create records with this Type.
  • Available Status - Select the Level 2 Statuses that can be selected for this Type.
  • Enhanced Quick Entry Status - Select the Level 2 Statuses that will be displayed when creating level 2s via Quick Entry. Only available when the Show Enhanced Quick Entry Tab option is activated on the main settings page. If no statuses are defined then it will use the statuses defined in the Available Status for the specific level 2 type. If no statuses are defined there, then the Quick Entry will show all Level 2 statuses.
  • Calendar Status - Select the Level 2 Statuses in which records of this Type will be displayed on Calendars. The option None can be selected, in which case this Type will not be displayed on any Calendar.
  • Enabled on Level 1 Templates - Currently only available against level 2 tasks. Allows you to define the level 1 templates that the current level 2 type is associated with.
  • Available to Level 2 Types - Currently only available against level 3 tasks. Allows you to define the level 2 types that the current level 3 type is associated with.
  • Associated Parent Settings - Source - Currently only available against level 3 tasks. Provides ability to select between 2 level two entities in the same UTA or in related provider UTAs. Used in conjunction with the Associated Parent standard field.
  • Associated Parent Settings - Level 2 Activity Status - Currently only available against level 3 tasks. Allows selection of the level 2 statuses, based on the selected source, with the selected statuses controlling what is displayed in the Associated Parent standard field.
  • Associated Parent Settings - Level 2 Activity Type - Currently only available against level 3 tasks. Allows selection of the level 2 types, based on the selected source, with the selected types controlling what is displayed in the Associated Parent standard field.
Middle Section of Level 2 Type Edit Page
  • Disabled Transaction Types - See Disabled Transaction Types for detailed instructions.
  • Level 2/Level 3 Formula - A set of expressions used to calculate values when the Level 2 or Level 3 item is saved. Similar to the Level 1 Template formula. (See Template / Type Formula)
  • ID Used - Used in concert with Level 2/Level 3 Formula above. Only the custom fields with field IDs entered into this section will be taken into account when running a Template/Type Formula. If this section is left blank, template formulas will run, but performance may be impacted.
  • Reminder Settings (Level 2 only) - The subject and content of the Reminder message. These fields are only applicable if you have included reminder standard fields in your Level 2 Entity.
    • By default, if there is no owner standard field - as is the case with calendar activities - then the last person to update the activity will be set as the owner.
    • If there is an owner standard field enabled, then the owner will be selected when creating reminders or follow-ups.
  • Follow Up Settings (Level 2 only) - The subject and content of the Follow up message. These fields are only applicable if you have included follow up standard fields in your Level 2 Entity.
Bottom Section of Level 2 Type Edit Page
  • Restrict Contact Assignment by Contact (Level 2 only) - Allows you to restrict contact assignment for this Level 2 Type to named contacts.
For example, if the Level 2 Type is "Dissertation Review", and if there are 2 people in your company that look after all dissertation reviews you would specify them here by name so that only they could be assigned to level 2 records of this type
  • Restrict Contact Assignment by Role (Level 2 only) - Allows you to define which contact Roles can be assigned to this Level 2 Type.
For example, if the Level 2 Type is "Legal Contract", you may wish to specify that only contacts with the role of "Lawyer" can be assigned to records of this type.
  • Restrict Contact Assignment Role List - When assigning contacts to a Level 2 record, you can restrict the UTA Roles that are available from the dropdown with this section.
See also Restrict Contact Assignment.
  • Scheduling Prerequisite

Type Custom Fields

You can define Custom Fields that will appear only on the Level 2 or Level 3 records of a given Type.

  • To define these fields, click on the Fields button next to the relevant Type. Then create the desired custom fields in the normal fashion.
  • The Display Order of the Custom Fields you create on a Type works in conjunction with the Display Order on any general Level 2 or Level 3 Custom Fields that have been defined.
    For example, if you have a Custom Field on a Level 2 Type with Display order of 15, it would appear between the global Level 2 custom fields with display orders of 10 and 20.

Notes

Notes can also be added to individual Types. This feature assists system administrators keep track of the functionality and changes to individual types.

See Also


Previous.png  Level 2 Types        Restricting Level 2 Types to Specific Level 1 Templates  Next.png
Retrieved from ‘https://wiki.smartsimple.com/index.php?title=Types&oldid=39369’