Assets search gives the possibility of enhanced search, visibility, and selection of Asset objects in Assets custom fields from the Customer Portal. After configuration, the Asset search field will be added to the customer portal on the request creation page. See Asset search configuration and Assets search on the Customer Portal below for the user guide.
Before configuring the Asset search field, you need to establish a connection with Assets.
Connection to Assets
When you navigate to the Asset search in the app configuration page after the installation of the app, you will see the notification that the connection with Assets is not established:
...
Go to “General Settings / Assets search” to configure connection with Assets:
...
Click the “Configure now” button and fill in the Email and API Token fields:
...
Email
Enter the email address of the user who has permission to access Assets. This user should have valid JSM Agent License.
API Token
Enter the API Token of the user selected above. You can create a Token through the following link.
When fill both fields in, the “Save Configuration“ button will be enabled and if the credentials are correct, you will see the success message:
...
You can refresh the connection status by clicking the “Refresh status“ button.
If the credentials are incorrect, you will see the corresponding notification:
...
When the connection is successful, you can go to the “Assets Search” in the left sidebar to configure the Asset search field.
Asset search configuration
To configure the Asset search field, you initially need to connect to Assets. If the connection is not configured (for example after the initial installation of the app), you will see the corresponding notification:
...
| Info |
|---|
To configure the connection with assets, see the instructions above. |
After the connection is successful, you can start configuring the Asset search field by clicking “+Add Asset search field“ button and defining the parameters:
...
Active/Inactive (toggle)
Switch this toggle to show or hide the search field on the Customer Portal.
Required (toggle)
Toggling this on will make this Asset field mandatory for requests in the Customer Portal.
Name (mandatory)
Choose a name for your Asset search field. The name will be visible above the search field on the Customer Portal.
Placeholder
Choose a placeholder for your Asset search field. This placeholder will be visible by default in the search field on the Customer Portal.
Description
Add a description for your Asset search field. This description will be visible under the search field on the Customer Portal.
Copy to summary toggle
Projects (mandatory)
Select the project(s), in the requests of which the Asset search field should be visible.
Issue Types (mandatory)
Select the Issue Type(s), where the Asset search field should be visible. The list of the Issue Types is defined by the selected project above.
Request Types
Select the Request Type(s), in which the Asset search field should be visible. The list of the Request Types is defined by the selected Projects and Issue Types above.
Assets info sheet | Display Settings
Linked Jira Asset Field (mandatory)
Choose the Asset custom field that should be shown on the Customer portal and where the searched object will be selected after the creation of the request. The dropdown will show all the Asset fields in the JSM. The Asset field must be associated with the create and edit issue screens of the selected projects' corresponding issue type(s).
Display and search across these attributes in the custom field
Select the attributes that should be displayed on the Customer Portal in the Asset Info Sheet for the searched object. The list shows the attributes selected in "Allow search filtering by these attributes" in the Assets custom field configuration in Jira.
Field can store multiple objects (toggle)
Select this toggle if the “Field can store multiple objects“ option in the Asset field configuration is selected.
After all the mandatory fields are filled, click the enabled “Save Configuration“ button.
Assets search on the Customer Portal
When the Asset search field is configured, you will see the field in the request create page and can search and view object details according to the configuration:
...
By checking the checkbox, you can select the object(s) in the field:
...
After creating the request, the Asset field will be filled with the selected objects.