Introdução
O objetivo dessa página é mostrar como tornar uma Consulta SQL em um Objeto de Negócio de forma a fornecer dados para o TReports. Smart View.
Nota |
---|
title | Configuração - Smart Client |
---|
|
Para ambientes Smart Client, pode ser necessário configurar o DNS externo no RM.exe via atributo nas configurações: Bloco de código |
---|
| <add key="HTTP_BASEURL" value="https://meudnsexterno:PORTA_HTTP" />
<add key="API_BASEURL" value="https://meudnsexterno:PORTA_DE_API" /> |
|
Etapas
Primeiro passo: na Na listagem de Consultas SQL (Visões de Dados), clicar clique com o botão direito sobre a Consulta SQL que se deseja associar a um Objeto de Negócio, selecionar . Então selecione o menu "Outras Informações" e em seguida clicar em "Objetos de Negócio de Consulta SQL":
![](/download/attachments/706142104/image2022-9-19_15-16-26.png?version=1&modificationDate=1663611386957&api=v2)
Dica |
---|
Outra forma é selecionar a Consulta SQL e em seguida clicar em "Anexos/Objetos de Negócio de Consulta SQL": Image Added
|
Aviso |
---|
Apenas os usuários perfis com permissão de à edição de Consultas SQL possuem acesso ao modal de à criação/edição de Objetos de Negócio de Consulta SQL. |
A criação Logo então, o módulo de Objeto de Negócio de uma Consulta SQL é realizada em 3 etapas será exibido, possibilitando a edição ou criação de um novo Objeto de Negócio a partir daquela Consulta SQL
Informações |
---|
|
Este processo é realizado em 3 partes, sendo: - Preenchimento das informações do Objeto de Negócio;
- Confirmação dos tipos de dados do esquema e dos parâmetros da Consulta SQL;
- Seleção dos perfis para permissão de acesso ao Objeto de Negócio;
|
Etapa 1 - Aviso |
---|
Em todas as etapas é exibido o status do Objeto de Negócio. Inicialmente ele é criado como inativo, sendo ativado apenas após a confirmação do esquema e dos parâmetros da Consulta SQL. Caso a Consulta SQL seja editada e seus parâmetros ou campos sejam modificados, o Objeto de Negócio será desativado e não aparecerá mais para uso no TReports enquanto não for acessado o módulo Objeto de Negócio de uma Consulta SQL e validada a etapa de Esquema e Parâmetros |
Ao acessar a interface de criação de objeto de negócio serão exibidos os campos para preenchimento das informações:
- Nome - Nome do Objeto de Negócio - Este é o nome que será exibido no TReports para seleção do Objeto de Negócio (
- Preenchimento obrigatório
- Mínimo de caracteres:
mínimo 4 e máximo 64 caracteres);- 4
- Máximo de caracteres: 64
- Descrição - Descrição do Objeto de Negócio (
- Preenchimento opcional
- Máximo de caracteres:
máximo 1024 caracteres);
É exibida ainda Nota |
---|
|
Nesta etapa também é exibida a informação da Área do Objeto de Negócio |
, a qual é . No caso de Consultas SQL, esta é definida com base no sistema a qual a Consulta SQL foi criada (no TReports os Objetos de Negócio são organizados por área |
, sendo obrigatória essa informação).Etapa 2 - Esquema e Parâmetros da Consulta SQL
Etapa 3 - Permissões de acesso
e por isso, essa informação é buscada automaticamente. |
Esquema e Parâmetros da Consulta SQL
Nesta etapa é necessário validar o mapeamento de campos e parâmetros da Consulta SQL para o Objeto de Negócio. É necessário preencher as seguintes informações para cada propriedade e parâmetro exibido:
- Nome Amigável: É como a propriedade será exibida no TReports. Por padrão é preenchida com o nome do campo na Consulta SQL, mas é possível personalizá-lo para aparecer de forma diferente no TReports, ao preencher essa informação.
- Tamanho máximo de 40 caracteres;
- Não pode ser nulo ou vazio;
- Tipo: É o tipo de dados das propriedades e parâmetros da Consulta SQL. Este campo é importante pois é ele que definirá como o dado será recebido, tratado e manipulado pelo TReports.
- É necessário que todas as propriedades/parâmetros tenham um tipo definido.
Dica |
---|
title | Tipos de dados possíveis |
---|
|
O RM tentará descobrir/resolver o tipo da propriedade/parâmetro automaticamente, porém pode ser que este descobrimento não seja possível ou que o usuário deseje que o campo seja interpretado de forma diferente pelo TReports. Neste caso, é necessário que o usuário escolha o tipo compatível com a propriedade/parâmetro dentre as opções listadas abaixo: - Boolean
- Byte;
- DateTime
- Decimal;
- Double;
- Int16;
- Int32;
- Int64;
- Single;
- String;
- UInt16;
- UInt32;
- UInt64
|
Dica |
---|
title | Ativando o Objeto de Negócio |
---|
|
Após validar e salvar as propriedades e os parâmetros com os tipos definidos, o Objeto de Negócio passa a ficar ativo e já está pronto para ser utilizado no TReports |
Segurança
Um Objeto de Negócio, como todo objeto do RM, possui a segurança atrelada aos perfis que lhe foram atribuitos, e dessa forma, nesta etapa devem ser definidas as permissões de acesso ao Objeto de Negócio. Essa definição pode ser feita de duas formas:
- Permitir acesso à Perfis selecionados;
- Permitir acesso à todos os usuários;
Aviso |
---|
Ambas as permissões são válidas apenas para usuários que possuam perfil no Sistema em que a Consulta SQL que deu origem ao Objeto de Negócio foi criada. |
Informações |
---|
Permitir PerfisPara escolher os perfis que terão acesso ao Objeto de Negócio, o switch disponível na interface deve estar na posição "Apenas selecionados". Com isso, em "Perfis permitidos" será habilitado um lookup (ícone de lupa) que abre uma tela de pop-up onde são listados os 10 primeiros perfis existentes no Sistema em que a Consulta SQL foi criada. Para visualizar os demais perfis, deve-se clicar em "Carregar mais resultados" até que o perfil desejado seja exibido. Em seguida, deve-se selecionar os perfis que se deseja dar permissão e clicar no botão "Selecionar". Com isso o pop-up será fechado, retornando para a tela de Segurança. |
Informações |
---|
Permitir TodosCaso deseje que todos os usuários com perfil no Sistema em que a Consulta SQL foi criada, marque esta opção. Ela não irá apagar os perfis já anexados, porém não os levará em conta e permitirá que qualquer perfil no Sistema da Consulta SQL acesse este Objeto de Negócio |
Para concluir a permissão, deve-se clicar no botão "Salvar" ou em "Salvar e Fechar".
Apagar o Objeto de Negócio
Após a criação do Objeto de Negócio, já na primeira etapa, é disponibilizado um botão quer permite apagá-lo. Ao clicar nesse botão é exibida uma janela de confirmação. Caso seja confirmado através do botão "Apagar", o Objeto de Negócio será excluído e a interface de criação/edição será fechada.
Aviso |
---|
Após apagar um Objeto de Negócio, não é possível recuperá-lo. |
Limitações
Aviso |
---|
Não é possível gerar Objeto de Negócio de Consultas SQL que possuam: - Fórmulas;
- Stored Procedures que utilizem parâmetros;
|
Observações
Informações |
---|
Caso a Consulta SQL associada a um Objeto de Negócio tenha sido editada de forma a modificar seu esquema ou parâmetros, o Objeto de Negócio será desativado e será necessário validar novamente essas informações. Nesse caso, ao clicar em "Salvar" será exibida a mensagem de alerta abaixo. que possibilita o acesso à interface de edição do Objeto de Negócio: Image Added
|