開発者向けONLYOFFICE Docs 7.3：APIとDoc Builderのアップデート

[バージョン7.3](https://www.onlyoffice.com/blog/ja/2023/01/onlyoffice-docs-v7-3-smartart&utm_source=qiita&utm_medium=social&utm_campaign=docs_73_devs)の新機能のリリースに伴い、エディタ、プラグイン、ドキュメントビルダーのAPIを更新しました。詳細は下記をご覧ください。 

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2655664/4a83d0ed-8304-fecf-c91d-6a26963bf747.png)

## WOPIサポートの強化

WOPIとの連携において、doc, ppt, xlsなどのバイナリーフォーマットを扱えるようになりました。WOPI のディスカバリーに[変換アクション](https://api.onlyoffice.com/editors/wopi/discovery?_ga=2.4796915.1113996902.1675693445-1867947466.1655385017#convert)を含む対応[スキーム](https://api.onlyoffice.com/editors/wopi/editingbinary?_ga=2.4796915.1113996902.1675693445-1867947466.1655385017)を実装しました。これはバイナリファイルをdocx, pptx, xlsxに変換し、さらに編集できるようにするものです。

さらに、[WOPI Conversion API](https://api.onlyoffice.com/editors/wopi/conversionapi?_ga=2.243883333.1113996902.1675693445-1867947466.1655385017) を追加して、異なるオフィスファイル形式をより簡単に扱えるようにしました。

```
<form action="https://documentserver/cool/convert-to/docx" enctype="multipart/form-data" method="post">     
File: <input type="file" name="data"><br/>     
<input type="submit" value="Convert to DOCX">
</form>
```

ここでのさらなる強化は以下の通りです。

* CheckFileInfo WOPI 操作の [UserCanNotWriteRelative](https://api.onlyoffice.com/editors/wopi/restapi/checkfileinfo?&_ga=2.15807990.1113996902.1675693445-1867947466.1655385017#UserCanNotWriteRelative) プロパティは、ユーザーが WOPI サーバに新しいファイルを作成する権限を持っているかどうかを指定します。
* [PutRelativeFile WOPI](https://api.onlyoffice.com/editors/wopi/restapi/putrelativefile?_ga=2.84163801.1113996902.1675693445-1867947466.1655385017) 操作は、現在のファイルに基づいてホスト上に新しいファイルを作成します。

## 表計算ソフトへの外部データの挿入

新しく追加された [document.referenceData](https://api.onlyoffice.com/editors/config/document?_ga=2.84163801.1113996902.1675693445-1867947466.1655385017#referenceData) パラメータは、インテグレータがシステム内のファイルを一意に識別するために生成するオブジェクトを定義します。

実装された[setReferenceData](https://api.onlyoffice.com/editors/methods?_ga=2.84163801.1113996902.1675693445-1867947466.1655385017#setReferenceData)メソッドと[onRequestReferenceData](https://api.onlyoffice.com/editors/config/events?_ga=2.84163801.1113996902.1675693445-1867947466.1655385017#onRequestReferenceData)イベントとともに、ユーザーが外部リンクダイアログボックスの対応するボタンをクリックして外部ファイルから挿入した値を更新しようとするとき、ファイルへのリンクを使用してデータを更新することができるようになりました。[詳細はこちら](https://api.onlyoffice.com/editors/insertingexternaldata?_ga=2.3404144.1113996902.1675693445-1867947466.1655385017)

```
var onRequestReferenceData = function () {
var referenceData =  event.data.referenceData;
var path = event.data.path;
   ...
docEditor.setReferenceData({
 "fileType": "xlsx",
 "path": "sample.xlsx",
 "referenceData": {
"fileKey": "BCFA2CED",
"instanceId": "https://example.com"
 },
 "url": "https://example.com/url-to-example-document.xlsx"
 });
};
var docEditor = new DocsAPI.DocEditor("placeholder", {
"events": {
"onRequestReferenceData": onRequestReferenceData, 
 ...
    },
 ...
});
```

## インターフェイスのカスタマイズ

ONLYOFFICE Docs Developer Editionの拡張ライセンスユーザーは、設定ファイルを介してエディタのフロントエンドをカスタマイズするための新しいオプションを得ることができます。

* ボタン、タブなどのインターフェイス要素のフォントの調整
* 右/左パネルの可視性（表示/非表示）の初期値の定義

#### プラグインやマクロのAPI更新

* [initDataType](https://api.onlyoffice.com/plugin/config?_ga=2.244014149.1113996902.1675693445-1867947466.1655385017#initDataType)のconfigパラメータにサインタイプを追加しました。
* 文書中のすべてのVBAマクロを返す[GetVBAMacros](https://api.onlyoffice.com/plugin/executemethod/common/getvbamacros?_ga=2.244014149.1113996902.1675693445-1867947466.1655385017)メソッドを追加しました。
* [OnDropEvent](https://api.onlyoffice.com/plugin/executemethod/common/ondropevent?_ga=2.244014149.1113996902.1675693445-1867947466.1655385017)メソッドで、外部からのドラッグ＆ドロップのエミュレーションを実装しました。
* window.Asc.plugin.executeMethodで使用できる[Spreadsheet Api](https://api.onlyoffice.com/plugin/executemethod/cell?_ga=2.75709013.1113996902.1675693445-1867947466.1655385017)と[Presentation Api](https://api.onlyoffice.com/plugin/executemethod/slide?_ga=2.75709013.1113996902.1675693445-1867947466.1655385017)のメソッドです。

OnDropEventメソッドについては、このコード例をご参照ください。

```
window.Asc.plugin.executeMethod("OnDropEvent", [{
  type: "ondrop",
  x : pos.x,
  y : pos.y,
  text : "test text",
  html : "test html"
}]);
```

ONLYOFFICE Docs Developer Editionの最新バージョンを入手しましょう！

[**今すぐダウンロード**](https://www.onlyoffice.com/download-docs.aspx?utm_source=blog&utm_medium=social&utm_campaign=docs_73_devs#docs-developer)

## ドキュメントビルダーのAPI更新

[DocBuilder API](https://api.onlyoffice.com/docbuilder/basic?_ga=2.16994425.1113996902.1675693445-1867947466.1655385017)では、コメント、目次/図、および以下のようないくつかのメソッドを新たに多数追加しました。

* [ApiBlockLvlSdt/AddComment](https://api.onlyoffice.com/docbuilder/textdocumentapi/apiblocklvlsdt/addcomment?_ga=2.16994425.1113996902.1675693445-1867947466.1655385017)
* [ApiComment/GetAutorName](https://api.onlyoffice.com/docbuilder/textdocumentapi/apicomment/getautorname?_ga=2.16994425.1113996902.1675693445-1867947466.1655385017)
* [ApiDocument/AddTableOfContents](https://api.onlyoffice.com/docbuilder/textdocumentapi/apidocument/addtableofcontents?_ga=2.16994425.1113996902.1675693445-1867947466.1655385017)
* [ApiDocument/AddTableOfFigures](https://api.onlyoffice.com/docbuilder/textdocumentapi/apidocument/addtableoffigures?_ga=2.16994425.1113996902.1675693445-1867947466.1655385017)
* [ApiParagraph/AddCaption](https://api.onlyoffice.com/docbuilder/textdocumentapi/apiparagraph/addcaption?_ga=2.16994425.1113996902.1675693445-1867947466.1655385017)
* [ApiDocument/GetStatistics](https://api.onlyoffice.com/docbuilder/textdocumentapi/apidocument/getstatistics?_ga=2.8008050.1113996902.1675693445-1867947466.1655385017)

新しいメソッドの[一覧](https://api.onlyoffice.com/docbuilder/changelog?_ga=2.239138883.1113996902.1675693445-1867947466.1655385017#73)を確認してください。

ご注意：今のところ、更新されたDocBuilder APIはすでに利用可能です。ONLYOFFICE Document Builderのインストールファイルは、近日中にv7.3に更新される予定です。

## お役立ちリンク

* ONLYOFFICE Docs 7.3について： [ブログ](https://www.onlyoffice.com/blog/ja/2023/01/onlyoffice-docs-v7-3-smartart&utm_source=qiita&utm_medium=social&utm_campaign=docs_73_devs) / [動画](https://youtu.be/lJYyz9CiZfE) / [ライブイベント](https://youtu.be/0LpAWnJEEGE)
* [開発者向けONLYOFFICE](https://www.onlyoffice.com/ja/developer-edition.aspx?utm_source=qiita&utm_medium=social&utm_campaign=docs_73_devs)
* [ONLYOFFICE Document Builder](https://www.onlyoffice.com/document-builder.aspx?utm_source=qiita&utm_medium=social&utm_campaign=docs_73_devs)
* [API ドキュメント](https://api.onlyoffice.com/?utm_source=qiita&utm_medium=social&utm_campaign=docs_73_devs&_ga=2.12663031.1113996902.1675693445-1867947466.1655385017)
* [API 変更ログ](https://api.onlyoffice.com/editors/changelog?utm_source=qiita&utm_medium=social&utm_campaign=docs_73_devs&_ga=2.73152979.1113996902.1675693445-1867947466.1655385017)
* [プラグイン＆マクロの変更ログ](https://api.onlyoffice.com/plugin/changelog?utm_source=qiita&utm_medium=social&utm_campaign=docs_73_devs&_ga=2.73152979.1113996902.1675693445-1867947466.1655385017)
* [DocBuilder 変更ログ](https://api.onlyoffice.com/docbuilder/changelog?utm_source=qiita&utm_medium=social&utm_campaign=docs_73_devs&_ga=2.73152979.1113996902.1675693445-1867947466.1655385017)