ONLYOFFICE Document Builder v7.2 : Commandes JS, bibliothèque .Net, conversion JSON, méthodes d’objets OLE, etc.

6 octobre 2022By Dasha

Nous avons considérablement amélioré API de Doc Builder en mettant à niveau les wrappers, en ajoutant la conversion vers et depuis JSON, plus d’options pour travailler avec des objets OLE, des formulaires, Word Art, des graphiques et des tableaux. Découvrez tous les détails ci-dessous.

ONLYOFFICE Document Builder v7.2: JS commands, .Net library, JSON conversion, OLE object methods, and more

Optimisation complète

Nous avons complètement mis à jour l’API native d’ONLYOFFICE Doc Builder pour rendre la génération de documents plus confortable en utilisant des commandes JS au lieu de commandes texte.

L’API d’intégration comprend de nouvelles classes et méthodes qui facilitent le travail avec les types de données С/С++.

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);

De plus, nous avons ajouté la bibliothèque doctrenderer .Net qui permet de travailler avec l’API Doc Builder dans votre application basée sur .Net. Nous allons également ajouter l’option de wrapper Java bientôt.

Conversion JSON

Avec les nouvelles méthodes FromJSON et ToJSON, vous pouvez convertir l’objet JSON spécifié en objet Document Builder du type correspondant et vice versa – convertir l’objet ApiDocument en objet JSON. Ceci s’applique à des éléments tels que les liens hypertextes, les paragraphes, les numérotations, les tableaux, les diapositives, etc.

builder.CreateFile("docx");
var oDocument = Api.GetDocument();
.....
var sJSON = oDocument.ToJSON(false, false, true, true);
....
builder.SaveFile("docx", "ToJSON.docx");
builder.CloseFile();

Méthodes OLE

Nous avons ajouté la classe ApiOleObject à l’API Doc Builder. Par exemple, avec la méthode CreateOleObject, vous pouvez créer un objet OLE avec les paramètres spécifiés. En pratique, cela permet d’ajouter et de modifier des feuilles de calcul en tant qu’objets OLE intégrés dans des documents texte, des feuilles et des diapositives, ce qui peut être utile pour travailler avec des statistiques et des rapports intelligents.

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();

Nouvelles méthodes de formulaires

Grâce aux nouvelles méthodes de formulaire, il est maintenant possible de récupérer une liste de tous les tags utilisés pour les contrôles de contenu et les formulaires dans le document, ainsi que de récupérer une liste de tous les contrôles de contenu et formulaires avec le nom de balise spécifié.

Il simplifie le travail avec les champs en mode automatique, par exemple, lors de l’analyse d’un document sans l’ouvrir.

OBTENIR DOC BUILDER

Notes de fin, notes de bas de page, Word Art

Créez des documents avec des notes de fin et des notes de bas de page :

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();

En outre, vous pouvez désormais créer des objets Word Art lors de la création de documents texte, de feuilles de calcul et de présentations.

Plus de méthodes de graphiques et de dessins

Les nouvelles méthodes d’enregistrement comprennent :

  • ApplyChartStyle pour définir un style pour le graphique actuel par l’ID du style ;
  • SetLegendFill pour définir un remplissage de la légende du graphique ;
  • SetSeriaValues pour définir les valeurs de la plage spécifiée dans la série spécifiée ;
  • SetTitleFill pour définir le remplissage du titre du graphique ;
  • et autres.

Parmi les méthodes de dessin mises à jour, vous trouverez :

  • ReplaceDrawing pour remplacer un dessin par un nouveau ;
  • GetLockValue pour récupérer la valeur de verrouillage pour le type de verrouillage spécifié du dessin actuel ;
  • SetDrawingPrFromDrawing pour définir les propriétés d’un autre dessin sur le dessin actuel ;
  • et plusieurs autres.

Autres actualisations

Les méthodes UpdateAllTOC et UpdateAllTOF permettent de mettre à jour toutes les tables des matières et toutes les tables des figures du document en cours.

De nouvelles méthodes de tableau pour les documents texte permettent de définir/obtenir la description du tableau et le titre/la légende du tableau.

Explorez la liste complète des nouvelles méthodes avec leurs descriptions