SuiteCRM

主な機能

• テキスト文書、スプレッドシート、プレゼンテーションの編集と閲覧。
• リアルタイムでの共同編集：2つの共同編集モード（高速モードと厳密モード）、変更履歴モード、コメント、内蔵チャット。
• フォームテンプレートの作成と編集。
  フォームについて詳しくは、作成および記入に関する記事をご覧ください。
• JWTサポートにより、適切な権限を持つユーザー以外が文書にアクセスできないようにトラフィックを保護します。

対応フォーマット

• 編集と閲覧用：DOCX、XLSX、PPTX。
• 閲覧のみ：PDF、ODT、ODS、ODP、DOC、XLS、PPT、PPS、EPUB、RTF、HTML、HTM、TXT、CSV。

要件

• ONLYOFFICE Document Server v7.1（サーバー）以降

  ONLYOFFICE Docsのインスタンスが必要です。これはSuiteCRMおよび任意のエンドクライアントから解決可能で接続可能である必要があります。また、SuiteCRMに直接POSTできる必要があります。

  ONLYOFFICE Docsのインストールについて詳しくは、公式のドキュメントページをご覧ください。
• SuiteCRM 7（すべての7.xリリース）
• SuiteCRM用ONLYOFFICEコネクタ v1.0.0以降

SuiteCRM用ONLYOFFICE統合モジュールのインストール

ONLYOFFICEアプリケーションをインストールするには：

1. ONLYOFFICE統合プラグインの最新のコンパイル済みパッケージファイルをGitHubページから取得します。
2. SuiteCRMを起動し、管理 > 管理ツール > モジュールローダーに移動します。
   
3. ONLYOFFICEプラグインのアーカイブをアップロードします。
4. インストールボタンを押してアップロードされたモジュールをインストールします。
5. 管理 > 管理ツール > 修復に移動します。
6. クイック修復と再構築を実行します。
   

動作の仕組み

ユーザーと文書のやり取りは、クライアント側とサーバー側の両方で行われます。

以下は、このドキュメント全体で使用される主要な用語の説明です。

クライアント側には以下が含まれます：

• 文書マネージャー - ユーザーのブラウザに表示される文書のリストで、ユーザーが必要な文書を選択し、いくつかの操作を行うことができます（提供された権限に応じて、文書を開いて表示したり、編集したり、他のユーザーと共有したりできます）。
• 文書エディター - 文書の表示と編集のインターフェースで、最もよく知られている文書編集機能がすべて利用可能で、ユーザーと文書編集サービスの間の媒介として使用されます。

サーバー側には以下が含まれます：

• 文書ストレージサービス - 適切なアクセス権を持つユーザーが利用できるすべての文書を保存するサーバーサービスです。文書IDとこれらの文書へのリンクを文書マネージャーに提供し、ユーザーがブラウザで確認できます。
• 文書編集サービス - 文書の表示と編集を行うサーバーサービスです（ユーザーがそれを行う適切な権限を持っている場合）。文書エディターインターフェースを使用して、すべての文書編集サービス機能にアクセスします。
• 文書コマンドサービス - 文書編集サービスで追加のコマンドを実行するサーバーサービスです。
• 文書変換サービス - 文書ファイルを適切なOffice Open XML形式（テキスト文書用のdocx、スプレッドシート用のxlsx、プレゼンテーション用のpptx）に変換して編集またはダウンロードするサーバーサービスです。
• 文書ビルダーサービス - 実際に文書処理エディターを実行することなく、簡単に文書を作成するサーバーサービスです。

ONLYOFFICE Document Serverには、文書エディター、文書編集サービス、文書コマンドサービス、文書変換サービス、文書ビルダーサービスが含まれています。文書マネージャーと文書ストレージサービスは、コミュニティサーバーに含まれているか、ONLYOFFICE Document Serverを独自のサーバーで使用するソフトウェアインテグレーターによって実装される必要があります。

ONLYOFFICEとSuiteCRMの統合用JWTの設定

JWTまたはJSON Web Tokenは、クライアントの正当性を検証するためにクライアントからサーバーに送信される文字列です。JWTはクライアント側にのみ保存されるため、当事者間の通信は保護され、デジタル署名されています。

トークンはJWT（JSON Web Tokens）標準を使用して生成されます。トークンはサーバーのキーで署名されているため、クライアントはトークンが正当であることを確認できます。

ONLYOFFICE Docsはトークンを検証します。ペイロードからのデータは有効と見なされ、メインパラメータの対応するデータの代わりに使用されます。トークンが無効な場合、コマンドは実行されません。詳しくは、APIセキュリティガイドをご覧ください。

ONLYOFFICE Docsでは、バージョン7.2以降、JWTがデフォルトで有効になっています。

必要に応じて手動で設定するには、以下の手順に従ってください：

1. 管理 > ONLYOFFICE > ONLYOFFICE設定に移動します。
   
2. 次のフィールドに値を入力します：
   • 文書編集サービスアドレス：ONLYOFFICE DocsがインストールされているURLアドレスを指定します（例：https://documentserver）。
   • シークレットキー（無効にするには空白のままにする）：シークレットキーは自動的に生成され、ONLYOFFICE Docsへのアクセスを制限します。このフィールドに独自のシークレットキーを指定する場合は、ONLYOFFICE Docsの設定ファイルにも同じシークレットキーを指定して検証を有効にします。
   • 認証ヘッダー（デフォルトのヘッダーを使用するには空白のままにする）：ONLYOFFICEで使用される標準のJWTヘッダーはAuthorizationです。このヘッダーが設定と競合する場合は、カスタムヘッダーに変更できます。