Settings & Configuration
Settings & Configuration
Dibz – Asset Reservation Calendar for JSM lets customers reserve objects from Jira Assets, such as pool cars, meeting rooms, desks or laptops, through the Jira Service Management customer portal. Every booking belongs to a JSM request, so agents handle it in the queue they already use.
Key concepts
| Term | Meaning |
|---|---|
| Booking profile | The central setting. It connects one or more request types to the Assets objects customers can book, and sets the rules (length, notice, approval, handover), hours, closed days and portal design. |
| Request type | A JSM request type on a portal. Each request type can belong to only one profile. |
| Steps (AQL) | One to five Assets queries. Earlier steps narrow the choice (for example Office); the last step is what customers book (for example Car). |
| Request fields | Jira fields the app fills on every request: the Assets field (booked object), Pick-up, Return and, optionally, Booking status. |
| Default availability | Site-wide opening hours, closed days and maintenance blocks that apply to every profile. |
| Design template | The look of the booking form on the portal: Classic, Modern or a custom design. |
Prepare these in Jira before creating your first booking profile:
| ✓ | What | Notes |
|---|---|---|
| ☐ | A JSM service project with a portal and a request type for bookings | For example Car reservation. The project pages only appear in service projects. |
| ☐ | An Assets schema with the objects to book | Objects need attributes you can query, for example Status = "In service". |
| ☐ | An Assets objects custom field | Stores the booked object on the request. |
| ☐ | Two date-time custom fields | For Pick-up and Return. Date-only fields can’t be used. |
| ☐ | Optional: a short text field | Booking status, useful for Automation and JQL. |
| ☐ | Fields on the work item view | Add all these fields to the work item view (edit screen) of each booking request type. The app checks this but can’t add them for you. |
| ☐ | An approver group (if approval is used) | A Jira group whose members approve or decline. |
| ☐ | Customer organisations (optional) | Only if booking should be limited to certain organisations. |
| ☐ | Time zone and date format | Set them first in Settings › General (chapter 7). |