youngmon/atlassian-qna huggingface dataset:
How do you search by labels specifically?
Asked by D Pozega:

*This question is in reference to Atlassian Documentation: [Confluence Search Syntax](https://confluence.atlassian.com/pages/viewpage.action?pageId=158720)*

I have started labelling my docs...but I can't find a way to search the labels specifically. I don't understand the explanation on this page.


Answers:
author: Daniel D
body: The only thing that works (in JIRA, not sure about Confluence) is:

In my example I have label fields which are named: "VERSION CODES 1","VERSION CODES 2","VERSION CODES 3"

like this:Screen Shot 2016-03-07 at 6.53.26 PM.pngor this: Screen Shot 2016-03-07 at 6.59.18 PM.png

To find the label "TBD" in these fields this query works:

"VERSION CODES 1" = TBD OR "VERSION CODES 2" = TBD OR "VERSION CODES 3" = TBD

I am trying to do a similar thing in JIRA because, like yours, my searches do not look in labels only in text fields.

My own Atlasssian question is here: [How to search for labels in any custom field](https://answers.atlassian.com/questions/37057215/answers/37535668 "How to search for labels in any custom field")

I think the CQL and JQL are similar.

Hope this helps.  
[](https://community.atlassian.com/t5/Confluence-questions/How-do-you-search-by-labels-specifically/qaq-p/18008?attachment-id=279){#link_11874105a67542}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/2970/1/Screen%20Shot%202016-03-07%20at%206.59.18%20PM.png){#display_11874105a67542_0}  
[](https://community.atlassian.com/t5/Confluence-questions/How-do-you-search-by-labels-specifically/qaq-p/18008?attachment-id=280){#link_11874105a67542_0}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/2970/2/Screen%20Shot%202016-03-07%20at%206.53.26%20PM.png){#display_11874105a67542_2}


author: Milo Test
body: You can use labelText**:**

**labelText**:search_string\*****

**NOTE:** the asterisk at the end sometimes improves results.


Tags: label

search
Where is this button?: "To search for pages and posts with a particular label or labels, use the Add a filter option at the bottom left of the page and choose Label."
Asked by D Pozega:

*This question is in reference to Atlassian Documentation: [Confluence Search Syntax](https://confluence.atlassian.com/pages/viewpage.action?pageId=158720)*

I can find no such button.


Answers:
author: Cathy Rivard
body: Just in case you're not sure where to look, the documentation is referring to the "Add a filter" link that appears at the bottom of the left menu on the Search Results page. This is an example from my instance (Cloud version):

Search - Label Filter Added.jpg

When you click "Add a filter", select "Label" from the list:

Search - Add a Filter.jpg

You can also refer to the main Search article: <https://confluence.atlassian.com/doc/search-139528.html>

[](https://community.atlassian.com/t5/Confluence-questions/Where-is-this-button-quot-To-search-for-pages-and-posts-with-a/qaq-p/391517?attachment-id=11089){#link_1187411aaa6d1b}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/66242/1/Search%20-%20Label%20Filter%20Added.jpg){#display_1187411aaa6d1b_0}  
[](https://community.atlassian.com/t5/Confluence-questions/Where-is-this-button-quot-To-search-for-pages-and-posts-with-a/qaq-p/391517?attachment-id=11090){#link_1187411aaa6d1b_0}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/66242/2/Search%20-%20Add%20a%20Filter.jpg){#display_1187411aaa6d1b_2}


author: Milo Test
body: This is certainly in Confluence Cloud, and if it isn't in Confluence Server 5.9, then it will be in a future version.

comments: author: D Pozega
body: This appears to be it. The workaround is using "labelTag:*yourlabel*" in the search box.


author: Cathy Rivard
body: I tried that syntax but it didn't work for me. I used "label**Text** :*yourlabel*" instead.

This article has all the fields you can search against this way: [Confluence Search Fields](https://confluence.atlassian.com/doc/confluence-search-fields-161188.html)

The filter I mentioned before is applied against search results. It's handy too!


Tags: label

search
How can I easily migrate Confluence Data to another Confluence System (export/import) ?
Asked by Ralf Marg:

Want to move my Confluence data from customer system to my own. Could not find an easy way to do it like exporting XML and importing the same into the other system.

How does this work ?


Answers:
author: Boris Georgiev [Appfire]
body: Do a XML backup of Confluence and then import it into your instance as described in the docs <https://confluence.atlassian.com/doc/site-backup-and-restore-163578.html>

<https://confluence.atlassian.com/doc/manually-backing-up-the-site-152405.html>

If you've got some existing data into your Confluence instance than this is not so simple especially if there are a lot of spaces.

1. Create separate backup for each confluence space on the **customer**instance
2. Import each space backup into **your**instance

The problems you might face are :

1. Broken links - if you have web links that point to confluence pages they need to be manually fixed or you need to do a complex db update
2. Links to JIRA issues (if Confluence is linked with JIRA)
3. Space shortcuts will not be migrated
4. Custom space avatars - the space avatars are not migrated
5. User Management - if the user base is different you might have incorrect page history and user mentions inside the restored pages
6. Plugin data - if you have a plugin like Team Calendars - the data will not be migrated and you need to move it via SQL, but this is really complex if you have never done it before
7. Others...


Tags: confluence-administration
Does connecting Confluence to JIRA for user management allow for SSO?
Asked by Randall Fisher:

If I point my Confluence user management at JIRA as described here:

<https://confluence.atlassian.com/doc/connecting-to-crowd-or-jira-for-user-management-229838465.html>

Will my users still be required to login in twice (to both JIRA and Confluence)?

OR

Will a logging into one, be sufficient to access both?


Answers:
author: Ezra Rezky
body: Hi Randall!  

Your users will still be required to login twice, because you haven't enable SSO for both JIRA and Confluence yet. To be able to enable SSO with Crowd in JIRA and Confluence, you can checkout these links:  

Confluence: <https://confluence.atlassian.com/display/CROWD/Integrating+Crowd+with+Atlassian+Confluence>  

JIRA: <https://confluence.atlassian.com/display/CROWD/Integrating+Crowd+with+Atlassian+JIRA>  

Hope this answer helps, and I wish you a good day!  

Warm Cheers,  
Ezra A.  

comments: author: Randall Fisher
body: Ezra, Thanks for the clarification! This was not the magic pill I thought it might be.

I can't quite justify the cost of CROWD, so I suppose we'll continue with the double login.


author: Ezra Rezky
body: No problem, mate ![laugh](/html/@BEA1CC333F4D830F5303329D7DC07DE4/images/emoticons/laugh.png "laugh")  

You can start to consider using CROWD if you want to start managing users in more instances (e.g, several JIRAs or Confluences, or even adding other application like Stash, FishEye, Crucible, etc), or if you start having many sources of users Directory (e.g LDAP, Active Directory, OpenID, Google Apps, etc)


author: Ezra Rezky
body: By the way, Randall, if this solution helps in the slightest, do you mind accepting the answer so other users with similar situation can find this? ![laugh](/html/@BEA1CC333F4D830F5303329D7DC07DE4/images/emoticons/laugh.png "laugh") Thank you!


author: Randall Fisher
body: Sorry, thought I already did.


Tags: confluence-administration

jira
Attachment macro
Asked by Hsein Han Kew:

The attachment macro is very useful and extensively used by my team here. In addition, we also use the buttons "View", "Edit in Office" etc.

Unfortunately, these buttons appear at the bottom of the version history. When we have many versions such as 50 or 100, it will be a hassle to scroll down just to find these buttons.

Is there any way that I can modify the macro so that these button appear at the top?

Or does anyone have another idea?


Answers:
author: Cathy Rivard
body: Just wondering if you need to keep that many versions of an attachment? It's possible to delete specific versions (without deleting the attachment entirely) on the Attachments view (of the page where the actual file is attached). If you deleted unneeded versions the buttons would be easier to reach and you'd free up disk space too.
Is it possible to query with CQL by page property value?
Asked by Shauna Winters:

*This question is in reference to Atlassian Documentation: [Confluence Search Syntax](https://confluence.atlassian.com/pages/viewpage.action?pageId=158720)*

Is it possible to query with CQL by page property value? We'd like to be able to use page properties as metadata for the purpose of creating some fairly robust systems documentation. It would be nice to be able to leverage CQL against page properties so we can quickly narrow down affected systems by integration point during migrations and upgrades.


Answers:
author: Steven F Behnke
body: You can, but you need to include an indexing module in an Atlassian Connect add-on. Please read on -- <https://developer.atlassian.com/blog/2015/02/confluence-5-7-apis/>
> ... with the combination of CQL and content property indexing, add-on developers can query the properties they've added to content ...


Tags: cloud

confluence-cloud

cql

search
how to highlight JSON?
Asked by Denis Peplin:

*This question is in reference to Atlassian Documentation: [Code Block Macro](https://confluence.atlassian.com/pages/viewpage.action?pageId=139390)*

Ask your question here...


Answers:
author: Stephen Deutsch
body: Your best bet is to choose "Javascript" from the syntax highlighting option. Otherwise you can install a custom SyntaxHighlighter brush like this one: <http://donovanbrown.com/post/2016/01/10/Json-SyntaxHighLigther>

comments: author: Robert Galovic
body: This doesn't work for SyntaxHighlighter in the confluence code makro.

(Atlassian should improve the documentation and stop using outdated extensions like syntaxhighlighter)


author: Robert Galovic
body: Use this brush for JSON, save it as a file and add it via confluence code macro. Have fun ;-)

```
/**
 *  Author: Robert Galovic, AVINOC - www.avinoc.com
 *  License: GPL-2 | GPL-3
 *  JSON brush for confluence syntaxhighlighter
 */
SyntaxHighlighter.brushes.JSON = function()
{
    var key_bool = 'true false null NULL';
    this.regexList = [
        { regex: new RegExp(this.getKeywords(key_bool), 'gm'), css: 'value' },
        { regex: /[^\D](\d?\.?\d+)/gm, css: 'constants' },
        { regex: /((\"[\w]+\S*[^\\]\"))(?=[\:]|\s\:)/gm, css: 'variable' },
        { regex: SyntaxHighlighter.regexLib.doubleQuotedString, css: 'string' },
        { regex: /((\'[\w]+\S*[^\\]\'))(?=[\:]|\s\:)/gm, css: 'comments' },
        { regex: SyntaxHighlighter.regexLib.singleQuotedString, css: 'comments' },
    ];
};
SyntaxHighlighter.brushes.JSON.prototype   = new SyntaxHighlighter.Highlighter();
SyntaxHighlighter.brushes.JSON.aliases = ['json', 'Json', 'JSON'];
```

(If you like, you can customize it by changing the css definitions. Single quoted JSON entries wont comply to the standard, so I used "comments" css on them to mark them for being able later on to correct them easily)

comments: author: Open Europa Wikis Team
body: Thanks a lot [@Robert Galovic](/t5/user/viewprofilepage/user-id/2786002) this is very useful.

Can't believe this is still not a native feature of confluence.

One improvement, change

```
{ regex: /[^\D](\d?\.?\d+)/gm, css: 'constants' },
```

for

```
{ regex: /-?(0|[1-9]\d*)(\.\d+)?([eE][+-]?\d+)?/gm, css: 'constants' },
```

This will allow to highlight numbers followed by a comma.

Best regards.

Alexandre - DIGIT WEBTOOLS


author: Kyle_Corsi
body: This worked but only when I preview a page. If I try to access a saved page normally I get an alert dialog "*Can't find brush* for: json"


author: Robert Galovic
body: I don't know what you did or how your rights are set, but my suggested solution works not only in preview mode (that would make no sense to me at all, right?).


author: weweave UG
body: Even though this question is quite old, for Confluence Cloud you can give our app Prism Syntax Highlighter for Confluence (see <https://marketplace.atlassian.com/apps/1222532/prism-syntax-highlighter-for-confluence>) a try.


author: Marcel Nick
body: You could use [JSON Viewer Macro](https://goo.gl/wUNzyK) for Confluence (Cloud \& Server)


Tags: code-block

documentation
Space color schemes mysteriously changed overnight
Asked by Bob Swift (personal):

We use a global color scheme for all our spaces. These all got changed to a space customized version. Must have been through a Confluence Cloud update .

Anybody else experience this problem? I wrote this up to describe how we fixed this quickly.


Answers:
author: Bob Swift (personal)
body: See [How to set the color scheme for a space to the global scheme](https://bobswift.atlassian.net/wiki/display/CSOAP/How+to+set+the+color+scheme+for+a+space+to+the+global+scheme) using [Confluence Command Line Interface (CLI)](https://bobswift.atlassian.net/wiki/display/CSOAP).


Tags: cloud

confluence-cloud
Confluence HTML Include Macro
Asked by Alex Basinskikh:

Hi!

I try to customise table on some page in Confluence space with HTML Include Macro.

HTML includes are enebled in Add-ons settings

When i try to paste the page URL (confluence internal) i have error message, like this:

Error rendering macro 'html-include' : [java.net](http://java.net).ConnectException: Connection refused

What i did wrong?

[](https://community.atlassian.com/t5/Confluence-questions/Confluence-HTML-Include-Macro/qaq-p/393240?attachment-id=5080){#link_118741a061aa42}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/66583/1/html-include.PNG){#display_118741a061aa42_0}  
[](https://community.atlassian.com/t5/Confluence-questions/Confluence-HTML-Include-Macro/qaq-p/393240?attachment-id=5081){#link_118741a061aa42_0}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/66583/2/image2016-3-7%209%3A37%3A41.png){#display_118741a061aa42_2}


Answers:
author: Nathanael Clement
body: We are seeing the same behaviour, did you get any help with this?


author: Alex Basinskikh
body: html-include.PNG

This is Confluence Internal page. Link was generated by ... \> Link t this page...  

<br />

Page contains html:

\<p\> \</p\>  
\<p\>  
\<span\>  
\<a href="<https://answers.atlassian.com/questions/37521669/comments/37532215>" title="Confluence HTML Include Macro"\>  
\<span style="color: rgb(59,115,175);"\>Confluence HTML Include Macro\</span\>  
\</a\>  
\</span\>  
\</p\>


author: Steven F Behnke
body: Can you show us a screenshot or copy the code you're placing into the HTML macro? We're flying blind.
How are attached MS Office files treated for concurrent editing?
Asked by David Miller:

*This question is in reference to Atlassian Documentation: [Edit Office Files](https://confluence.atlassian.com/pages/viewpage.action?pageId=170494553)*

How are files locked when we click on "edit in office" in an attachment page? Will concurrent changes to the same document by multiple editors be merged or not? What is required to merge concurrent edit changes (e.g does it assume somethign from Microsoft on the server). The documentation is unclear here.

If we want to prevent users editing the same document at the same time do we still need the Arsenale Lockpoint Macro for this?


Answers:
author: Rowan Page
body: Will the Office Connector support concurrent editing of office files in the future?


author: Steven F Behnke
body: Confluence doesn't lock files when you use the **Edit in Office** function. You download a copy of the file. When you save the file, the new one is uploaded as a new version of the attachment. There is no way to merge attachment changes from what I can imagine.

Confluence Pages support page merging. Confluence Pages will support live concurrent editing soon.

comments: author: Sky Yeo
body: Hi Steven, Any update on this concurent editing feature for MSfile uploaded to confluence page. I felt this feature is really useful. Is there any progress since this blog is raised one year ago

Thanks


author: Bryan Koene
body: Since concurrent editing of Office documents is not possible or clunky at best, is there a way to block muliple people opening and editing the document at the same time?


author: AlvinL
body: Hi Steven, I see a JIRA was created for this issue <https://jira.atlassian.com/browse/CONFSERVER-39185>, back in 2012! How can we get this prioritized?


author: AnnWorley
body: Hi [@AlvinL](/t5/user/viewprofilepage/user-id/662994), I hope you don't mind my barging in on your thread, hoping to help. I understand you would like to see the issue [Concurrent editing of files for the Office Connector](https://jira.atlassian.com/browse/CONFSERVER-39185) prioritized. Please see our [Atlassian Bug Fixing Policy](https://confluence.atlassian.com/support/atlassian-bug-fixing-policy-201294573.html)

Please emphasize the importance of this suggestion by commenting or voting on the Jira issue as that will communicate directly with the development team responsible for choosing features. Voting and/or commenting will also add you to notifications for the suggestion so you will know when there is progress.


Tags: concurrent

edit

ms-office
Can I upload a documentation generated using appledoc to confluence?
Asked by Tulakshana:

I have a documentation generated using appledocs. It is saved in my repository. Is there a way to add it to confluence? For anybody who doesn't know about appledocs, please check <https://objcsharp.wordpress.com/2013/09/24/how-to-generate-beautiful-apple-style-documentation-in-xcode-5/>


Answers:
author: Nic Brough -Adaptavist-
body: Yes, you can always upload it, but if you want to make it look good, you're going to need to think about importing rather than just uploading (as an upload just attaches an object)

What format is the appledocs stored in? It needs to be one you can import.

comments: author: Tulakshana
body: They are in html. It is a directory structure with an index.html


author: Nic Brough -Adaptavist-
body: Ok, that's not a great 1:1 import route, but there are options.

Have a read of <https://confluence.atlassian.com/conf51/importing-content-into-confluence-336169436.html#ImportingContentIntoConfluence-Importingwebcontent>


author: Tulakshana
body: Embed git files using <https://marketplace.atlassian.com/plugins/nl.avisi.confluence.plugins.git-plugin/server/overview>


Tags: cloud
how to use Content Formatting macros in Confluence
Asked by son22:


Answers:
author: Nic Brough -Adaptavist-
body: It's pretty much the same as you'd use any other macro - select "insert macro" from the page editing menu, or use a { and use the menu that triggers to find the one you want, then fill in the data you want to format, and the parameters and save it.

There's a list of the available macros, what they do and how to use them at <http://www.adaptavist.com/doco/display/CFP/Content+Formatting+Macros+Plugin>
Link to parent
Asked by Matt Lindop:

I'd like to include an automatic link back to the parent page in my template. I can see how to do this for children pages but not for parent page.

Surely this is possible? What am I missing?


Answers:
author: Mohamad Khalife
body: You can make a simple user macro that will provide this functionality:

|-----|------------------------------------------------------------------|
| 1 2 | `## @noparams` `#contentLink2($content.getParent() false false)` |


author: Stephen Deutsch
body: Hi Matt,

I've been thinking about your problem for a while, and I decided to write a small connect plugin that displays a link to the parent page. It's not 100% perfect yet (it still doesn't align text perfectly when the link is displayed in the same paragraph with other text), but if you would like to try it out, you can send me an e-mail at [stephendeutsch1@gmail.com](mailto:stephendeutsch1@gmail.com) and I will send you a link to install it.

comments: author: evanbartlett
body: Did you end up releasing this?


author: Stephen Deutsch
body: Hi Evan, yes, it ended up getting released in a slightly different form as part of another app, Useful Macros: [https://marketplace.atlassian.com/apps/1222454/useful-macros-for-confluence-cloud?hosting=cloud\&tab=overview](https://marketplace.atlassian.com/apps/1222454/useful-macros-for-confluence-cloud?hosting=cloud&tab=overview)


author: Matt Lindop
body: Sounds great but we're on Confluence Cloud ![sad](/html/@C495B4504065515364EB1894F812B34C/images/emoticons/sad.png "sad")


author: Mirek
body: You might add a HTML macro to a template with javascript code


Tags: cloud

confluence-cloud
Page properties report
Asked by Roger Portner:

Hi

We have in the *"Page properties"* insset the "Status macro". Now I w'll filter the Status in the*"Page properties report"* so that we don't see the Status like DONE.

But it looks like the I can not filter for*"Status macro"* in the *"Page properties report"* ?!


Answers:
author: Nick Reilingh
body: Correct--the Filter option on the Page Properties Report is a page filter that uses CQL. CQL does not use page content; only standard metadata as you can see.

You could try using a label that you remove from the page once its status is Done, or you could simply sort the report by the status column so that the Done items appear together at the bottom.
Pocket Query: Caching option not shown in administration interface
Asked by Phillip Riedel:

Hello,

regarding the documentation for the Confluence Pocket Query plug-in an option for configuring cache duration should be shown in the query administration interface.

This is not the case in our installation (using Version 1.14.8).

Can anybody tell why this is and what can be done to enable query caching?

<br />

Many thanks and regards

Phillip


Answers:
author: Felix Grund (Scandio)
body: Hi Phillip!

Thank you for your interest in PocketQuery! Caching is feature that came up with PocketQuery 2.0 (see [here](https://www.scandio.de/en/2015/11/pocketquery-2-0-is-released/)). Please use the most recent version :wink:

Regards, Felix


author: Phillip Riedel
body: Many thanks for your fast answer and this helpful advice. :smile:

Regrds,

Phillip

comments: author: Felix Grund (Scandio)
body: Feel free to ask anytime! If you like PocketQuery, we'd be very happy about a little review at the [marketplace](https://marketplace.atlassian.com/plugins/de.scandio.confluence.plugins.pocketquery/server/overview) :smile:
confluence calculation
Asked by Ernst-Jan Zwienenberg:


Answers:
author: CelesteCS
body: Hello!

The question is understood: how to perform any calculations on Confluence pages.

For any calculations in Confluence, including any manipulations with table data, you may use [CelesteCS Math for Confluence](https://marketplace.atlassian.com/plugins/com.celestecs.confluence.celestecs-math).

Assume you have a table with three columns and three rows on your page -- from A1 till C3, where row 1 is the header row. The sum calculation formula for rows 2 and 3 will be simple:

|-------------------|
| SUM(Table1.A2:C3) |

There is a plenty of other functions in the macro, so you may perform any calculations using formulas in EXCEL style.

Thanks!

comments: author: Nic Brough -Adaptavist-
body: It's a good answer for the question you've posed, but the original question is too unclear to be certain.


author: Nic Brough -Adaptavist-
body: Might want to explain what you're trying to calculate?


Tags: calculation