Resumo da API: últimas atualizações para o ONLYOFFICE Docs

Desde opções de personalização atualizadas até SDKs e geração de macros com tecnologia de IA, essas atualizações foram projetadas para aumentar a produtividade e a criatividade de todos os desenvolvedores e integradores. Aqui está uma análise detalhada das novidades.

Novidades na integração do Docs

Lançamos atualizações em nossos SDKs para integrar os editores do ONLYOFFICE aos seus próprios aplicativos e serviços. As versões mais recentes dos SDKs Java e PHP trazem suporte aprimorado a formatos, novas opções de configuração e a adição de um novo tipo de visualizador — Diagrama. Vamos dar uma olhada mais de perto nas novidades.

Java SDK 1.6.0

Disponível em Maven Central o SDK Java recém-atualizado disponibiliza:

• Novo tipo de visualizador: Diagrama. O SDK agora oferece suporte à inicialização do visualizador de diagramas do ONLYOFFICE, introduzido na versão 9.0.
• Novos campos de configuração. Compatível com a versão 9.0 do editor, permitindo um controle mais granular sobre a inicialização do editor.
• Lista atualizada de formatos suportados. Garante compatibilidade com os tipos de arquivo mais recentes de documentos, planilhas, apresentações, formulários e diagramas.
• Atualizações de dependências. Todos os componentes com vulnerabilidades conhecidas foram atualizados para melhorar a segurança e a estabilidade.

PHP SDK 1.3.0

Disponível em Packagist a nova versão do PHP SDK suporta:

• Novo tipo de visualizador: Diagrama. Os desenvolvedores agora podem integrar o visualizador de diagramas do ONLYOFFICE, ideal para fluxogramas, mapas mentais e muito mais.
• Suporte para visualização de arquivos .odg e .md . Expande a compatibilidade de arquivos para formatos abertos e arquivos Markdown.
• Suporte para edição de arquivos .xlsb. Agora você pode integrar recursos de edição para pastas de trabalho binárias do Excel.
• Novos modelos de arquivo vazios. Adicionados para os seguintes idiomas: Catalão (ca-ES), Tcheco (cs-CZ), Dinamarquês (da-DK), Húngaro (hu-HU), Indonésio (id-ID), Romeno (ro-RO), Albanês (sq-AL), Urdu (ur-PK).
• Versão mínima do editor compatível: 8.0. Certifique-se de que sua instância do ONLYOFFICE Docs esteja atualizada para compatibilidade total.

Recomendamos que todos os desenvolvedores que integram editores do ONLYOFFICE atualizem para as versões mais recentes do SDK para aproveitar os novos recursos e manter a compatibilidade com o ONLYOFFICE Docs 8.0 e superior.

O que há de novo na API Docs

Perguntas frequentes sobre personalização. Adicionamos mais respostas às suas perguntas frequentes, oferecendo insights sobre opções de personalização menos conhecidas.

• Como desabilitar dicas de recursos no editors para manter uma interface mais limpa.
• Como alterar a fonte e o tamanho do texto para um layout de editor personalizado.
• Como ocultar ícones de usuários ativos e nomes de usuários no cabeçalho do editor para maior privacidade.

Novos exemplos da API do Office. Para oferecer suporte a diversos casos de uso, apresentamos novos exemplos de criação de documentos com aplicações práticas.

• Layouts de duas colunas. Gere rapidamente documentos profissionais, como brochuras ou relatórios, em um formato compacto de duas colunas.
• Layouts de paisagens. Crie páginas com orientação paisagem, ideais para acomodar tabelas e gráficos amplos.
• Marcas d’água de texto. Automatize a inserção de marcas d’água “Confidenciais” semitransparentes para manter a segurança dos documentos.
• Convites para eventos. Crie convites com dimensões predefinidas e mensagens personalizadas para eventos.

Novidades para plugins e macros

Personalização de macros atualizada. Com o lançamento da versão 9.0.3, melhoramos o comportamento do parâmetro da macro customization.macros. Contexto macros para false agora desabilita completamente a funcionalidade de macros. Isso significa que os usuários não podem executar, adicionar ou editar macros; o botão Macros fica oculto na aba Exibir.

const config = {
  editorConfig: {
    customization: {
...
macros: false, 
...

Geração de macros com tecnologia de IA. A integração de IA no desenvolvimento de macros acelera muito o processo de criação de macros para o ONLYOFFICE.

Começando com versão 9.0, o AI plugin pode gerar modelos de macro a partir de descrições textuais, economizando horas de esforço manual. Saiba mais

Além disso, você pode converter automaticamente o código VBA em macros baseadas em JavaScript do ONLYOFFICE.

Aqui estão três exemplos de macros convertidas do VBA usando IA:

• Desfazer a mesclagem de todas as células. Simplifique a formatação de planilhas removendo todas as mesclagens de células em um comando.
• Converter fórmulas em valores. Converta rapidamente cálculos dinâmicos em dados estáticos para consistência.
• Alterar valor da célula. Automatize a personalização para células específicas.

Confira um exemplo de macro para alterar o valor da célula selecionada:

(function(){
    // Get the active sheet
    var activeSheet = Api.GetActiveSheet();
    
    // Select cell A1
    activeSheet.GetRange("A1").Select();
    
    // Set the value of the selected cell to "Hello World"
    activeSheet.GetRange("A1").SetValue("Hello World");
})();

Cálculos assíncronos. Adicionar funções personalizadas assíncronas para gerenciar qualquer solicitação dentro do corpo da função. Confira um exemplo de calculando o indicador do Banco Mundial.

Novos exemplos de macro. Expanda suas capacidades com novos exemplos de macro que simplificam os fluxos de trabalho de documentos (além disso, faça uso do recurso adicionado instrução sobre como executar uma amostra de macro).

Ao incorporar essas macros, você pode reduzir a sobrecarga manual e melhorar a eficiência operacional:

• Campos de preenchimento automático
• Ajustar campos de texto automaticamente
• Inserir cálculos
• Limitar o número de caracteres
• Modificar valores da lista
• Remover valores padrão
• Definir marcador de posição
• Marcadores em negrito
• Gerar esboço
• Remover slides duplicados
• Remover slides
• Encontrar e-mails inválidos

Confira o exemplo de código para definir um espaço reservado:

(function () {
    let key = "MyKey";
    let placeholderText = "Placeholder";
    let doc = Api.GetDocument();

    doc.GetAllForms()
        .filter(field => field.GetFormType() === "comboBoxForm" && field.GetFormKey() === key)
        .forEach(field => field.SetPlaceholderText(placeholderText));
})();