Pular para o conteúdo principal

Alfresco Content App

Sobre a integração do ONLYOFFICE com o Alfresco Content App​

O ONLYOFFICE oferece uma integração oficial para levar a edição e a colaboração em documentos diretamente ao Alfresco Content App (ACA) — a interface moderna baseada em Angular para o Alfresco Content Services. Você pode baixar o pacote de integração no registro npm ou na página do GitHub do ONLYOFFICE.

observação

Esta integração é voltada especificamente ao Alfresco Content App. Se você usa o Alfresco Share, consulte o artigo Conector do ONLYOFFICE para Alfresco Share.

Principais recursos​

  • Criação, edição e visualização de documentos de texto, planilhas e apresentações.
  • Criação e preenchimento de formulários PDF preenchíveis.
  • Coedição de documentos em tempo real: dois modos de coedição (Rápido e Estrito), o modo Controle de alterações, comentários e o chat integrado.
  • Acompanhamento do histórico de versões do documento diretamente na interface do editor.
  • Conversão de arquivos para formatos OOXML e exportação para vários formatos.
  • Gerenciamento de permissões de documentos na interface de edição.
  • Ações avançadas do editor: inserir imagens do Alfresco, anexar arquivos para mala direta, selecionar documentos para comparação, usar plug-ins, inserir dados de links externos, navegar até a pasta do arquivo atual e criar novos documentos a partir do editor.
  • Suporte a JWT para proteger o seu tráfego, de modo que ninguém possa acessar os seus documentos, exceto usuários com os direitos adequados.

Formatos compatíveis​

  • Para edição: DOCX, XLSX, PPTX
  • Para visualização: DOCX, XLSX, PPTX, PDF e outros formatos de escritório
  • Para criação: DOCX, XLSX, PPTX, formulários PDF
  • Para conversão: formatos de escritório para OOXML
  • Para exportação: vários formatos, dependendo da configuração do backend
observação

A lista exata de formatos disponíveis para edição, visualização, conversão e exportação pode variar de acordo com a versão instalada e a configuração do backend.

Novidades da versão 1.0.0​

Lançamento inicial da integração do ONLYOFFICE para o Alfresco Content App.

O registro completo de alterações está disponível aqui.

Conectando o ONLYOFFICE Docs ao Alfresco Content App​

Requisitos​

Instalando a integração do ONLYOFFICE para Alfresco Content App​

  1. Instale o pacote da extensão:

    npm install @onlyoffice/alfresco-extension

  2. Registre a extensão no seu projeto ACA.

  3. Execute o aplicativo:

    npm run start

Para obter instruções detalhadas de instalação e configuração, consulte a documentação do projeto.

Ativando o JWT para a integração do ONLYOFFICE com o Alfresco Content App​

Para proteger os documentos contra acesso não autorizado, os editores do ONLYOFFICE usam o JSON Web Token (JWT). O token é adicionado à configuração quando o Editor de Documentos é inicializado e durante a troca de comandos entre os serviços internos do ONLYOFFICE Docs. A chave secreta é usada para assinar o JSON Web Token e validar o token na solicitação ao ONLYOFFICE Docs.

A partir do ONLYOFFICE Docs v7.2, o JWT é ativado por padrão e a chave secreta é gerada automaticamente. Você precisa encontrar a sua chave secreta no arquivo de configuração do ONLYOFFICE Docs e, em seguida, especificar a mesma chave secreta nas configurações da integração.

Etapa 1: Encontre a sua chave secreta no arquivo de configuração do ONLYOFFICE Docs

  1. Abra o arquivo local.json com qualquer editor de texto disponível.

    • No Linux — /etc/onlyoffice/documentserver/local.json
    • No Windows — %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • No Docker — acesse o contêiner do ONLYOFFICE Docs usando o comando docker exec -it <containerID> bash e abra /etc/onlyoffice/documentserver/local.json

    O arquivo local.json deve ter a seguinte aparência:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }

  2. O valor true é especificado em três seções, o que significa que a validação do token está ativada:

    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox

  3. A chave secreta gerada automaticamente é especificada em três seções. Você pode substituir o valor secreto padrão pelo seu próprio. A chave secreta deve ser a mesma nas três seções:

    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string

  4. Se fizer alterações, salve-as e reinicie os serviços para que as alterações de configuração entrem em vigor:

    supervisorctl restart all

Etapa 2: Especifique a mesma chave secreta nas configurações da integração

Nas configurações da integração, especifique a mesma chave secreta no campo Chave secreta e salve as configurações.

Começando a usar o ONLYOFFICE Docs no Alfresco Content App​

Após a instalação, novas ações do ONLYOFFICE ficam disponíveis diretamente na interface do Alfresco Content App.

Para editar um documento:

  1. Clique com o botão direito em um arquivo compatível na interface do ACA.
  2. Escolha Editar no ONLYOFFICE para abrir o arquivo no editor.

Para visualizar um documento:

  1. Clique com o botão direito no arquivo.
  2. Escolha Visualizar no ONLYOFFICE para abrir uma pré-visualização somente leitura sem baixar o arquivo.

Para criar um novo arquivo:

  1. Use a opção Criar no ONLYOFFICE na interface do ACA.
  2. Selecione o tipo de arquivo que deseja criar: Documento, Planilha, Apresentação ou Formulário PDF.
  3. O novo arquivo será aberto imediatamente para edição.

Para converter um arquivo para o formato OOXML:

  1. Selecione o arquivo no ACA.
  2. Clique em Converter no ONLYOFFICE.

Para exportar um arquivo em outro formato:

  1. Selecione o arquivo no ACA.
  2. Use Baixar como e escolha o formato desejado sem sair do Alfresco Content App.

Para saber mais sobre formulários, leia os artigos correspondentes sobre criação e preenchimento de formulários.