Creating a Custom Card
Last updated
Last updated
Custom cards let you add custom content into your Tickets, Cases and Actions. You can instantly create cards of your custom data fields, or switch to Advanced mode to show richer content such as external systems and webforms.
To create a Custom Card that you are able to quickly auto-generate from an ordered list of the fields listed on the cards, select the Custom Cards section from the toolbar.
This will bring you to a list of all Custom Cards. This is where you can create, edit and delete Custom Cards.
You can also export and import Custom Cards - see here for more information:
Importing / Exporting Custom CardsTo find out how to create a Custom Card in Enate, you can watch the following video or read the information below.
Clicking the '+' icon on the top right of the page will give you the option to 'Add a Work Manager Card' or to 'Add a Self Service Card'. As the name suggests, Work Manager cards are used for presenting data to agents looking at work items in Work Manager; Self Service cards are used for presenting data to customers in Self Service, usually used to give end service recipients a view on their data for a service request they are submitting or reviewing via Self Service.
Clicking on either of these links will bring up the card details:
The screen will show you card header data to be filled in, plus two columns showing a list of custom data fields. The 'Added Fields' section on the left shows the fields currently added to the card (which will be empty for brand new card); the 'Available' section on the right lists all other custom data fields that are available in your system.
You then need to configure the following information for the Custom Card:
Attribute | Description |
Name | The card name. Mandatory. |
Description | A description for the card |
Advanced | Whether you want the Custom Card to include advanced content. See here for more information. |
To add a custom data field to a custom card, you can click on a field from the 'Available' section on the right-hand side which shows a list of all the custom data fields in the system. This will add the field to the 'Added Fields' section on the left which shows a list of all the custom data fields which have been added to the Custom Card.
If you have many fields to choose from, you can click to filter the list by type of data or you can search for the field name itself.
After adding the desired custom data fields to your Custom Card, drag and drop the fields to modify the order in which you want your custom data fields them to display in Work Manager.
You can choose if you want end users in Work Managers to have to fill in the field by selecting to make a custom data field mandatory.
To make a field mandatory, select a custom data field from the list of Added Fields on the left and click the '+' icon. This will open the Field Settings pop-up.
Selecting the 'Mandatory' option will mean that an agent in Work Manager will be required to fill out the fields marked as mandatory before they are able to submit or change the status of the work item.
The validation check for when only the 'mandatory' option is set runs every time a work item gets submitted or the status gets changed. This means that when an agent clicks to change the status of the work item, regardless of what that status is the system will still run a check and ask the agent to complete any mandatory fields that are yet to be filled in in order to proceed every time the user clicks to change the status of the work item.
Selecting the 'Only on Resolve' option will mean that an agent in Work Manager will only be required to fill out the fields marked as mandatory at the point of Resolving a ticket or Action, rather that for any update.
When this setting is ticked, the validation check to make sure that all mandatory fields are filled in only occurs when an agent clicks to mark the work item as successfully resolved, instead of every time the submit or change the status of the work item.
This means that when an agent clicks to change the status of the work item to resolved successfully but has not filled out the mandatory fields, the system will prevent the agent from resolving the work item and will ask the agent to complete the mandatory fields in order to proceed.
However, if the agent is changing the status to something other than successfully resolved, e.g. 'Waiting' because they do not have the data required to fill in the mandatory data fields, or they are rejecting or cancelling the work item, the system will not ask the user to fill in the mandatory fields; they will instead be able to proceed without being forced to fill in the mandatory data fields.
This should help avoid scenarios where agents must fill in any mandatory fields, even though the change in work item status no longer requires the data fields to be filled in e.g. when rejecting a Ticket as spam.
For a Ticket, this is when choosing to resolve a Ticket
With Customer Response, or with
No customer response
For an Action, this is when you click to resolve the Action and mark it as 'complete'.
Once you have marked a field as 'Mandatory' or 'Mandatory Only on Resolve' and clicked 'Apply', the field will now be marked with an 'M' to show that it is mandatory.
Note that when it comes to making a custom data table mandatory, you cannot make the whole table mandatory but you can make individual fields within the table mandatory.
You can choose if you want end users in Work Manager to be unable to edit the field by selecting to make a custom data field read-only.
To make a field read-only, select a custom data field from the list of Added Fields on the left and click the '+' icon. This will open the Field Settings pop-up.
Click the 'Mark this field as read-only' option and click 'Apply'.
The field will now be marked with an 'R' to show that it is mandatory.
Note that when making a field read-only your options for providing a value to it are as follows:
Set a default value for the field by adjusting the custom data field settings, or if you leave the default settings blank,
Users in Work Manager can enter a value into the field on a Work Item, but once the field has been filled in and the work item has been subsequently submitted, the field will become read-only and users will no longer be able to edit it.
Note that you cannot set a default value for the following types of data:
multiple-level lists
decimal numbers.
When it comes to making a custom data table read-only, you cannot make the whole table read-only but you can make individual fields within the table read-only.
You can also choose if you want to hide a custom data field from end users in Work Manager based on the value of another field on the card by selecting to Add Conditions. For example, you could choose to hide the field 'Type of hardware required' if the answer for the field 'Is hardware required' is no by adding the following condition:
Then if any one of these conditions are met, the field 'Type of hardware required' will not show on the Custom Card in Work Manager (this can happen instantly on field value change when users a changing field values).
To add a condition, a field from the list of Added Fields on the left and click the '+' icon. This will open the Field Settings pop-up.
Click the '+' option to add a condition and then select the field and the condition.
You can add a condition based on any of the existing custom data fields that have been added to a Custom Card and for all custom field data types.
'OR' logic applies if multiple conditions are added to a field, i.e. if any one of the conditions added to a field are met, the field will not show on the Custom Card in Work Manager.
The conditions you can add depend upon the type of custom field. See the following table for further information:
Type of custom data field | Type of condition that can be used |
---|---|
Check Box | Equals Does Not Equal |
Date and Time | Equals Does Not Equal Is Between Is greater than Is less than Is greater than or equals Is less than or equals |
Date Only | Equals Does Not Equal Is Between Is greater than Is less than Is greater than or equals Is less than or equals |
Decimal Number | Equals Does Not Equal Is Between Is greater than Is less than Is greater than or equals Is less than or equals |
Email Address | Equals Does Not Equal |
Hyperlink | Equals Does Not Equal |
List | Equals Does Not Equal |
Long Text | Equals Does not equal |
Multiple Level List | Equals Does Not Equal |
Short Text | Equals Does Not Equal |
Whole Number | Equals Does Not Equal Is Between Is greater than Is less than Is greater than or equals Is less than or equals |
Custom Data Table | See below. |
When adding conditions to determine whether a data table should be shown or hidden depending on whether certain conditions are met, note that the entire data table will either be shown or hidden - you cannot choose to show or hide individual fields within a custom data table. This includes any fields that you have selected as mandatory.
You can easily create new custom data fields without leaving the Cards editing screen - simply click the 'add' icon above the list of system fields and fill in the required information in the resulting popup.
If you wish your Custom Card to contain bespoke content, you can select the 'Advanced' option while editing the card. This will allow you to add HTML and Typescript.
See here for more information about Advanced Custom Cards:
Advanced Custom Cards