Moodle

主な機能

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

サポートされている形式

• 表示および編集用：DOCX、XLSX、PPTX、PDF
• 表示のみ：TXT、CSV
• フォーム記入用：PDF

バージョン6.1.0の新機能

追加

• 接続テスト用の設定に「接続を確認」ボタンを追加
• Document Server関連フィールドの管理者設定の検証
• 新しい言語テンプレートを追加：ca、cs、da、hu、id、ro、sq、ur

変更

• 入力の有効性のみをチェックするための管理者設定の検証ロジックを変更
• 更新後の設定URLから末尾のスラッシュを削除
• ファイル名変更の失敗を修正
• サポートされていないファイルのアップロードを修正
• 承認ブロッカーを修正：名前空間の衝突、スーパーグローバルの使用
• curlリクエストでの証明書検証の無効化を修正

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

要件

• ONLYOFFICE Docs（Document Server）6.1.0以上（サーバーまたはクラウドバージョン）

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

  ONLYOFFICE Docsのインストールについて詳しくは、公式のドキュメントページをご覧ください。
• Moodle v4.9以降
• Moodle v4.3.0用のONLYOFFICE Connector v4.4.0が使用されます。v4.3.0はMoodle v4 < 4.3.0用、v4.2.0はMoodle v3.9 - 3.11用です。

Moodleプラグインライブラリを使用したONLYOFFICEコネクタのインストール

1. 管理者としてMoodleインスタンスにログインし、サイト管理 > プラグイン > プラグインのインストールに移動します。
   この場所が見つからない場合、サイトでプラグインのインストールが無効になっています。
2. Moodleプラグインディレクトリからプラグインをインストールボタンをクリックします。
3. 現在のMoodleバージョンを選択します。
4. ONLYOFFICE文書プラグインを検索します。
5. インストールボタンをクリックし、続行をクリックします。
6. インストール要求を確認します。
7. プラグイン検証レポートを確認します。
   重要 Moodleバージョンを正しく選択してください。誤ったバージョンのプラグインをMoodleサーバーにダウンロードしてインストールすると、重大な問題を引き起こす可能性があります。

GitHub .ZIPアーカイブを使用したONLYOFFICEコネクタのインストール

1. GitHubページからコネクタをダウンロードします。
2. 管理者としてMoodleインスタンスにログインし、サイト管理セクションに移動し、プラグインタブに切り替え、プラグインのインストールリンクをクリックします。
3. ファイルピッカーを使用して、または対応するフィールドにドラッグアンドドロップしてmoodle-mod_onlyofficeeditor-x.x.x.zipファイルをアップロードし、ZIPファイルからプラグインをインストールボタンをクリックします。
   
4. プラグイン検証レポートを確認し、続行をクリックします。
   ターゲットディレクトリが書き込み可能でない場合、警告メッセージが表示されます。例：[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

5. 現在のリリース情報 -> サーバーチェックページで続行をクリックします。
6. プラグインチェックページでMoodleデータベースを今すぐアップグレードをクリックします。
   
7. 新しいバージョンへのアップグレードページで続行をクリックします。

Moodle Assign Submission ONLYOFFICE Integrationプラグインのインストール

1. 管理者としてMoodleインスタンスにログインし、サイト管理 > プラグイン > プラグインのインストールに移動します。
   この場所が見つからない場合、サイトでプラグインのインストールが無効になっています。
2. Moodleプラグインディレクトリからプラグインをインストールボタンをクリックします。
3. 現在のMoodleバージョンを選択します。
4. ONLYOFFICE Assign Submissionプラグインを検索します。
5. インストールボタンをクリックし、続行をクリックします。
6. インストール要求を確認します。
7. プラグイン検証レポートを確認します。
   重要 Moodleバージョンを正しく選択してください。誤ったバージョンのプラグインをMoodleサーバーにダウンロードしてインストールすると、重大な問題を引き起こす可能性があります。

または、GitHubページからプラグインをダウンロードし、ZIPファイルからインストールすることもできます。

動作方法

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

以下に、現在のドキュメントで使用される主な概念を説明します。

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

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

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

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

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

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

文書を不正アクセスから保護するために、ONLYOFFICEエディターはJSON Webトークン（JWT）を使用します。トークンは、Document Editorが初期化されるとき、および内部ONLYOFFICE Docsサービス間でのコマンド交換中に設定に追加されます。シークレットキーは、JSON Webトークンを署名し、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ファイルは次のようになります：

   {"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. 変更を加えた場合、変更を保存し、設定変更を反映させるためにサービスを再起動します。
   • Linuxの場合：

     sudo supervisorctl restart all

   • Dockerの場合：

     docker exec <containerID> supervisorctl restart all

     またはコンテナ全体を再起動します：

     docker restart <containerID>

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

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

ONLYOFFICEアクティビティの追加

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

1. マイコースセクションを開き、必要なコースに切り替えます。
2. 右上のスイッチを使用して編集モードを有効にします。
3. アクティビティまたはリソースを追加をクリックします。
4. ポップアップウィンドウでONLYOFFICE文書アクティビティを選択します。
   
5. アクティビティ名を入力し、必要な文書を作成、アップロード、またはPCからドラッグアンドドロップして保存して表示ボタンをクリックします。
   

   アクティビティは空の.docx、.xlsx、.pptxまたは.pdfファイルであることがあります。

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

ファイルの表示と編集

ONLYOFFICEアクティビティは、コースページ上でアイコンでマークされます。ONLYOFFICE Docsエディターでドキュメントを開くには、そのタイトルをクリックするだけです。

エディターをフルスクリーンモードで開くには、エディターウィンドウの右上にあるフルスクリーンで開くボタンをクリックします。

提出物の追加

ONLYOFFICE文書タイプのカスタム提出を.pdf形式で追加するには、

1. マイコースセクションを開き、必要なコースに切り替えます。
2. 右上のスイッチを使用して編集モードを有効にします。
3. アクティビティまたはリソースを追加をクリックします。
4. ポップアップウィンドウで課題アクティビティを選択します。
5. 提出タイプタブでONLYOFFICE文書タイプを選択します。完了すると、課題作成/編集ページでフォームクリエーター（.pdf）が利用可能になります。ここで、保存後に学生が記入できるフォームを作成できます。
6. コースに戻るまたは保存して表示をクリックします。作成された課題はコースセクションに表示されます。

フォームの記入

フォームを記入するには、

1. 作成された課題を選択し、提出を追加をクリックします。
   
2. フォームは.pdf形式で開かれます（Docs v8.0以降の場合。古いバージョンでは.oform形式が使用されます）。各学生は自分のpdfフォームのコピーを取得し、自分の課題に取り組みます。
3. フォームを記入し、変更を保存をクリックします。

教師はすべての提出を表示ボタンをクリックしてすべての課題を表示できます。

パスワードでファイルを保護する

ONLYOFFICEファイルは、無許可のアクセスを防ぐためにパスワードで保護することができます。その方法は次の通りです：

1. 上部ツールバーのファイルタブに移動します。
2. 保護オプションを選択します。
3. パスワードを追加ボタンをクリックします。
4. パスワードフィールドにパスワードを設定し、下のパスワードを再入力フィールドに再入力してからOKをクリックします。
   重要 パスワードは紛失または忘れた場合、復元できません。安全な場所に保管してください。

パスワードを変更するには、

1. 上部ツールバーのファイルタブに移動します。
2. 保護オプションを選択します。
3. パスワードを変更ボタンをクリックします。
4. パスワードフィールドにパスワードを設定し、下のパスワードを再入力フィールドに再入力してからOKをクリックします。

パスワードを削除するには、

1. 上部ツールバーのファイルタブに移動します。
2. 保護オプションを選択します。
3. パスワードを削除ボタンをクリックします。

保護オプションを無効にするには、

1. アクティビティ編集ページに移動します。
2. ドキュメントの権限セクションを開きます。
3. 保護タブを非表示ボックスをチェックします。

権限の管理

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

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

1. 必要なONLYOFFICE文書を開きます。
2. その他 > 権限に移動します。
3. ONLYOFFICE文書アクティビティを編集/ONLYOFFICE文書アクティビティを表示エントリを見つけます。
4. 禁止セクションに必要な役割を追加するか、権限を持つ役割セクションから役割を削除します。