With the new assets management API for Jira Cloud, developers can bring a lot more context into Jira to create a faster and more powerful issue resolution experience. Join Andrea, a developer on Jira Service Desk, as she gives a holistic overview of asset management in Jira Cloud. We’ll step through an ideal end-to-end user experience from help seekers raising a request for their laptop, to an agent resolution. In this talk, you’ll learn what powers these experiences and exactly how to create them using the Jira Cloud Assets API and integration points.

1. The Jira Cloud Assets API
Discover the possibilities
ANDREA OLRICH | DEVELOPER | ATLASSIAN | AOLRICH@ATLASSIAN.COM

6. Help!

7. Help!

8. Help!

9. Help!
It’s my laptop

10. Help!
It’s my laptop

11. Help!
It’s my laptop

12. Help!
It’s my laptop
It’s only 6
months old

13. Help!
It’s my laptop
It’s only 6
months old

14. Help!
It’s my laptop
It’s only 6
months old
It’s happened before

15. Help!
It’s my laptop
It’s only 6
months old
It’s happened before

16. Help!
It’s my laptop
It’s only 6
months old
It’s happened before
Troubleshooted
previously

17. Help!
It’s my laptop
It’s only 6
months old
It’s happened before
Troubleshooted
previously

18. Help!
It’s my laptop
It’s only 6
months old
It’s happened before
It’s under warranty
Troubleshooted
previously

19. Help!
It’s my laptop
It’s only 6
months old
It’s happened before
It’s under warranty
Troubleshooted
previously

20. Help!
It’s my laptop
It’s only 6
months old
It’s happened before
It’s under warranty
Troubleshooted
previously

21. Help!
It’s my laptop
It’s only 6
months old
It’s happened before
It’s under warranty
Troubleshooted
previously

22. Help!

23. Agenda
An asset-powered experience
Building the experience
Extending the experience
Next steps

24. Agenda
An asset-powered experience
Building the experience
Extending the experience
Next steps

25. Agenda
An asset-powered experience
Extending the experience
Next steps
Building the experience

26. Agenda
An asset-powered experience
Next steps
Building the experience
Extending the experience

27. An asset-powered experience
Cut the back and forth and context switching

39. Help!

40. Building the experience
with Atlassian Connect and the Jira Cloud Assets API

41. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
STORE
CUSTOM FIELD
Asset Panel
PANELCONNECT APPSTORE

42. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
STORE
CUSTOM FIELD
Asset Panel
PANELCONNECT APPSTORE

43. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
STORE
CUSTOM FIELD
Asset Panel
PANELCONNECT APPSTORE

44. Syncing
assets
Configuring the
custom field
Enriching the
issue view
Using the Jira Cloud Assets API

45. Using the Jira Cloud Assets API
Syncing
assets
Configuring the
custom field
Enriching the
issue view

46. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
STORE
CUSTOM FIELD
Asset Panel
PANELCONNECT APPSTORE
SYNCING ASSETS

47. com.myasset.app
STORECONNECT APPSTORE
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
SYNCING ASSETS

48. com.myasset.app
STORECONNECT APPSTORE
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
SYNCING ASSETS

49. STORE

50. STORE
ASSET

51. STORE
ASSET
TYPE
LICENSELAPTOP DESKTOP

52. RELATIONSHIP #1: ASSET AND TYPE
STORE
ASSET
TYPE
LICENSELAPTOP DESKTOP

53. STORE
TYPE
ASSET
LICENSELAPTOP DESKTOP
RELATIONSHIP #1: ASSET AND TYPE

54. STORE
TYPE
ASSET
LICENSELAPTOP DESKTOP
RELATIONSHIP #1: ASSET AND TYPE

55. STORE
LICENSELAPTOP DESKTOP
TYPE
ASSET
RELATIONSHIP #1: ASSET AND TYPE

56. STORE
ASSET
ASSIGNEE
RELATIONSHIP #2: ASSET AND ASSIGNEE

57. STORE
ASSET
ASSIGNEE
RELATIONSHIP #2: ASSET AND ASSIGNEE

58. STORE
ASSET
ORIGIN
RELATIONSHIP #3: ASSET AND ORIGIN

59. STORE
ASSET
ORIGIN
RELATIONSHIP #3: ASSET AND ORIGIN

60. /rest/assetapi/asset/type
{
"origin": {
"appKey": "com.myasset.app",
"originId": "1"
},
"label": {
"value": "laptop"
}
}
PUT
Syncing
assets
Define by type
Identify the
origin
Create an asset type (e.g. laptop, software, server)
Assign to user

61. /rest/assetapi/asset/type
{
"origin": {
"appKey": "com.myasset.app",
"originId": "1"
},
"label": {
"value": "laptop"
}
}
PUT
Syncing
assets
Define by type
Create an asset type (e.g. laptop, software, server)
Assign to user
Identify the
origin

62. /rest/assetapi/asset/type
{
"origin": {
"appKey": "com.myasset.app",
"originId": "1"
},
"label": {
"value": "laptop"
}
}
PUT
Syncing
assets
Define by type
Create an asset type (e.g. laptop, software, server)
Assign to user
Identify the
origin

63. /rest/assetapi/asset
{
"type": {
"appKey": "com.myasset.app",
"originId": "1"
},
"origin": {…},
"label": {…},
"assignee": {…},
"fields": [{…}]
}
Syncing
assets
Define by type
Create an asset (e.g. MacBook Pro 15” 2016)
PUT
Assign to user
Identify the
origin

64. Syncing
assets
Define by type
Create an asset (e.g. MacBook Pro 15” 2016)
PUT
Assign to user
/rest/assetapi/asset
{
"type": {…}
"origin": {…},
"label": {…},
"assignee": {
"accountId": "27505:c73cd17-..-d754d02420be"
},
"fields": [{…}]
}
Identify the
origin

65. Syncing
assets
Define by type
Create an asset (e.g. MacBook Pro 15” 2016)
PUT
Assign to user
/rest/assetapi/asset
{
"type": {…}
"origin": {…},
"label": {…},
"assignee": {
"email": "test@example.com"
},
"fields": [{…}]
}
Identify the
origin

66. Syncing
assets
Define by type
Create an asset (e.g. MacBook Pro 15” 2016)
PUT /rest/assetapi/asset
{
"type": {…},
"origin": {
"appKey": "com.myasset.app",
"originId": "5-113-51143-2032"
},
"label": {
"value": "MacBook Pro 15" 2016"
}
"assignee": {…},
"fields": [{…}]
}
Identify the
origin
Assign to user

67. Using the Jira Cloud Assets API
Syncing
assets
Configuring the
custom field
Enriching the
issue view

68. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
STORE
CUSTOM FIELD
Asset Panel
PANELCONNECT APPSTORE
CONFIGURING THE CUSTOM FIELD

69. STORE
JIRA CLOUD ASSETS API
CUSTOM FIELD
CONFIGURING THE CUSTOM FIELD

70. STORE
JIRA CLOUD ASSETS API
CUSTOM FIELD
CONFIGURING THE CUSTOM FIELD

71. CONFIGURING THE CUSTOM FIELD

72. CONFIGURING THE CUSTOM FIELD

73. Assets custom field
NEW
Searches and links assets stored
using the Jira Cloud Assets API
CONFIGURING THE CUSTOM FIELD

74. Filter the asset custom field
to search by asset type
RELATIONSHIP #1: ASSET AND TYPE

81. Restrict or prioritise the
asset custom field search
based on assignee
RELATIONSHIP #2: ASSET AND ASSIGNEE

82. Asset Type Assignee
Macbook Pro 15 inch laptop Narul
Macbook Pro 15 inch laptop Leo
IntelliJ IDEA Ultimate software Tanya
Apple iMac Desktop desktop Gerard
Apple iMac Desktop desktop Narul
Asset Type Assignee
Macbook Pro 15 inch laptop Narul
Macbook Pro 15 inch laptop IT Loan
IntelliJ IDEA Ultimate software Narul
Apple iMac Desktop desktop Leo
Apple iMac Desktop desktop Narul

83. Asset Type Assignee
Macbook Pro 15 inch laptop Narul
Macbook Pro 15 inch laptop IT Loan
IntelliJ IDEA Ultimate software Narul
Apple iMac Desktop desktop Leo
Apple iMac Desktop desktop Narul

84. Store the origin
of a linked asset
in the asset custom field
RELATIONSHIP #3: ASSET AND ORIGIN

85. STORE
JIRA CLOUD ASSETS API
CUSTOM FIELD
CONFIGURING THE CUSTOM FIELD

86. STORE
JIRA CLOUD ASSETS API
CUSTOM FIELD
CONFIGURING THE CUSTOM FIELD
ISSUE

87. Using the Jira Cloud Assets API
Syncing
assets
Configuring the
custom field
Enriching the
issue view

88. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
STORE
CUSTOM FIELD
Asset Panel
PANELCONNECT APPSTORE
ENRICHING THE ISSUE VIEW

89. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
CUSTOM FIELD
Asset Panel
PANELCONNECT APP
ENRICHING THE ISSUE VIEW
STORE

90. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
CUSTOM FIELD
Asset Panel
PANELCONNECT APP
ENRICHING THE ISSUE VIEW
STORE

91. com.myasset.app
THIRD-PARTY APPLICATION JIRA CLOUD ASSETS API
CUSTOM FIELD
Asset Panel
PANELCONNECT APP
ENRICHING THE ISSUE VIEW
STORE

92. Render information about
an asset linked to a Jira issue
in the asset custom field panel
RELATIONSHIP #3: ASSET AND ORIGIN

95. …
"modules": {
"assetPanels": [{
"key": "my-asset-panel",
"url": “/asset-panel?appKey={asset.appKey}
&originId={asset.originId}
&fieldName={asset.field.name}”,
"name": {
"value": "My Asset Panel"
}
}]
}
…
Enriching the
issue view
Define your
panel URL
Link to related
issues
Add an assetPanels module to the connect descriptor
Render fields

96. …
"modules": {
"assetPanels": [{
"key": "my-asset-panel",
"url": “/asset-panel?appKey={asset.appKey}
&originId={asset.originId}
&fieldName={asset.field.name}”,
"name": {
"value": "My Asset Panel"
}
}]
}
…
Enriching the
issue view
Define your
panel URL
Add an assetPanels module to the connect descriptor
Link to related
issues
Render fields

97. …
"modules": {
"assetPanels": [{
"key": "my-asset-panel",
"url": “/asset-panel?appKey={asset.appKey}
&originId={asset.originId}
&fieldName={asset.field.name}”,
"name": {
"value": "My Asset Panel"
}
}]
}
…
Enriching the
issue view
Define your
panel URL
Add an assetPanels module to the connect descriptor
Link to related
issues
Render fields

98. Enriching the
issue view
Define your
panel URL
asset.originId 1
asset.appKey com.myasset.app
asset.field.name Devices
/issues/?jql=“Devices”=“com.myasset.app/1”
Render fields
Link to related
issues

99. Enriching the
issue view
Define your
panel URL
/issues/?jql=“{asset.field.name}”=
“{asset.appKey}/{asset.originId}”
asset.originId 1
asset.appKey com.myasset.app
asset.field.name Devices
Render fields
Link to related
issues

100. Enriching the
issue view
Define your
panel URL
Link to related
issues
Render fields

101. Enriching the
issue view
Define your
panel URL
Link to related
issues
Render fields

102. Enriching the
issue view
Define your
panel URL
Link to related
issues
Render fields

103. Extending the experience
Using the search API to bring assets everywhere you are

106. What’s next?
Check out the documentation and talk to us

107. HTTPS://DEVELOPER.ATLASSIAN.COM/CLOUD/ASSETSAPI

108. HTTPS://DEVELOPER.ATLASSIAN.COM/CLOUD/ASSETSAPI

109. HTTPS://DEVELOPER.ATLASSIAN.COM/CLOUD/ASSETSAPI

111. This [asset management app]
allows us to easily tie two of
our main systems together
MARKETPLACE REVIEW

112. Integration with Jira Service
Desk is perfect and is a high
added value.
MARKETPLACE REVIEW

113. We love this plugin and we
don’t even use it for traditional
asset management!
MARKETPLACE REVIEW

114. You’re ready!
Go and explore the possibilities of what
you can create with the Jira Cloud
Assets API

115. Thank you!
ANDREA OLRICH | DEVELOPER | ATLASSIAN | AOLRICH@ATLASSIAN.COM