Difference between revisions of "SmartCard"
From SmartWiki
(→No summary) |
|||
| (15 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
=Overview= | =Overview= | ||
| − | |||
The SmartCard feature is an easy to build and easy to access store of commonly used object data that can be shared with other users, either individually or based on system roles. | The SmartCard feature is an easy to build and easy to access store of commonly used object data that can be shared with other users, either individually or based on system roles. | ||
| − | The SmartCard feature is currently available against the following object data . . . | + | The SmartCard feature is currently available against the following object data . . . |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | * [[Level 1 Entity|UTA Level 1 records]] | ||
| + | * [[Level 2 Entity|UTA Level 2 records]] | ||
| + | * [[Level 3 Entity|UTA Level 3 records]] | ||
| + | * [[User]] | ||
| + | * [[Organization]] | ||
| + | * [[Transactions]] | ||
=Configuring SmartCards= | =Configuring SmartCards= | ||
| − | |||
==Permissions== | ==Permissions== | ||
| − | + | The ability to create, add objects to and then access SmartCards is controlled by the '''Enable SmartCard''' setting in the [[System_Feature_Permissions#Miscellaneous_Feature_Permission|System Feature Permissions]]. | |
| − | The ability to add objects to and then access SmartCards is controlled by the '''Enable SmartCard''' setting in the [[System_Feature_Permissions#Miscellaneous_Feature_Permission|System Feature Permissions]]. | ||
Use the lookup button for the '''Enable SmartCard''' setting to add those roles that should have access to this feature. | Use the lookup button for the '''Enable SmartCard''' setting to add those roles that should have access to this feature. | ||
| − | |||
==Display Options== | ==Display Options== | ||
| − | |||
The system allows for 3 fields to be displayed for each SmartCard item for all supported Object types. | The system allows for 3 fields to be displayed for each SmartCard item for all supported Object types. | ||
| − | The fields themselves are configured via the '''SmartCard Item Display Settings''' page. | + | The displayed fields themselves are configured via the '''SmartCard Item Display Settings''' page. |
| − | |||
| − | |||
| + | :: [[Image:SmartCardDisplay.png|550px|border|link:]] | ||
# Under the Configuration menu click on '''Global Settings'''. | # Under the Configuration menu click on '''Global Settings'''. | ||
| − | # | + | # Under the System Configuration header, click on the SmartCard option. |
# The '''SmartCard Item Display Settings''' page is displayed. | # The '''SmartCard Item Display Settings''' page is displayed. | ||
| − | # Select the Object type from the first drop-down. | + | # Select the Object type from the first drop-down. |
| − | # Click on the button adjacent to the first drop-down, which has a tool-tip that reads "Edit Object Type display settings". | + | # Click on the button adjacent to the first drop-down, which has a tool-tip that reads "Edit Object Type display settings". |
| − | # A SmartCard display item will appear on the right hand panel, while all Standard and Custom fields associated with the selected Object Type appear on the left hand panel, beneath the second drop-down. | + | # A SmartCard display item will appear on the right hand panel, while all Standard and Custom fields associated with the selected Object Type appear on the left hand panel, beneath the second drop-down. |
| − | # The second drop-down can be used to control the display of fields underneath, restricting them to Standard fields, common Custom fields or to Type / Role / Category specific Custom Fields. | + | # The second drop-down can be used to control the display of fields underneath, restricting them to Standard fields, common Custom fields or to Type / Role / Category specific Custom Fields. |
# Required fields can be dragged across to the SmartCard display item. | # Required fields can be dragged across to the SmartCard display item. | ||
# Fields can be removed from the SmartCard display item by clicking on the X to the right of the field name. | # Fields can be removed from the SmartCard display item by clicking on the X to the right of the field name. | ||
# Click Save once complete. You will be informed that SmartCard Display Settings have saved. | # Click Save once complete. You will be informed that SmartCard Display Settings have saved. | ||
# Click on the the delete option in the top right of the SmartCard Display item if you wish to remove the entire item, then click Save. | # Click on the the delete option in the top right of the SmartCard Display item if you wish to remove the entire item, then click Save. | ||
| − | |||
| − | |||
| − | |||
=Creating SmartCards= | =Creating SmartCards= | ||
| − | |||
==Selecting individual Object Record== | ==Selecting individual Object Record== | ||
| − | + | # Navigate into the Object record that you wish to add to a SmartCard. | |
| − | + | # A small star icon will appear in the top right corner of the Object record. Click this. | |
| − | + | # You will be presented with window allowing you to add to a new Smartcard or an existing SmartCard, depending on whether a SmartCard has been created for the current Object Type. | |
| − | # Navigate into the Object record that you wish to add to a SmartCard. | ||
| − | # Click | ||
| − | # You will be presented with window allowing you to add to a new Smartcard or an existing SmartCard, depending on whether a SmartCard has been created for the current Object Type. | ||
| − | |||
==Selecting objects from List View== | ==Selecting objects from List View== | ||
| − | + | :: [[Image:SmartCard2.png|700px|border|link:]] | |
| − | ::[[Image:SmartCard2.png|link: | + | # Navigate to list view for the Object Type that you wish to add to a SmartCard. |
| − | + | # Run a search and then check the boxes for the records that you wish to add. | |
| − | # Navigate to list view for the Object Type that you wish to add to a SmartCard. | + | # A small star icon will appear in the menu bar above the list view. |
| − | # Run a search and then check the boxes for the records that you wish to add. | + | # Click on this star icon. |
| − | # A small star icon will appear in the menu bar above the list view. | + | # You will be presented with window allowing you to add to a new Smartcard or an existing SmartCard, depending on whether a SmartCard has been created for the current Object Type. |
| − | # Click on this star icon. | ||
| − | # You will be presented with window allowing you to add to a new Smartcard or an existing SmartCard, depending on whether a SmartCard has been created for the current Object Type. | ||
==Adding to New SmartCard== | ==Adding to New SmartCard== | ||
| + | If there is no SmartCard for the selected object type then you can create a new SmartCard. | ||
| − | + | :: [[Image:SmartCard3.png|500px|border|link:]] | |
| − | |||
| − | ::[[Image:SmartCard3.png|link: | ||
| − | |||
# Populate the Title field with the name you wish to assign the SmartCard. | # Populate the Title field with the name you wish to assign the SmartCard. | ||
# Use the Lookup button beside the Icon field to select any icon you wish to assign the SmartCard, | # Use the Lookup button beside the Icon field to select any icon you wish to assign the SmartCard, | ||
# You can choose to Share the SmartCard. | # You can choose to Share the SmartCard. | ||
# Click the Add to New SmartCard button at the bottom. | # Click the Add to New SmartCard button at the bottom. | ||
| − | # The New SmartCard screen will refresh, and you should now see the SmartCard listed on the left hand side and the create new options appear on the right. | + | # The New SmartCard screen will refresh, and you should now see the SmartCard listed on the left hand side and the create new options appear on the right. |
| + | |||
==Adding to / Removing from Existing SmartCard== | ==Adding to / Removing from Existing SmartCard== | ||
| + | If there are existing SmartCards for the selected object type then you can add to these existing ones as well as create a new SmartCard. | ||
| − | + | The SmartCard screen will appear with the existing object specific SmartCards listed on the left hand side and the Create New options on the right. | |
| − | |||
| − | The SmartCard screen will appear with the existing object specific SmartCards listed on the left hand side and the Create New options on the right. | ||
| − | |||
| − | |||
| + | :: [[Image:SmartCard4.png|700px|border|link:]] | ||
# Each existing SmartCard will have a star icon to the left of the SmartCard name. | # Each existing SmartCard will have a star icon to the left of the SmartCard name. | ||
| − | # If the star is a solid colour then the record or records already exist against the SmartCard. In this case you can click the Star to remove the record. | + | # If the star is a solid colour then the record or records already exist against the SmartCard. In this case you can click the Star to remove the record. |
| − | # If the stars border is a different colour than its centre then the record or records do not yet exist against the SmartCard. In this case you can click the Star to add the record. | + | # If the stars border is a different colour than its centre then the record or records do not yet exist against the SmartCard. In this case you can click the Star to add the record. |
| − | # In each case you will be informed that the SmartCard has been updated. | + | # In each case you will be informed that the SmartCard has been updated. |
| − | # You can also create a new SmartCard for the object using the options on the right hand side. | + | # You can also create a new SmartCard for the object using the options on the right hand side. |
| − | |||
==Sharing SmartCard== | ==Sharing SmartCard== | ||
| + | SmartCards can be shared with other [[SmartCard#Permissions|permissioned]] users, either individually or based on system roles., | ||
| − | + | # To share based on roles then click on the Lookup option beside the Select Roles option, then select roles that you wish to share the SmartCard with and click OK. | |
| − | + | # To share based on individual users then either type into the Select Users Ajax lookup field and select the user from the returned results or use the adjacent Lookup option to select users. | |
| − | |||
| − | # | ||
| − | |||
| − | |||
| − | |||
=Using SmartCards= | =Using SmartCards= | ||
| − | |||
==Accessing SmartCard== | ==Accessing SmartCard== | ||
| − | |||
SmartCards are accessed from the User Menu, by clicking on the My SmartCards option. | SmartCards are accessed from the User Menu, by clicking on the My SmartCards option. | ||
| − | ::[[Image:SmartCard5.png|link: | + | :: [[Image:SmartCard5.png|150px|border|link:]] |
| + | The User will be brought to the SmartCards page, which has 2 tabs | ||
| − | |||
* My SmartCards - the SmartCards created by the current user. They have the ability to edit, delete and share | * My SmartCards - the SmartCards created by the current user. They have the ability to edit, delete and share | ||
* Shared with Me - the SmartCards created by other users. They can view, but cannot edit, deleted or share | * Shared with Me - the SmartCards created by other users. They can view, but cannot edit, deleted or share | ||
| − | |||
| − | |||
| − | If | + | :: [[Image:SmartCard9.png|400px|border|link:]] |
| + | Users can click on the individual records listed and will be automatically brought to that record. | ||
| + | |||
| + | If a SmartCard has more records than can be listed on the screen then there will be small arrow icon at the bottom that will allow them to scroll down through all the records. | ||
| − | |||
==Edit / Delete from My SmartCards== | ==Edit / Delete from My SmartCards== | ||
| + | The My SmartCards section displays those SmartCards created by the current user. | ||
| − | The | + | The current user will have the ability to remove individual records from SmartCards by clicking on the Delete icon to the right of each individual record. |
| − | The current user will have the ability to edit | + | The current user will have the ability to edit the SmartCard by clicking on the Edit icon. |
| − | ::[[Image:SmartCard7.png|link: | + | :: [[Image:SmartCard7.png|400px|border|link:]] |
| + | They can then rename the SmartCard and save or, alternatively, they have the option to delete the entire SmartCard. | ||
| − | |||
| − | They will also have the option to Share the SmartCard by clicking on the Share icon, which presents them with the Select Roles and Select User options. | + | They will also have the option to Share the SmartCard by clicking on the Share icon, which presents them with the Select Roles and Select User options. |
| − | ::[[Image:SmartCard8.png|link: | + | :: [[Image:SmartCard8.png|400px|border|link:]] |
Latest revision as of 15:06, 26 January 2021
Overview
The SmartCard feature is an easy to build and easy to access store of commonly used object data that can be shared with other users, either individually or based on system roles.
The SmartCard feature is currently available against the following object data . . .
Configuring SmartCards
Permissions
The ability to create, add objects to and then access SmartCards is controlled by the Enable SmartCard setting in the System Feature Permissions.
Use the lookup button for the Enable SmartCard setting to add those roles that should have access to this feature.
Display Options
The system allows for 3 fields to be displayed for each SmartCard item for all supported Object types.
The displayed fields themselves are configured via the SmartCard Item Display Settings page.
- Under the Configuration menu click on Global Settings.
- Under the System Configuration header, click on the SmartCard option.
- The SmartCard Item Display Settings page is displayed.
- Select the Object type from the first drop-down.
- Click on the button adjacent to the first drop-down, which has a tool-tip that reads "Edit Object Type display settings".
- A SmartCard display item will appear on the right hand panel, while all Standard and Custom fields associated with the selected Object Type appear on the left hand panel, beneath the second drop-down.
- The second drop-down can be used to control the display of fields underneath, restricting them to Standard fields, common Custom fields or to Type / Role / Category specific Custom Fields.
- Required fields can be dragged across to the SmartCard display item.
- Fields can be removed from the SmartCard display item by clicking on the X to the right of the field name.
- Click Save once complete. You will be informed that SmartCard Display Settings have saved.
- Click on the the delete option in the top right of the SmartCard Display item if you wish to remove the entire item, then click Save.
Creating SmartCards
Selecting individual Object Record
- Navigate into the Object record that you wish to add to a SmartCard.
- A small star icon will appear in the top right corner of the Object record. Click this.
- You will be presented with window allowing you to add to a new Smartcard or an existing SmartCard, depending on whether a SmartCard has been created for the current Object Type.
Selecting objects from List View
- Navigate to list view for the Object Type that you wish to add to a SmartCard.
- Run a search and then check the boxes for the records that you wish to add.
- A small star icon will appear in the menu bar above the list view.
- Click on this star icon.
- You will be presented with window allowing you to add to a new Smartcard or an existing SmartCard, depending on whether a SmartCard has been created for the current Object Type.
Adding to New SmartCard
If there is no SmartCard for the selected object type then you can create a new SmartCard.
- Populate the Title field with the name you wish to assign the SmartCard.
- Use the Lookup button beside the Icon field to select any icon you wish to assign the SmartCard,
- You can choose to Share the SmartCard.
- Click the Add to New SmartCard button at the bottom.
- The New SmartCard screen will refresh, and you should now see the SmartCard listed on the left hand side and the create new options appear on the right.
Adding to / Removing from Existing SmartCard
If there are existing SmartCards for the selected object type then you can add to these existing ones as well as create a new SmartCard.
The SmartCard screen will appear with the existing object specific SmartCards listed on the left hand side and the Create New options on the right.
- Each existing SmartCard will have a star icon to the left of the SmartCard name.
- If the star is a solid colour then the record or records already exist against the SmartCard. In this case you can click the Star to remove the record.
- If the stars border is a different colour than its centre then the record or records do not yet exist against the SmartCard. In this case you can click the Star to add the record.
- In each case you will be informed that the SmartCard has been updated.
- You can also create a new SmartCard for the object using the options on the right hand side.
Sharing SmartCard
SmartCards can be shared with other permissioned users, either individually or based on system roles.,
- To share based on roles then click on the Lookup option beside the Select Roles option, then select roles that you wish to share the SmartCard with and click OK.
- To share based on individual users then either type into the Select Users Ajax lookup field and select the user from the returned results or use the adjacent Lookup option to select users.
Using SmartCards
Accessing SmartCard
SmartCards are accessed from the User Menu, by clicking on the My SmartCards option.
The User will be brought to the SmartCards page, which has 2 tabs
- My SmartCards - the SmartCards created by the current user. They have the ability to edit, delete and share
- Shared with Me - the SmartCards created by other users. They can view, but cannot edit, deleted or share
Users can click on the individual records listed and will be automatically brought to that record.
If a SmartCard has more records than can be listed on the screen then there will be small arrow icon at the bottom that will allow them to scroll down through all the records.
Edit / Delete from My SmartCards
The My SmartCards section displays those SmartCards created by the current user.
The current user will have the ability to remove individual records from SmartCards by clicking on the Delete icon to the right of each individual record.
The current user will have the ability to edit the SmartCard by clicking on the Edit icon.
They can then rename the SmartCard and save or, alternatively, they have the option to delete the entire SmartCard.
They will also have the option to Share the SmartCard by clicking on the Share icon, which presents them with the Select Roles and Select User options.
