ONLYOFFICE DocsとDrupalを連携させる方法

## Drupal について

[Drupal](https://www.drupal.org)は、PHPで書かれた無料でオープンソースのWebコンテンツ管理システム（CMS）です。個人ブログから企業、政治、行政のサイトまで、世界のトップ10,000ウェブサイトの少なくとも14%、トップ10百万ウェブサイトの1.2%にバックエンドフレームワークを提供しています。また、ナレッジマネジメントやビジネスコラボレーションにもDrupalが使用されています。

Drupalは開発者向けに洗練されたAPIを提供していますが、基本的なウェブサイトのインストールやフレームワークの管理には、プログラミングのスキルは必要ありません。Drupalは、PHPを実行できるWebサーバーと、コンテンツや設定を保存するためのデータベースの両方をサポートするあらゆるコンピュータプラットフォーム上で動作します。

## ONLYOFFICEのコネクタについて

ONLYOFFICEモジュールは、Document Server のコミュニティまたはエンタープライズ版としてパッケージされたONLYOFFICE Docsを使って、DrupalからMediaモジュールのファイルを編集することを可能にします。

このモジュールでは、以下のことが可能です。

* テキスト文書、スプレッドシート、スライドの編集
* 公開ページでのファイルのプレビュー
* 2つの共同編集モード（リアルタイムと段落ロック）を使用したドキュメント上でのコラボレーションする

サポートされているフォーマット：

* 編集用：docx, xlsx, pptx
* 閲覧のみ：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

このモジュールの詳細については、プロジェクトページをご覧ください: https://www.drupal.org/project/onlyoffice

バグレポートや機能提案を提出したり、変更点を追跡するには: https://www.drupal.org/project/issues/onlyoffice . また、ONLYOFFICEチームへのお問い合わせは、forum.onlyoffice.comで受け付けています。

## インストール方法

**ステップ1**：モジュールの追加

１番目の方法は、[Drupalのユーザーインターフェイス](https://www.drupal.org/docs/extending-drupal/installing-modules#s-add-a-module-using-drupals-user-interface-easy)を使ってモジュールを追加します（簡単）：

１．drupal.orgのアドミンツールバーの[プロジェクトページ](https://www.drupal.org/project)で、ページ下部のダウンロードセクションまでスクロールします。
２．`tar.gz`のリンクのアドレスをコピーしてください。お使いのデバイスやブラウザによっては、右クリックして「**リンクのアドレスをコピー**」を選択することでこれを行うことができます。
３．管理メニューで、「**Extend**」（admin/modules）に移動します。「Extend」ページが表示されます。
４．「**Install new module**」をクリックします。新しいモジュールのインストールページが表示されます。
５．「**Install from a URL**」フィールドに、コピーしたダウンロードリンクを貼り付けます。
６．**Install**をクリックすると、新しいモジュールがサーバーにアップロードされ、解凍されます。ファイルはモジュールディレクトリにダウンロードされます。

２番目の方法は、 [Composer](https://www.drupal.org/docs/extending-drupal/installing-modules#s-add-a-module-with-composer)でモジュールを追加します。

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

```
composer require drupal/onlyoffice
```

**ステップ2**：モジュールを有効にする

１番目の方法は、Drupalのユーザーインターフェイスを使用します（簡単）：

１．管理メニューからExtendページ(admin/modules)に移動します。
２．ONLYOFFICE Connectorモジュールを探し、ボックスにチェックを入れます。
３．インストールをクリックして、有効にします。

２番目の方法は、コマンドラインを使用します（高度ですが、非常に効率的です）：

１．以下のDrushコマンドを実行し、パラメータとしてプロジェクト名を指定します。
```
drush pm:enable onlyoffice
```
２．画面に表示される指示に従います。

## 設定方法

Drupal で、ONLYOFFICE セクションの管理設定がある `~/config/system/onlyoffice-settings` ページを開きます。ONLYOFFICE ドキュメントサーバに接続するためのアドレスを入力します。
```
https://<documentserver>/
```
ここで、documentserverはONLYOFFICE Document Serverがインストールされているサーバーの名前です。このアドレスは、ユーザーのブラウザとDrupalサーバーからアクセス可能である必要があります。また、Drupalサーバのアドレスは、ONLYOFFICE Document Serverからアクセス可能でなければ、正しく動作しません。

ONLYOFFICE Document Serverへのアクセスを制限するため、またセキュリティ上の理由やデータの整合性を保つために、暗号化された署名を使用します。Drupalの管理者設定でシークレットキーを指定します。ONLYOFFICE Document Server の[設定ファイル](https://api.onlyoffice.com/editors/signature/)に、同じ秘密鍵を指定し、検証を有効にします。

## 使用方法

### Drupalにアップロード済みのファイルを編集する

Mediaに追加されたすべてのオフィスファイルは編集のために開くことができます。最後のテーブルの列で、ドロップダウンリストをクリックし、ONLYOFFICEで編集するアクションを選択します。エディターが同じタブで開きます。管理者権限を持つユーザーは、ONLYOFFICE Docsを使用してファイルを共同編集することができます。すべての変更は、同じファイルに保存されます。

### 新規投稿の作成

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

１．「構造」→「コンテンツタイプ」→「フィールドの管理」と進みます。開いたページで、「フィールドを追加」をクリックします。ファイルまたはメディアの新しいフィールドを追加します。ラベルを設定し、保存します。

２．追加された「ファイル」フィールドには、ファイルの拡張子を指定します。「構造」→「コンテンツタイプ」→「フィールドの管理」に進みます。「許可されたファイル拡張子]フィールドで、エディタに表示されるファイル形式を指定します（docx,xlsx,pptx）。

「追加されたメディア]フィールドで、「ドキュメント」チェックボックスをクリックします。

３．「構造」→「メディアタイプ」→「ドキュメント」→「表示の管理」と進みます。

「ドキュメント」フィールドに、ONLYOFFICEプレビュー形式を指定します。歯車マークをクリックすると、埋め込まれたエディタウィンドウの寸法を指定することができます。

事前設定が終わったら、「コンテンツ」タブで記事を作成します。コンテンツ追加ボタンをクリックし、作成したコンテンツを選択します。

タイトルを指定し、ファイルを選択します（コンテンツにFileフィールドが含まれる場合）。

メディアセクションには、以前にアップロードしたファイルの名前を指定します。

サイトの訪問者も作成されたページを見ることができます（「人」→「権限」→「公開されたコンテンツを見る」）。

## ONLYOFFICE Docsのインストール

Drupalとエンドクライアントの両方から解決および接続可能なONLYOFFICE Docsのインスタンス（ドキュメントサーバ）が必要です。ONLYOFFICEドキュメントサーバは、Drupalに直接POSTできる必要があります。

ONLYOFFICE Docsは、無償のCommunity版とスケーラブルなEnterprise版をインストールすることができます。

無料のCommunity版をインストールするには、[Docker](https://github.com/onlyoffice/Docker-DocumentServer)を使用するか（推奨）、Debian、Ubuntu、または派生製品の場合は[この指示](https://helpcenter.onlyoffice.com/installation/docs-community-install-ubuntu.aspx)に従います。

Enterprise Editionをインストールするには、[こちらの手順](https://helpcenter.onlyoffice.com/installation/docs-enterprise-index.aspx)に従ってください。

ONLYOFFICE Docsは、Document Serverとしてパッケージ化されています。

コミュニティ版（`onlyoffice-documentserver` パッケージ）
エンタープライズ版（`onlyoffice-documentserver-ee`パッケージ）