Bilan de l’API : dernières mises à jour pour ONLYOFFICE Docs

Nous avons déployé une série de mises à jour de l’API pour ONLYOFFICE Docs, visant à améliorer la compatibilité, la personnalisation et la sécurité. Que vous construisiez des flux de travail personnalisés, que vous mettiez en place une collaboration documentaire sécurisée ou que vous intégriez des API avancées, ces améliorations offrent des possibilités illimitées. Voici un aperçu des derniers ajouts et améliorations.

Prise en charge étendue des formats de fichiers

L’API Docs prend désormais en charge des formats de fichiers supplémentaires, offrant une plus grande compatibilité, afin de garantir une expérience transparente aux utilisateurs travaillant avec des types de fichiers variés. Il s’agit notamment des formats Apple iWork et Hancom Office :

• pages
• key
• numbers
• hwp
• hwpx

Ces formats peuvent être spécifiés à l’aide de la propriété documentType, par exemple :

const config = {
  documentType: "pages",

Options de personnalisation améliorées

Les développeurs ont désormais plus de contrôle sur le comportement et l’apparence de l’éditeur. Les principales mises à jour sont les suivantes :

• Masquer les conseils sur les fonctionnalités

Le paramètre editorConfig.customization.features.featuresTips permet d’activer ou de désactiver les infobulles sur les nouvelles fonctionnalités lors du premier chargement de l’éditeur à la suite d’une mise à jour. La valeur par défaut est true.

• Afficher les barres de défilement de la feuille de calcul

À partir de la version 8.3, il est possible de définir si le défilement horizontal/vertical est automatiquement affiché ou caché lorsque l’éditeur de feuilles de calcul est chargé. Vérifiez editorConfig.customization.showHorizontalScroll et editorConfig.customization.showVerticalScroll pour contrôler ces paramètres.

• Arrière-plan du diaporama de la présentation

Utilisez le paramètre editorConfig.customization.slidePlayerBackground pour définir la couleur d’arrière-plan du diaporama aux formats HEX, RVB ou RGBA. Par exemple, #ff0000, rgb(255, 0, 0), rgba(255, 0, 0, 0.5).

showHorizontalScroll: true,
      showVerticalScroll: true,
      slidePlayerBackground: "#000000",

• Couleurs des en-têtes de documents

Personnalisez les styles d’en-tête dans l’éditeur de documents avec le paramètre editorConfig.customization.wordHeadingsColor, qui permet de spécifier des couleurs HEX.

• Bouton Mobile Info

Permettez l’affichage du bouton Informations sur le document pour les éditeurs mobiles utilisant editorConfig.customization.mobile.info. La valeur par défaut est false.

• Mode pointeur

Ajustez le mode du pointeur (sélection ou main) dans le visualiseur de présentation à l’aide du paramètre editorConfig.customization.pointerMode. La valeur par défaut est select.

• Barre d’outils compacte pour le visualiseur

Le paramètre editorConfig.customization.compactToolbar prend désormais en charge le mode d’affichage, permettant de basculer entre les barres d’outils complète et compacte. La valeur par défaut du mode de visualisation est true.

Fonctions de sécurité améliorées

L’API Docs introduit la gestion des fichiers protégés par un mot de passe grâce à l’événement events.onUserActionRequired. La fonction est appelée lorsqu’une action de l’utilisateur est requise pour ouvrir un document dans les cas suivants :

• lorsque l’utilisateur doit saisir un mot de passe pour ouvrir le document protégé ;
• lorsque l’utilisateur doit sélectionner un encodage pour le fichier TXT ;
• lorsque l’utilisateur doit sélectionner un encodage et un délimiteur pour le fichier CSV.

Voici un exemple du fonctionnement de l’événement :

function onUserActionRequired() {
  console.log("Enter a password")
};
const config = {
  events: {
    onUserActionRequired,
  },
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);

Par ailleurs, vous pouvez désormais utiliser la commande drop pour interdire l’édition de documents à des utilisateurs spécifiques :

{
  "c": "drop",
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0"]
}

La liste complète des modifications apportées à l’API Docs est disponible ici.

Obtenez la dernière version de ONLYOFFICE Docs Developer :

TÉLÉCHARGER MAINTENANT

Nouvelles méthodes de l’API Office

L’API Office reçoit des mises à jour importantes pour une meilleure gestion des documents, notamment :

• Signets
• Contrôles du contenu
• Sections
• Filtres automatiques
• Sélection
• Et plus encore

Ces améliorations permettent des interactions et des expériences d’édition plus riches. Pour une description détaillée des commandes, consultez le journal des modifications de l’API Office.

Mises à jour de l’API des plugins

Plusieurs nouvelles méthodes et propriétés élargissent les capacités des plugins :

• Recherche de contenu

La méthode GetSelectedContent permet de récupérer un contenu sélectionné dans un format spécifié.

expression.GetSelectedContent(prop);

• Messages d’erreur

La méthode ShowError permet aux plugins d’afficher des messages d’erreur ou d’avertissement.

expression.ShowError(error, level);

• Propriétés du contrôle de contenu amélioré

Les nouvelles propriétésShd (ombrage d’arrière-plan) et Border améliorent l’objet ContentControlProperties pour une meilleure personnalisation visuelle.

• Activation du panneau

Le paramètre isActivated vous permet de spécifier si un panneau de plugin créé est développé (true) ou réduit (false) au chargement.

Consultez la liste complète des mises à jour de l’API du plugin.