Resumo da API para desenvolvedores: ONLYOFFICE Docs 9.1 e DocSpace 3.5

Bem-vindo ao mais recente resumo da API para o ecossistema ONLYOFFICE. Com o lançamento do ONLYOFFICE Docs 9.1 e do DocSpace 3.5, estamos introduzindo uma série de novos recursos e aprimoramentos poderosos, projetados para oferecer aos desenvolvedores mais controle, flexibilidade e eficiência.

Esta publicação irá guiá-lo pelas principais atualizações, desde o suporte a novos formatos e opções de personalização no Docs até melhorias significativas no SDK para o DocSpace. Vamos explorar o que essas novas versões reservam para seus projetos de desenvolvimento.

Atualizações do ONLYOFFICE Docs 9.1

Versão 9.1 do ONLYOFFICE Docs traz uma variedade de melhorias na API.

Suporte e conversão para novos formatos

Para ampliar a compatibilidade dos documentos, adicionamos suporte para novos formatos e expandimos os recursos de conversão:

• abrindo arquivos HML;
• convertendo Apresentações PPTX em formato TXT.

Customização

Estamos oferecendo a você mais controle sobre a aparência dos editores. O parâmetro editorConfig.customization.uitheme , que define o tema do editor, agora está disponível para editores móveis. Isso permite que você crie uma experiência visual consistente em todas as plataformas.

Também atualizamos os requisitos de tamanho para o editorConfig.customization.logo.image. Agora você pode usar uma imagem com dimensões de 300×20 pixels para exibir seu logotipo personalizado no cabeçalho do editor.

const config = {  
   editorConfig: {    
     customization: {
      logo: {        
      image: "https://example.com/logo.png",
      ....
      uiTheme: "theme-dark", ...

Integração WOPI

Para aqueles que utilizam o Web Application Open Platform Interface (WOPI), introduzimos a propriedade UserCanOnlyComment para a operação CheckFileInfo. Esta propriedade booleana permite especificar se um usuário deve ter permissões apenas para comentar, impedindo-o de fazer outras edições.

Além disso, melhoramos o tratamento de erros. Se um documento não puder ser locked via WOPI, agora ele será aberto no modo visualizador com uma mensagem de erro apropriada, garantindo uma experiência de usuário mais tranquila.

Novo método para plugins

Expandimos a API para planilhas e apresentações com o método RemoveOleObject. (para planilhas / para slides). Isso permite remover programaticamente um objeto OLE de uma pasta de trabalho ou apresentação usando seu ID interno, proporcionando maior controle sobre o conteúdo incorporado.

expression.RemoveOleObject(internalId);

API do Office

A versão 9.1 introduz um número significativo de novos métodos para o Office JavaScript API. Essas adições abrem novas e poderosas possibilidades para a manipulação programática de documentos, especialmente em planilhas. As principais áreas de expansão incluem:

• Formatação condicional: um conjunto abrangente de métodos para gerenciar regras de formatação condicional, incluindo acima da média, escalas de cores, barras de dados, conjuntos de ícones, top 10 e valores exclusivos.
• Geometria e trajetórias: novos métodos para trabalhar com geometria, trajetórias e comandos de trajetória, proporcionando um controle mais preciso sobre formas e desenhos.
• XML personalizado: Métodos para interagir com partes XML personalizadas dentro de documentos.
• Gerenciamento de objetos e propriedades: Novos métodos e ferramentas de conversão para gerenciar propriedades de documentos.
• Controle avançado de objetos: métodos aprimorados para trabalhar com seções, pastas de trabalho, tabelas dinâmicas, intervalos e apresentações.

Confira a lista completa de novos métodos

SDKs atualizados e exemplos de integração

Para dar suporte a essas atualizações, lançamos uma atualização do Java SDK que é compatível com o Docs 9.1. Inclui suporte para a nova conversão de apresentação para TXT e manipulação do formato HTML.

Também atualizamos nossos exemplos de teste para conectar os editores, incluindo exemplos Node.js que demonstram o suporte a formatos para Docs v9.1. Confira no GitHub

Atualizações em ONLYOFFICE DocSpace 3.5

DocSpace 3.5 apresenta uma variedade de melhorias projetadas para capacitar os desenvolvedores, com SDKs aprimorados e atualizados API de Backend.

SDK 2.0.0 dos plug-ins do DocSpace

O novo SDK de Plugins introduz várias alterações importantes destinadas a melhorar a segurança e a funcionalidade do diálogo modal.

• Segurança de arquivos aprimorada: transferimos as configurações de segurança de arquivos para uma enumeração FilesSecurity separada, para melhor organização e clareza. A interface IFileItem agora inclui as propriedades fileSecurity e security.
• Diálogos modais aprimorados: agora você pode criar diálogos modais com mais controle sobre sua aparência usando as propriedades withoutBodyPadding e withoutHeaderMargin. Também adicionamos a ação updateCreateDialogModal para atualizações dinâmicas.
• Criação mais inteligente de diálogos: a interface ICreateDialog foi aprimorada com novas propriedades, como isAutoFocusOnError, errorText, onError, onChange, isCloseAfterCreate e isCreateDisabled, oferecendo um controle mais granular sobre as interações do usuário e a validação de formulários.

Você também pode conferir os plugins de sistema atualizados baseado no SDK 2.0.0 em ação dentro de DocSpace:

• draw.io
• Markdown
• PDF Converter
• Speech-to-Text

SDKs da API DocSpace v3.5 atualizados

Para nos alinharmos com o lançamento do DocSpace 3.5, atualizamos nossos SDKs de API em várias linguagens. Esses SDKs oferecem uma maneira conveniente de interagir com a API do DocSpace, gerenciar arquivos, usuários e salas programaticamente.

Os SDKs atualizados estão disponíveis para:

• TypeScript: @onlyoffice/docspace-api-sdk on npm
• C#: DocSpace.API.SDK on NuGet
• Python: docspace-api-sdk on PyPI

Comece a construir hoje mesmo

As últimas atualizações do ONLYOFFICE Docs e DocSpace oferecem um conjunto de ferramentas mais rico e poderoso para desenvolvedores. Desde um controle e personalização mais profundos da API nos editores até um SDK mais robusto para plug-ins do DocSpace, essas melhorias foram projetadas para ajudá-lo a criar soluções mais integradas e ricas em recursos.

Recomendamos que você explore a documentação atualizada, baixe os SDKs mais recentes e comece a implementar esses novos recursos em seus projetos. Estamos ansiosos para ver o que você criará!

Obtenha a versão mais recente do ONLYOFFICE Docs para desenvolvedores:

DOWNLOAD