Ligações de Projeto

As Ligações de Projeto permitem que os objetos do mesmo Projeto utilizem uma ligação partilhada sem a associar às Funções da aplicação. São objetos do Catálogo Studio, criados e geridos no Designer por Projeto.

Diferenças em relação às ligações Environment

Aspeto	Ligação Environment	Ligação de Projeto
Gestão	Administradores autorizados, em Configurações	Owner e Editor, no Designer por Projeto
Visibilidade	Depende das Funções associadas	Depende da pertença ao Projeto
Utilização	Objetos compatíveis com as Funções necessárias	Todos os objetos compatíveis pertencentes ao Projeto
Nome	Não pode ser alterado após a criação	Pode ser atualizado por quem gere todos os Projetos associados
Partilha	Através de Funções	Através da associação a um ou mais Projetos

As ligações Environment continuam a funcionar com as regras existentes. Em particular, o respetivo nome mantém-se como referência estável apresentada nos Workflow e não pode ser alterado na interface correspondente.

Pré-requisitos e permissões

Para criar ou alterar uma Ligação de Projeto, é necessário ser Owner ou Editor do Projeto aberto. Se a ligação pertencer a vários Projetos, a gestão exige uma função com permissão de edição em todos os Projetos envolvidos.

Os Viewer podem ver a ligação no Catálogo e utilizá-la nos objetos a que têm acesso, mas não podem alterá-la. Os dados protegidos não são apresentados nos resumos nem nos seletores.

Criar uma ligação

1. Abra o Projeto no Designer Workbench.
2. Abra Ligações de Projeto no painel lateral direito.
3. Selecione Nova.
4. Introduza o nome e a descrição e escolha o tipo proposto.
5. Preencha os campos apresentados e selecione um ou mais Projetos editáveis. Para SSH, Autenticação permite escolher Palavra-passe ou Chave privada; o caminho da chave só é obrigatório com Chave privada.
6. Utilize Verificar para testar os dados introduzidos mesmo antes de guardar.
7. Guarde ou selecione Cancelar para abandonar a criação e fechar o painel.

A gravação e a verificação são efetuadas sem recarregar a página. Durante a criação, apenas estão disponíveis ações não destrutivas; desativar, revogar e eliminar aparecem depois de guardar. Se o teste falhar, o painel apresenta uma mensagem operacional: corrija os campos indicados e repita o teste.

aviso

Não introduza informações confidenciais no nome ou na descrição e não as copie para capturas de ecrã, tickets ou documentos partilhados.

Catálogo Studio e associação a Projetos

Após a criação, a ligação aparece no Catálogo Studio com o tipo Ligação de Projeto e nos Projetos aos quais está associada. Também aparece no modal Adicionar objeto ao Projeto quando pode ser adicionada ao Projeto selecionado.

Uma única ligação pode pertencer a vários Projetos: não é criada uma cópia e as alterações são partilhadas. Todos os objetos compatíveis de cada Projeto associado podem selecioná-la.

Utilizá-la nos objetos do Projeto

A opção Projeto ou Ligação de Projeto aparece nos seletores dos consumidores compatíveis, incluindo:

• Task de Workflow que utilizam ligações de base de dados ou SSH;
• fontes de dados das Vistas de Utilizador;
• entidades dos Modelos Semânticos;
• Data Resource dos Portais.

A ligação tem de pertencer a pelo menos um Projeto do objeto que a utiliza. Se um objeto for partilhado entre vários Projetos, o Sybot verifica se a referência continua válida no respetivo âmbito antes de guardar ou executar.

Alterar o estado e o âmbito

No painel lateral é possível atualizar a descrição, os campos permitidos, o nome, os Projetos associados e o estado. Uma ligação revogada não pode ser reativada.

O Sybot impede a remoção de um Projeto ou a eliminação da ligação quando esta ainda é utilizada por uma Task, uma Vista de Utilizador, um Modelo Semântico ou um Portal desse âmbito. Substitua ou remova primeiro a referência nos objetos indicados.

Importação e exportação

Os packages de Vistas de Utilizador, Modelos Semânticos e Portais registam a referência à Ligação de Projeto, mas não incluem os valores protegidos. Durante a importação, o Sybot propõe uma ligação compatível do Projeto de destino. Se não existir, crie-a ou associe-a ao Projeto e repita a operação.

Resolução de problemas

Problema	Verificação
A ligação não aparece	Verifique se está ativa, é compatível e está associada a um Projeto do objeto.
O painel está em modo de apenas leitura	Verifique se é Owner ou Editor em todos os Projetos associados.
Não é possível remover um Projeto	Procure os objetos indicados como dependências e substitua primeiro a ligação.
Uma importação exige uma associação	Crie ou associe uma Ligação de Projeto compatível no Projeto de destino.
O teste ou a Preview falham	Utilize a mensagem apresentada e comunique apenas o nome, a hora e a referência de diagnóstico, sem valores confidenciais.

Para conhecer o funcionamento geral do contexto, consulte Designer por Projeto. Para ligações administrativas baseadas em Funções, consulte Ligações.