Cloudability SaaS Connect Confluence to Cloudability SaaS
What data is used by Cloudability SaaS from Confluence?
Confluence is integrated with Cloudability SaaS using the Confluence API.
For more information about the Confluence API, refer to https://developer.atlassian.com/cloud/confluence/rest/intro/ .
Cloudability SaaS uses user and expense data from the Confluence API. The data is analyzed and displayed as useful insights in Cloudability SaaS .
View the data fields that are used by Cloudability SaaS from ConfluenceCloudability SaaS uses six different API call to the Confluence API.
Get audit records
For more information about this call, refer to https://developer.atlassian.com/cloud/confluence/rest/api-group-audit/#api-wiki-rest-api-audit-get.
The following fields are used by Cloudability SaaS :
results
author ( type , displayName , operations , username , userKey
remoteAddress
creationDate
summary
description
category
sysAdmin
affectedObject ( name , objectType )
changedValues ( name , oldValue , newValue )
start
limit
size
_links
additionalProperties
Get content
For more information about this call, refer to https://developer.atlassian.com/cloud/confluence/rest/api-group-content/#api-wiki-rest-api-content-get.
The following fields are used by Cloudability SaaS :
results
id
Get content by ID
For more information about this call, refer to https://developer.atlassian.com/cloud/confluence/rest/api-group-content/#api-wiki-rest-api-content-id-get.
The following fields are used by Cloudability SaaS :
id
type
status
history
createdBy (type, accountId, publicName)
createdDate
Get content comments by ID
For more information about this call, refer to https://developer.atlassian.com/cloud/confluence/rest/api-group-content-comments/#api-wiki-rest-api-content-id-child-comment-get .
The following fields are used by Cloudability SaaS :
results
id
Search users
This API call is used to check authorization. No data is retrieved using this API call.
For more information about this call, refer to https://developer.atlassian.com/cloud/confluence/rest/api-group-users/#api-wiki-rest-api-user-current-get
Get content comments
For more information about this call, refer to https://developer.atlassian.com/cloud/confluence/rest/api-group-search/#api-wiki-rest-api-search-user-get .
The following fields are used by Cloudability SaaS :
results
user ( type , accountId , accountType , email , publicName , profilePicture ( path , width , height , isDefault ), displayName , _expandable ( operations , details , personalSpace ), _links (additionalProperties)
title
excerpt
url
entityType
start
limit
size
_links
additionalProperties
Calculated fields
Last login date
The last login date is based on the created date of the most recent audit record for a user (within a set timeframe, usually 30 days).
Activity status
The last login date is used to determine when the user was last active; see Last login date .
If there is no last login date, then the user is marked as inactive.
Purchased license count
This value is set manually.
Used license count
The used license count is based on the number of users found by Cloudability SaaS .
Connect to Confluence
Before you start
Before you can integrate Confluence with Cloudability SaaS , you must have the following:
A Confluence account subscription at Standard level as a minimum.
For more information refer to https://www.atlassian.com/software/confluence/pricing
The Confluence account must have the Confluence Administrator permission level.
For more information, refer to https://confluence.atlassian.com/doc/global-permissions-overview-138709.html
An API token generated from your Atlassian account.
For more information, refer to https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/
Steps to connect
Connect Confluence to Cloudability SaaS .
Find the Confluence tile and select Connect .
Enter the following information:
Organization Name : The name of your organization in Confluence. Login to your Confluence account and view the address bar in your browser. Your organization name is used as the subdomain. For example, if the full URL is https://cloudability-saas.atlassian.net , enter only the subdomain cloudability-saas .
Email : The email associated with your Confluence account.
API Token : Enter an API token generated from your Confluence account.
Select Continue .
Confirm success
Use the wording below as a guide when describing a single connector. For example, a single application connected using an API connection.
Confirm that Confluence has been integrated with Cloudability SaaS correctly.
Confirm that the Cloudability SaaS Dashboard displays the Confluence tile under Your Connected Applications .
Select the Confluence tile and confirm that data from Confluence can be viewed in the application details page.
Compare the data in Confluence to data in Cloudability SaaS to confirm success.
Troubleshooting
Troubleshooting questions can be listed here using the drop-down. Copy the following Madcap dropdown and replace the text for each common issue.
Common Issue short descriptionCommon issue longer description (if required)
Issue solution or workaround