ONLYOFFICE DocsとMoodleの連携方法について

## ONLYOFFICEとMoodleの連携について

ONLYOFFICEでは、[ONLYOFFICE Docs](https://www.onlyoffice.com/ja/download-docs.aspx)とMoodleを連携させ、コースページに添付されたオフィスドキュメントを編集するための公式コネクタを提供しています。ONLYOFFICEコネクタは、[Moodleのプラグインライブラリ](https://moodle.org/plugins/mod_onlyofficeeditor)または[GitHubのページ](https://github.com/ONLYOFFICE/onlyoffice-moodle)からダウンロードできます。

### 主な機能

* テキスト文書、スプレッドシート、スライドの編集と閲覧
* リアルタイムでのドキュメントの共同編集：2つの共同編集モード（高速と厳格）、変更履歴モード、コメント、ビルトインチャット
* JWTのサポートにより、適切な権限を持つユーザー以外がドキュメントにアクセスできないように、トラフィックの保護

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

* 閲覧・編集用：docx、xlsx、pptx、txt、csv
* 閲覧のみ：PDF
* Office Open XML形式への変換用：odt, ods, odp, doc, xls, ppt, pps, epub, rtf, html, htm


### バージョン2.1.0での新機能

追加したこと：

* バックアップAPI
* プライバシーAPI

変更点：

* マーケットコードプレチェックに基づく修正

変更履歴は[こちら](https://github.com/ONLYOFFICE/onlyoffice-moodle/blob/master/CHANGELOG.md)でご覧いただけます。

## ONLYOFFICE DocsとMoodleを連携させる方法

### 動作環境

* ONLYOFFICE Docs（ドキュメントサーバ）4.2.7以上

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

:::note warn
ONLYOFFICE Docsのインストールについての詳細は、[公式ドキュメントのページ](https://helpcenter.onlyoffice.com/installation/docs-index.aspx)をご参照ください。
:::

* Moodle v3.9.10以降
* Moodle用ONLYOFFICEコネクタv2.1.0

### Moodle用ONLYOFFICEコネクタのインストール

#### Moodleプラグインライブラリを使用する

１．Moodleインスタンスに管理者としてログインし、「**サイト管理**」 > 「**プラグイン**」 > 「**プラグインのインストール**」に移動してください。

:::note warn
「プラグイン」を見つけられない場合、サイトではプラグインのインストールが無効になっています。
:::

２．「**Moodleプラグインディレクトリからプラグインをインストール**」ボタンをクリックしてください。
３．現在の[Moodleバージョン](https://docs.moodle.org/311/en/Moodle_version)を選択してください。
４．**ONLYOFFICEドキュメント**プラグインを検索してください。
５．**インストール**ボタンをクリックし、「**次へ**」をクリックしてください。
６．インストール要求を確認してください。
７．プラグイン検証レポートを確認します。

:::note warn
[Moodleバージョン](https://docs.moodle.org/311/en/Moodle_version)を正しく選択することは、非常に重要です。もし、Moodleサーバに間違ったバージョンのプラグインをダウンロードおよびインストールした場合、いくつかの深刻な問題につながる可能性があり、Moodleサイトが凍結することさえあります。
:::

#### GitHubの.ZIPアーカイブを使用する

１．[GitHubページ](https://github.com/ONLYOFFICE/onlyoffice-moodle/releases)からコネクタをダウンロードします。
２．Moodleインスタンスに管理者としてログインし、**サイト管理**セクションに移動し、**プラグイン**タブに切り替えて、**プラグインのインストール**リンクをクリックします。
３．ファイルピッカー経由で*onlyoffice-moodle-master.zip*ファイルをアップロードするか、対応するフィールドにドラッグ＆ドロップして、「**ZIPファイルからプラグインをインストールする**」ボタンをクリックしてください。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/1267afc8-b50b-790d-b9fc-137f0575adfa.png)


４．プラグイン検証レポートを確認し、「**次へ**」をクリックします。

```diff_ruby
# 目的のディレクトリが書き込み可能でない場合、[Error] Write access check [/var/www/html/moodle/mod] のような警告メッセージが表示されます。この場合、以下のコマンドで一時的に書き込み可能な状態にすることができます。

sudo chmod -R 777 /var/www/html/moodle

# その後、手順3を繰り返してください。

#プラグインをインストールした後、ディレクトリが書き込み可能にならないように、パーミッションを元に戻す必要があります。以下のコマンドを使用します。

sudo chmod -R 0755 /var/www/html/moodle
```

５．**現在のリリース情報** → **サーバチェックページ**で、「**次へ**」をクリックします。

６．**プラグインのチェック**ページで、**今すぐMoodleデータベースをアップグレードする**をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/93dd1d7d-d1ab-db99-f6e6-512a6d011f2a.png)

７．**新しいバージョンにアップグレードする**ページで「**次へ**」をクリックします。

### Moodle用ONLYOFFICEコネクタを設定する

プラグインをインストールすると、プラグイン設定ページが表示されます。または、**プラグイン概要**ページで**ONLYOFFICEドキュメント**を見つけ、「**設定**」をクリックすることもできます。**設定ページ**では、以下のパラメータを設定することができます。

* **文書編集サービスのアドレス**フィールドに、Moodleから文書編集サービスにアクセスするために使用するアドレスを入力してください。このフィールドは必須です。
* 必要に応じて、「**ドキュメントサーバーシークレット**」フィールドにデータ署名に使用するシークレットを指定します。このシクレットキーは、ドキュメントサーバへのリクエスト時に、JSONウェブトークンを検証するために使用されます。詳細については、ONLYOFFICE Docs側でJWTを設定するための[APIドキュメント](https://api.onlyoffice.com/editors/signature/)を確認してください。

準備ができたら、「**変更を保存**」をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/bfbd1b05-b211-903d-c9a8-1b8106dff27a.png)

## MoodleでONLYOFFICE Docsの利用を開始する

### ONLYOFFICEアクティビティを追加する

新しいONLYOFFICEアクティビティを作成するには：

１．「**マイコース**」セクションを開き、必要なコースに切り替えてください。
２．右上のスイッチャを使用して、**編集モード**を有効にします。
３．**アクティビティまたはリソース**を追加するをクリックします。
４．ポップアップウィンドウで**ONLYOFFICEドキュメント**アクティビティを選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/9ecda078-138d-3f91-72c7-2f137f063970.png)

５．アクティビティ名を入力し、必要なドキュメントをPCからアップロードまたはドラッグ＆ドロップして、「**保存して表示**」ボタンをクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/9e93f2d1-a0dd-fb94-af08-c4c9d4236200.png)

ONLYOFFICE Docsのエディタでドキュメントが開かれます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/b58bfb66-ca62-7104-922f-7d269979b539.png)

### ファイルの表示と編集

ONLYOFFICEアクティビティは、あなたのコースページに![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/9d7b2cac-b647-fb37-e288-8c986604b320.png)アイコンが表示されます。ONLYOFFICE Docsのエディタでドキュメントを開くには、そのタイトルをクリックするだけです。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/c6dda902-6f93-81e0-79cf-92cc12e1fe10.png)

### アクセス権の管理

管理者/教師は、ONLYOFFICEエディタ内からドキュメントをダウンロードまたは印刷することができるかどうかを選択することができます。これは、**ドキュメントの許可**セクションで行うことができます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/1bf5d479-1cf8-a8e1-f0d0-9f122273d5b5.png)

ドキュメントの権限を読み取り専用に変更するには：

１．必要なONLYOFFICEドキュメントを開く。
２．「**詳細情報**」->「**許可**」に進みます。
３．[[**onlyoffice:editdocument**]]のエントリを見つけます。
４．「**禁止**」 セクションに必要なロールを追加するか、「**権限を持つ役割**]」セクションからロールを削除します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/fce9f477-12db-0296-372a-c3a7bc4e4398.png)