Drupal

主な機能

• テキスト文書、スプレッドシート、プレゼンテーション、PDFフォームの編集と表示。
• リアルタイムでの共同編集：2つの共同編集モード（高速と厳密）、変更履歴モード、コメント、組み込みチャット。
• 適切な権限を持つユーザー以外がドキュメントにアクセスできないようにするJWTサポート。
• 公開ページでのファイルプレビュー。

対応フォーマット

• 編集可能：DOCX、XLSX、PPTX、PDFフォーム。
• 表示のみ：DJVU、DOC、DOCM、DOT、DOTM、DOTX、EPUB、FB2、FODT、HTML、MHT、ODT、OTT、OXPS、PDF、RTF、TXT、XPS、XML、CSV、FODS、ODS、OTS、XLS、XLSM、XLT、XLTM、XLTX、FODP、ODP、OTP、POT、POTM、POTX、PPS、PPSM、PPSX、PPT、PPTM。

要件

• ONLYOFFICE Docs (Document Server) v7.1以降。

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

  ONLYOFFICE Docsのインストールについて詳しくは、公式ドキュメントページをご覧ください。
• Drupalコアモジュール10以上。
• firebase/php-jwt: 6.0.0以上。
• Drupal用ONLYOFFICEコネクタ

Drupalユーザーインターフェースを通じてインストール

1. drupal.orgのAdminツールバープロジェクトページで、ページ下部のReleasesセクションまでスクロールします。View all releasesリンクをクリックします。
2. リストから必要なバージョンを選択します。
3. tar.gzリンクのアドレスをコピーします。デバイスやブラウザによっては、右クリックしてリンクアドレスをコピーを選択することで行うことができます。
4. Manage管理メニューでExtend（admin/modules）に移動します。Extendページが表示されます。
5. Add new moduleボタンをクリックします。Add new moduleページが表示されます。
   
6. コピーしたダウンロードリンクをAdd from a URLフィールドに貼り付けます。
   
7. Installをクリックして新しいモジュールをサーバーにアップロードし、解凍します。ファイルはモジュールディレクトリにダウンロードされます。
8. ローカリゼーション設定を適用するには、次のコマンドを実行してください：

   drush locale-check

   drush locale-update

Composerを通じてインストール

Drupalサイトのルートで次のコマンドを入力します：

composer require onlyoffice/onlyoffice-drupal

インストールディレクトリがweb/modules/contrib/drupalの場合、ローカリゼーション設定を適用するために次のコマンドを実行してください：

drush locale-check

drush locale-update

Drupalユーザーインターフェースを通じてONLYOFFICE統合モジュールを有効化する

1. Manage管理メニューを通じてExtendページ（admin/modules）を開きます。
2. ONLYOFFICE Connector moduleを見つけて、対応するボックスにチェックを入れます。
   
3. Installをクリックしてモジュールを有効化します。

コマンドラインを通じてONLYOFFICE統合モジュールを有効化する

1. プロジェクト名をパラメータとして次のDrushコマンドを実行します：

   drush pm:enable onlyoffice

2. ウィザードの指示に従ってください。

動作の仕組み

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

現在のドキュメント全体で使用される主な概念は以下に説明されています。

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

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

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

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

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

ONLYOFFICEとDrupalの統合のためのJWTの有効化

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

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

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

DrupalでJWTを使用してドキュメントを保護するには、ONLYOFFICEセクションの管理設定を持つ~/config/system/onlyoffice-settingsページを開きます。または、次の手順に従ってください：

1. Manage管理メニューを通じてExtendページ（admin/modules）を開きます。
2. ONLYOFFICE Connector moduleの説明にある矢印をクリックしてドロップダウンリストを開きます。
3. Configureオプションを選択します。
4. Secret keyフィールドにシークレットキーを入力します。
   
5. ONLYOFFICE Document Serverの設定ファイルで同じシークレットキーを指定し、検証を有効にします。

ファイルをDrupalにアップロードする

1. Manage > Contentに移動します。
2. Add contentボタンをクリックします。
3. 必要なコンテンツタイプをクリックします。
4. タイトル、言語、本文を入力し、テキスト形式を設定します。
5. Add a new fileフィールドでBrowseボタンをクリックし、PCのハードドライブからファイルを選択します。
6. Publishedボックスをチェックまたはチェックを外します。
7. Saveボタンをクリックします。

Drupalでのファイルの表示、編集、管理

1. Manage > Contentに移動します。
2. 画面上部のMediaタブに切り替えます。
3. リストから必要なファイルを見つけるか、上部の検索フィールドを使用します。
4. Operations列の矢印をクリックして、ファイルのプロパティをEditするか、Edit in ONLYOFFICEするか、ファイルをDeleteするかを選択します。
   

投稿へのファイルの追加

投稿を作成する際に、新しいONLYOFFICE要素を追加できます。

1. Structure > Content types > 必要なコンテンツフィールドの横にあるManage fieldsをクリックします。開いたページでAdd fieldをクリックします。新しいフィールドを追加します：General、Number、Reference、またはText。ラベルを設定して保存します。
   
2. 追加したFileフィールドに対してファイル拡張子を指定します。Structure > Content types > Manage fieldsに移動するか、開いたページにとどまります。Allowed file extensionsフィールドで、エディターに表示されるファイル形式を指定します（docx、xlsx、pptx）。
   
3. 追加したMediaフィールドに対して、Documentチェックボックスをクリックします。
   
4. Structure > Media types > Document > ドロップダウンリストを開いてManage displayオプションを選択します。
   
5. Documentフィールドに対して、ONLYOFFICE Preview形式を指定します。ギアシンボルをクリックすると、埋め込みエディターウィンドウのサイズを指定できます。
   

   プリセットが完了したら、Contentタブで投稿を作成できます。Add contentボタンをクリックし、作成したコンテンツを選択します。

   

1. タイトルを指定し、ファイルを選択します（コンテンツにFileフィールドが含まれている場合）。
2. Mediaセクションに、以前にアップロードしたファイルの名前を指定します。
3. サイト訪問者は、作成されたページを表示することもできます（People > Permissions > View published content）。

PDFフォームの操作

PDFフォームの作成/アップロード

1. Manage → Content → ONLYOFFICE formに移動します。
2. Create&Uploadボタンをクリックします。
3. Create form fromドロップダウンメニューからBlankオプションを選択し、新しいファイルを作成するためにファイルnameを対応するフィールドに入力します。
4. 既存のPDFファイルをアップロードするには、Create form fromドロップダウンメニューからUploadオプションを選択します。
5. ファイルはPDF Formsページで利用可能になります。

PDFフォームの公開

事前設定

1. Manage → Structure → Content typeに移動します。
2. 必要なコンテンツタイプの近くにあるManage fieldsオプションを選択します。
3. 新しく開いたManage fieldsページの左上隅にあるCreate a new fieldボタンをクリックします。
4. ONLYOFFICE formオプションを選択します。
5. Labelフィールドに必要な名前を入力します。
6. ステップ2で以前に選択したコンテンツタイプには、ONLYOFFICEフォームタイプが割り当てられています。

公開

1. Manage → Content → Contentに移動します。
2. 左上隅にあるAdd contentボタンをクリックします。
3. 以前にONLYOFFICE formタイプを割り当てたコンテンツタイプを選択します。
4. 作成したフォームの名前をONLYOFFICE formフィールドに入力します。以前に作成されたフォームがない場合は、Create new ONLYOFFICE formボタンをクリックします。
5. Saveボタンをクリックして、Drupalにフォームページを作成します。

PDFフォームの記入

1. フォームフィールドに入力します。
2. 上部ツールバーのComplete&Submitボタンをクリックします。
3. 記入済みフォームのコピーをダウンロードできます。右上隅の⋮ボタンをクリックし、.docxまたは.pdfファイルとしてダウンロードするかを選択します。

フォームの記入について詳しくは、以下のガイドを参照してください。

記入済みフォームの操作

1. Manage → Content → ONLYOFFICE form → Submitted formsに移動します。
2. すべての記入済みフォームはテンプレート名でグループ化されています。テンプレート名をクリックして、関連するすべてのフォームを表示します。
3. フォームを表示、ダウンロード、または削除できます。