この記事はAIによって翻訳されました

HumHub

ONLYOFFICEとHumHubの統合について

ONLYOFFICEは、ONLYOFFICE DocsをHumHubと統合し、ソーシャルネットワーク内でオフィス文書を編集するための公式コネクタを提供しています。ONLYOFFICEコネクタは、公式のHumHubマーケットプレイスまたはONLYOFFICEのGitHubページからダウンロードできます。

HumHub用ONLYOFFICEコネクタの動作について詳しく知りたい場合は、APIドキュメントをご覧ください。
主な機能
  • テキスト文書、スプレッドシート、プレゼンテーションの作成、編集、表示。
  • リアルタイムでの共同編集：2つの共同編集モード（高速モードと厳格モード）、変更履歴モード、コメント、内蔵チャット。
  • JWTサポートにより、適切な権限を持つユーザー以外が文書にアクセスできないようにトラフィックを保護します。
サポートされているフォーマット
  • 開いて編集可能：DOCX、XLSX、PPTX、PDFフォーム
  • Office Open XMLへの変換用：ODT、ODS、ODP、DOC、XLS、PPT、TXT、CSV
  • 表示のみ：ODT、ODS、ODP、DOC、XLS、PPT、TXT、PDF
バージョン3.3.0の新機能

追加された機能

  • .vsdx、.vssx、.vstx、.vsdm、.vssm、.vstmの図表ドキュメントタイプのサポート
  • .odg、.mdの表示サポート
  • .xlsbの編集サポート
  • hwp、hwpx、pages、numbers、keyフォーマットのサポート
  • Docs APIおよびConversion APIへのリクエスト用にshardKeyパラメータを追加
  • 不足している翻訳を追加
  • メンション用のユーザーのページネーションを追加し、権限チェックを含む

変更された点

  • Conversion APIへのリクエスト用URL
  • 権限が不十分な状態でのcfilesフォルダー内のファイル作成の修正

完全な変更ログはこちらで確認できます。

ONLYOFFICE DocsをHumHubに接続する

要件
  • ONLYOFFICE Document Server v6.1.0（サーバーまたはクラウドバージョン）以降

    ONLYOFFICE Docsのインスタンスが、HumHubおよびすべてのエンドクライアントから解決可能で接続可能である必要があります。HumHubに直接POSTできる必要があります。

    ONLYOFFICE Docsのインストールについて詳しくは、公式のドキュメントページをご覧ください。
  • HumHub 1.8以降
  • HumHub用ONLYOFFICE Connector 2.4.0
HumHub用ONLYOFFICEコネクタのインストール

最新のコネクタバージョンは公式HumHubマーケットプレイスからダウンロードして設定できます。以下の手順に従ってください：

  • 管理者としてHumHubインスタンスにログインします。
  • プロフィールのドロップダウンボックスをクリックし、管理オプションを選択します。ユーザー管理画面が表示されます。
  • ページの左側にあるモジュールセクションをクリックします。
  • オンラインで閲覧セクションに入り、検索でONLYOFFICEコネクタを見つけます。結果には、HumHubインスタンスと互換性のあるバージョンが含まれます。
  • インストールボタンをクリックして、ONLYOFFICEモジュールをダウンロードしてインストールします。
  • モジュールがインストールされたら、有効化ボタンをクリックします。
    ONLYOFFICE_installONLYOFFICE_install

または、moduleAutoloadPathsパラメータで指定されたフォルダーの1つにリポジトリをクローンするだけです。詳細についてはHumHubドキュメントをご覧ください。

HumHub用ONLYOFFICEコネクタの設定
  1. 管理 -> モジュール -> インストール済みに移動します。
  2. HumHub用ONLYOFFICEコネクタモジュールを見つけます。
  3. 設定ボタンをクリックします。
  4. 次のパラメータを指定します：
    • ホスト名 - 文書編集サービスがインストールされているURLアドレスを指定します（ONLYOFFICE Docsはデフォルトでポート80にインストールされます）。
      重要ONLYOFFICE DocsのアドレスはHumHubからアクセス可能である必要があり、HumHubのアドレスもONLYOFFICE Docsからアクセス可能である必要があります。
    • JWTシークレット - データの署名に使用されるシークレットを指定します。
      ONLYOFFICE Docs v7.2以降、JWTはデフォルトで有効化されており、シークレットキーは自動的に生成されます。HumHub側でも有効にする必要があります：ONLYOFFICE Docs設定ファイルでシークレットキーを見つけ、コネクタ設定で同じシークレットキーを指定します。詳細については、この記事のONLYOFFICEとHumHubの統合用JWTの有効化セクションをご覧ください。
  5. サーバーからの内部リクエスト用ONLYOFFICE Docsアドレス - HumHubから文書編集サービスにアクセスするために使用されるアドレスを指定します。
  6. ONLYOFFICE Docsからの内部リクエスト用サーバーアドレス - 文書編集サービスからHumHubにアクセスするために使用されるアドレスを指定します。
Configure_menuConfigure_menu

統合アプリケーションを設定した後、送信ボタンをクリックして変更を保存します。

動作の仕組み

ONLYOFFICEの統合は、こちらで文書化されたAPIに従います。

  1. 新しいファイルを作成する際、ユーザーは文書、スプレッドシート、またはプレゼンテーションのオプションを文書を作成メニューで提供されます。
  2. ブラウザは、/controllers/CreateController.phpコントローラのindexメソッドを呼び出します。
  3. または、既存のファイルを開く際、ユーザーは拡張子に応じて文書を表示または文書を編集オプションを提供されます。
  4. ポップアップが開き、/controllers/OpenController.phpコントローラのindexメソッドが呼び出されます。
  5. アプリは次のプロパティを持つJSONオブジェクトを準備します：
    • url - ONLYOFFICE Docsが文書をダウンロードするために使用するURL；
    • callbackUrl - ONLYOFFICE Docsが文書編集のステータスを通知するために使用するURL；
    • key - ONLYOFFICE Docsが文書を再度ダウンロードするかどうかを指示するランダムなMD5ハッシュ；
    • title - 文書のタイトル（名前）；
    • id - ユーザー識別；
    • name - ユーザー名。
  6. HumHubはこのオブジェクトを受け取り、views/open/index.phpテンプレートからページを構築し、クライアントブラウザがエディターを読み込めるようにすべての値を埋め込みます。
  7. クライアントブラウザはONLYOFFICE DocsのJavaScriptライブラリにリクエストを行い、上記のプロパティを持つDocEditor設定をONLYOFFICE Docsに送信します。
  8. その後、ONLYOFFICE DocsはHumHubから文書をダウンロードし、ユーザーは編集を開始します。
  9. ONLYOFFICE Docsは、ユーザーが文書を編集していることを知らせるためにcallbackUrlにPOSTリクエストを送信します。
  10. すべてのユーザーとクライアントブラウザが編集を終了し、編集ウィンドウを閉じます。
  11. 10秒の非アクティブ状態の後、ONLYOFFICE Docsはクライアントが文書の編集を終了し、閉じたことを知らせるためにcallbackUrlにPOSTを送信します。
  12. HumHubは文書の新しいバージョンをダウンロードし、古いものを置き換えます。
ONLYOFFICEとHumHubの統合用JWTの有効化

文書を不正アクセスから保護するために、ONLYOFFICEエディターはJSON Web Token（JWT）を使用します。トークンは、文書エディターが初期化される際と、内部ONLYOFFICE Docsサービス間でのコマンド交換時に設定に追加されます。シークレットキーは、JSON Web Tokenの署名とONLYOFFICE Docsへのリクエスト時のトークンの検証に使用されます。

ONLYOFFICE Docs v7.2以降、JWTはデフォルトで有効化されており、シークレットキーは自動的に生成されます。ONLYOFFICE Docs設定ファイルでシークレットキーを見つけ、コネクタ設定で同じシークレットキーを指定する必要があります。

ステップ1: ONLYOFFICE Docs設定ファイルでシークレットキーを見つける

  1. 任意のテキストエディターでlocal.jsonファイルを開きます。
    • Linuxの場合 - /etc/onlyoffice/documentserver/local.json
    • Windowsの場合 - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • Dockerの場合 – docker exec -it <containerID> bashコマンドを使用してONLYOFFICE Docsコンテナに入り、/etc/onlyoffice/documentserver/local.jsonを開きます。

      または、local.jsonを開かずにデフォルトのシークレットキーを見つけるために、次のコマンドを使用できます：

      sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

    local.jsonファイルは次のようになります：

    {"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}
  2. trueの値は3つのセクションで指定されています。これは、トークン検証が有効であることを意味します。
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. 自動生成されたシークレットキーは3つのセクションで指定されています。デフォルトのシークレット値を独自のシークレットキーに置き換えることができます。シークレットキーは3つのセクションで同じでなければなりません。
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
  4. 変更を加えた場合、それらを保存し、設定変更を反映させるためにサービスを再起動します。 
    supervisorctl restart all

ステップ2: コネクタ設定で同じシークレットキーを指定する

コネクタ設定で、シークレットキーフィールドに同じシークレットを指定し、設定を保存します。

HumHub内でONLYOFFICE Docsを使用開始

文書を作成するには：

  1. ファイルタブを開きます。
  2. ファイルを追加ボタンをクリックします。
  3. 文書を作成オプションをクリックします。
    ONLYOFFICE_create1ONLYOFFICE_create1
  4. 開いたウィンドウで、ファイルタイプを選択します：文書、スプレッドシート、またはプレゼンテーション。
    ONLYOFFICE_create2ONLYOFFICE_create2
  5. ファイル名を指定します。
  6. 次のステップで新しい文書を開くチェックボックスを選択して、文書の作業を開始します。
  7. 保存ボタンをクリックします。
    ONLYOFFICE_create3ONLYOFFICE_create3

文書を表示/編集するには：

  1. ファイルタブを開きます。
  2. 必要なファイルをクリックします。
  3. 開いたウィンドウで、文書を編集ボタンをクリックします。
    ONLYOFFICE_editviewONLYOFFICE_editview
最も一般的な問題とその解決方法について詳しく知りたい場合は、トラブルシューティングガイドをご覧ください。

ONLYOFFICE Docsを自社サーバーでホストするか、クラウドで利用する

今すぐ入手するクラウドで使う
次の項目が含まれている記事：タグ：
すべてのタグを見る