Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Revertida da versão 22

Índice


Índice
exclude.*ndice:

Objetivo


      O objetivo deste documento é demonstrar quais são os primeiros passos para a utilização dos recursos disponíveis no TReportsSmart View.

Introdução


      Alguns recursos disponíveis no TReports Smart View possuem um fluxo de criação comum. Nos itens abaixo serão detalhadas essas etapas que são aplicáveis à criação de Relatórios (Novos) e , Tabelas Dinâmicas e Visão de Dados.

     Para iniciar o fluxo de criação de um recurso, deve-se acessar o seu submenu na barra lateral do TReports e adicionar um novo recurso.item no menu da barra lateral do Smart View, acessando assim a tela de listagem (ver Listagem de Recursos), onde será possível iniciar o fluxo de criação.

  Mais informações sobre a criação de cada recurso nas páginas abaixo:

1 - Preenchimento de Informações


      Na primeira etapa da criação do recurso devem ser informados o Nome de Exibição (mínimo 4 caracteres e no máximo 64 128 caracteres) e a Descrição (opcional, com no máximo 1024 65.535 caracteres).

1.1 Preenchimento de traduções de informações

      Após salvar essas informações, será disponibilizado a opção "Gerenciar traduções" no canto inferior direito. Nela é possível adicionar idiomas para o recurso ser traduzido. Ao adicionar um idioma, o Nome de Exibição deve ser informado conforme tradução; a Descrição também pode ser informada, opcionalmente. Na etapa seguinte será selecionado o Objeto de Negócio do recurso.

      Exemplo

      Acesso ao gerenciador de traduções:

Image Added


      Selecionando o idioma e adicionando-o:

Image Added

Image Added

      Após informar o Nome de Exibição e a Descrição, basta salvar a alteração.

Image Added

2 - Seleção de Objeto de Negócio


      O Objeto de Negócio corresponde ao conjunto de dados que será disponibilizado em um recurso. As informações dos Objetos de Negócios são providenciadas através dos Conectores cadastrados pelo administrador do TreportsSmart View (ver Conectores), e são organizados em áreas de forma a facilitar sua identificação (um Objeto de Negócio pode fazer parte de mais de uma área).

     Na tela de seleção de Objeto de Negócio é possível fazer uma busca por área ou por nome do objeto.

     Após a seleção do Objeto de Negócio serão exibidas as seguintes informações: 

  • Nome do Objeto de Negócio;
  • Conector;
  • Descrição do Objeto de Negócio;
  • Áreas;
  • Parâmetros nativos do Objeto de Negócio;
Dica

É necessário clicar no botão "Enviar" para que seja possível pré-visualizar os dados. Caso haja parâmetros, será necessário preencher os campos.

2.1 Filtros


     Ainda na tela de seleção de Objeto de Negócio é possível a criação de filtros que permitem uma maior manipulação dos dados a serem disponibilizados no recurso. Os filtros permitem fazer combinações lógicas entre as condições dos valores das propriedades dos Objetos de Negócio.    

       A tela de Filtros Filtro conta com 3 opções para a montagem: os operadores E e OU e a Condição.

  • Operadores E/OU: Operadores lógicos que conduzem a criação do filtro por meio de agrupadores das condições;
  • Condição: Definição da condição aplicada a uma propriedade do Objeto de Negócio para a realização do filtro.

       Na configuração da condição, primeiro se escolhe a propriedade do Objeto de Negócio que será avaliada (serão listadas na tela as propriedades filtráveis do Objeto de Negócio). Com base no tipo da propriedade, que pode ser um texto, um número, uma data ou um valor booleano, são disponibilizadas as condições possíveis de serem aplicadas nessa propriedade, como por exemplo "Igual a", "Diferente de", "Maior que", "Menor que", dentre outras.

       Em seguida, deve-se definir os valores ou os parâmetros para esse filtro. A diferença entre essas opções é:

  • Valores -  São aplicados no filtro antes do acesso à tabela dinâmica;
  • Parâmetros - São aplicados no filtro durante a edição/visualização da tabela dinâmica.

       Quando selecionado Valores, o usuário deverá informar o valor ou os valores (caso a condição aceite mais de um) a ser aplicado no filtro.

       Quando selecionado Parâmetros, o usuário deverá informar um nome para esse parâmetro, o qual será exibido nas telas de design/visualização/geração com um campo para preenchimento do valor a ser aplicado no filtro.

       Dessa forma, se o usuário que está criando um recurso desejar que uma condição de um filtro seja sempre aplicada com um mesmo valor, deve configurar utilizando Valores. Caso deseje que o valor da condição do filtro possa ser informado posteriormente, ou seja, que possam ser aplicados valores diferentes, conforme sua necessidade, deve utilizar a opção de Parâmetros.

       Na configuração do Filtro, os nodos E/OU permitem criar nodos filhos a partir deles, enquanto as Condições se aplicam como irmãos.

Informações

  O tipo do valor ou do parâmetro é definido conforme o tipo da Propriedade selecionada para o Filtro.

Dica

A tela de Filtros possibilita alterar entre as visões de Árvore e Código JSON.

Exemplo

       Para exemplificar a utilização de Filtros, será usado um Objeto de Negócios chamado "Instalações Ativas", que traz informações sobre as instalações das aplicações do TReportsSmart View.

       Abaixo uma pré-visualização dos dados desse Objeto de Negócios:

Image Modified

       Um filtro para disponibilizar os dados que respeitem as condições abaixo:

Condição: Aplicação igual a 'TReports' e Data de Instalação maior que e Plataforma igual ao valor informado pelo usuário durante design/exibição da tabela dinâmica ou geração do recurso é mostrado abaixo:

Image Modified

       Nesse exemplo, as condições das propriedades Aplicação e Data de Instalação foram configuradas utilizando Valores e a condição da propriedade Plataforma foi configurada utilizando Parâmetros.

Informações

Dica
titleHierarquia de aplicação do filtro

Image Added


       Ao acessar a edição de filtros/parâmetros anteriormente criados, é exibido uma mensagem de alerta com a seguinte informação: "Ao editar o filtro, as configurações dos parâmetros serão perdidas.".
Image Added

       Essa mensagem pode ser exibida em português, espanhol e inglês, a depender do idioma utilizado pelo usuário:

Image Added
Image Added

   A definição dos Objetos de Negócios, bem como a configuração das propriedades filtráveis, está descrita na RFC010001: https://arquitetura.totvs.io/architectural-records/RFCs/Framework-BH/RFC010001/.

3 - Design

     Na próxima etapa é realizado o design do recurso:

4 - Compartilhamento


      Na etapa de compartilhamento é possível vincular o recurso criado a uma pasta existente e também fazer seu compartilhamento com outros usuários. Para mais detalhes, acesse a página Compartilhamento.

Nota

A etapa de Compartilhamento NÃO é obrigatória. 

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Processo: TReports Smart View

Informações
iconfalse

Versão: 1.67

Informações
iconfalse
Informações
iconfalse

Status: Rascunho Concluído

Informações
iconfalse

Data:  

Informações
iconfalse

Autores:

Aline Cristina Braz de Oliveira

Carlos Philippe de Farias Marques

Cesar Henrique Silva Rodrigues_ 

Diogo Damiani Ferreira

Usuário desconhecido (fernando.souza)