V10 RecursosGuias
RecursosGuias
Guias
Voltar | Lista de artigos

Como criar painéis de informação relacionada com base numa query?

Última alteração a 29/09/2021

Este documento descreve os passos necessários para a criação de painéis de informação relacionada para o ERP PRIMAVERA.

Os painéis de informação relacionada permitem carregar controlos criados pelo utilizador de forma a estender a informação de uma entidade. Este tipo de controlo revela-se especialmente útil no apoio à tomada de decisão, através da apresentação de conteúdos relacionados com o contexto no qual o utilizador está a trabalhar.

Adicionalmente, os painéis de informação relacionada, são vinculados a categorias (Clientes, Fornecedores, Artigos, etc.) ao invocar o “F4” no ERP, sendo desta forma exibidos apenas quando essas categorias forem selecionadas ou invocadas.

É possível ativar/desativar a abertura automática de painéis de informação relacionada através da opção de Contexto | Informação Relacionada. O fecho manual do painel desativa esta opção.

Tipos de componentes

Para construção de painéis, existem já três tipos de componentes disponibilizados pela PRIMAVERA e que podem ser reutilizados. São eles:

  • CI_Registo: permite exibir uma lista de atributos de uma determinada entidade. Este componente está preparado para exibir atributos de vários tipos, tais como: texto, valores numéricos, datas, imagens, etc.
  • CI_Lista: permite exibir uma tabela de dados.
  • CI_Lista(Gráfico): permite exibir uma tabela de dados na forma de gráfico.

Criar painéis de informação relacionada

Passo 1 - Registar o painel 

Os painéis de informação relacionada são registados na base dados, nas tabelas Informacao Relacionada, que guarda a definição e origem de dados  do painel, e na tabela Contextos Informacao Relacionada que, por sua vez, guarda o local onde o painel é executado.

Tabela de Informação relacionada:

CamposDescrição
IDIdentificador do componente (que será utilizado posteriormente para associar um ecrã/formulário).
CategoriaCategoria de informação que identifica a entidade a que está associado o componente, por exemplo "Artigo".
ConfigParametrização do componente. Os elementos principais desta configuração passam pelo local onde deve ser colocado o nome do componente que será incluído no painel, que alimentará a grelha e o respectivo gráfico, e pela definição das colunas da grelha.

TypeClassName: Nome do controlo que será incluido no Painel (CI_Lista, CI_Registo, etc)
SqlQuery: A query SQL que alimentará a grelha e respectivo gráfico.
Grid: Definição das colunas da grelha

De seguida, é apresentado um exemplo de um componente que tem com objetivo verificar a disponibilidade do stock. É utilizado o Componente CI_Lista, sendo a origem da informação uma query sobre a tabela: ArtigoArmazem.
Cada componente está associado a um tipo de entidade através da Categoria correspondente. Neste caso, a Categoria é 'Artigo'.

De realçar que os dois modos de exibição (Gráfico ou Tabela), associados a componente CI_Lista, são independentes e opcionais. Nesse sentido, a apresentação do gráfico depende do estado do atributo Visible associado a tag Graph, ou seja, se não pretender o modo de visualização em gráfico, basta atribuir o valor zero ao atributo Visible.

INSERT INTO [dbo].[InformacaoRelacionada]
			   ([Id]
			   ,[Categoria]
			   ,[Config])
		 VALUES
			   ('65336A27-A96B-4CD2-8ED7-70AD00539888',
				'Artigo',
	'
	  
		PriCloudLibrary900.CI_Lista
		Exemplo: DisponibilidadesStock
		
		Disponibilidades de Stock
		0
		2000
	  
	  
		
			  SELECT AA.Armazem,AA.Localizacao,AA.StkActual,AA.QtReservada,AA.QtTransito       
			  FROM dbo.ArtigoArmazem AA
			  WHERE AA.Artigo= ''@@Entidade@@'' AND AA.StkActual > 0
		
	  
	  
		0
		1
		1
		
		  
			Armazem
			
		  
		  
			Localizacao
			
		  
		  
			StkActual
			
			1
		  
		   
			QtReservada
			
		  
		  
			QtTransito
			
		  
		
	  
	  
		0
	  
	'
	           
	)

Passo 2 - Associar o painel ao contexto 

Depois de ter definido o componente este tem de ser associado a um ou vários contextos (ecrãs do ERP). Para isso deve ser preenchida a informação na tabela ContextosInformacaoRelacionada. 

CampoDescrição
IdCategoriaIdentificador do componente criado anteriormente
ContextoO nome lógico do Form do ERP onde o Componente deve ser exibido
OrdemPosição em que o componente deve aparecer, caso existam outros para o mesmo Form e Categoria
ParamsLista de Parâmetros a transferir do Formulário para o Componente. Tipicamente existe apenas  1 parâmetro: @CHAVE@ que contém a chave primária da entidade em causa e que será aplicado diretamente na query SQL (ie: @CHAVE@ = @@Entidade@@ = Código da Entidade)

De seguida, é apresentado o código SQL que associa o componente, definido anteriormente ao ecrã/formulário de manutenção de artigos.

INSERT INTO [dbo].[ContextosInformacaoRelacionada]
([IdCategoria]
,[Contexto]
,[Ordem]
,[Params])
VALUES
('65336A27-A96B-4CD2-8ED7-70AD00539888'
,'frmTabArtigos'
,2
,
'

1



Entidade
@CHAVE@


')

Nota: Para saber o nome das categorias de informação e formulários, utilizar o painel de diagnósticos do ERP. Para ativar o painel adicionar ao ficheiro Config.ini localizado na pasta Config do ERP a seguinte secção [Diag] Completo = 1 Destino = 2

Adicionar aos favoritos ou partilhar este artigo
Esta página foi útil?
Obrigado pelo seu voto.
Artigos Relacionados
Começar a Usar Como criar um projeto de integração com Visual Studio? Como criar um projeto de extensibilidade de interface (PEX) com Visual Studio? Como criar um projeto de extensibilidade de API (Motor) com Visual Studio? Como criar separadores do utilizador com Visual Studio?