ONLYOFFICE 文档生成器 v7.2：JS命令、.Net 库、JSON 转换、OLE 对象方法等
我们通过升级封装容器、添加与JSON之间的转换、更多用于处理OLE对象、表单、艺术字、图表和表格的选项，显著提升了文档生成器 API。如要了解详情，请阅读如下信息。
全面优化
我们全面升级了原生 ONLYOFFICE 文档生成器 API，让您使用 JS 命令而非文本命令生成文档，更加自如。
集成 API包括新的类和方法，让处理 С/С++ 数据类型更加轻松。
CValue oApi = oGlobal["Api"];
CValue oDocument = oApi.Call("GetDocument");
CValue oParagraph = oApi.Call("CreateParagraph");
oParagraph.Call("SetSpacingAfter", 1000, false);
oParagraph.Call("AddText", "Hello, world!");
CValue oContent = oContext.CreateArray(1);
oContent[0] = oParagraph;
oDocument.Call("InsertContent", oContent);此外，我们还添加了 .Net doctrenderer 代码库，从而允许在基于 .Net 的应用中使用文档生成器 API。我们稍后还会添加 Java 封装容器选项。
JSON转换
使用全新 FromJSON 和 ToJSON 方法，您可以将指定的 JSON 对象转换为相应类型的文档生成器对象，反之亦然——将 ApiDocument 对象转换为 JSON 对象。这适用于超链接、段落、编号、表格、幻灯片等元素。
builder.CreateFile("docx");
var oDocument = Api.GetDocument();
.....
var sJSON = oDocument.ToJSON(false, false, true, true);
....
builder.SaveFile("docx", "ToJSON.docx");
builder.CloseFile();OLE方法
我们将 ApiOleObject 类添加到了文档生成器 API。例如，使用 CreateOleObject 方法，您可以使用指定的参数创建一个 OLE 对象。在实际操作中，支持将电子表格作为嵌入文本文档、工作表和幻灯片中的 OLE 对象进行添加和编辑，在使用智能统计数据和报表时，这种方法会很有用。
builder.CreateFile("xlsx");
var oWorksheet = Api.GetActiveSheet();
oWorksheet.AddOleObject("https://i.ytimg.com/vi_webp/SKGz4pmnpgY/sddefault.webp", 130 * 36000, 90 * 36000, "https://youtu.be/SKGz4pmnpgY", "asc.{38E022EA-AD92-45FC-B22B-49DF39746DB4}", 0, 2 * 36000, 4, 3 * 36000);
builder.SaveFile("xlsx", "AddOleObject.xlsx");
builder.CloseFile();新的表单方法
有了新的表单方法，您现在可以检索文档中用于内容控制和表单所有标记的列表，以及返回具有指定标记名称的所有内容控制和表单列表。
它简化了在自动模式下使用字段的处理，例如，无需打开文档也可对其进行解析。
尾注、脚注、艺术字
builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oParagraph = oDocument.GetElement(0);
oParagraph.AddText("This is just a sample text.");
oDocument.AddEndnote();
builder.SaveFile("docx", "AddEndnote.docx");
builder.CloseFile();此外，现在您可以在生成文本文档、电子表格和演示文稿时创建艺术字对象。
其他图表和绘图方法
新的图表方法包括：
- ApplyChartStyle：用于根据样式 ID 将样式设置为当前图表；
- SetLegendFill：用于设置图例的填充；
- SetSeriaValues：用于设置从指定范围到指定系列的值；
- SetTitleFill：用于设置图表标题的填充；
- 等等。
更新的绘图方法包括：
- ReplaceDrawing：用新的绘图替换；
- GetLockValue：获取当前图形的指定锁定类型的锁定值；
- SetDrawingPrFromDrawing：将另一个图形中的特性设置为当前图形；
- 等等。
其他更新
您可以使用 UpdateAllTOC 和 UpdateAllTOF 方法，更新当前文档中的所有目录和所有图表目录。
文本文档的新表格方法允许设置/获取表格描述和表格标题/标题。
