ONLYOFFICE Document Serverで文書を保存するまでの流れを参考図と以下の手順で説明します。
ファイルを開く
1.ユーザーは、ドキュメントエディターでドキュメントを編集する。
2.ドキュメントエディターは、ドキュメント編集サービスに変更内容を送信します。
3.ユーザーは、ドキュメントエディターを閉じます。
4.文書編集サービスは、文書編集作業の終了を見届け、文書編集者から送られてきた変更内容を1つの文書にまとめます。
5.文書編集サービスは、JavaScript APIのcallbackUrlを使用して、文書編集の終了を文書保管サービスに通知し、変更した文書へのリンクを返します。
なお、バージョン5.5以降では、リクエストのステータスに応じてcallbackUrlが選択されます。バージョン4.4からバージョン5.5までは、共同編集に参加した最後のユーザーからcallbackUrlが使用されます。バージョン4.4以前では、共同編集の場合、最初に編集用のファイルを開いたユーザーからcallbackUrlが使用されます。
6.文書保管サービスは、文書編集サービスから保存されたすべての変更点を含む文書ファイルをダウンロードし、保管します。
実際にどのようにできるのか
1.文書編集サービスから文書を保存するためのコールバックハンドラを作成する。
2.ドキュメントを開くためのhtmlファイルを作成する。
3.ドキュメントエディター初期化用設定スクリプトのパラメータ行に、コールバックハンドラーを持つファイルのURLを指定します。
new DocsAPI.DocEditor("placeholder", {
"document": {
"fileType": "docx",
"key": "Khirz6zTPdfd7",
"title": "Example Document Title.docx",
"url": "https://example.com/url-to-example-document.docx"
},
"documentType": "word",
"editorConfig": {
"callbackUrl": "https://example.com/url-to-callback.ashx"
}
});
ここで、example.comは、ドキュメントマネージャーとドキュメントストレージサービスがインストールされているサーバーの名前です。
4.ブラウザでhtmlファイルを開き、ドキュメントを編集します。
5.ドキュメントエディターを閉じます。約10秒後にあなたのドキュメントをチェックしてください。すべての変更が保存され、構成が正しいことを意味します。
保存遅延
文書編集が終了すると、文書編集サービスから文書保管サービスにその旨が通知される。その時間は、編集したファイルをOffice Open XML形式に変換する時間(ファイルの大きさ、複雑さ、コンピュータのパワーに依存し、かなり長い時間がかかる)と、変換開始遅延時間(デフォルトでは5秒に等しい)を使って計算します。一般的なケースでは、編集終了後10秒程度となります。
変換開始遅延時間は、ファイルを保存せずに編集セッションに戻るために必要です(例えば、編集のためにファイルを開いたブラウザページを再読み込みする場合など)。デフォルトの変換開始遅延時間は、Document Server設定ファイルのservices.CoAuthoring.server.savetimeoutdelayパラメータで定義されます(以下のパスにあります):
Linuxの場合 - /etc/onlyoffice/documentserver/default.json
Windowsの場合 - %ProgramFiles%ONLYOFFICE}DocumentServer}config}default.json
変更したい場合は、編集したすべてのパラメータを格納する必要があるlocal.jsonファイルを使用することができます。このファイルはdefault.jsonファイルと同じディレクトリにあり、必要なパラメーターのオブジェクト構造全体を保持する必要があります(以下の例を参照)。
default.jsonファイルの内容を直接編集しないでください。Dockerコンテナを再起動したり、Document Serverを新しいバージョンにアップグレードしたりするたびにデフォルト値が復元され、変更内容がすべて失われてしまいます。
フォースセービング
文書編集サービスでは、編集が終了する前に現在の文書の状態を取得することができます。ONLYOFFICE Document Serverでは、この処理をforceaveと呼んでいます。forceaveが開始されると、ドキュメント編集サービスは、urlパラメータにドキュメントへのリンクを、statusパラメータに6の値を指定して、コールバックハンドラへのリクエストを実行します。forceaveプロセスは、以下の方法で開始することができます:
- cパラメータにforceave値を指定したドキュメントコマンドサービスへのリクエストによって。コールバックハンドラへリクエストを送信する際、forceavetypeパラメータは0を持ちます。
- エディター初期化設定において、editorConfig.customization.formsaveモードをtrueに設定し、有効化する。この場合、ユーザーが保存ボタンをクリックするたびに、強制保存が行われ、コールバックハンドラへのリクエストを送信する際に、forceavetyパラメータは1の値を持ちます。
- ドキュメントサーバーの追加設定ファイルで、forceaveの繰り返し起動を有効にすることができます。この設定ファイルは、次の場所で見つけるか(すでに作成している場合)、次のパスに配置します:
Linuxの場合 - /etc/onlyoffice/documentserver/local.json.
Windowsの場合 - %ProgramFiles%ONLYOFFICE}DocumentServer}config}local.json.
オリジナルフォーマットでの保存
バージョン7.0から、アセンブルしたファイルを元の形式で保存するために、assemblyFormatAsOriginサーバーの設定がデフォルトで有効になっています。ファイル形式をOOXMLからODFに変更する場合や、マクロを含むファイルを保存する場合に使用されます。