Páginas filhas
  • Exemplo de utilização da Action de Funcionários em um Projeto Metadados

Exemplo de utilização da Action de Funcionários em um Projeto Metadados

Produto:

RM

Versões:

12.1.XX

Ocorrência:

Utilizando MetaDados com uma Action em um controle do tipo Caixa de Pesquisa

Ambiente:

MetaDados

Passo a passo:

O objetivo desse documento é orientar como criar um projeto MetaDados utilizando uma Action do sistema em um controle do Tipo Caixa de Pesquisa.


Para exemplificar, criei um MetaDados simples utilizando apenas uma tabela, nomeada como ZMDACTION. Essa tabela possui os seguintes campos:

  • ID do tipo de dados inteiro e Numeração Automática para gerar o ID em auto incremento, criado apenas para ser chave primária da tabela.
  • CODCOLFUNC do tipo inteiro, criado para ser utilizado como Chave do LookUp e Action.
  • CHAPAFUNC do tipo varchar, criado para armazenar o valor retornado pela Action e também ser utilizado como Chave do LookUp e Action.


OBSERVAÇÂO 1

Lembre-se de marcar a opção "Descrição para Lookup" quando o campo selecionado for ser usado como Descrição de Lookup configurado na tela de "Modelo de Negócio".


Já no Modelo de negócios, inserir na aba Estrutura de dados à tabela acima criada e na aba de Controles defini os tipos de controle de cada campo, conforme abaixo:

  • ID Tipo de controle Caixa de Edição.
  • CODCOLFUNC Tipo de controle Caixa de Edição.
  • CHAPAFUNC Tipo de controle Caixa de Pesquisa


No campo CHAPAFUNC, ao configurá-lo como Caixa de Pesquisa, será exibido o menu Definições de Caixa de Pesquisa, onde nesse menu serão realizadas as configurações da Action utilizada. No meu exemplo, informei a Action de Funcionários ( FopFuncAction) em Action fonte de dados. Em Relacionamento informei quais campos da minha tabela se relacionam com os campos “chaves “da Action de funcionários, no meu exemplo o campo CODCOLFUNC se relaciona com o Código da Coligada e o CHAPAFUNC com a Chapa do Funcionário.  Já em Campo Descrição da Fonte de dados, será informado qual o campo de retorno feito pela pesquisa na Action, nesse exemplo utilizei o Nome do Funcionário. Por último em Todos os campos a Serem Retornados, informei quais os campos da Action em que a busca pelo dado desejado pode ser realizada.


OBSERVAÇÃO 2

Devemos prestar atenção no Relacionamento, o último campo é aquele cujo lookup entende como coluna principal (Main Column), e todas as ações tomadas pelo lookup serão apartir dela, por isso é muito importante colocar em ordem, as chaves da action nessa tela conforme a ordem estabelecida na própria action.

No caso da Action FopFuncAction é:

1) CODCOLIGADA

2) CHAPA

Caso o relacionamento seja feito errado, ao gerar o projeto, e abrir o formulário criado, você perceberá que o lookup criado estará desabilitado e qualquer ação realizada no controle, levantará uma exceção como a abaixo:



No meu de Formulários, localizei o Modelo de Negócios criado acima e em Apresentação informei o tipo GroupBox.

Feito todo o procedimento para criação do projeto MetaDados, criei um novo Projeto utilizando a apresentação criada acima. Inseri o menu criado dentro do cadastro Customização do RMLABORE e gerei o projeto pelo menu Processos\Gerar Projeto MetaDados. 


Após gerar o projeto, pode ser necessário conceder permissões no perfil do usuário no módulo, em meu exemplo RMLABORE.

Ao reiniciar o Serviço do HOST para que as DLL do projeto sejam, acesse o menu em que o projeto foi designado, aplique um filtro e perceba que será retornado a visão sem nenhum dado. 

Ao clicar no botão Incluir, será exibida uma janela de acordo com a Apresentação criada acima e print abaixo. O ID por ter sido criado como Numeração Automática, o seu valor será preenchido de forma automática. Em CODCOLFUNC pode ser informado qualquer valor inteiro e em CHAPA, ao clicar no botão em vermelho, será exibida uma caixa de pesquisa onde a pesquisa pode ser realizada por qualquer dos campos informados no Modelo de Negócios. Outra maneira de realizar a pesquisa, é informar o valor da chapa no campo em azul no print abaixo.


Ao realizar a busca de qualquer uma das duas maneiras acima, o nome do funcionário será exibido conforme abaixo.

Clicando no botão salvar, a chapa do funcionário será salva na tabela do MetaDados. Ao editar o cadastro do projeto e clicar no nome ITAMAR MENDES DA SILVEIRA, será exibida a tela do cadastro de funcionário do RMLABORE.

Observações: