Atlassian has announced the deprecation of its External Assets Platform, with a complete shutdown scheduled for . To ensure a seamless transition and minimize disruptions to your workflows, we are introducing a new Asset Custom Field, built on Atlassian's Forge capabilities, as a replacement.
This guide provides detailed instructions for migrating to the new solution, including essential steps, required actions, and key considerations to help you adapt effectively.
On this page: |
|---|
Overview of changes
The External Assets Platform custom field will no longer be available.
A new Asset Custom Field is provided as a replacement.
Existing data will be migrated to the new custom field.
Some configuration updates, particularly related to asset filters, may be required.
Admins need to decide on the best migration approach for their organization and complete the necessary actions.
Migration steps
If you encounter any issues or have questions during the migration process, our support team is here to help. Contact us to get assistance and ensure a smooth transition.
Step 1: Notification and initial configuration
Admins will see a banner in the application notifying them of the upcoming changes.
The banner includes information about the new custom field, and a call-to-action to Configure the migration option.
Actions required
Admins must:
Click Configure the migration.
Choose your preferred migration approach:
Automated updates – Check the box labeled Yes, update them to automatically update existing issue data. Note that this may trigger automation rules or impact reports.
Manual configuration – Leave the box unchecked if you prefer to manage configurations manually.
Important
If you leave the box unchecked, all asset data stored in the old custom field will be lost when the External Assets Platform is shut down on . You will need to migrate the data manually.
Step 2: Data migration
The migration process automatically maps existing data from the deprecated custom field to the new one.
Process:
Upgrade the application – Install the new Forge-based version of the app.
Migration begins automatically – When the admin upgrades to the Forge app, the migration starts automatically.
Monitor progress – Real-time updates will be displayed during the migration.
Completion – Once the migration is complete, the new custom field will be added to relevant screens and schemes for continued functionality.
Step 3: Optional configuration for filters
If you used asset filters with the old custom field, follow these steps to replicate the functionality in the new field:
Review and update filters:
Navigate to Asset Navigator, locate the automatically created filter, and verify its contents.
Adjust settings as needed under Filter Settings > Viewers, and make sure My Organization is always selected. Otherwise, you won’t be able to use this filter in the custom field.
Update custom field Contexts:
Go to Jira Settings > Custom Fields.
Find the relevant custom field, then select Contexts > Create, Edit, or Delete Contexts.
Edit the context settings and select the appropriate Asset filter.
Choose the Field type (Single or Multiple choice) and optionally make the field read-only.
If you skip this step, the migration will still succeed, but filters may not function as expected in the new custom field.
Adding the new custom field to Jira Service Management (JSM) Portal
To display the custom field on the JSM portal:
Navigate to Project Settings in your service project.
Under Apps, click Assets settings (AIP).
Locate the request type where you want to add the field and click Edit fields.
Select the custom field and click Save.
The custom field now appear on the customer portal form under that request type.
Optionally, you can enable the Display Asset Details in Portal View checkbox to show asset information on the portal.
Limitations
The new custom field cannot be set as mandatory on JSM portal forms due to Atlassian platform limitations.
The position of the custom field on the portal form cannot be rearranged.
Known issues
String vs. ID Values
Due to Atlassian limitations, the custom field may display ID values instead of labels (for example, showing 1 instead of Employee). This issue affects:
JQL queries – The query will function correctly, but the Issues view may show IDs instead of labels.
History panel – Changes in the custom field will also display IDs instead of labels in the issue History tab. If this affects your workflow, contact our support team to discuss adding an Asset History Panel to improve usability.
