ConfluenceサーバーにLucidchartを使用する

この記事では、Lucidchart を Confluence サーバーで使用する方法を説明します。

Confluence 用の Lucidchart アプリは、チームアカウントとエンタープライズアカウントでのみ使用できます。 Lucidchart チームまたはエンタープライズアカウントの管理者は、Lucidchart アプリを Confluence クラウドまたはサーバーインスタンスにインストールできます。

Lucidchart アカウントをお持ちでない場合は、 料金表ページで無料チームトライアルをご利用いただけます。 試用版をすでに完了しており、現在無料または個人アカウントをお持ちの場合は、アカウント内の [ サブスクリプションレベル ] ページに移動して、適切なチームライセンス層を選択します。

LucidchartダイアグラムをConfluenceページに追加するには、次の手順を実行します。
  1. Confluenceページを作成するか、既存のページを開いて"編集をクリックします"

    edit_confluence_page.png
  2. 上部のバーから" + " (さらにコンテンツを挿入)をクリックし、 " [Lucidchart Diagramを追加]を選択します。 "このオプションが表示されない場合は、Lucidchartアカウントの管理者に連絡してください。

    add_lucidchart_diagram_to_confluence_page.png
  3. Lucidchartにログインしている場合、Lucidchartドキュメントページがロードされます。ログインしていない場合は、Lucidchartの資格情報を入力してください。

    enter_credentials_for_confluence.png
  4. 追加するドキュメントにカーソルを合わせて、[ "選択]をクリックします。 "新しいドキュメントを作成したり、Visio、Gliffy、Draw.io、またはOmniGraffleファイルをインポートすることもできます。選択すると、ドキュメントがConfluenceページに読み込まれます。

    select_a_document_to_insert_to_confluence.png
  5. " Update "をクリックして、ドキュメントをConfluenceページに公開します。

    update_confluence_with_lucidchart_diagram.png

    公開されると、そのページに対する権限を持つすべてのユーザーがドキュメントを表示できるようになります。
ダイアグラムが挿入されたConfluenceページへの編集アクセス権がある場合、Lucidchartでそれらのダイアグラムを編集し、それらの変更をConfluenceにプッシュできます。

Confluenceページに既に追加されているダイアグラムを編集するには、次の手順に従います。
  1. Confluenceページの上部にある[ "編集" ]をクリックし、挿入された図に表示されるオプションバーの[ "編集" ]をクリックします。

    edit_confluence_page.png

    edit_inserted_diagram.png

    または、ダイアグラムにカーソルを合わせて鉛筆アイコンをクリックします。

    edit_pencil.png

    ドキュメントがLucidchartエディターで開きます。
  2. Lucidchartドキュメントに変更を加えます。完了したら、Lucidchartエディターの左上隅にある[ " Confluenceに戻る" ]をクリックします。

    back_to_confluence_button.png

    変更はConfluenceの図に自動的に同期されます。
  3. Confluenceページの右下にある" Update "をクリックして、変更を公開します。

    update_confluence_with_lucidchart_diagram.png
Confluenceページに既に追加されているダイアグラムを削除するには、次の手順を実行します。
  1. Confluenceページの上部にある"編集"をクリックします。

    edit_confluence_page.png
  2. 挿入された図をクリックし、表示されるオプションバーから" Remove "をクリックします。

    remove_diagram_from_confluence.png
  3. Confluenceページの右下にある" Update "をクリックして、変更を公開します。

    update_confluence_with_lucidchart_diagram.png
ドキュメントの共有権限は、Confluence ページから継承されます。 つまり、Confluence ページを表示および編集でき、Lucidchart のライセンスユーザーであれば、Confluence ページでドキュメントを表示および編集できます。
挿入されたダイアグラムの表示プロパティを変更するには、Confluenceページの右上にある"編集"をクリックしてから、ダイアグラムを選択し、表示されるバーから"プロパティ"をクリックします。

edit_properties_of_inserted_diagram.png

「ダイアグラムのプロパティ」というタイトルのモーダルが開きます。

confluence_viewer_properties.png

このモーダルでは、次の設定を調整できます。
  • 調整及び高さ挿入図のを
  • 自動サイズオンまたはオフにします
  • Confluenceページに表示されるダイアグラムのアライメントを調整します。
  • Confluence ページの 閲覧者が使用できる Lucidchart ドキュメントのページを指定します (3 または 2-3 など)。 注:ページまたはページ範囲を選択できるのは、リッチビューアを使用している場合のみです。
  • リッチビューアーとベーシックビューアー切り替えます(詳細については以下を参照)
  • 自動更新有効にし (詳細については以下を参照)
あなたはこれらの設定に変更を加える完了したら、クリックしてください"保存]を。 "
ConfluenceのためのLucidchartアプリは、あなたがすることができます自動的に変更押し込みのConfluenceに表示された図をLucidchartエディタからを。特定の図の自動更新を有効にするには、次の手順を実行します。
    1. 図を選択します。
    2. 下部のオプションバーから"プロパティ"をクリックします。
    3. "のオプションの下にある[ " " ]をクリックします。この図をLucidchartで行った変更で自動的に更新します。 "
    4. [保存] をクリックします。
注:個別のダイアグラムベースでのみ自動更新を有効にすることができます。
ConfluenceサーバーでLucidchartダイアグラムを表示するために使用できる2つのビューア、BasicとRichがあります。 BasicビューアーはConfluenceサーバーでホストされ、図の静的なPNGを提供します。 Basicビューアーは、Chrome、Firefox、Safari、およびInternet Explorerで使用できます。

を選択し、基本的なビューアでダイアグラムを表示するにはオフの下" Lucidchartビューアの使用リッチ"ダイアグラムのプロパティモーダルインチ

rich_viewer_toggled_off.png

basic_viewer.png

基本ビューアーで表示される図の隅に一連のアイコンが表示され、ビューアーは次のアクションを実行できます。
  • Lucidchartで図を編集する
  • Confluenceページから図を削除します
  • リッチビューアーに切り替える
  • Lucidchartダイアグラムの最新バージョンに更新します
  • ダイアグラムのズームインとズームアウト
  • 注:基本ビューアーを使用する場合、Lucidchart ドキュメントのどのページをビューアが使用できるかは指定できません。 この機能にアクセスするには、リッチビューアを使用する必要があります。
挿入された図に複数のページが含まれる場合、表示された図にカーソルを合わせたときにビューアーの横に表示される対応する矢印をクリックして、ページを切り替えることができます。
ConfluenceサーバーでLucidchartダイアグラムを表示するために使用できる2つのビューア、BasicとRichがあります。リッチビューアーはLucidchartサーバーでホストされ、実行するにはインターネットアクセスが必要です。 Lucidchartとの完全な対話機能を提供します。リッチビューアーは、Chrome、Firefox、およびSafariで使用できますが、Internet Explorerでは使用できません。基本ビューアーでダイアグラムを表示するには、 "下の"オン"選択します。ダイアグラムプロパティモーダルでLucidchartビューアー"でリッチを使用します。

rich_viewer_toggled_on.png

rich_viewer.png

Richビューアーで表示されるダイアグラムの下部にプロパティバーが表示され、ビューアーは次のアクションを実行できます。
  • 新しいブラウザタブでLucidchartを開きます
  • Lucidchartで図を編集する
  • 基本的なビューアに切り替えます
  • Lucidchartダイアグラムの最新バージョンに更新します
  • 挿入された図のスライドを切り替える
  • ダイアグラムのズームインとズームアウト
  • 全画面モードに入る
  • 次のオプションを含むビューアーオプションモーダルを開きます。
    • ページのタブを表示
    • ホットスポットを表示
    • ノートを表示
    • WebGL を有効化
挿入した図に複数のページが含まれている場合は、図の上にマウスポインタを置くと、ビューアの上部に表示されます。 ページに関連付けられたタブをクリックすると、そのページが表示されます。

Screen_Shot_2019-07-08_at_10.27.51_AM.png
一般的な問題
エラーを受け取った場合: "このインスタンスに関連付けられたチームに参加していません。 "おそらく、特定のユーザーは間違ったLucidchartチームに接続されています。これを修正するには、次の手順を実行します。
    1. 現在 Confluence に誤ってリンクされている Lucidchart アカウントへログインします。どのメールアドレスがリンクされているかが不明な場合には、この段階で手順を中止して当社までご連絡ください。当社側で誤ったリンクを探し出し、接続を切断します。
    2. アカウント設定の下の外部アプリケーションページに移動します。
    3. ' Confluence '横にあるチェックボックスをオンにして、[ '削除' ]ボタンをクリックします。これにより、アカウントが切断されます。
    4. 正しい接続を再確立するには、Lucidchartからログアウトします。次に、Confluenceページに図を挿入する必要があります。 Lucidchartにログインするように求められたら、リンクしようとしているConfluenceアカウントにリンクされている組織'のLucidchartアカウント(ステップ1でログインしたメールではなく)にログインしていることを確認してください。
Lucidchart Confluence Server コネクターのインストールや構成時に以下の 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 サーバーと同期させる必要が生じます。

ConfluenceサーバーでDraw.ioダイアグラムをLucidchartダイアグラムに変換するには、次の手順を実行します。
  1. 変換するダイアグラムを含むページに移動します。
  2. Draw.ioでファイルを開き、XMLファイルとしてダウンロードします。
  3. Confluence ページの編集モードに入ります。
  4. エディターの上部にあるツールバーのプラスアイコンを使用して、ドロップダウンのLucidchart選択を介して新しいLucidchartダイアグラムを挿入します。
  5. Lucidchartエディターが開いたら、インポートメニューから図をインポートできます。
  6. ダイアグラムがインポートされたら、ドキュメントリストからそれを選択すると、Confluenceページに追加されます。この時点で、Confluenceにリダイレクトされます。
  7. 変換が完了し、元の Draw.io の図を Confluence ページから削除することが可能となります。
注:Confluence サーバーと Confluence クラウドのエクスペリエンスは異なります。Confluence Cloud を使用している場合は、 この記事 に移動してください。
Lucidchart の図形、および Confluence で選択したフレームのサイズによっては、図に余白(空白)が表示されることがあります。以下の例を参照してください。

注意:Lucidchart 内のキャンバスのサイズは、Confluence 内に表示される空白の量には影響しません。

以下の Lucidchart 図はかなり広いです。

pasted_image_0.png

フレーム@@ のサイズを変更 せずに Confluence Server に挿入すると 、フレームはダイアグラムのサイズに合わせて調整され、空白は最小限に抑えられます。

pasted_image_2.png

ただし、この図は非常に大きく、Confluence ページでそれほど多くのスペースを占めたくないので、フレームを小さくしましょう。Confluence ページの編集モードに入り、図を選択すると、以下のメニューがポップアップ表示されます。変更はまだ行われていないため、フレームサイズは現在「オリジナル」に設定されています。つまり、 図のサイズに合わせてフレームが調整されています。

pasted_image_3.png

図のプロパティ(プロパティオプションを選択)を見ると、元のサイズ変更が反映されていることがわかります。幅と高さは均一ではありません。図に合わせてフレームのサイズが自動的に調整されます。

pasted_image_4.png

フレームサイズを小さくするには、下のメニューに戻り、[小]、[中]、[大] のいずれかを選択します。この例では、メディアを選択します。

pasted_image_3.png

メディアを選択した後、プロパティをもう一度見てみると、何かが変わったことがわかります。幅と高さの両方が600pxになりました。これは、「中」オプションに関連付けられたプリセットフレームサイズです。これは、フレームがそのサイズに固定されていることを意味します。ページを公開すると、図のサイズに合わせてフレームを調整するのではなく、 図はフレームのサイズに合わせて調整する必要があります。

pasted_image_5.png

この例の図は幅が広いため、600 x 600 フレームに収めると、図の上下に白い余白が生じます。

pasted_image_6.png

余白が欲しくない場合は、それらを削除する方法があります。プロパティメニューに戻ると、高さと幅をカスタマイズできます。サンプル図の上下に空白があるので、高さを 600 から 300 まで下げて「保存」を選択し、ページを発行します。

pasted_image_7.png

これで、白い余白が削除され、図が Confluence ページ全体を占めなくなるように、フレームサイズの変更に成功しました。

pasted_image_8.png

必要に応じて、Confluence Server にダイアグラムを挿入した直後にフレームのカスタマイズに進むことができます。ただし、どの幅と高さが最適かを判断するために、標準サイズのいずれかでダイアグラムがどのように表示されるかを確認しておくと便利です。

Confluence に図を挿入している場合に、上記の機能に関係しない異常な量の空白があるように感じる場合は、support@lucidchart.com にメールを送信して Lucidchart サポートに連絡し、以下の情報を提供してください。の図が [Confluence] ページに表示され、Lucidchart 内からその図への URL が表示されます。