Pipedrive para DocSpace

Requisitos

• ONLYOFFICE Document Server v6.1 (servidor ou versão cloud) ou posterior

  Você precisa de uma instância do ONLYOFFICE Docs que seja resolvível e conectável tanto do Plone quanto de qualquer cliente final. Deve ser capaz de fazer POST diretamente para o Plone.

  Consulte a página de documentação oficial para saber mais sobre a instalação do ONLYOFFICE Docs.
• Python 3.4 e posterior
• Plugin de integração ONLYOFFICE 3.0.1 ou posterior para Plone

Instalando o plugin de integração ONLYOFFICE para Plone

Configurando o plugin de integração ONLYOFFICE para Plone

Para configurar o plugin:

1. Vá para Configuração do Site.
2. Role para baixo até a seção Configuração de Complementos.
3. Pressione o botão Configuração ONLYOFFICE.
4. No campo Serviço de edição de documentos, especifique o endereço URL onde o ONLYOFFICE Docs está localizado.
   O endereço deve estar acessível do Plone, assim como o endereço do Plone deve estar acessível do ONLYOFFICE Docs.
5. No campo Chave secreta, especifique o segredo usado para assinar os dados.
   A partir do ONLYOFFICE Docs v7.2, o JWT está habilitado por padrão e a chave secreta é gerada automaticamente. Você precisa habilitá-lo no lado do Plone também: encontre sua chave secreta no arquivo de configuração do ONLYOFFICE Docs, depois especifique a mesma chave secreta nas configurações do conector. Para mais detalhes, veja a seção Habilitando JWT para a integração ONLYOFFICE e Plone deste artigo.
6. No campo Endereço do servidor para requisições internas do Serviço de Edição de Documentos, especifique o endereço usado para acessar o Plone do Serviço de Edição de Documentos.
7. No campo Endereço do Serviço de Edição de Documentos para requisições internas do servidor, especifique o endereço usado para acessar o Serviço de Edição de Documentos do Plone.

Desenvolvendo plugin Plone ONLYOFFICE

1. Clone o repositório e mude o diretório:

   git clone --branch deploy git@github.com:ONLYOFFICE/onlyoffice-plone.git cd onlyoffice-plone

2. Crie um virtualenv no pacote.
3. Instale os requisitos com pip.
4. Execute buildout:

   virtualenv . ./bin/pip install -r requirements.txt ./bin/buildout

5. Inicie o Plone em primeiro plano:

   ./bin/instance fg

Se você tem uma instância do Plone funcionando, pode instalar o plugin adicionando os arquivos do projeto ao diretório scr:

1. No diretório scr, crie o diretório onlyoffice.plone.
2. Coloque seus arquivos de projeto recebidos pelo Git no diretório onlyoffice.plone.
3. Edite o arquivo buildout.cfg:

   [buildout] ... eggs = onlyoffice.plone develop = src/onlyoffice.plone

4. Execute novamente buildout para que as mudanças tenham efeito:

   .bin/buildout

5. Então inicie ou reinicie sua instância do Plone.

O Plone é baseado no servidor Zope e não será executado como usuário root. Se você pretende executá-lo como usuário root, deve fornecer uma diretiva effective-user. Para fazer isso, adicione effective-user

< nome_usuario >

Atualizar plugin de integração Plone ONLYOFFICE

1. Se você especificou uma versão precisa do plugin no seu arquivo buildout.cfg (chamado pinning, e uma prática recomendada), como onlyoffice.plone = 1.0.0, atualize esta referência para apontar para a versão mais nova. Se a versão do plugin não for especificada, então a versão mais recente será carregada automaticamente:

   [versions] ... onlyoffice.plone = 1.0.1

2. Execute bin/buildout. Aguarde até que uma nova versão seja baixada e instalada.
3. Seu site pode aparecer distorcido ou até mesmo ficar inacessível até você completar o próximo passo.
4. Navegue para a tela Complemento (adicione /prefs_install_products_form à URL do seu site) e na lista Atualizações selecione onlyoffice.plone e clique em Atualizar onlyoffice.plone.

Como funciona

A integração ONLYOFFICE segue a API documentada aqui.

1. O usuário navega para um documento no Plone e seleciona a ação Editar ONLYOFFICE.
2. O Plone prepara um objeto JSON para o Document Server com as seguintes propriedades:
   • url: a URL que o ONLYOFFICE Docs usa para baixar o documento;
   • callbackUrl: a URL que o ONLYOFFICE Docs informa sobre o status da edição do documento;
   • key: o UUID+Timestamp Modificado para instruir o ONLYOFFICE Docs se deve baixar o documento novamente ou não;
   • title: o título (nome) do documento.
3. O Plone constrói uma página do template .pt, preenchendo todos esses valores para que o navegador cliente possa carregar o editor.
4. O navegador cliente faz uma requisição para a biblioteca JavaScript do ONLYOFFICE Docs e envia ao ONLYOFFICE Docs a configuração DocEditor com as propriedades acima.
5. Então o ONLYOFFICE Docs baixa o documento do Plone e o usuário começa a editar.
6. O ONLYOFFICE Docs envia uma requisição POST para callbackUrl para informar ao Plone que um usuário está editando o documento.
7. Quando todos os usuários e navegadores clientes terminam de editar, eles fecham a janela de edição.
8. Após 10 segundos de inatividade, o ONLYOFFICE Docs envia um POST para callbackUrl informando ao Plone que os clientes terminaram de editar o documento e o fecharam.
9. O Plone baixa uma nova versão do documento, substituindo a antiga.

Habilitando JWT para a integração ONLYOFFICE e Plone

Para proteger documentos de acesso não autorizado, os editores ONLYOFFICE usam o JSON Web Token (JWT). O token é adicionado na 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 token web JSON e validar o token mediante requisição ao ONLYOFFICE Docs.

A partir do ONLYOFFICE Docs v7.2, o JWT está habilitado por padrão e a chave secreta é gerada automaticamente. Você precisa encontrar sua chave secreta no arquivo de configuração do ONLYOFFICE Docs, depois especificar a mesma chave secreta nas configurações do conector.

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

1. Abra o arquivo local.json com qualquer editor de texto disponível.
   • Para Linux - /etc/onlyoffice/documentserver/local.json
   • Para Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Para Docker – acesse o container ONLYOFFICE Docs usando o comando docker exec -it <containerID> bash e abra /etc/onlyoffice/documentserver/local.json

     Alternativamente, você pode usar o seguinte comando para encontrar a chave secreta padrão sem abrir o local.json:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   O arquivo local.json deve ficar assim:

   {"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. Isso significa que a validação de token está habilitada.
   • 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 pela sua própria chave secreta. 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 você fizer alterações, salve-as e reinicie os serviços para que as mudanças de configuração tenham efeito.

   supervisorctl restart all

Passo 2: Especifique a mesma chave secreta nas configurações do conector

Nas configurações do conector, especifique o mesmo segredo no campo Chave secreta e salve as configurações.

Conectando ao ONLYOFFICE Docs demonstração

A partir da versão 3.0.0 do conector ONLYOFFICE, você pode testar os editores online ONLYOFFICE no Plone sem instalar o ONLYOFFICE Docs.

Para ativar a conexão, clique na caixa de seleção Conectar ao Document Server ONLYOFFICE demonstração e clique no botão Salvar.