Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Redirect
filename
locationhttps://docs.meta-inf.hu/glass-project-documentation/user-guides/administration-guide/3-set-up-confluence-export
Note

This guide suitable for

Status
titleserver
and
Status
colourBlue
titledata center
version only, Authentication on
Status
colourGreen
titlecloud
managed by the users.

First steps

To use the Confluence export option in Glass Documentation, there are settings that need to be configured in advance.

  • You are going to need a valid Confluence where the Glass Documentation will be exported.

  • Confluence Instance and Jira Instance need to be linked via Application Links settings.

  • The executer user / admin has to exist in both Jira and Confluence Applications.

  • Users need to have specific permissions in the destination Confluence Space.

As an admin, you can configure all the required settings in Jira and Confluence System Admin sites.

If you are new to Application Links or need a guiding hand in setup and configuration, check out the official Atlassian Documentation for Application Links.

List of Settings

...

Prerequisite

...

Create New

...

Update Existing

...

Application Links (linking Jira and Confluence)

...

Status
colourGreen
titleRequired

...

Status
colourGreen
titleRequired

...

View Permission in Confluence

...

Status
colourGreen
titleRequired

...

Status
colourGreen
titleRequired

...

Add Permission in Confluence

...

Status
colourGreen
titleRequired

...

Status
colourGreen
titleRequired

Troubleshooting

In case you have received an error message during your Glass Documentation export into Confluence, please read the possible causes down below. You might find what you are looking for.

Not Found error

...

Error message

...

What could it mean?

...

How to fix it?

...

Warning

Not Found

  • Page does not exist

  • Missing view permission for page

  • Missing view permission for space

...

The page title or page ID is incorrect in the ā€œLocation URLā€ you have added.

...

Check the destination Confluence pageā€™s URL again and correct the ā€œLocation URLā€.
ā€Location URLā€ should be one of these formats:

  • https://myconfluence.com/display/SPACE/pagetitle

  • http://myconfluence.com/pages/viewpage.action?pageId=yourpageID

...

You have no View Permission in the Confluence space and/or page you want to export into.

...

Grant View Permission to the executer user in the destination Confluence or contact your System Administrator to help you.

...

The Application Links between Jira and Confluence is either missing or not working correctly.

...

Make sure that the Jira and Confluence Application Links' statuses are

Status
colourGreen
titleCONNECTED
and the Confluence user has the right permissions.

Forbidden errors

...

Error message

...

What could it mean?

...

How to fix it?

...

Warning

Forbidden

  • Missing add permission for page

  • Missing add permission for space

...

It might mean that you have no Add Permission in the Confluence space and/or page you want to export into.

...

Grant Add Permission to the executer user in the destination Confluence or contact your System Administrator to help you.

...

Warning

Forbidden

  • Application link is missing

  • Application link is not working

  • Invalid Location URL

For more info, please read thisĀ guide, or contact the system administrator

...

The page title is missing in the ā€œLocation URLā€ you have added.

...

  • https://myconfluence.com/display/SPACE/pagetitle

  • http://myconfluence.com/pages/viewpage.action?pageId=yourpageID

...

The ā€œLocation URLā€ field was filled with invalid input - anything other than a valid Confluence page URL.

...

The Application Links between Jira and Confluence are either missing or not working correctly.

Make sure that the Jira and Confluence Application Links' statuses are

Status
colourGreen
titleCONNECTED
and the Confluence user has the right permissions.

...

Bad Request error

...

Error message

...

What could it mean?

...

How to fix it?

...

Warning

Bad Request

  • A page with this title already exists in this space

  • Invalid page title

...

The ā€œPage Titleā€ field was filled with invalid input - may be left empty or only filled with whitespaces.

...

Add valid input into ā€œPage Titleā€œ field before clicking on Export.

...

CREATE:
A Confluence page with the title you have added in ā€œPage Titleā€œ already exists within the same space you want to export into.

...

Add another title in ā€œPage Titleā€œ field before clicking on Export.

...

UPDATE:
A Confluence page, other than the page you want to update already exists with the added ā€œPage Titleā€œ within the same space you want to export into.