ONLYOFFICE 10.0 para desenvolvedores: O que há de novo

ONLYOFFICE 10.0 traz um conjunto robusto de atualizações para desenvolvedores que criam soluções baseadas nos editores. Você ganha novos endpoints que simplificam o manuseio de arquivos, edição de PDF no Document Builder e uma API de Plugins modernizada com métodos assíncronos. A versão também adiciona novos controles para recursos de IA e configurações mais seguras em todo o servidor.

Abaixo, uma rápida apresentação das mudanças que mais importam para suas integrações, além de algumas mudanças de comportamento para verificar antes de atualizar.

Ferramentas de IA, opções de personalização de IA e gerenciamento de IA no servidor

ONLYOFFICE Docs 10.0 traz Ferramentas de IA para cada editor. Mais do que geração básica de texto, elas entendem a estrutura do documento, reconhecem elementos, conectam conteúdos entre seções e criam referências clicáveis para facilitar a navegação. Você pode conectar qualquer modelo de IA, incluindo modelos locais para casos de uso sensíveis à privacidade, e atribuir diferentes modelos a diferentes tarefas.

Nas edições comerciais do ONLYOFFICE Docs 10.0, os administradores podem configurar provedores de IA uma vez no Painel de Administração. Uma vez configurado, os usuários editores recebem ferramentas de IA prontas para uso sem precisarem inserir suas próprias chaves de API. Os administradores podem atribuir diferentes modelos a tarefas específicas, conectar servidores MCP para acesso a ferramentas externas e controlar se a pesquisa na web está disponível. Uma vez que a configuração do lado do servidor é salva, os usuários ficam limitados aos provedores e modelos aprovados — eles não podem mais adicionar suas próprias chaves ou mudar qual modelo é usado. Saiba mais

Você decide se as ferramentas de IA aparecem no seu produto. A versão 10.0 oferece dois níveis de controle:

• Por instância do editor: Use editorConfig.customization.ai com o parâmetro disabled para ocultar recursos de IA em uma configuração específica do editor.
• Em todo o servidor: Use a aiSettings.enable configuração do servidor para desativar recursos de IA e excluir Ferramentas de IA do /plugins.json.

Isso é útil se você atender diferentes níveis de clientes ou se algumas implantações precisarem permanecer sem IA por razões de conformidade.

Aplicativos modulares

ONLYOFFICE Docs 10.0 introduz aplicativos modulares – uma nova maneira de estender os editores sem alterar seu núcleo. Aplicativos como agentes de IA, Formulários, Salas e Arquivos se conectam ao ONLYOFFICE Docs e adicionam novas funcionalidades.

Para os desenvolvedores, isso significa que você pode ativar apenas as capacidades que seus usuários precisam, manter sua integração enxuta e expandir passo a passo à medida que seu produto cresce.

Melhorias de segurança e arquitetura

A versão 10.0 ativa várias proteções como “ativadas por padrão”, de modo que novas integrações comecem a partir de uma base mais segura.

• JWT habilitado por padrão. O JWT agora está ativado em default.json.
• Tratamento de token mais rigoroso. Se um segredo estiver vazio ou não definido, inclusive segredos de locatário, o ONLYOFFICE Docs agora rejeita o token em vez de verificá-lo ou assiná-lo.
• Tokens escopados para APIs de serviço. /converter, /docbuilder e /command não aceitam mais um token da configuração do editor. Um novo campo operation no token é opcional para essas solicitações e obrigatório para /converter/from-file e /docbuilder/from-file.
• Verificação de integridade para arquivos baixados. Quando sua integração envia cabeçalhos de integridade, o servidor verifica os arquivos baixados com base neles. Os cabeçalhos suportados incluem Content-Digest, Repr-Digest, x-amz-checksum-* e WOPI SHA256. Isso é controlado por services.CoAuthoring.requestDefaults.checksumVerification, que é true por padrão.
• Hosts WOPI explícitos. Hosts WOPI agora devem ser permitidos por uma regra de filtro de IP. A regra curinga allow: * não é mais suficiente, portanto, especifique cada host explicitamente.
• Controles de acesso à API. Use services.CoAuthoring.server.convertServiceEnable e services.CoAuthoring.server.docbuilderEnable para desativar as APIs de conversão pública e Document Builder. Ambas estão true por padrão.
• Configuração de execução mais restrita. Apenas o nível de log do log4js pode agora ser alterado via runtime.json.

Uma análise mais detalhada das últimas correções de segurança

Edição de PDF no Document Builder

O Document Builder agora pode editar PDFs, o que abre a porta para muitos novos cenários de automação:

• OpenFile lida com PDFs de forma inteligente. Formulários PDF criados no ONLYOFFICE abrem no editor de documentos. Outros PDFs abrem no editor de PDF com acesso total à API de PDF.
• PDFs protegidos por senha. O novo parâmetro m_sPassword em OpenFile permite que você abra arquivos protegidos.
• Criação de formulários PDF. Chame CreateFile com o tipo pdf para criar formulários PDF.

No lado do servidor, formulários salvos como um PDF regular agora são assinados quando os usuários os enviam. Isso oferece uma camada extra de confiabilidade em seus fluxos de trabalho de formulários.

Alexander Trofimov, Chefe da Equipe de Desenvolvimento do Editor da ONLYOFFICE:

Com o ONLYOFFICE Docs 10.0, tornamos os editores ainda mais seguros para suas integrações. Além disso, este lançamento traz suporte completo a PDF para o Document Builder, permitindo que desenvolvedores e usuários finais criem, editem e gerenciem PDFs diretamente do Builder sem depender de soluções alternativas ou ferramentas de terceiros.

Atualizações de implantação e administração

Executar o ONLYOFFICE Docs em produção também ficou mais fácil:

• Painel de Administração inicia com o servidor. Nas edições comerciais, o Painel de Administração agora é iniciado automaticamente por padrão. Ele também inclui blocos para visualização do segredo JWT e botões para abrir e iniciar ou parar o exemplo de teste.
• Criação de administrador via CLI. Agora você cria o primeiro administrador através do CLI do host documentserver-admin, usando create-admin e reset-admin-password. Isso substitui a antiga página da web que dependia de logs de inicialização.
• Recuperação automática de alterações não salvas. Se o servidor for desligado, as alterações não salvas são recuperadas automaticamente em “arquivos esquecidos”. O script separado changes2forgotten foi removido.
• Nova porta padrão. Instalações DEB e RPM agora usam a porta 8083 por padrão. Atualize suas regras de proxy e firewall, se necessário.
• Melhor monitoramento. A nova métrica coauth.connections inclui as tags mode (edição, visualização ao vivo, visualização) e replica.
• Flag de atualização do Desktop. No Windows, a flag de linha de comando --prefer-alternate-url permite que os Desktop Editors baixem atualizações de uma fonte alternativa.
• Página inicial renovada. A página de boas-vindas do servidor tem um novo design.

Novo suporte a formatos de arquivo

A versão 10.0 adiciona duas atualizações de formato que ajudam você a lidar com mais documentos com menos trabalho personalizado:

• Visualização e conversão de OFD. Você pode abrir e converter arquivos ofd. Assim como xps, eles abrem em modo somente visualização.
• Conversão para XLS. Você pode converter qualquer formato de planilha para o formato clássico xls. Isso é útil quando seus usuários ou parceiros ainda dependem de sistemas legados.

Endpoints multipart para upload direto de arquivos

Até agora, os serviços de conversão e Document Builder baixavam arquivos de origem de uma URL. Isso significava que você tinha que hospedar o arquivo em algum lugar que o servidor pudesse alcançar. A versão 10.0 adiciona dois novos endpoints que eliminam essa etapa:

• POST /converter/from-file
• POST /docbuilder/from-file

Ambos aceitam dados no formato multipart/form-data. Você pode enviar um arquivo ou um script diretamente na solicitação, para que não precise expô-lo através de uma URL temporária.

Esta é uma opção mais limpa para muitos fluxos de trabalho. Por exemplo, um serviço de backend pode converter uploads de usuário em tempo real ou executar um script do Document Builder sem primeiro preparar os arquivos.

Exemplo de solicitação: convertendo TXT para DOCX

curl -f -X POST "https://documentserver/converter/from-file" 
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Título do Documento Exemplo.txt"}' 
  -F 'file=@example.txt' 
  -o "Título do Documento Exemplo.docx"

Modernização da API de Plugins

A API de Plugins e Macros passou por sua maior atualização em um tempo.

Um novo objeto global Editor

Os métodos agora são chamados como funções regulares que retornam uma Promise. Em vez de direcionar cada chamada através de window.Asc.plugin.executeMethod, você pode escrever código assíncrono limpo:

const text = await Editor.GetSelectedText();

O resultado é um código mais curto e legível que se encaixa naturalmente em projetos modernos de JavaScript.

Novos métodos e eventos

A versão 10.0 também adiciona novas ferramentas para construir plugins mais ricos:

• Métodos: Editor.RunMacro, GetRestrictions, SetButtonDisabled, GetOFormRole
• Eventos: onFloatActionButtonClick, onSelectionEnd, onSelectionCancel

Por exemplo, os eventos de seleção permitem que seu plugin reaja no momento em que um usuário termina ou cancela uma seleção.

Ver a lista completa de mudanças da API de Plugins

Comece a construir com o ONLYOFFICE 10.0

A versão 10.0 oferece APIs mais limpas, mais poder de automação e configurações mais seguras. Aqui está um plano rápido para aproveitar ao máximo:

• Revise as mudanças de comportamento. Verifique o uso de tokens, regras de filtro de IP WOPI e a nova porta padrão.
• Atualize seus plugins. Mude para o objeto global Editor e substitua quaisquer métodos renomeados ou removidos.
• Experimente os novos endpoints. Teste /converter/from-file e /docbuilder/from-file em seus fluxos de trabalho de conversão.
• Decida sobre IA. Configure editorConfig.customization.ai ou aiSettings.enable para corresponder às necessidades do seu produto.

BAIXAR

Construindo com a versão em nuvem do ONLYOFFICE Docs? Experimente Docs Connect para uma maneira mais fácil de conectar os editores a plataformas e serviços externos. Ao contrário da versão auto-hospedada do ONLYOFFICE Docs, que exige que você implemente e mantenha os editores em seus próprios servidores, o Docs Connect cuida da hospedagem, manutenção e atualizações regulares para você.

Consulte o changelog completo para todos os detalhes e compartilhe seus comentários no fórum da comunidade ONLYOFFICE. Estamos ansiosos para ver o que você desenvolve!