Visando facilitar o instanciamento de registros existentes no dicionário de dados em um Projeto do Gestão de Ambientes, foi desenvolvido o Instanciamento de Artefatos. Com ele pode-se adicionar a um projeto existente um ou mais registros de um determinado dicionário de dados de forma simplificada e rápida, e através da Geração de Pacotes ou Dicionário de Dados Diferencial do projeto, criar esses registros instanciados na base de dados de destino rapidamente e de forma consistente através do UPDDISTR ou MPUPDATEPACK.   
Essa documentação é dividida em duas etapas, sendo a primeira etapa os dicionários de dados sem relacionamento (SX1, SX5, SX6, SX7, SXB, XAL e XAM) e na segunda etapa os dicionários de dados com relacionamento (SX2, SX3, SIX, SXA, XXA, SXQ e SXR)

Este recurso está disponível a partir da LIB versão 20240226.


Para se instanciar registros de um dicionário de dados no projeto, deve-se acessar o Cadastro de Projetos (Configurador > Base de Dados > Gestão de Ambientes > Cadastro de Projetos), clicar sobre o projeto que deseja que os registros sejam instanciados e clicar no botão Detalhes do Projeto



01. Dicionário de dados sem relacionamento

Em Detalhes do Projeto, selecione no menu lateral abaixo da Base de Dados o dicionário que deseja instanciar seus registros sendo eles: Gatilhos, Tabelas Genéricas, Parâmetros, Perguntas, Consulta Padrão, Grupo de dados protegidos e Dados protegidos.  Após clique no botão Outras Ações localizado no canto superior direito da tela e clique em Instanciamento de artefatos:





Caso já possua algum registro no projeto para o dicionário de dados selecionado, será apresentada a mensagem abaixo:



Se instanciar um registro que já exista no projeto, este será sobreposto. Analise atentamente, caso deseje continuar quando apresentada essa mensagem.




Será aberto o aplicativo de acordo com o dicionário selecionado e  serão listados todos os registros para seleção pertencentes ao dicionário escolhido. Em nosso exemplo selecionamos os Gatilhos que correspondem a tabela SX7:




Devemos selecionar os registros que desejamos instanciar no projeto e após clicar no botão Instanciar no projeto



Observação: Ao utilizar a pesquisa, o termo digitado será buscado em todas as colunas exibidas na tela. Poderá selecionar todos os registros exibidos e ordenar tanto pelas colunas, quanto pelos registros selecionados para melhor visualização dos dados.




Após instanciar os registros no projeto, você permanecerá no Instanciamento de Artefatos do dicionário selecionado, para caso deseje instanciar mais dados. Se desejar voltar a tela inicial poderá clicar em Sair no menu lateral ou em Detalhes do Projeto localizado no BreadCrumb da página: 



Observação: Ao sair, caso possua registros selecionados e não instanciados no projeto, será exibida uma mensagem de confirmação, garantindo que o trabalho realizado não seja perdido devido a uma ação incorreta na página.




Após sair, você será direcionado para a Home do projeto. Clicando nos botões do dicionário instanciado, poderá visualizar que os registros selecionados no passo anterior foram instanciados no projeto:




Observação: Através da visualização dos dados no projeto (tela acima), também é possível abrir o Instanciamento de Artefatos para o dicionário de dados que está sendo visualizado clicando no botão Outras Ações e após em Instanciamento de Artefatos.


02. Dicionário de dados com relacionamento

Em Detalhes do projeto, selecione no menu lateral abaixo da Base de Dados a opção Dicionário de dados. Após clique no botão Outras Ações localizado no canto superior direito da tela e clique em Instanciamento de Artefatos:




Caso já possua algum registro no projeto para o dicionário de dados selecionado, será apresentada a mensagem abaixo:



Se instanciar um registro que já exista no projeto, este será sobreposto. Analise atentamente, caso deseje continuar quando apresentada essa mensagem.



Será aberto o aplicativo referente aos dicionário de dados com relacionamento:




Clique em Adicionar para escolher uma Tabela (SX2) e selecionar os respectivos registros vinculados a mesma. Após selecionar a tabela, clique em Avançar:




Na segunda etapa, deve informar se o registro selecionado na etapa anterior Tabelas (SX2), deve ser instanciado no projeto, marque Sim ou Não:




Ainda na segunda etapa, note que existe um conjunto de abas, qual cada representa um dicionário de dados que possui vinculo ao dicionário de dados Tabelas (SX2). Cada aba conterá os registros relacionados a tabela escolhidos na etapa anterior. Selecione os registros desejados para cada dicionário:

Observação: Ao utilizar a pesquisa, o termo digitado será buscado em todas as colunas exibidas na tela. Poderá selecionar todos os registros exibidos e ordenar pelas colunas para melhor visualização dos dados dispostos em cada aba.




A etapa seguinte, Revisão, irá exibir os dados selecionados na etapa anterior para que se certifique de ter selecionado todos os dados desejados:




Clique em Finalizar caso esteja certo disso. Será exibida uma mensagem para confirmar o salvamento do mesmo. Caso deseje pode cancelar e continuar editando: 

Observação: Caso necessário poderá editar posteriormente, nesse momento os dados ainda não estão instanciados no projeto.




Após clicar em Apenas salvar você será direcionado a tela inicial novamente, e o registro recém adicionado será apresentado na tela inicial, como no exemplo abaixo: 

Observação: Ao utilizar a pesquisa, o termo digitado será buscado em todas as colunas exibidas na tela. Poderá selecionar todos os registros exibidos e ordenar pelas colunas ou pelos itens selecionados para melhor visualização dos dados dispostos na tela.




Note que serão exibidas todas as tabelas selecionadas e os dicionários selecionados que estão vinculados a essa tabela. Caso deseje remover um item, poderá selecioná-lo e clicar no botão Remover:




Caso deseje adicionar mais registros de um determinado dicionário de dados vinculado a uma tabela, selecione o item na tela inicial. Note que o botão Adicionar irá alterar sua nomenclatura para Editar. Modifique o registro conforme desejado e salve o mesmo:




Após adicionar todos os registros que deseja instanciar no projeto, na tela inicial selecione os itens desejados, e clique no botão Instanciar no projeto:




Após instanciar os registros no projeto, você permanecerá no Instanciamento de Artefatos do dicionário selecionado, para caso deseje instanciar mais dados. Se desejar voltar a tela inicial poderá clicar em Sair no menu lateral da página: 

Observação: Ao sair, caso possua registros não instanciados no projeto, será exibida uma mensagem de confirmação, garantindo que o trabalho realizado não seja perdido devido a uma ação incorreta na página.




Após sair, você será direcionado para a Home do projeto. Clicando nos botões do dicionário instanciado poderá visualizar que os registros selecionados no passo anterior foram instanciados no projeto: