Tempo aproximado para leitura: 00:03:00 min
Dúvida
Como utilizar uma consulta SQL como Objeto de Negócio no TReports?
Ambiente
Cross Segmentos - TOTVS Backoffice (Linha RM) - RM BI - A partir da 12.1.2302
Solução
Segue abaixo etapas demonstrando como tornar uma Consulta SQL em um Objeto de Negócio de forma a fornecer dados para o TReports.
Na listagem de Consultas SQL (Visões de Dados), clique com o botão direito sobre a Consulta SQL que se deseja associar a um Objeto de Negócio. Então selecione o menu "Outras Informações" e em seguida clicar em "Objetos de Negócio de Consulta SQL":
Logo então, o módulo de Objeto de Negócio de uma Consulta SQL será exibido, possibilitando a edição ou criação de um novo Objeto de Negócio a partir daquela Consulta SQL
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
Informações do Objeto de Negócio
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: 4
- Máximo de caracteres: 64
-
Descrição - Descrição do Objeto de Negócio
- Preenchimento opcional
- Máximo de caracteres: 1024
Área
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.
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
Ativando o Objeto de Negócio
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;
Permitir Perfis
Para 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.
Permitir Todos
Caso 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.
Após apagar um Objeto de Negócio, não é possível recuperá-lo.
Limitações
Não é possível gerar Objeto de Negócio de Consultas SQL que possuam:
- Fórmulas;
- Stored Procedures que utilizem parâmetros.
Importante
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:
Saiba mais
Nestes How To demonstramos como realizar a criação de um relatório simples com objeto de negócio do book RM Criação de relatório simples no TOTVS Smart View - Parte 1 e Criação de relatório simples no TOTVS Smart View - Parte 2
0 Comentários