Along with the release of the new features in version 7.3, we updated ONLYOFFICE API for the editors, plugins, and Document Builder.

Along with the release of the new features in <a href="/blog/?p=52310&amp;utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">version 7.3</a>, we updated API for the editors, plugins, and Document Builder. Check all the details below.
<img decoding="async" loading="lazy" class="alignnone wp-image-53306 size-full" src="https://static-blog.onlyoffice.com/wp-content/uploads/2023/02/onlyoffice-docs-7.3-for-developers.png" alt="ONLYOFFICE Docs 7.3 for developers: API &amp; Doc Builder updates" width="1472" height="742" srcset="https://static-blog.onlyoffice.com/wp-content/uploads/2023/02/onlyoffice-docs-7.3-for-developers.png 1472w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/02/onlyoffice-docs-7.3-for-developers-300x151.png 300w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/02/onlyoffice-docs-7.3-for-developers-1024x516.png 1024w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/02/onlyoffice-docs-7.3-for-developers-768x387.png 768w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/02/onlyoffice-docs-7.3-for-developers-634x320.png 634w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/02/onlyoffice-docs-7.3-for-developers-353x178.png 353w" sizes="(max-width: 1472px) 100vw, 1472px" />

<h2>Enhanced WOPI support</h2>
From now on, you are able to work with the binary formats such as doc, ppt, and xls within WOPI integrations. We implemented the corresponding <a href="https://api.onlyoffice.com/editors/wopi/editingbinary" target="_blank" rel="noopener">scheme</a> which includes the <a href="https://api.onlyoffice.com/editors/wopi/discovery#convert" target="_blank" rel="noopener">convert</a> action in the WOPI discovery. It converts binary files into docx, pptx, and xlsx for further editing.
Besides, we added the <a href="https://api.onlyoffice.com/editors/wopi/conversionapi" target="_blank" rel="noopener">WOPI Conversion API</a> for easier work with different office file formats.
<pre class="theme:github font:monospace lang:default decode:true ">&lt;form action="https://documentserver/cool/convert-to/docx" enctype="multipart/form-data" method="post"&gt; 
File: &lt;input type="file" name="data"&gt;&lt;br/&gt; 
&lt;input type="submit" value="Convert to DOCX"&gt;
&lt;/form&gt;
</pre>
Further enhancements here comprise:
<ul>
<li><a href="https://api.onlyoffice.com/editors/wopi/restapi/checkfileinfo#UserCanNotWriteRelative" target="_blank" rel="noopener">UserCanNotWriteRelative</a> property in the CheckFileInfo WOPI operation which specifies if a user has permissions to create new files on the WOPI server or not;</li>
<li><a href="https://api.onlyoffice.com/editors/wopi/restapi/putrelativefile" target="_blank" rel="noopener">PutRelativeFile</a> WOPI operation which creates a new file on the host based on the current file.</li>
</ul>
<h2>Inserting external data in spreadsheets</h2>
The newly added <a href="https://api.onlyoffice.com/editors/config/document#referenceData" target="_blank" rel="noopener">document.referenceData</a> parameter defines an object that is generated by the integrator to uniquely identify a file in its system.
Together with the implemented <a href="https://api.onlyoffice.com/editors/methods#setReferenceData" target="_blank" rel="noopener">setReferenceData</a> method and <a href="https://api.onlyoffice.com/editors/config/events#onRequestReferenceData" target="_blank" rel="noopener">onRequestReferenceData</a> event, it is now possible to refresh data using a link to a file — when a user is trying to update values inserted from the external file by clicking the corresponding button in the External links dialog box. <a href="https://api.onlyoffice.com/editors/insertingexternaldata" target="_blank" rel="noopener">Learn more</a>
<pre class="theme:github font:monospace lang:default decode:true ">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, 
 ...
 },
 ...
});</pre>
<h2>Interface customization</h2>
Users of ONLYOFFICE Docs Developer Edition with the extended license get new options for customizing the frontend of the editors via the config file:
<ul>
<li>adjusting the font of the interface elements such as buttons, tabs, etc.;</li>
<li>defining the initial value of the right/left panel visibility – displayed or hidden.</li>
</ul>
<h2>API updates for plugins and macros</h2>
<ul>
<li>Sign type in the <a href="https://api.onlyoffice.com/plugin/config#initDataType" target="_blank" rel="noopener">initDataType</a> config parameter.</li>
<li><a href="https://api.onlyoffice.com/plugin/executemethod/common/getvbamacros" target="_blank" rel="noopener">GetVBAMacros</a> method which returns all VBA macros from the document.</li>
<li><a href="https://api.onlyoffice.com/plugin/executemethod/common/ondropevent" target="_blank" rel="noopener">OnDropEvent</a> method which implements the external drag&amp;drop emulation.</li>
<li><a href="https://api.onlyoffice.com/plugin/executemethod/cell" target="_blank" rel="noopener">Spreadsheet Api</a> and <a href="https://api.onlyoffice.com/plugin/executemethod/slide" target="_blank" rel="noopener">Presentation Api</a> methods available for the window.Asc.plugin.executeMethod.</li>
</ul>
Check this code example for the OnDropEvent method:
<pre class="theme:github font:monospace lang:default decode:true ">window.Asc.plugin.executeMethod("OnDropEvent", [{
 type: "ondrop",
 x : pos.x,
 y : pos.y,
 text : "test text",
 html : "test html"
}]);</pre>
Get the latest version of ONLYOFFICE Docs Developer Edition:
<a class="red button" href="https://www.onlyoffice.com/download-docs.aspx?utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs#docs-developer" target="_blank" rel="noopener">DOWNLOAD NOW</a>
<h2>API updates for Document Builder</h2>
In the <a href="https://api.onlyoffice.com/docbuilder/basic" target="_blank" rel="noopener">DocBuilder API</a>, we added lots of new comment, table of contents/figure, and some other methods, including the following ones:
<ul>
<li><a href="https://api.onlyoffice.com/docbuilder/textdocumentapi/apiblocklvlsdt/addcomment" target="_blank" rel="noopener">ApiBlockLvlSdt/AddComment</a></li>
<li><a href="https://api.onlyoffice.com/docbuilder/textdocumentapi/apicomment/getautorname" target="_blank" rel="noopener">ApiComment/GetAutorName</a></li>
<li><a href="https://api.onlyoffice.com/docbuilder/textdocumentapi/apidocument/addtableofcontents" target="_blank" rel="noopener">ApiDocument/AddTableOfContents</a></li>
<li><a href="https://api.onlyoffice.com/docbuilder/textdocumentapi/apidocument/addtableoffigures" target="_blank" rel="noopener">ApiDocument/AddTableOfFigures</a></li>
<li><a href="https://api.onlyoffice.com/docbuilder/textdocumentapi/apiparagraph/addcaption" target="_blank" rel="noopener">ApiParagraph/AddCaption</a></li>
<li><a href="https://api.onlyoffice.com/docbuilder/textdocumentapi/apidocument/getstatistics" target="_blank" rel="noopener">ApiDocument/GetStatistics</a></li>
</ul>
Check the <a href="https://api.onlyoffice.com/docbuilder/changelog#73" target="_blank" rel="noopener">full list</a> of new methods.
<a class="red button" href="https://www.onlyoffice.com/download-builder.aspx?utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">DOWNLOAD NOW</a>
<div class="useful-links">
<h3>Useful links</h3>
What’s new in ONLYOFFICE Docs 7.3: <a href="/blog/?p=52310&amp;utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">blog</a> / <a href="https://youtu.be/lJYyz9CiZfE" target="_blank" rel="noopener">video</a> / <a href="https://youtu.be/0LpAWnJEEGE" target="_blank" rel="noopener">live event</a>
<a href="https://www.onlyoffice.com/developer-edition.aspx?utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">ONLYOFFICE for developers</a>
<a href="https://www.onlyoffice.com/document-builder.aspx?utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">ONLYOFFICE Document Builder</a>
<a href="https://api.onlyoffice.com/?utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">API documentation</a>
<a href="https://api.onlyoffice.com/editors/changelog?utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">API changelog</a>
<a href="https://api.onlyoffice.com/plugin/changelog?utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">Plugins &amp; macros changelog</a>
<a href="https://api.onlyoffice.com/docbuilder/changelog?utm_source=blog&amp;utm_medium=social&amp;utm_campaign=docs_73_devs" target="_blank" rel="noopener">DocBuilder changelog</a>
</div>

ONLYOFFICE Docs 7.3 for developers: API & Doc Builder updates

Recent posts

7 best tools to share files securely

How the Stiftung der Deutschen Wirtschaft manages its funding processes with ONLYOFFICE and Nextcloud

Practice opportunities: ONLYOFFICE Campus Ambassador Program for students