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

2.
Help!

3.
Help!

4.
Help!

5.
Help!
It’s my laptop

6.
Help!
It’s my laptop

7.
Help!
It’s my laptop

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

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

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

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

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

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

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

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

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

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

18.
Help!

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

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

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

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

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

24.
Help!

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

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

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

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

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

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

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

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

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

34.
STORE

35.
STORE
ASSET

36.
STORE
ASSET
TYPE
LICENSELAPTOP DESKTOP

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

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

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

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

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

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

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

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

45.
/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

46.
/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

47.
/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

48.
/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

49.
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

50.
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

51.
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

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

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

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

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

56.
CONFIGURING THE CUSTOM FIELD

57.
CONFIGURING THE CUSTOM FIELD

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

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

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

61.
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

62.
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

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

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

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

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

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

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

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

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

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

72.
…
"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

73.
…
"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

74.
…
"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

75.
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

76.
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

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

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

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

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

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

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

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

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

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

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

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

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

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