ONLYOFFICE Docs 8.2 para desenvolvedores: Atualizações de API

Juntamente com o lançamento dos novos recursos do versão 8.2, atualizamos a API para os editores, a API do Office e os plug-ins, adicionamos a estrutura Java para o Document Builder e o SDK de integração PHP. Confira todos os detalhes abaixo.

Implementação do zero tempo de inatividade

A implementação com zero tempo de inatividade é uma ótima maneira de atualizar um aplicativo sem exigir nenhuma pausa. Portanto, é possível atualizar os editores sem precisar colocá-los off-line.

Como isso funciona? A instância do ONLYOFFICE Docs (Servidor de Documentos, DS) com a nova versão é lançada em paralelo ao Servidor de Documentos atualmente em execução. Novas sessões de edição são abertas no novo DS. A versão anterior do DS está funcionando até que os próprios usuários terminem suas sessões de edição. Somente depois disso o DS anterior é interrompido.

Se estivermos falando sobre os fragmentos de documentos do ONLYOFFICE, aqui podemos direcionar uma sessão de edição para o DS específico no cluster. Portanto, é possível ter Servidores de Documentos de diferentes versões trabalhando em paralelo. Não se esqueça de levar em consideração que a duplicação de recursos e o próprio processo de atualização podem levar algum tempo.

Observação: a implantação sem tempo de inatividade está disponível para o ONLYOFFICE Docs entregue como Kubernetes Shards. Interessado em saber mais? Basta entrar em contato conosco por meio de sales@onlyoffice.com.

SDK de integração PHP

Integre facilmente o ONLYOFFICE Docs em seu aplicativo escrito em PHP. O SDK inclui o código geral para integrações PHP, criando configuração de inicialização e manipulando métodos comuns no back-end. Dê uma olhada

O PHP SDK agora está implementado, por exemplo, na integração entre ONLYOFFICE e Chamilo.

Novos estilos de interface

O parâmetro editorConfig.customization.features traz mais dois campos – tabStyle e tabBackground. Dessa forma, você pode ajustar a aparência do editor a seu gosto.

O primeiro permite definir o estilo de Preenchimento (as guias da barra de ferramentas superior são exibidas de forma distinta) ou de Linha (as guias da barra de ferramentas superior são destacadas com sublinhado).

O último define se o plano de fundo das guias da barra de ferramentas superior corresponde ao plano de fundo do cabeçalho ou ao plano de fundo da barra de ferramentas.

Além disso, adicionamos o imageLight para o campo editorConfig.customization.logo. Ele define o caminho para o arquivo de imagem usado para o cabeçalho claro, por exemplo, no recém-adicionado tema Cinza.

const logo = {
  image: "https://example.com/logo.png",
  imageDark: "https://example.com/dark-logo.png",
  imageLight: "https://example.com/light-logo.png",
  url: "https://example.com",
  visible: true,
}

Inserção de texto de fontes de terceiros

O tipo de texto de inserção da seleção de documento é adicionado ao parâmetro c do método setRequestedDocument. Dessa forma, os usuários podem selecionar um documento do arquivo local/URL/armazenamento para inserir seu conteúdo no documento atual.

docEditor.setRequestedDocument({
  c: "insert-text",
  fileType: "docx",
  url: "https://example.com/url-to-example-document.docx",
...

Verificação do status do documento

O parâmetro de usuários agora é adicionado à resposta do comando info. Esse parâmetro define a lista dos identificadores dos usuários que abriram o documento para edição. Quando o documento tiver sido alterado, os usuários retornarão o identificador do usuário que foi o último a editar o documento.

{
  "error": 0,
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0", "78e1e841"]
}

O que mais foi alterado na API de documentos

• Novos parâmetros de solicitação para o API de conversão WOPI para trabalhar com documentos protegidos: Password e PasswordToOpen.
• O https://documentserver/coauthoring/CommandService.ashx endereço do command service é substituído por https://documentserver/command.
• Para o conversion service, Use o endereço https://documentserver/converter.
• O campo editorConfig.location está obsoleto. Use o arquivo editorConfig.region em vez disso, para definir o padrão das unidades de medida em todos os tipos de editor.
• O editorConfig.customization.toolbarNoTabs está obsoleto, use o campo  editorConfig.customization.features.tabStyle e editorConfig.customization.features.tabBackground em vez disso.

Obtenha a versão mais recente do ONLYOFFICE Docs Developer:

BAIXE AGORA

Notificações por e-mail: avisos de limite de licença e cota

Agora é possível enviar notificações por e-mail, por exemplo, informando que a licença está prestes a expirar ou que o limite de conexão está prestes a ser atingido.

Como isso funciona? Adicionamos a capacidade de definir as configurações do servidor de e-mail à configuração do servidor. Um servidor de e-mail externo é usado para enviar notificações, cuja conexão é realizada por meio da biblioteca Nodemailer. Muitas definições da configuração do servidor são transferidas diretamente para essa biblioteca.

Aprimoramentos da API para plug-ins

A API do plug-in também traz aprimoramentos úteis, como métodos para executar ações de desfazer e refazer.

• api.prototype.Undo = function()
• api.prototype.Redo = function()
• api.prototype.CanUndo = function()
• api.prototype.CanRedo = function()

Veja a lista completa das atualizações da API do plug-in.

Estrutura Java para o Document Builder

Para o ONLYOFFICE Document Builder, agora há um Java Builder Framework disponível. Ele contém uma coleção de bibliotecas, classes e funções que facilitam muito o desenvolvimento rápido de aplicativos em Java com recursos de criação de documentos.

OBTER O DOCUMENT BUILDER

Office API

Para o Office JavaScript API, Adicionamos vários métodos novos para a versão 8.2, incluindo aqueles para:

• faixas;
• Tabelas dinâmicas;
• espaços reservados;
• obtenção e substituição de palavras/frases;
• atualização de todos os campos;
• contornos;
• e outros.

Veja a lista completa de novos métodos.