youngmon/atlassian-qna huggingface dataset:
Single Sign-on with Confluence
Asked by Kay Jiang:

Hi there,

Our company is trialing Confluence as a possible new tool for technical documentation, and we have a question regarding SSO. We want the online documentation provided to our licensed clients only, which means that if they are logged into our product/software, they have direct access to the documentation. Otherwise they need to provide a valid login.

Crowd and some add-ons were mentioned in the Atlassian support site, but I'm bit confused regarding what kind of SSO mechanism we should use in our scenario. I'm wondering if anyone can give us some advice or direction that I can look into.

Thank you very much,

Kay


Answers:
author: Gregory Van Den Ham
body: Do you already have a provider, like AzureAD or Okta, to link SSO back to?

We use: <https://marketplace.atlassian.com/plugins/com.resolution.atlasplugins.samlsso.Confluence/server/overview>

This does all the basics. You do need, ADFS, or AzureAD or Okta, or another provider setup in your environment to link back to.


Tags: confluence-server

sso
Status Macro not working in the new Confluence
Asked by danielle-branquinho:

Hi All,

The Status macro is no longer working after the Confluence re-skin. When I click on exisiting status I can change the word in it, but clicking on edit nothing happens. Also, the option to select colour is no longer there either.

Also, selecting this macro from the menu doesn't do anything either.

Is anyone having a similar issue?


Answers:
author: Shannon S
body: Hi Danielle,

You're currently on Cloud Confluence, correct? I've tested this macro in my own Cloud instance with the New Look turned on, but I'm not able to replicate the problem.

Can you confirm which browser and version you're able to replicate this in? Does it only occur with old Status Macros or are you also not able to create and edit new ones?

Kind Regards,

Shannon

comments: author: danielle-branquinho
body: I am using Chrome - Version 60.0.3112.113.

And this issue happens when I try to update an existing one, add a new one to a page or add a new one to a new page. Clicking on Status macro does nothing (it is like I haven't clicked on it). And I have attached a screenshot of what I see when I click on an existing one (as mentioned, clicking on Edit also does nothing)![Status_Macro_Issue.png](https://community.atlassian.com/t5/image/serverpage/image-id/6130iDA9BD99872604544/image-size/large?v=v2&px=999 "Status_Macro_Issue.png")


author: Shannon S
body: Hi Danielle,

Thank you! I had a look at your instance and I was able to replicate it there, even on the most recent version of Chrome. It does, however, seem to be affected by something specific to your instance.

I noticed that you have a support ticket with our Cloud team and it's already being investigated for you there. I will allow that engineer to continue to investigate on that ticket, and then we'll update both that ticket and this question with the resolution as soon as we have it.

Thank you for your patience!

Kind Regards,  
Shannon
How can I use the spaces list macro on dashboard?
Asked by Nico Lange:

We update Confluence from 5.3 to 6.3 and we got a problem with the spaces list macro.   
At version 5.3 you can use the macro on dashboard (<https://confluence.atlassian.com/conf56/viewing-all-confluence-spaces-658737007.html#ViewingAllConfluenceSpaces-Viewingspacesonthedashboard>) but with version 6.3 there is no documentation about it.  
I try to integrate it into global layout but I have no idea how to...  
Please help me :)

<br />

Sincerly,

Nico


Answers:
author: Shannon S
body: Hi Nico,

This is part of the New Confluence dashboard [that we released starting in 5.9](https://confluence.atlassian.com/doc/confluence-5-9-upgrade-notes-788955921.html#Confluence5.9UpgradeNotes-Dashboardchanges).

Specifically:

[Favorite spaces is now My spaces](https://confluence.atlassian.com/doc/confluence-5-9-upgrade-notes-788955921.html#Confluence5.9UpgradeNotes-FavoritespacesisnowMyspaces)
> We've renamed the existing **Favorite spaces** feature to **My spaces**, and dropped it on the new dashboard sidebar where it's super easy to get to. This is just a name change, the behavior of this feature hasn't changed. You may still see Favorite spaces listed here and there, for example in some macro parameters, but don't worry, they're one and the same.

If you have a look at your instance, you'll see the My Spaces menu item in the left sidebar.

Let us know if you have any questions about that.

Kind Regards,  
Shannon
How can I rollback changes to a broken Overview page when the menu isn't showing?
Asked by PO Assima Group:

I added a Content Report Table widget to my Overview page, but I added a label with a special character "7.17". It wasn't until I tried to label a page with this tag that I realised the "." was not allowed.

When I went back to check my Overview page the main frame just keeps loading (I'm sure its to do with this widget), however the menu "..." doesn't load so I can't see the page history to roll back my change.

Help!


Answers:
author: Shannon S
body: Hi Emma,

Can you access the History through a direct link, perhaps?

http://\<confluence URL\>/pages/viewpreviousversions.action?pageId=######

If you don't know the page ID you can find the page ID if you're able to rollover the Edit button, for example.

Kind Regards,  
Shannon

comments: author: PO Assima Group
body: Thanks Shannon. In the end my colleague reverted to the old look, then was able to delete my changes before returning to the new look.


author: Shannon S
body: Hi Emma,

Thank you for letting me know that. Glad you were able to revert the changes.

Take care and have a pleasant weekend!

Kind Regards,  
Shannon


Tags: page-history
Link to external mp4 file using Widget Connector
Asked by Tom Wolff (Admin):

I have a file on another of our websites that is 59 MB so is too big to embed on a Confluence 5.10. Therefore, I can't use the Multimedia add-on. The obvious answer is to use the Widget Connector macro. However, none of the documentation discusses an mp4 file, and linking to the file doesn't work. Do I have any options for embedding this large video on our Confluence page?

Many thanks in advance.

Tom


Answers:
author: Shannon S
body: Hi Tom,

You could try using the [HTML Macro](https://confluence.atlassian.com/doc/html-macro-38273085.html) and embed your video using this. I've seen several users successfully display their videos this way. You may just need to convert the video to another format.

Have a look at [this community post](https://community.atlassian.com/t5/Confluence-questions/Embedded-mp4-does-not-work-in-any-browser/qaq-p/371772) from the past where a similar topic was discussed.

Kind Regards,  
Shannon


Tags: widget-connector
Generically associate pages
Asked by RedactedProfile:

Good day,

Much like in Jira where one can specify a "Relates To" association with another ticket from anywhere in the database, I was wondering if Confluence itself (or a plugin) can do this with pages?

As of right now I'm not worried about cross-space functionality, just interspace would be fine.

What I'm trying to accomplish here is making a bit of dynamic documentation based on associations. For example, creating a Page for a particular website's profile, and in the right sidebar is a flat list of associated pages regarding the technology that runs the site, and another list of associated pages in the same right sidebar that lists the microservices it uses. And when you click on a profile for one of the Microservices on that page, would go to the Microservices profile page that in its right column lists all the websites it's associated with.

But all I (ideally) had to do on either page is set up a "Relates To" association between them, and the "List" widget would be like "Associated Pages : Filtered by Label"

Disclosure: The way I have it set up right now is a little less than ideal but mostly gets the point across. I downloaded a plugin from the marketplace that lets me put in a widget that gives me a flat list of pages linking TO the page filtered by label. The problem here is it's a one way linking. I go to, say, the websites profile page and in the "Microservices" column, manually create a "Link" to the Microservice page. Now when clicking on that Microservice page, it shows the website that linked to it.

So it's about 4/5ths of the way there in terms of what I'm looking for and will work for the time being. But I'd rather not have to create an **in-page** link at all, and I'd like it so that whether I'm looking at the Microservice or the Website profile pages, I can edit that association. Right now the way it is, I have to remember which page I made the link on originally, and edit the entry there.

Anyone seen a plugin that does this? Or knows how to do it by just messing with Confluence itself?

We're on Confluence 5.10.7.

Thank you!


Answers:
author: AnnWorley
body: Your use case is interesting. It sounds like you are already using labels so I was wondering if this macro would help as a List widget: [Related Labels Macro](https://confluence.atlassian.com/doc/related-labels-macro-145560.html)
Installing Confluence 6.* on 32-bit system
Asked by Andy To:

Hi, I know there is no installer for 32-bit systems for Confluence versions 6 and up, however I downloaded the standalone .zip for 6.0.2 and extracted it on a 32-bit system. When I try to install it, it complains that tomcat8.exe is not compatible with the version of Windows I have.

Seems like the included tomcat8.exe is a 64-bit executable instead of 32? How can I install Confluence 6.\* on a 32-bit system?

Thanks


Answers:
author: Gregory Van Den Ham
body: Out of curiousity, can we ask why you would want to go onto a 32bit system?

comments: author: Andy To
body: It was an older installation that was done years ago and I'm trying to upgrade to a newer version. For some reason it was originally installed on a 32-bit system.


author: Nic Brough -Adaptavist-
body: You can't. Confluence 6 dropped all support for 32 bit installations.

In theory, you could try to install it and then unpick all the contents and place them into a 32 bit Tomcat installation, but I seem to remember that won't work as even they have been compiled for 64 bits.

I suspect your only chance might be to download the source and compile it for a 32 bit machine. I don't know if there is anything in there that would stop you, but I do suspect you'll need to make quite a few changes before it works.

comments: author: Andy To
body: Strange, according to this: <https://confluence.atlassian.com/doc/confluence-6-0-upgrade-notes-844235311.html#Confluence6.0UpgradeNotes-32-bitinstallersnotavailable>

it says "If you're running Confluence on a 32-bit operating system, you can still upgrade, using the archive file method".

Not a big deal though, we can stick with 5.10.8.


author: Nic Brough -Adaptavist-
body: Ah, yes, I've asked for that to be updated.
Confluence E-Mail Notification Soy Template
Asked by Marcel Gattinger:

Hello,  
I tried to edit the soy template "mention-email-notification-2.0.0.soy" in the Confluence web application folder /confluence/WEB-INF/atlassian-bundled-plugins/confluence-mentions-plugin-1.9.23.jar  
so that no more content in the notification e-mail is sent.

It would be best if you only received the sentence "you were mentioned in a comment" by e-mail.  
Unfortunately, every time I edit the Soy Template, I get the error:  
SoyException: Unable to compile Soy templates at: com.atlassian.confluence.plugins.confluence-mentions-plugin:mention-notification-template-body

Anyone know how to edit the template properly?

Thanks


Answers:
author: Sergio _
body: I need the same. but I have the same error   
SoyException: Unable to compile Soy templates at: com.atlassian.confluence.plugins.confluence-mentions-plugin:mention-notification-template-body  

When I'm trying to get the space name, in all ways, I receive that error.


author: Anne Calantog
body: Hi [@Marcel Gattinger](/t5/user/viewprofilepage/user-id/865439),

You might want to try [this](https://confluence.atlassian.com/conf58/customising-the-email-templates-771892736.html). Also, for developer related topic, please post it [here](https://community.developer.atlassian.com/)

Cheers,

Anne

comments: author: Marcel Gattinger
body: Hi [@Anne Calantog](/t5/user/viewprofilepage/user-id/1130311),  

Thanks.  
I have adapted the templates according to the instruction. But I do not find out how to customize it, so the notifications work fine.  
I've also posted the question in the developer community  

Regards   

Marcel  

<br />


Tags: app

email

notification

template
Can anybody restore a Confluence build from a backup without entities.xml or exportDescriptor files?
Asked by Sonny Strandlund:

Oh if anybody can help me I'd be so grateful. I've had a local(server) Confleunce build now for a few years.

August 11th, we did an upgrade to the latest verison, 6.3.3 I believe. I went through all the backup steps, as per warned.

That upgrade broke, and I could never get it back up and running correctly.

I've since uninstalled Confluence and reinstalled, in hopes that I could do a new build from the restore point. No such luck.

The 2 files required to restor from are not contained in my backup and havent been in backups for quiet a while.

Anybody have any tips or a solution to get my team back up without starting from scratch?

Thanks so much

Sonny


Answers:
author: Steven F Behnke
body: You have database backups?

comments: author: Sonny Strandlund
body: I do yes.


author: Steven F Behnke
body: Forget the XML backup then. I'll follow along this guide: <https://confluence.atlassian.com/conf51/restoring-data-from-other-backups-336169732.html>

1. Unpack the Confluence install directory (via a ZIP or TAR.GZ, NOT THE BIN/EXE)
2. Restore the home directory (this stores Plugins and Attachments)
3. Point the Confluence install directory to your Restored Confluence Home directory (\<CONFLUENCE_INSTALL\>/confluence-init.properties)
4. Point the Confluence home directory to a copy of your database (\<CONFLUENCE_HOME\>/confluence.cfg.xml)
5. Start Confluence


author: AnnWorley
body: Sonny, on number 3, in case you cannot find the path to confluence-init.properties, please try the path: \<confluence_install\>/confluence/WEB-INF/classes


author: Sonny Strandlund
body: Thank you both so much. I was able to get a stable Version 5.9.4 up and running which was awesome.

Has to make some adjustments in the database for build differences but that wasn't a problem.

However.... I decided to try the upgrade to 6.4. BAD IDEA!!!!!

I can't get any pages to run other than the main dashboard. Looks like im heading back to Step 1 again.


author: Sonny Strandlund
body: It seems that Tomcat running Confluence is acting up. Spiking CPU resources etc.


Tags: restore

upgrade
Simple Custom Velocity Macros in Confluence Cloud
Asked by Elmar Schwarz:

Hello:

I would have the need to offer some very simple custom velocity macros in the Confluence Cloud. We are really talking about some very simple things. I have understood that this feature is not accessible in the cloud solution.

Is there a way to achieve this anyway - or is it just not possible?

Thanks in advance.

Elmar


Answers:
author: Shannon S
body: Hi Elmar,

As you suspected, [User Macros](https://confluence.atlassian.com/doc/writing-user-macros-4485.html) are a [Restricted Function](https://confluence.atlassian.com/confcloud/restricted-functions-in-confluence-cloud-734070955.html) in Confluence Cloud and thus not possible.

If you can let us know what exactly you need Confluence to do we could help you perhaps find a 3rd party add-on that can help with this, or let you know if a feature request exists for that functionality.

Kind Regards,  
Shannon

comments: author: Elmar Schwarz
body: Hello Shannon,

Thanks you very much for your answer.

What we would need is a macro which lists all incoming links based on a label on the page; e.g. the pages in the space have the label "Label-1, "Label-2", "Label-3". These pages are referring to a certain page. On this very page I would like to automatically generate a list of links like:

Label-1:

* ++Page 1++
* ++Page 3++

Label-2:

* ++Page 2++
* ++Page 6++

Label-3:

* ++Page 5++

... with links to the pages.

Regards,

Elmar


author: Shannon S
body: Hi Elmar,

Would this not be the same functionality as the [Content by Label macro](https://confluence.atlassian.com/doc/content-by-label-macro-145566.html)? With that macro, you can list a specific label and it shows all the content that uses that label.

If this isn't the functionality you are requiring, can you let us know how it would differ?

Kind Regards,  
Shannon


author: Elmar Schwarz
body: Hi Shannon,

It looks like a good starting point; but it does not allow to filter the displayed pages by content, which is referring to the current page - does it? This is the key requirement. I want to see at a glance which pages of certain types refer to the current page.

If you would add this filter, we would be done.

Thanks and Regards,  
Elmar


author: Shannon S
body: Elmar,

So let me make sure I have this clearly - you wish to display all pages that have a certain label AND mention a specific page? Is this correct?

There's not a way to do that specifically with the available filters, so I went ahead and created a feature request for it:

* [CONFCLOUD-57422](https://jira.atlassian.com/browse/CONFCLOUD-57422)

Have a look and if I'm missing anything there please do let me know.

Kind Regards,  
Shannon


author: Elmar Schwarz
body: Hello Shannon,

Yes this is correct. A nice extension would be if I had an option to include pages which refer to one ot the children of the current page. But that would be rather a nice to have.

Regards,

Elmar


author: Shannon S
body: Thank you, Elmar. I've updated the request to reflect that.

Please make sure to vote and watch the request and update it with your business case. :)

Kind Regards,  
Shannon
New Confluence design: Edit/delete page labels
Asked by Sebastian Jopen:

I miss the functionality to edit or delete labels on a page. Where is it gone?


Answers:
author: Bruno Miretti
body: Hi, this functionality has been removed with the new UI in the Overview page, with some others....

You can vote for the following features requests to ask Atlassian to reintroduce the functionalities they removed with the new 'shiny' UI (it's hard to understand their way of thinking, I know):

[CONFCLOUD-56967](https://jira.atlassian.com/browse/CONFCLOUD-56967)

[CONFCLOUD-57258](https://jira.atlassian.com/browse/CONFCLOUD-57258)

Hope this helps :)

comments: author: Sebastian Jopen
body: That was exaclty the point, I missed it on the overview pages..


author: AnnWorley
body: On my Cloud test instance I can edit labels on the page in view mode at the bottom, just above comments:![Screen Shot 2017-09-11 at 10.53.35 AM.png](https://community.atlassian.com/t5/image/serverpage/image-id/6014i0AEE39CC954C740C/image-size/large?v=v2&px=999 "Screen Shot 2017-09-11 at 10.53.35 AM.png")

In edit mode the label edit button is next to the title:

![Screen Shot 2017-09-11 at 10.54.59 AM.png](https://community.atlassian.com/t5/image/serverpage/image-id/6011i1EE2FEC299F51197/image-size/large?v=v2&px=999 "Screen Shot 2017-09-11 at 10.54.59 AM.png")

![Screen Shot 2017-09-11 at 10.54.59 AM.png](https://community.atlassian.com/t5/image/serverpage/image-id/6011i1EE2FEC299F51197/image-size/large?v=v2&px=999 "Screen Shot 2017-09-11 at 10.54.59 AM.png")

comments: author: Sebastian Jopen
body: Thanks!
How can I fix my broken PDF?
Asked by ando:

I have a pdf file generatted with Confluence with Chrome in July 2017 which was fine, but by following the same process, the same file is now collapsed.  
The PDF creation process is:  
1, view the confluence page  
2, Click 'Export to PDF' and download the file,   
or Press 'ctrl + p' key and select pdf and save.

Issues are :  
1, The link in the 'table of contents' is not working.  
2, "page?break?before?always" is not working.

Has anybody face the same issue?  
I need help how to solve the issue.


Answers:
author: Bruno Miretti
body: Hi,

Do you mean you use a PDF utility to print files ? CTRL-P is a functionality of the browser, the usual way to export PDF files with Confluence is to click on the "..." menu then "Export to PDF". I tried on a page containing the "Table of contents" macro and it works fine. The only issue I have at the moment is related to the "child page" macro when exporting a space: in this case the links point to the cloud and not to the PDF document.

FYI, this problem is described here: [CONFCLOUD-56581](https://jira.atlassian.com/browse/CONFCLOUD-56581)

comments: author: ando
body: Thank you very much for your reply.

This time, I used the "Export to PDF" function of Confluence, but the pdf is still broken. (This time I can see "Error rendering macro 'toc' : null" error on the pdf.)

\*IE,Chrome, Chrome-incognito, the result is the same.

![cuji4.png](https://community.atlassian.com/t5/image/serverpage/image-id/6078i25E986BCAE0D735E/image-size/large?v=v2&px=999 "cuji4.png")

By the way, Ctrl+P with Chrome worked fine in July for the same Confluence page.


author: Bruno Miretti
body: Hello,

I'd recommend you open a ticket at Confluence support. They will need to have access to your page and PDF stylesheet to help you to solve this issue.


author: Yuki Okamoto
body: I'm support engineer in Atlassian and the original problem has already been solved in the support ticket.

The root cause was that the appropriate font file hadn't been installed in the cloud instance. (cf. <https://ja.confluence.atlassian.com/confkb/how-to-export-pdf-from-confluence-cloud-in-another-language-779166013.html>)

Installing the font file solved the macro break.


author: ando
body: Hi Yuki-san,

Thank you very much, this is solved.

:)


author: Yuki Okamoto
body: Thanks for your reply, Ando-san.

??????????????????????????????????????????????????????

[- ??????????????????](https://community.atlassian.com/t5/Agile-articles/%E6%97%A5%E6%9C%AC%E8%AA%9E%E3%81%A7%E3%82%B3%E3%83%9F%E3%83%A5%E3%83%8B%E3%83%86%E3%82%A3%E3%82%B5%E3%82%A4%E3%83%88%E3%82%92%E5%88%A9%E7%94%A8%E3%81%99%E3%82%8B/ba-p/606535)

????????????????


Tags: language-ja

pdf