Troubleshooting installation
Troubleshooting installation
Most problems after installation or first deployment fall into one of five categories. This page covers each one with symptoms, the most likely cause, and the fix. If your issue is not listed here, contact support through the Customer Documentation Access page.
Objects not appearing in requests
Symptoms: The Assets field is visible on the request form but shows no selectable objects.
Most common cause: The field is not filtered to the correct object type in the schema.
Fix: Edit the field configuration in your request type settings and ensure both a schema and an object type are selected (for example, Application). Without both of these set, the field has nothing to display.
| Other possible cause | Fix |
|---|---|
| No objects exist in the object type | Create at least one test object in Assets |
| Agent permissions do not include Assets access | Grant the relevant agents Assets permissions |
| Wrong field added to the request type | Remove the field and re-add as an Assets object field |
Permissions issues
Symptoms: Users cannot see objects, cannot open object details from a ticket, or get permission errors when navigating to Assets.
Typical reason: Assets permissions are separate from Jira space permissions. Having access to a Jira space does not automatically grant visibility into the Assets schema.
Fix: Go to Jira settings → Assets → Object schema → Permissions and add the appropriate groups. Typically this means granting view access to jira-servicedesk-users (so agents can see objects) and edit access to administrators or data owners who need to maintain records.
Screenshot coming soon
⚠️ This is the single most common support issue after a fresh deployment. If your agents can raise tickets but cannot see the linked Assets data, permissions are almost certainly the cause.
Automation not triggering
Symptoms: Automation rules that reference Assets fields do not fire, or fire but produce no result.
Common causes: The rule actor (the account running the automation) does not have permission to view objects, the Assets field is not included on the work item screen, or the field is not populated at the point the rule executes.
Fix: First, check that the rule actor has Assets view permissions. Second, confirm the Assets field is present on the work item screen (not just the request form). Third, if the rule triggers on work item creation, the object field may not yet be set when the rule runs. Either add a small delay condition or switch the trigger to "Field value changed" so it fires after the field is populated.
Most automation failures occur because the rule runs before the Assets field has a value. A two-second delay or a field-change trigger resolves this in almost every case.
Assets field empty
Symptoms: The Assets field is correctly configured but no objects appear in the dropdown.
Cause: The object schema is deployed but contains no data. LaunchPad creates the structure (object types, attributes, relationships) but does not populate it with records. An empty object type will show an empty field.
Fix: Create at least one object in the relevant object type. Go to Assets → Object schema → Object type → Create object and add a test record. The field will then become selectable in requests.
⚠️ After deploying a schema, create three to five sample objects in your most-used object types (for example, Application, Service, or Server). This gives you enough data to verify the integration works before importing real records.
Performance issues
Symptoms: Slow loading when opening Assets, browsing objects, or selecting values in Assets fields on request forms.
| Cause | What to do |
|---|---|
| Too many attributes on a single object type | Remove or hide unused attributes to reduce the data loaded per object |
| Long reference chains | Reduce deeply nested relationships where possible |
| Overly complex field filters | Simplify the AQL filter on the Assets field to return fewer results |
LaunchPad schemas are optimised for performance out of the box. Performance problems usually appear after heavy customisation, particularly when many additional attributes or multi-level reference chains are added. If you have not customised the schema and are experiencing slowness, contact support.