how to insert jira macro in confluence page with python script?

[AnnieLiu]

<ac:structured-macro ac:name='jira'> 

I used above  jira macro in confluence page before, but now we upgraded to cloud confluence/jira and the jira macro became legacy. Now I want to use jira issues as below in python, but I don't know how to use.

Where can I get the instruction?

[Andrii Maliuta]

Hello @AnnieLiu ,

You can always check the code format of any macro on the page - just add the necessary macro with data and check the ... -> Advanced Details -> View Storage Format.

Looks like it is added as just HTML <a> element with necessary attributes:

<a href="https://x.atlassian.net/issues/?jql=YOUR_JQL_HERE" 
    data-card-appearance="block" 
    data-datasource="{&quot;id&quot;:&quot;aaaa-dfda-4500-baaa-e49addddd4dd&quot;,&quot;parameters&quot;:{&quot;cloudId&quot;:&quot;abc-e1fc-&quot;,&quot;jql&quot;:&quot;project in (\&quot;XXX\&quot;) ORDER BY created DESC&quot;},&quot;views&quot;:[{&quot;type&quot;:&quot;table&quot;,&quot;properties&quot;:{&quot;columns&quot;:[{&quot;key&quot;:&quot;issuetype&quot;},{&quot;key&quot;:&quot;key&quot;},{&quot;key&quot;:&quot;summary&quot;},{&quot;key&quot;:&quot;assignee&quot;},{&quot;key&quot;:&quot;priority&quot;},{&quot;key&quot;:&quot;status&quot;},{&quot;key&quot;:&quot;updated&quot;}]}}]}">
    https://x.atlassian.net/issues/?jql=JQL_HERE
</a>

[AnnieLiu]

Hi, Andrii Maliuta

Thanks for your reply.

But sorry I couldn't find 'view storage format' on my confulence page.

So I want to know how should I rewrite my 'data-datasource'.  

[AnnieLiu]

[Andrii Maliuta]

@AnnieLiu ,

Sorry, did not clarify that for Storage Format you need Admin access to the Confluence instance. 

You can also check the page body representation using REST API (https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content/#api-group-content) with the format of:

https://{YOUR_SITE}.atlassian.net/wiki/rest/api/content/{PAGE_ID}?expand=body.storage

[kchan_d]

@Andrii Maliuta sorry for refresh this.

I notice there's hashlike `macro id`.  What's this used for? Will a random generated by myself work?

Thanks for advance :)

[Andrii Maliuta]

Hello @kchan_d ,

This hash is generated by Confluence automatically and is unique. As I know you can skip adding the ID (or add any other one) when adding macro with code and after next page update Confluence will add it itself, so it should work fine.