Como criar painéis de informação relacionada com base numa query?
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. Para construção de painéis, existem já três tipos de componentes disponibilizados pela PRIMAVERA e que podem ser reutilizados. São eles: 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: TypeClassName: Nome do controlo que será incluido no Painel (CI_Lista, CI_Registo, etc) 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. 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. 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. De seguida, é apresentado o código SQL que associa o componente, definido anteriormente ao ecrã/formulário de manutenção de artigos. 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 = 2Tipos de componentes
Criar painéis de informação relacionada
Campos Descrição ID Identificador do componente (que será utilizado posteriormente para associar um ecrã/formulário). Categoria Categoria de informação que identifica a entidade a que está associado o componente, por exemplo "Artigo". Config Parametrizaçã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.
SqlQuery: A query SQL que alimentará a grelha e respectivo gráfico.
Grid: Definição das colunas da grelha
Cada componente está associado a um tipo de entidade através da Categoria correspondente. Neste caso, a Categoria é 'Artigo'.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
'
)
Campo Descrição IdCategoria Identificador do componente criado anteriormente Contexto O nome lógico do Form do ERP onde o Componente deve ser exibido Ordem Posição em que o componente deve aparecer, caso existam outros para o mesmo Form e Categoria Params Lista 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) INSERT INTO [dbo].[ContextosInformacaoRelacionada]
([IdCategoria]
,[Contexto]
,[Ordem]
,[Params])
VALUES
('65336A27-A96B-4CD2-8ED7-70AD00539888'
,'frmTabArtigos'
,2
,
'
1
Entidade
@CHAVE@
')