ONLYOFFICE Docs 9.3 pour les développeurs : API PDF, nouvelles méthodes pour l’API JavaScript Office et plus encore

ONLYOFFICE Docs 9.3 apporte une multitude de mises à jour pour les développeurs. Cette version élargit considérablement les capacités de notre API, offrant plus de contrôle et de flexibilité pour l’intégration et l’extension des éditeurs. Découvrons ensemble les principales améliorations.

Présentation de la nouvelle API PDF

L’une des nouveautés les plus importantes de la version 9.3 est la toute nouvelle API PDF. Cet ensemble d’outils puissants vous permet de créer et de manipuler des documents PDF par programmation. Vous pouvez désormais créer des fichiers PDF complexes à partir de zéro, en ajoutant divers éléments tels que du texte, des images, des tableaux et des formes.

L’API offre un contrôle étendu sur la structure et le contenu des documents. Vous pouvez gérer les pages, utiliser le formatage de texte enrichi et insérer des dessins et d’autres objets avec précision. Cela ouvre de nouvelles possibilités pour automatiser la génération de documents et créer des solutions personnalisées basées sur le format PDF au sein de vos applications.

Consultez l’exemple de code permettant de créer un nouveau fichier PDF :

// create a PDF file with ONLYOFFICE Document Builder
builder.CreateFile("pdf")

// create a new 'oDocument' variable and get the created PDF document
const oDocument = Api.GetDocument()

// create a new paragraph for the PDF content
const oParagraph = Api.CreateParagraph()

// set the paragraph justification to center the text
oParagraph.SetJc("center")

// add a text containing a single 'Center' word to the paragraph
oParagraph.AddText("Center")

// push the paragraph to the document
oDocument.Push(oParagraph)

// save the resulting PDF document as a file in the .pdf format with the 'example.pdf' name and close it
builder.SaveFile("pdf", "example.pdf")
builder.CloseFile()

Mises à jour majeures de l’API JavaScript Office

L’API JavaScript Office a fait l’objet d’une mise à niveau importante, avec de nombreuses nouvelles méthodes dans différents modules afin d’améliorer l’automatisation et l’interaction des documents.

Améliorations apportées aux formulaires

Nous avons ajouté un ensemble complet de méthodes pour travailler avec les formulaires. Vous pouvez désormais gérer par programmation les champs de formulaire, y compris les boutons, les cases à cocher, les listes déroulantes et les champs de texte. Cela permet la création et l’interaction dynamiques de formulaires, facilitant ainsi la mise en place de solutions sophistiquées de saisie de données.

Capacités étendues de dessin et d’annotation

L’API pour les dessins et les annotations a été considérablement améliorée. De nouvelles méthodes permettent un contrôle plus précis des formes, de la géométrie et des propriétés visuelles telles que les remplissages et les contours. Cela inclut de nouvelles méthodes pour gérer :

• Annotations (curseur, cercle, surlignage, encre, etc.)
• Géométries et chemins
• Remplissages (dégradés, couleurs) et contours

Consultez l’exemple de code pour la méthode ApiStroke/GetFill (API tableur) :

// Creates a shape with a colored border and retrieves its fill properties.
let worksheet = Api.GetActiveSheet();
let fill = Api.CreateSolidFill(Api.CreateRGBColor(255, 200, 100));
let stroke = Api.CreateStroke(2 * 36000, Api.CreateSolidFill(Api.CreateRGBColor(0, 0, 255)));
let shape = worksheet.AddShape("rect", 60 * 36000, 40 * 36000, fill, stroke, 3, 0, 2, 2);
let strokeObj = shape.GetLine();
if (strokeObj) {
    let strokeFill = strokeObj.GetFill();
    if (strokeFill) {
        worksheet.GetRange("A1").SetValue("Stroke fill type: " + strokeFill.GetType());
    }
}

Méthodes avancées pour les graphiques et les tableaux

Le travail avec les graphiques et les tableaux est désormais plus flexible. Les nouvelles méthodes ApiChart et ApiTable offrent un meilleur contrôle programmatique sur leur création et leur modification, vous permettant ainsi de créer des documents plus dynamiques et riches en données.

Autres ajouts importants à l’API JavaScript

• Filters et validation : de nouvelles méthodes pour Autofilter, Filteret Validation ont été introduites afin de mieux gérer les données dans les feuilles de calcul.
• Notes de bas de page et notes de fin : ajoutez et gérez de manière programmatique les notes de bas de page et les notes de fin dans vos documents.
• Liens hypertextes et transitions : bénéficiez d’un meilleur contrôle sur les liens hypertextes et les transitions entre les diapositives de présentation.

Consulter la liste complète des nouvelles méthodes

Améliorations apportées à l’API des plugins et des macros

L’API pour les plugins et les macros bénéficie également d’importantes mises à jour dans la version 9.3. Ces améliorations sont conçues pour offrir aux développeurs davantage d’options afin d’étendre les fonctionnalités des éditeurs ONLYOFFICE. Vous pouvez désormais créer des plugins encore plus puissants et intégrés, automatiser des flux de travail complexes à l’aide de macros et proposer des fonctionnalités personnalisées adaptées aux besoins spécifiques des utilisateurs.

Par exemple, la méthode IsFormSigned vérifie si le formulaire spécifié a été signé :

window.Asc.plugin.executeMethod ("IsFormSigned", [], function(isSigned) {    
console.log ("Form is signed: " + isSigned);
});

La nouvelle API pour les macros dans l’éditeur PDF vous permet d’ajouter, de supprimer et de modifier des pages, des formulaires, des annotations, des formes automatiques, des tableaux, des images et des graphiques. Voici, par exemple, la méthode window.Asc.plugin.executeMethod pour l’API PDF :

window.Asc.plugin.executeMethod ("SetMacros", [JSON.stringify (Content)], function () {    
window.Asc.plugin.executeCommand ("close", "");
});

Consulter le journal complet des modifications pour l’API Plugins et Macros.