問題

Confluence ページに Jira リンクへの課題を作るには、Jira 課題マクロが使われます。これらのリンクには、リンクが参照する Jira インスタンスの ID が含まれます。

特定の状況において (ドメイン変更、移行、インスタンスの統合など)、これらのリンクを編集して別の Jira インスタンスを指すようにする必要があります。これを行わないと、Confluence ページに次のエラー メッセージが表示されます。

診断

A Jira Issue Macro link contains two identifiers; The Application Link ID and the Application Name. Should you encounter this issue, it is necessary to check if the Application Link ID and the Application Name is pointing to the correct Jira instance.

次の手順を行います。

1. First, please access the affected page and view the Confluence Storage Format.
    Please do take note of the Application Link ID and Application Name's values.

   例

   ストレージ形式の例

   <p><ac:structured-macro ac:name="Jira" ac:schema-version="1" ac:macro-id="f4b5962b-5cf2-4754-90d9-758306583d18"><ac:parameter ac:name="server">Jira Old</ac:parameter><ac:parameter ac:name="columns">key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution</ac:parameter><ac:parameter ac:name="maximumIssues">20</ac:parameter><ac:parameter ac:name="jqlQuery">project = SP </ac:parameter><ac:parameter ac:name="serverId">79f0263c-a3a5-323b-870c-aea1895cabeb</ac:parameter></ac:structured-macro></p>

   アプリケーション リンクの ID

    <ac:parameter ac:name="serverId">79f0263c-a3a5-323b-870c-aea1895cabeb</ac:parameter>

   アプリケーション名

    <ac:parameter ac:name="server">Jira Old</ac:parameter>

2. 次に、web ブラウザで次の URL にアクセスすることで、正しいアプリケーション リンク ID とアプリケーション名を特定します。

   http://<Jira-Base-URL>/rest/applinks/1.0/manifest

   例

   

   アプリケーション リンクの ID

    <id>144880e9-a353-312f-9412-ed028e8166fa</id>

   アプリケーション名

    <name>Atlassian Jira</name>

3. 最後に、ステップ 1 とステップ 2 の両方で特定したアプリケーション リンク ID とアプリケーション名を一致させる必要があります。

select body from bodycontent where contentid = (select contentid from content where spaceid = (select spaceid from spaces where spacekey = 'KEY') and title = 'Page Title');

ac:name="server">Jira (source.atlassian.net)</ac:parameter><ac:parameter ac:name="serverId">67806a6b-f924-3896-8e84-fecf05e0398b

原因

この問題は、影響を受けるページのストレージ形式と宛先の Jira インスタンスとでアプリケーション リンク ID とアプリケーション名が異なるために発生します。 

ソリューション 1

すべての Jira 課題マクロ情報は、次の例のように BODYCONTENT テーブルに含まれます。

<p><ac:structured-macro ac:name="Jira"><ac:parameter ac:name="columns">key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution</ac:parameter>
<ac:parameter ac:name="server">Jira Old</ac:parameter><ac:parameter ac:name="serverId">79f0263c-a3a5-323b-870c-aea1895cabeb</ac:parameter>
<ac:parameter ac:name="key">TST-1</ac:parameter></ac:structured-macro></p>

If the affected instance is on Confluence 7 or newer, make sure to update the Drafts to use changes on the next opening of the draft, If on the older Confluence version, skip to the update of BODYCONTENT:

UPDATE CONTENTPROPERTIES set stringval='synchrony-recovery' WHERE PROPERTYID in (SELECT cp.PROPERTYID FROM BODYCONTENT bc JOIN CONTENTPROPERTIES cp ON cp.CONTENTID = bc.CONTENTID WHERE bc.BODY like '%<old_string>%' AND cp.PROPERTYNAME = 'sync-rev-source');

BODYCONTENT テーブルの情報を更新するには、次の SQL ステートメントを使用します。

UPDATE BODYCONTENT 
 SET BODY = REPLACE(BODY,'<old_string>','<new_string>');

MSSQL の場合は次のようなクエリを使います。

UPDATE BODYCONTENT
 SET BODY = CAST(REPLACE(CAST(BODY as nvarchar(max)),'<old_string>','<new_string>') as ntext);

1. Confluence 6.x 以降で、共同編集がオンまたは制限付きに設定されている場合、上述のデータベース操作を行う前に共同編集を無効化し、変更後、 Confluence の再起動後に再度有効化します。これは、Synchrony のキャッシュで新しい値を取得できるようにするためです。 

   Per Administering Collaborative Editing, it's a good idea to prompt your users to publish any shared drafts before you turn collaborative editing off, as they will not be able to resume editing existing shared drafts or unpublished changes.

2. Confluence をシャットダウンします。

3. 次の SQL アップデート ステートメントを実行します。

4. UPDATE BODYCONTENT
   SET BODY = REPLACE(BODY, '<ac:parameter ac:name="server">Jira Old</ac:parameter>',
                      '<ac:parameter ac:name="server">Atlassian Jira</ac:parameter>');
   
   UPDATE BODYCONTENT
   SET BODY = REPLACE(BODY, '<ac:parameter ac:name="serverId">79f0263c-a3a5-323b-870c-aea1895cabeb</ac:parameter>',
                      '<ac:parameter ac:name="serverId">144880e9-a353-312f-9412-ed028e8166fa</ac:parameter>');

5. UPDATE BODYCONTENT
    SET BODY = CAST(REPLACE(CAST(BODY as nvarchar(max)),'<ac:parameter ac:name="server">Jira Old</ac:parameter>',
   '<ac:parameter ac:name="server">Atlassian Jira</ac:parameter>') as ntext);
   
   
   UPDATE BODYCONTENT
    SET BODY = CAST(REPLACE(CAST(BODY as nvarchar(max)),'<ac:parameter ac:name="serverId">Jira Old ServerID</ac:parameter>',
   '<ac:parameter ac:name="serverId">Atlassian Jira ServerID</ac:parameter>') as ntext);

6. 
   

   すべてのページに影響を与えたくない場合は条件を追加することもできます。次の SQL クエリは、spacekey - 'KEY' のスペースのコンテンツのみを更新します。

   Spacekey 値を指定する SQL アップデート クエリ

   UPDATE bodycontent
   SET body = replace(body, 'ac:name="server">Jira (source.atlassian.net',
                      'ac:name="server">Jira (destination.atlassian.net')
   where contentid in (select contentid from content where spaceid in (select spaceid from spaces where spacekey = 'KEY'));
   
   UPDATE bodycontent
   SET body = replace(body, 'ac:name="serverId"><source server ID>', 'ac:name="serverId"><destination server ID>')
   where contentid in (select contentid from content where spaceid in (select spaceid from spaces where spacekey = 'KEY'));

7. You may wish to verify that the content in the database has been updated before/after your UPDATE query has been set. Please engage with your DBA if needed, but you can select using the criteria below:

   SELECT
   	FROM
   	  CONTENTPROPERTIES
   	WHERE
   	  PROPERTYID in (
   	    SELECT
   	      cp.PROPERTYID
   	    FROM
   	      BODYCONTENT bc
   	      JOIN CONTENTPROPERTIES cp ON cp.CONTENTID = bc.CONTENTID
   	    WHERE
   	      bc.BODY like '%<ac:parameter ac:name="serverId">the-id-of-the-old-applink</ac:parameter>%'
   	  );

8. Confluence を再起動します。

ソリューション 2

When migrating to a new Jira DC Instance and deleting the old app link, ensure that the new app link is created with the same name as the previous one.This approach simplifies the migration process and is more efficient compared to Resolution 1, which involves running SQL scripts. 

By maintaining the same app link name, you can avoid manual database modifications and ensure a smoother transition.