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 方法，更新当前文档中的所有目录和所有图表目录。

文本文档的新表格方法允许设置/获取表格描述和表格标题/标题。

探索新方法的完整列表，含描述