開発者向けONLYOFFICE Docs 8.0:APIとDoc Builderのアップデート
バージョン8.0の新機能リリースに伴い、エディタ、ドキュメントビルダー、プラグインのAPIを更新しました。詳細は以下をご覧ください。
PDFのサポート
documentTypeパラメータにpdfドキュメントタイプを追加しました。これは、記入可能なフィールドを含むPDFファイル*が完全にサポートされ、ONLYOFFICE PDFエディタで注釈や記入のために開くことができるようになったことを意味します。以前はそのようなファイルはドキュメントとして認識され、ドキュメントエディタで開かれていました。
var docEditor = new DocsAPI.DocEditor("placeholder", {
"documentType": "pdf",
*DjVu、OXPS、XPSにも対応しています。
フォームを操作するためのAPI
コールバックハンドラに追加された formsdataurl パラメータにより、送信されたフォームデータを含む JSON ファイルの URL を定義できます。このファイルには以下のパラメータが含まれます:
- キー
- タグ
- 値
- タイプ (text、checkBox、picture、comboBox、dropDownList、dateTime、radio)
さらに、DocBuilder API には新しいフォーム・メソッドがあります:
- ApiDocument/GetFormsData:現在のドキュメントに存在するすべてのフォームのデータを返します;
- ApiDocument/SetFormsData: 指定されたフォームにデータを設定します。
builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oParagraph1 = oDocument.GetElement(0);
var oCheckBox = Api.CreateCheckBoxForm({"key": "BestCompany"});
oParagraph1.Push(oCheckBox);
var oTextForm = Api.CreateTextForm({"key": "CompanyName"});
oParagraph1.Push(oTextForm);
oDocument.SetFormsData([
{"key": "BestCompany", "value": true},
{"key": "CompanyName", "value": "ONLYOFFICE"}
]);
builder.SaveFile("docx", "SetFormsData.docx");
builder.CloseFile();
WOPIサポートの強化
最新リリースでは、ブラウザからサーバへのリクエストに追加されるWOPISrcクエリパラメータが追加されました。これにより、ONLYOFFICEの複数の独立したインスタンスを作成することができます。WOPISrc
によるロードバランシングリクエストは、共同編集が正しく機能することを保証します:同じドキュメントを編集している全てのユーザーは、同じサーバーからサービスを受けます。
WOPIについては、インテグレータから送信されたパラメータが使用されます。Docs API については、document.key パラメータが WOPISrc
に書き込まれます。
変換API
変換リクエストに追加された watermark フィールドは、変換中にPDF・画像ファイルに挿入されるしおりのプロパティを含む JSON オブジェクトを定義します。
"async": false,
"filetype": "docx",
"key": "Khirz6zTPdfd7",
"outputtype": "pdf",
"title": "Example Document Title.docx",
"url": "https://example.com/url-to-example-document.docx",
"watermark": {
"align": 1,
"fill": [255, 0, 0],
"height": 100,
"margins": [ 10, 10, 10, 10 ],
...
OracleおよびMicrosoft SQL Serverデータベースのサポート
サポートされているデータベースには、Oracle と Microsoft SQL Server があります。接続するには、データベースタイプをoracle / mssql
に変更してください。Dockerの場合は、DB_TYPEパラメータを調整する必要があります。
そのほかにも以下のデータベースも利用できます:
ユーザーアバター
バージョン8.0から、エディタに表示されるユーザーアバターを追加して、チームをより見やすくすることができるようになりました。
このため、setUsers メソッドと onRequestUsers イベントに info
オペレーション・タイプが追加され、data.id
パラメータで指定された ID を持つユーザのアバターが設定されます。また、新しく追加されたusers.image
フィールドは、ユーザーアバターへのパスを定義します。
var onRequestUsers = function (event) {
var c = event.data.c;
var id = event.data.id;
...
docEditor.setUsers({
"c": event.data.c,
"users": [
{
"email": "john@example.com",
"id": "78e1e841",
"image": "https://example.com/url-to-user-avatar1.png",
"name": "John Smith"
},
さらに、editorConfig.userパラメータにユーザーアバターへのパスを定義するimageフィールドが追加されました:
var docEditor = new DocsAPI.DocEditor("placeholder", {
"editorConfig": {
...
"user": {
"group": "Group1",
"id": "78e1e841",
"image": "https://example.com/url-to-user-avatar.png",
"name": "John Smith"
}
エディタ用APIのさらなる更新
- editorConfig.customization.mobileForceView パラメータで、起動時にモバイルドキュメントエディタを表示/編集モードで開くかどうかを定義できるようになりました。デフォルト値はtrueです。
- events.onRequestReferenceDataイベントに送られるデータオブジェクトのリンクフィールド。
ONLYOFFICE Docs Developerの最新バージョンを入手:
プラグイン用APIの強化
新しく追加されたプラグインメソッドにより、スライドショーの起動と管理が可能になりました:
- EndSlideShow
- GoToNextSlideInSlideShow
- GoToPreviousSlideInSlideShow
- GoToSlideInSlideShow
- PauseSlideShow
- ResumeSlideShow
- StartSlideShow
以下にコードサンプルをご紹介します:
window.Asc.plugin.executeMethod ("StartSlideShow");
window.Asc.plugin.executeMethod ("GoToSlideInSlideShow", [2]);
window.Asc.plugin.executeMethod ("EndSlideShow");
ドキュメント・ビルダーAPIのさらなる更新
DocBuilder APIでは、複数のフリーズ・ペインとコメント・メソッド、および以下のメソッドを含むその他のメソッドも追加しました:
- ApiFreezePanes/GetLocation:アクティブなワークシート・ビューでフリーズしたセルを表す範囲を返します。
- ApiBlockLvlSdt/AddComment:現在のブロックコンテンツコントロールにコメントを追加します。
- ApiSection/GetPageHeight:現在のセクションのページの高さを取得します。
- ApiDocument/AddDrawingToPage:指定されたページに図形を追加します。
新しいメソッドの全リストをご覧ください。
ONLYOFFICEの無料アカウントを登録する
オンラインでドキュメント、スプレッドシート、スライド、フォーム、PDFファイルの閲覧、編集、共同作業