Lucid と Confluence Data Center を統合する

管理者向け : インストールと構成の手順

チームまたはエンタープライズ アカウントのアカウント所有者またはアカウント管理者のみが、Confluence Data Center に Lucidchart アプリ、または Confluence Data Center に Lucidspark アプリをインストールして構成できます。
次のインストール手順に従ってください。

1. Confluence インスタンスに管理者としてログインします。
2. [管理] メニューを開きます。
3. 左側のサイドバーで [アドオン] をクリックします。
4. [新しいアドオンの検索] を選択します。
5. Atlassian Marketplace で「Lucidchart」または「Lucidspark」を検索します。
6. Lucidchartダイアグラム Connector タイル Lucidsparkホワイトボード コネクタ ータイル をクリックして ください 。
7. 右上隅にある [今すぐ入手] を選択します。
8. Lucidchartアプリをインストールする場合は、ポップアップウィンドウの「Data Center」の「 今すぐ取得」 をクリックしてください。

アプリがローカルデバイスにダウンロードされます。

ダウンロードしたアプリから、以下の手順に従ってインスタンスに設定します。

1. 管理と設定をクリックして、LucidにConfluenceへのアクセスを許可してください。
2. まだログインしていない場合は、Lucid アカウントにログインします。
3. [アカウントのリンク] を選択して、Confluence インスタンスを Lucid アカウントに接続します。

Lucidchart for Gov環境でデータセンターのLucidchartConfluenceアプリをセットアップするには、<baseUrl>/管理者/plugins/Lucidchart/environmentconfig.actionにアクセスし、<baseUrl>がConfluenceインスタンスのベースURL)に移動し、ドロップダウンから lucidgov.app を選択します。

文書を Confluence ページに追加

Lucidchart の図や Lucidspark ボードを Confluence ページに追加するには、以下の手順に従います。

1. Confluence ページを作成するか、既存のページを開きます。
2. ページ上部の [編集] をクリックします。
3. ページ上部のメニューの + をクリックします。 
4. 「 Add T Lucidchart ダイアグラム 」または「 Add Lucidspark ホワイトボード」を選択します。
   • このオプションが表示されない場合は、Lucidchart アカウントの管理者に連絡して、Confluence インスタンスに適した Lucid アプリをインストールして設定するよう依頼してください。
   • 追加する文書がリポジトリにある場合は、次のステップに進む前にそのリポジトリを開く必要があります。左側のナビゲーションからリポジトリをクリックし、特定のリポジトリを選択します。
5. 追加する文書の上にカーソルを合わせ、[選択] をクリックします。 
   • 左上隅の [+ 文書 ] をクリックして、新しい文書を作成することもできます。
6. 選択すると、文書が Confluence ページに読み込まれます。
7. Confluence ページの右下にある[更新] をクリックして、文書を公開します。

公開されると、そのページに対する権限を持つすべてのユーザーが文書を表示できるようになります。

埋め込まれた文書を管理

Confluence ページから直接 Lucidspark ボードを編集する

Confluence Data Center に Lucidspark ボードを埋め込む場合、Confluence で直接使用できる次のアクセス設定を選択できます。

• 表示のみ: Confluence ユーザーは埋め込まれた Lucidspark ボードのみを表示できます。
• コメントのみ: Confluence ユーザーは埋め込まれた Lucidspark ボードを表示し、コメントすることができます。
• 編集: Confluenceユーザーは、埋め込みLucidsparkボードを編集できます。

LucidsparkでConfluence ボードを直接編集すると、図形や線を追加したり、 に参加したりするなど、さまざまなオプションが提供されます。Visual ActivityLucidspark を初めてご利用になり、利用可能なさまざまな機能の使い方を学習することに興味がある場合は、 「Lucidspark へようこそ」の記事をご覧ください。

LucidchartをLucidで開いて編集します

文書が挿入された ページへの編集アクセス権がある場合は、 で文書を編集し、変更をConfluence LucidchartLucidConfluenceにプッシュすることができます。

Confluence ページに既に追加されている文書を編集するには、以下の手順に従います。

1. 公開 Confluence ページで、挿入された Lucidchart ダイアグラムまたは Lucidspark ボードの上にカーソルを置きます。
2. Lucidchartで開くをクリックしてください。
   • Confluence ページで編集モードになっている場合は、挿入された文書をクリックし、図の下に表示されるオプションバーから [編集] を選択します。
3. 文書が Lucid エディターで開き、変更を加えることができます。
4. 完了したら、Lucid エディターの左上隅の [Confluence に戻る ] をクリックします。
   • 変更は、Confluence の埋め込まれた文書に自動的に同期されます。
5. Confluenceページ右下の「Update」をクリックして、変更点を公開してください。

Confluence ページから文書を削除

Confluence ページに既に追加されている文書を削除するには、以下の手順に従います。

1. Confluence ページ上部の [編集] をクリックします。
2. 挿入した文書を選択します。
3. 文書の下に表示されるオプションバーから [削除] をクリックします。
4. Confluenceページ右下の「Update」をクリックして、変更点を公開してください。

図の表示プロパティを調整

挿入された文書の表示プロパティにアクセスするには、以下の手順に従います。

1. Confluence ページ上部の [編集] をクリックします。
2. 文書を選択します。
3. 文書の下に表示されるオプションバーの [プロパティ] をクリックして、表示プロパティモーダルを開きます。
4. 表示プロパティを変更した後、[保存] をクリックします。

このモーダルでは、使用している Lucid アプリに応じ、以下の設定が表示される場合があります。

• 挿入する文書の幅と高さを調整します。
• 自動サイズ設定をオンまたはオフにします。
• Confluence ページに表示される図の配置を調整します。
• Lucidchart の文書の場合は、Confluence ページの閲覧者が利用できるページを指示します (例: 3 または 2-3)。
  • ページまたはページ範囲の選択は、リッチビューアーを使用している場合にのみ可能です。
• リッチビューアーとシンプルビューアーを切り替えます。
• Lucid で文書が更新されたときに自動更新を有効にします。
  • 自動更新の有効化は、リッチビューアーを使用している場合にのみ可能です。

シンプルビューアーとリッチビューアー

Confluence Data Center で Lucid 文書を表示するには、シンプルとリッチの 2 つのビューアが使用できます。

マクロ設定モーダルで、特定の文書につきシンプルビューアーとリッチビューアーを切り替えることができます。

シンプルビューアー

シンプルビューアーは Confluence サーバーでホストされ、文書の静的な PNG を提供します。

文書の上にカーソルを合わせると、シンプルビューアーで次のアクションを実行できます。

• Lucid で図を編集
• Confluence ページから図を削除
• リッチビューアーに切り替え
• Lucid 文書の最新バージョンに更新
• 図をズームイン/ズームアウト

挿入された文書に複数のページが含まれている場合は、文書の上にカーソルを合わせたときにビューアーの側面に表示される矢印をクリックして、ページを切り替えることができます。

リッチビューアー

リッチビューアは Lucid サーバーでホストされており、実行するにはインターネットアクセスが必要です。Lucid 文書との完全なインタラクティブ性を提供します。

リッチビューアーで表示された文書の上にカーソルを合わせると、フレームが表示されます。

ユーザーはフレームの上部から以下の操作ができます。

• Lucid 文書を新しいブラウザタブで開く
• 文書のタイトルを表示する
• 文書内で作成されたスライドを表示する
• 全画面モードに入る
• ビューアーオプションモーダルを開く
  • この Lucidchart アプリのモーダルには、メモやホットスポットの表示、WebGL の有効化、図の最新版への更新などの機能が含まれています。

ユーザーはフレームの下部から以下の操作ができます。

• 別のページタブを選択して Lucidchart 文書で表示する
• 図のさまざまなレイヤーを Lucidchart 文書で表示する
• 図をズームイン/ズームアウト

Draw.io の図を Lucidchart 文書に変換する

Confluence Data Center で Draw.io ダイアグラムをLucidchartに変換するには、次の手順に従います。

1. 変換する文書が含まれているページに移動します。
2. 対象のファイルを Draw.io で開き、XML ファイルとしてダウンロードします。
3. Confluence ページの編集モードに入ります。
4. エディター上部のツールバーのプラスアイコンを使い、ドロップダウンメニューから Lucidchart を選択し、新規の Lucidchart 文書を挿入します。
5. Lucidchart エディターが開くと、インポートメニューから図をインポートすることができます。
6. 図のインポートが完了したら、文書リストから対象の図を選択します。図が Confluence ページに追加されます。この時点で、Confluence へリダイレクトされます。
7. 変換が完了し、元の Draw.io の図を Confluence ページから削除することが可能となります。

Confluence Data CenterからConfluence Cloudへの移行

ConfluenceデータセンターからConfluence Cloudへ移行する前に、以下の点を覚えておいてください。

• 文書はページ単位ではなく、スペースで変換されます。
• この移行は、Confluenceインスタンスの以前のバックアップを復元しない限り、一括で元に戻すことはできません。
• 変換は文書ごとに元に戻すことができ、文書にアクセスしてページ履歴からページを復元できます。

LucidchartアプリのデータセンターConfluenceConfluenceクラウドに移行する場合は、以下の手順に従って文書をリセットして再び表示してください:

1. アドオン Lucidchart の設定セクションに移動します。
2. 「Confluence Conversion」タブを選択してください。
3. 変換が必要なダイアグラムを探すには 検索をクリックしてください 。
4. 「 コンバージョン」を選択してください。

文書を移行したら、 その インテグレーションの使い方については 「 Lucid withConfluence Cloud 」の記事をご覧ください。

よくある質問 (FAQ)

Confluenceページに埋め込まれたLucid 文書のビューと編集は誰ができるのでしょうか?
ConfluenceデータセンターにおけるLucid 文書の閲覧権限はConfluenceページから引き継がれます。つまり、Confluenceページをビューできれば、Lucidアカウントの有無にかかわらず、Confluenceページで文書をビューできるということです。

Confluence の Lucidspark アプリも Confluence ページから編集権限を取得します。つまり、Confluenceページのビューや編集ができ、ライセンスを持つLucid ユーザーであれば、各文書の「Open in Lucidchart 」ボタンをクリックして、Lucidアプリでダイアグラムをビュー・編集できます。

Confluence の Lucidspark アプリで文書を編集するには、Confluence の編集権限と埋め込まれた Lucidspark ボードの編集アクセス権限の両方が必要です。

インテグレーションにアクセスしようとしたときにログインループから先に進めません。
このインテグレーションの使用時に Lucid へのログインを継続的に求められるログインループが発生した場合は、ブラウザでサードパーティの Cookie がブロックされていることが原因の可能性があります。ブロックされないよう設定を変更する方法の詳細については、記事「 トラブルシューティング : サードパーティのクッキーの有効化 」を参照してください。

Confluence に埋め込まれた Lucid の図の周囲に白い余白が表示されるのはなぜですか？
Confluence に図を挿入すると、文書の周囲に空白が発生することがあります。埋め込み文書の外観を最適化する方法については、このコミュニティ投稿「 挿入された図の空白 スペース 」(英語) を参照してください。

なぜConfluence Data Center用のLucidchartアプリをインストールしようとするとOAuth timestakeエラーが出るのでしょうか?
Lucidchart Confluence Data Centerコネクタのインストールと設定時に以下のOAuthタイムスタンプエラーが出た場合、

“org.scribe.exceptions.OAuthException: Response body is incorrect. Can't extract token and secret from this: 'oauth_problem=expired_timestamp,_yours_1359614629,_ours_1359585813'”

このエラーは、Confluence をホストしているサーバーのタイムスタンプの精度が高くないことを示す場合が一般的です。サーバー時間に一見問題がないように思われる場合でも、15秒から30秒の不整合により、サーバー間の通信に問題が生じる可能性もあります。十分な精度でサーバー時間を調整することは不可能なため、タイムスタンプを NTP サーバーと同期させる必要が生じます。

「あなたはこのインスタンスに関連付けられたチームに参加していません。」というエラーが表示されるのはなぜですか？
このエラーは、ユーザーが誤ったLucidアカウントに接続されている可能性が高いことを意味します。これを修正するには、以下の手順を実行します。

1. 現在 Confluence に誤ってリンクされている Lucid アカウントへログインします。
2. Lucid アカウントの右上隅にあるプロフィール画像またはイニシャルをクリックします。
3. [アカウント設定] を選択します。
4. 左側のメニューから [アプリとインテグレーション] タブを選択します。
5. 「Confluence」の横にあるチェックボックスをオンにします。
6. 削除ボタンをクリックしてください。これにより、アカウントの接続が解除されます。
7. Lucid からログアウトし、正しい接続を確立します。
8. 任意の Lucid 文書を Confluence ページに挿入します。
9. Lucid へのログインを求められたら、組織の Lucid アカウントに関連付けられているメールアドレスでログインしていることを確認してください。

最初に設定した管理者が辞めたら、アカウント全体のConfluence接続はどうなりますか?
管理者が離れても、アカウントレベルで設定されているため接続は有効のままです。管理者権限は接続作成の初期セットアッププロセス中のみ必要です。
 

この記事へのフィードバックをお寄せください