Integração com Nextcloud
Pode utilizar Nextcloud como um armazenamento de ficheiros integrado no OpenProject.
Esta integração permite-lhe:
- Associar ficheiros e pastas armazenados no Nextcloud a pacotes de trabalho no OpenProject
- Visualizar, abrir e transferir ficheiros e pastas associados a um pacote de trabalho através do separador Ficheiros
- Visualizar todos os pacotes de trabalho associados a um ficheiro
- Criar pacotes de trabalho diretamente no Nextcloud
Além disso, pode:
-
Visualizar notificações do OpenProject através do painel de controlo do Nextcloud
-
Escolher e pré-visualizar ligações para pacotes de trabalho no Nextcloud
-
Pesquisar pacotes de trabalho através da barra de pesquisa do Nextcloud
Também é possível criar automaticamente pastas de projeto dedicadas, o que torna a estrutura da documentação mais clara e a navegação mais intuitiva.
Nota
Para poder utilizar o Nextcloud como um armazenamento de ficheiros no seu projeto, o administrador da sua instância deve primeiro ter concluído a configuração da integração do Nextcloud.
| Tópico | Descrição |
|---|---|
| Ligar as suas contas OpenProject e Nextcloud | Como ligar as suas contas Nextcloud e OpenProject para poder utilizar esta integração |
| Associar ficheiros e pastas a pacotes de trabalho | Como associar ficheiros e pastas a pacotes de trabalho e visualizar e transferir ficheiros associados |
| Desassociar ficheiros e pastas | Como remover a ligação entre um pacote de trabalho e um ficheiro ou pasta Nextcloud |
| Painel de controlo do Nextcloud | Como ficar atento às suas notificações do OpenProject |
| Navegação e pesquisa no Nextcloud | Como pesquisar pacotes de trabalho do OpenProject através da barra de pesquisa universal |
| Pré-visualização da ligação do pacote de trabalho no Nextcloud | Como utilizar o seletor inteligente e ver pré-visualizações de pacotes de trabalho em campos de texto |
| Permissões e controlo de acesso | Quem tem acesso aos ficheiros associados e quem não tem |
| Possíveis erros e resolução de problemas | Erros comuns e como os resolver |
Este vídeo dar-lhe-á uma visão geral completa de como configurar e trabalhar com a integração Nextcloud (apenas em inglês):
Este vídeo está disponível em inglês.
Ligue as suas contas OpenProject e Nextcloud
Para começar a utilizar esta integração, terá primeiro de ligar as suas contas OpenProject e Nextcloud. Para fazer isso, abra qualquer pacote de trabalho num projeto em que um armazenamento de ficheiros Nextcloud tenha sido adicionado e ativado por um administrador e siga estes passos:
-
Vá para o separador Ficheiros e, no cabeçalho “Nextcloud”, clique em Iniciar sessão no Nextcloud.
-
Verá um ecrã Nextcloud a pedir-lhe para iniciar sessão antes de conceder ao OpenProject acesso à sua conta Nextcloud. Também verá um aviso de segurança, mas como está de facto a tentar ligar as duas contas, pode ignorá-lo com segurança. Clique em Iniciar sessão e introduza as suas credenciais Nextcloud.
- Quando estiver conectado ao Nextcloud, clique em Conceder acesso para confirmar que deseja dar ao OpenProject acesso à sua conta Nextcloud.
- Será agora redirecionado para o OpenProject, onde também lhe será pedido que conceda ao Nextcloud acesso de leitura e escrita à sua conta OpenProject através da API. Isto é necessário para que a integração funcione. Clique em Autorizar.
- O processo único para ligar as suas duas contas está concluído. Será agora reencaminhado para o pacote de trabalho original, onde pode ver e abrir quaisquer ficheiros Nextcloud que já estejam associados, ou começar a associar novos ficheiros.
Nota
Para desligar a ligação entre as suas contas OpenProject e Nextcloud, vá até Nextcloud e navegue até Definições → OpenProject. Aí, clique no botão Desligar do OpenProject. Para voltar a associar as duas contas, basta seguir novamente as instruções acima.
Associar ficheiros e pastas a pacotes de trabalho
No OpenProject
Este vídeo dá-lhe uma visão geral de como associar ficheiros existentes e carregar novos ficheiros do OpenProject para o Nextcloud (apenas em inglês):
Este vídeo está disponível em inglês.
Além de listar os ficheiros diretamente associados a um pacote de trabalho, o separador Ficheiros mostra os seus ficheiros Nextcloud que estão associados ao pacote de trabalho atual. Ao passar o rato sobre qualquer ficheiro associado, terá opções para abrir ou transferir o ficheiro, mostrar a pasta que o contém no Nextcloud ou remover a ligação.
Associar ficheiros existentes
Para associar um ficheiro Nextcloud ao pacote de trabalho atual, pode:
- selecionar um ficheiro do seu computador, que será carregado para o Nextcloud e associado a este pacote de trabalho
- selecionar um ficheiro existente no Nextcloud para o qual criar uma ligação
Dica
O projeto predefinido que abre no seletor de localização é definido pelos administradores do projeto nas Definições de armazenamento de ficheiros.
Carregar e associar novos ficheiros
Se o ficheiro que pretende associar ainda não tiver sido carregado para o Nextcloud, pode fazê-lo clicando na ligação Carregar ficheiros.
Em seguida, ser-lhe-á pedido que selecione um ficheiro (ou vários ficheiros) no seu computador que pretende carregar para o Nextcloud.
Alternativamente, também pode simplesmente arrastar um ficheiro ou pasta do seu computador para a zona de arrastamento que aparecerá sob o nome do seu armazenamento de ficheiros Nextcloud.
Quando tiver selecionado ou largado os ficheiros que pretende carregar, terá de selecionar uma pasta no Nextcloud à qual estes devem ser adicionados.
Dica
O projeto predefinido que abre no seletor de localização é definido pelos administradores do projeto nas Definições de armazenamento de ficheiros.
Pode clicar nas pastas que vê para navegar até elas. Uma útil barra de navegação mostra-lhe onde se encontra na hierarquia de pastas.
Também pode criar diretamente uma nova pasta clicando no botão Nova pasta à esquerda.
Para navegar um nível acima ou para voltar à raiz, basta clicar no elemento principal relevante no caminho de navegação.
Dica
Se tiver navegado muito fundo (mais de 4 níveis), os níveis intermédios podem ser colapsados para poupar espaço, mas poderá sempre navegar de volta para o elemento principal imediato ou para a raiz para voltar atrás.
Para guardar os ficheiros que carregou na pasta atualmente aberta, clique no botão Escolher localização.
O ficheiro selecionado é carregado para a sua instância Nextcloud e associado ao pacote de trabalho atual. Aparece sob o nome do ficheiro de armazenamento.
Se um ficheiro tiver sido eliminado de um armazenamento Nextcloud, continuará a ser visível no separador Ficheiros para uma maior transparência. No entanto, não será selecionável. Se passar o rato sobre um ficheiro eliminado, verá a mensagem que indica que o ficheiro não foi encontrado.
Transferir, abrir pastas e remover ligações
Se quiser desassociar um ficheiro ou pasta associados, passe o cursor sobre o mesmo na lista de ficheiros associados e clique no ícone Desassociar.
Respetivamente, para transferir um ficheiro, passe o cursor sobre o ícone Transferir na lista dos ficheiros associados.
Se clicar no ícone Pasta, a pasta Nextcloud que contém este ficheiro será aberta num separador separado.
No Nextcloud
Este vídeo dá-lhe uma visão geral de como associar ficheiros e pastas do Nextcloud para o OpenProject (apenas em inglês).
Este vídeo está disponível em inglês.
Associar pacotes de trabalho
No ficheiro ou pasta que pretende associar a um pacote de trabalho, clique nos três pontos → Detalhes.
No painel lateral Detalhes, clique no separador OpenProject. Este separador permite-lhe associar pacotes de trabalho no OpenProject ao ficheiro atual e listará todos os pacotes de trabalho associados. Quando ainda não está nada associado, a lista estará vazia.
Para associar este ficheiro a um pacote de trabalho no OpenProject pela primeira vez, use a barra de pesquisa para encontrar o pacote de trabalho correto (pode pesquisar usando uma palavra no título do pacote de trabalho, ou simplesmente introduza o ID do pacote de trabalho) e clique nele.
Este ficheiro associado aparecerá então por baixo da barra de pesquisa. Se o fizer, também adicionará automaticamente o ficheiro ao separador Ficheiros do(s) pacote(s) de trabalho correspondente(s) no OpenProject.
Associar vários ficheiros a um pacote de trabalho
Pode também associar vários ficheiros a um único pacote de trabalho OpenProject. Para tal, selecione os ficheiros que pretende associar, clique no menu Ações e selecione a respetiva opção. 
Será aberta uma caixa de diálogo que lhe permitirá procurar e selecionar um pacote de trabalho OpenProject ao qual adicionar todos os ficheiros. Os ficheiros recentemente adicionados ficarão visíveis no separador Ficheiros do pacote de trabalho.
Criar um novo pacote de trabalho
Pode criar um novo pacote de trabalho OpenProject diretamente a partir do armazenamento de ficheiros Nextcloud. Para tal, selecione o ficheiro que pretende associair, escolha o separador OpenProject e clique em + Criar e associar um pacote de trabalho. 
Será aberta uma caixa de diálogo que lhe permitirá especificar o projeto, o nome do pacote de trabalho e mais detalhes. Depois de clicar em Criar, o novo pacote de trabalho será criado no projeto especificado e o ficheiro será associado a ele.
Remover ligações
Quando um pacote de trabalho estiver associado a um ficheiro, pode sempre desassociá-lo clicando no ícone desassociar.
Ser-lhe-á pedido que confirme que pretende desassociar. Clique em Remover ligação para o fazer.
Nota
Desassociar um ficheiro ou pasta remove simplesmente a ligação com este pacote de trabalho; o ficheiro ou pasta original não serão eliminados ou afetados de forma alguma. A única alteração é que deixará de aparecer no separador Ficheiros no OpenProject e o pacote de trabalho deixará de ser listado no separador “OpenProject” para esse ficheiro no Nextcloud.
Painel de controlo do Nextcloud
Para além das ações relacionadas com ficheiros individuais, também pode optar por apresentar o widget OpenProject no seu painel de instrumentos Nextcloud, de modo manter debaixo de olho as suas notificações OpenProject. 
Navegação e pesquisa no Nextcloud
Existem duas funcionalidades adicionais relacionadas com a integração que pode ativar no Nextcloud. Na sua página de definições pessoais, em OpenProject, encontrará estas opções:
- Ativar a ligação de navegação mostra uma ligação para a sua instância do OpenProject no cabeçalho do Nextcloud
- Ativar a pesquisa unificada para instâncias permite-lhe pesquisar pacotes de trabalho do OpenProject através da barra de pesquisa universal no Nextcloud
Pré-visualização da ligação do pacote de trabalho no Nextcloud
A partir da Aplicação de integração do Nextcloud do OpenProject 2.4, será apresentada uma pré-visualização da ligação do pacote de trabalho se você usar as aplicações Nextcloud Talk ou Text. Tenha em atenção que necessita do Nextcloud 26 ou superior para poder utilizar esta funcionalidade.
Pode copiar uma ligação de pacote de trabalho e colá-la num campo de texto, por exemplo, no Nextcloud Talk ou Nextcloud Collectives. Sempre que colar um URL para um pacote de trabalho num campo de texto, será apresentado um cartão para pré-visualizar o pacote de trabalho.
Alternativamente, pode utilizar / para ativar o seletor inteligente e encontrar o pacote de trabalho através de uma pesquisa.
Assim que tiver selecionado um pacote de trabalho para partilhar na aplicação de conversação ou de texto, será apresentada uma pré-visualização desse pacote de trabalho.
Permissões e controlo de acesso
Quando um ficheiro ou pasta Nextcloud está associado a um pacote de trabalho, um utilizador do OpenProject que tenha acesso a esse pacote de trabalho poderá:
- Ver o nome do ficheiro ou pasta associado
- Ver quando foi modificado pela última vez (ou criado, se ainda não tiver sido modificado)
- Ver quem o modificou pela última vez (ou quem o criou, se ainda não tiver sido modificado)
No entanto, todas as ações disponíveis dependem das permissões que o utilizador do OpenProject (ou mais precisamente, a conta Nextcloud associada a esse utilizador) tem no Nextcloud. Por outras palavras, um utilizador que não tenha permissão para aceder ao ficheiro no Nextcloud também não poderá abrir, transferir, modificar ou desassociar o ficheiro no OpenProject.
Possíveis erros e resolução de problemas
Não tem permissão para ver este ficheiro
Se não conseguir ver os detalhes de um ficheiro ou não conseguir abrir alguns dos ficheiros associados a um pacote de trabalho, isso pode estar relacionado com o facto de a sua conta Nextcloud não ter as permissões necessárias. Nesse caso, poderá ver o nome, a hora da última modificação e o nome do modificador, mas não poderá efetuar quaisquer outras ações. Para abrir ou aceder a estes ficheiros, contacte o seu administrador Nextcloud ou o criador do ficheiro para que este lhe conceda as permissões necessárias.
Utilizador sem sessão iniciada no Nextcloud
Se vir as palavras “Iniciar sessão no Nextcloud” onde normalmente veria uma lista de ficheiros associados no separador Ficheiros no OpenProject, é porque terminou a sessão (ou foi automaticamente terminada) no Nextcloud. Alternativamente, poderá ter iniciado sessão com uma conta diferente da que configurou para utilizar com o OpenProject.
Nesse caso, continuará a poder ver a lista de ficheiros associados, mas não poderá executar quaisquer ações. Para restaurar a funcionalidade total, basta voltar a iniciar sessão na sua conta Nextcloud.
Erro de ligação
Se vir as palavras “Sem ligação no Nextcloud” no separador Ficheiros no OpenProject, a sua instância do OpenProject está a ter problemas em ligar-se à sua instância do Nextcloud. Isto pode dever-se a uma série de diferentes razões. O melhor que tem a fazer é entrar em contacto com o administrador das suas instâncias OpenProject e Nextcloud para identificar e resolver o problema.
Erro na obtenção de ficheiros
Em raras ocasiões, é possível que a integração não consiga obter todos os detalhes de todos os ficheiros associados. Uma simples atualização da página deve resolver o problema. Se o erro persistir, contacte o administrador das suas instâncias OpenProject e Nextcloud.
As notificações de projetos não são apresentadas no Nextcloud
Se as notificações do OpenProject não forem apresentadas corretamente no Nextcloud, vá às Definições de administração → Definições básicas → Trabalhos em segundo plano e certifique-se de que Cron está selecionado.
