Visões Dinâmicas

1. Acesse Tecnologia > Customização > Relatórios > Visões Dinâmicas;
2. Clique em Nova visão;
3. Informe o Nome, Descrição e Tags para a identificação dessa visão dinâmica e clique em Editor visual para configurações;
4. Em seguida, selecione no campo Tabela uma ou mais tabelas que serão utilizadas para criação da visão dinâmica. Caso seja selecionado mais de uma tabela, em Ligações informe quais campos são responsáveis pelo Join na visão dinâmica;
5. Se desejar, utilize os demais campos à direita da tabela escolhida para filtrar e personalizar as informações exibidas, definindo agrupamento e ordenação, por exemplo;
6. Opcionalmente, utilize o botão Visualizar para ter uma prévia das informações em tela (na visualização são mostradas até 10 linhas de dados) ou então em Visualizar em PDF para ter noção da visualização de tais dados em arquivo;
7. Para gerar um relatório em arquivo com todos os resultados, clique em Gerar relatório e então defina o Formato e Envio do arquivo (por e-mail como anexo ou como link). Clique em Confirmar;
8. Clique em Salvar visão para que ela seja salva e possa ser utilizada novamente. Dessa forma, ao entrar novamente em Tecnologia > Customização > Visões Dinâmicas, a visão salva é mostrada.

1. Acesse Tecnologia > Customização > Relatórios > Visões Dinâmicas.
2. Clique em Nova visão.
3. Informe o Nome, Descrição e Tags para identificar a visão dinâmica. Em seguida, clique em Editor SQL para configurar o SQL conforme necessário.
   Nota

   Para garantir maior eficiência na construção do SQL, siga as orientações descritas na documentação de Melhores Práticas SQL.

4. Para gerar um relatório em arquivo com todos os resultados, clique em Gerar relatório e defina o formato e o envio do arquivo (por e-mail como anexo ou como link). Em seguida, clique emConfirmar.
5. Clique em Salvar visão para que ela seja armazenada e possa ser utilizada novamente. Dessa forma, ao acessar novamente as Visões Dinâmicas, a visão salva será exibida.

Opcionalmente, utilize o botão Visualizar para ter uma prévia das informações na tela (a visualização mostra até 10 linhas de dados) ou em Visualizar em PDF para ter uma noção da aparência dos dados em um arquivo PDF. Ao clicar em Visualizar em PDF, uma caixa de diálogo será exibida para definir a largura da exibição, útil principalmente para consultas com muitas colunas, pois ajusta os dados horizontalmente no arquivo.

Após a criação de uma visão dinâmica, estão disponíveis todas as informações disponíveis na tabela selecionada. Porém, é possível escolher quais informações são exibidas e mudar a forma como elas são apresentadas, a partir dos recursos de agrupar, adicionar funções, esconder, mudar posição, ordenar e filtrar os campos da tabela, exceto em campos customizados:

Agrupamento

1. Em Agrupado por, clique em Adicione um agrupamento + para definir por qual campo as informações devem ser agrupadas;
   
2. Clique em Visualizar para atualizar os dados exibidos na visão de acordo com o filtro;
3. Se não quiser manter o filtro, é preciso clicar no X ao lado dele e clicar novamente em Visualizar para atualizar as informações.

A ordem de exibição das colunas será a mesma definida ao agrupamento. Caso se monte a visão e depois se deseje reordenar os agrupamentos, todas as outras funções da visão serão perdidas, já que elas dependem do que estiver nessas primeiras.

Funções

Com intuito de proporcionar um refinamento dos dados exibidos, as visões dinâmicas suportam o uso de expressões comuns SQL, como por exemplo COUNT(), SUM() e MAX():

1. Em Funções, clique Dados puros +. Quando não houver expressão configurada, é mantido assim o valor deste campo;
2. Selecione uma expressão disponível e, em seguida, determine o campo sobre o qual ela deve ser executada;
3. Clique em Visualizar para atualizar os dados exibidos na visão de acordo com o filtro;
4. Se não quiser manter o filtro, é preciso clicar no X ao lado dele e clicar novamente em Visualizar para atualizar as informações.

Essa expressão estará disponível na última coluna da visão dinâmica e no relatório.

Campos

Ao não optar pelo agrupamento de campos ou funções, é possível selecionar quais colunas serão exibidas na consulta e a ordem de exibição.

1. Clique em Todos para abrir uma janela com todos os campos disponíveis para a tabela selecionada;
2. Deixe marcados aqueles que deseja visualizar e desmarcados aqueles que não devem ser mostrados como colunas na sua visão dinâmica;
3. Para ordenação, reposicione os campos, clicando e arrastando-os para o local desejado;
4. Clique em Concluído para aplicar as alterações;
5. Clique em Visualizar novamente para atualizar os dados exibidos na visão de acordo com o filtro;
6. Se não quiser manter os campos conforme configurou, repita os passos de 1 ao 4.

Nota

Os campos customizados são apresentados a partir de um ícone indicativo na coluna, a fim de identificá-los dentro de uma visão dinâmica.

Para configuração de nome (alias) e largura de campo para visões dinâmicas do tipo visual acesse Customização > Relatórios > Visão Dinâmica

Em seguida, para selecionar os campos que serão apresentados,clique na opção Campos

Abra o modal para inserir Alias e Largura do campo, ambos opcionais.

Será apresentada uma tela com as informações inseridas (Alias - Largura):

É importante destacar que a largura máxima permitida em um campo é de 100%. Caso o valor dos campos ultrapasse esse limite, o sistema impedirá a ação de salvar ou visualizar, exibindo uma mensagem de alerta.

Caso alguns campos não sejam preenchidos, o percentual restante será distribuído entre eles. Como neste exemplo, a imagem apresenta os valores 50 e 20, portanto, os 30% restantes serão atribuídos ao campo dsx_numericos.integer_column.

As alterações não se aplicam à visualização, somente ao gerar um relatório.

Ordenação

Ao não optar por agrupar alguma coluna, é possível ordenar por qualquer coluna que esteja marcada para visualização.

1. Clique em Configure a ordenação + para definir por qual campo as informações devem ser ordenadas;
   
2. Clique em Visualizar para atualizar os dados exibidos na visão de acordo com o filtro;
3. Se não quiser manter o filtro, é preciso clicar no X ao lado dele e clicar novamente em Visualizar para atualizar as informações.

Observação

Por padrão, a ordenação é realizada em ordem Ascendente (do menor para o maior valor). Se quiser inverter esta ordem, clique sobre a palavra asc ao lado do campo desejado, para exibir o menu com o sentido da ordenação.

Filtros

Os dados somente são filtrados na visão, após essa configuração. Caso contrário, todos eles são exibidos.

1. Clique em Adicione filtros + para filtrar as informações exibidas de acordo com algum dos campos da tabela;
2. É apresentada uma lista com todos os campos existentes na tabela, sendo que ao lado de um há um ícone identificando seu tipo: string, numérico, data ou booleano. Cada um possui diferentes opções de filtros;
3. Após escolher o campo, defina como ele é filtrado e, dependendo do que é escolhido, informe um valor e clique em Adicionar filtro;
4. Para que ao executar a visão dinâmica sejam informados parâmetros, assinale a opção Parâmetro e determine que este filtro é um parâmetro. Em seguida, informe o nome do parâmetro e clique em Adicionar filtro;
5. Clique em Visualizar para atualizar os dados exibidos na visão de acordo com o filtro;
6. Se não quiser manter o filtro, é preciso clicar no X ao lado dele e clicar novamente em Visualizar para atualizar as informações.

Observação

Quando o campo for do tipo string, é aplicada automaticamente a função LOWER, que converte o retorno do campo em minúsculo, para que a comparação ocorra corretamente.

A configuração do fuso horário (timezone) no momento da execução das Visões Dinâmicas e/ou Relatórios ocorre da seguinte maneira:

• Configuração padrão: para os campos do tipo timestamp (Carimbo de data/hora), por padrão, no momento da execução das Visões Dinâmicas e/ou Relatórios é aplicado o timezone do navegador do usuário, enviado através do header x-user-timezone-offset.
• Configuração manual (timezone informado manualmente): em virtude de alguns produtos armazenarem essa informação a partir da aplicação do timezone e outras utilizando o UTC-0, no momento da visualização, as informações acabam apresentando divergências. Para que isso não ocorra, basta configurar o timezone manualmente através do campo e assim, sobrescrever a configuração padrão. Através do campo Informar timezone manual determine:
  1. "Não aplicar timezone": utilizada para visualizar as informações data/hora exatamente como estão armazenadas, ou seja, quando já possui um timezone aplicado;
  2. As demais opções deve ser utilizadas quando a informação está armazenada em UTC-0 e desejar configurar uma visão dinâmica informando um timezone diferente do que é enviado pelo navegador.

Para os campos tipo hora, é possível adicionar a visão dos segundos. Para isso, basta marcar o checkbox Apresentar segundos nos campos do tipo hora e clicar em Salvar.

Para os campos numéricos, é possível formatar os valores retornados com separadores de milhar e decimal. Para isso, basta marcar o checkbox Apresentar separadores de milhar e decimais nos campos numéricos e clicar em Salvar. No botão Visualizar, é retornada uma prévia do resultado final para conferência.

Acesse Tecnologia > Customização > Relatórios > Visões Dinâmicas. Clique sobre a visão dinâmica desejada e, para vê-la, no botão Detalhes, na parte superior da tela. Após isso, na tela que mostra a visão, é possível fazer alterações e Salvar, Visualizar com as informações salvas anteriormente ou Excluir visão.

Acesse Tecnologia > Customização > Relatórios > Visões Dinâmicas. Clique sobre a visão dinâmica desejada e, em seguida, em Duplicar visão, na parte superior da tela. Após isso, informe um nome para a nova visão e prossiga com os passos para criar uma nova visão dinâmica.

1. Acesse Tecnologia > Customização > Relatórios > Visões Dinâmicas;
2. Clique sobre a visão dinâmica desejada e para vê-la no botão Detalhes, na parte superior da tela;
3. Clique em Gerar relatório e escolha um dos formatos disponíveis:
   • as impressões em relatórios, no formato PDF, são exportadas de forma paginada, ou seja, com quebras de páginas;
   • ao exportar em formato CSV, os dados são exportados com um cabeçalho e uma lista de valores, que posteriormente podem ser importados no Excel. Para isso, basta no próprio arquivo do Excel acessar Dados > Obter Dados de Text/CSV e escolher esse arquivo para importação.

   Importante

   Devido os sistemas serem internacionalizáveis, os dados são exportados em formato UTF-8. Portanto, ao importar os dados no Excel é recomendável trocar o enconding para UTF-8.

4. Escolha a forma de envio, que pode ser via notificação, e-mail com anexo ou e-mail com link. Se a opção escolhida for notificação e existir a permissão de visualizar grupos, é possível marcar a caixa de seleção Usuários de um grupo. Dessa forma, todos os usuários do grupo receberão o relatório;
5. Clique em Confirmar.

Após a confirmação, será exibida uma notificação na tela informando a geração do relatório. Após terminar, uma nova notificação será apresentada com o link para visualizá-lo.

Para realizar a disponibilização deste relatório, é preciso habilitar alguns recursos vinculados ao processo, para que seja possível executar o relatório e visualizar o mesmo.

Abaixo seguem os passos para pode habilitar o relatório, atualizar a base de dados, criar o relatório e executar.

Habilitar a visão para o processo

Caso o processo não tenha a visão habilitada, não será possível criar o relatório para o mesmo. Execute os passos abaixo:

• Acesse a Plataforma Senior X com o usuário administrador do processo;
• Acesse o menu Senior X > BPM > Processos;
• Encontre o processo que deseja criar o relatório e clique em "Ações > Editar";
• Na tela de edição do processo, clique na opção "integrações";
• Habilite o campo "Habilitar visão" e inclua um nome para a visão dinâmica deste processo;
• Clique no botão "Salvar" para gravar as informações.

Atualização da base de dados de relatório

Sempre que houver mudanças na definição da base de relatórios, é necessário realizar a sincronização dos metadados para que o recurso esteja disponível em seu Tenant junto com as tabelas, campos e estrutura de metadados.

Para isso, realize os passos abaixo:

• Acesse a Plataforma com usuário administrador;
• Acesse o menu Tecnologia > Administração > Banco de dados de Relatório > Habilitar relatório;
• Role até o final da tela, e clique no botão "Atualizar base de dados";
• O processo de atualização pode demorar bastante. Aguarde até a finalização completa.

Criação do relatório

Como o objetivo do relatório é ter um retorno informando o status de cada uma das solicitações do processo, abaixo segue a forma como esse status é armazenado na base de dados da plataforma.

Status = 11 Quando a solicitação do processo já está como 'Encerrado' ou 'tratada'

Status = 4 Quando a solicitação do processo está como 'Cancelado'

Status = 1 Quando a solicitação do processo está como 'Pendente' ou 'Em Andamento', aguardando uma ação de aprovação.

• Acesse o menu Tecnologia > Customização > Relatórios > Visão Dinâmica;
• Clique no botão "Nova Visão";
• Insira um nome e descrição para seu relatório;
• Clique na opção "Editor SQL".

• Clique então no botão "Salvar" para gravar o seu relatório;
• Para visualizar um preview do relatório você pode clicar no botão "Visualizar";
• Para gerar um relatório completo, clique no botão "Gerar Relatório".

Você pode também agendar uma execução periódica automática deste relatório clicando no botão "Agendar execução". Basta selecionar o formato do relatório, e a quantidade de dias que o mesmo deverá ficar disponiblizado.

Ao clicar para confirmar você será direcionado para a tela de Dados do Agendamento. Na sessão "Execução", você deve informar quando o relatório deve ser iniciado, e o horário de geração do mesmo. Caso queira que o relatório seja executado mais de uma vez, selecione a opção "Repetir" e configure a periodicidade.

É possível colocar parâmetros para executar a visão dinâmica. Os parâmetros podem ser configurados como:

• Obrigatórios: indicados pelo símbolo: $, exigem a inserção de uma valor antes de gerar a visão. Esse valor é usado para filtrar os dados exibidos no relatório;
• Opcionais: indicados pelo símbolo !, permitem que o parâmetro fique em branco, não sendo necessário incluí-lo. Dessa forma, a visão é executada sem aplicar filtragem à informação.

O parâmetro deve ser incluído após o WHERE no SQL, conforme exemplos:

Obrigatório:

O formato para compor o where com parâmetros obrigatórios é esse:

Exemplo:

Opcional:

O formato para compor o where com parâmetros opcionais é esse:

Exemplo:

Significado de cada item:

• "platform-social": Domínio e serviço responsável pela tabela;
• profiles_total_engagement: View que está sendo aplicado o parâmetro;
• total_engagement: Campo que deverá ser comparado ao valor informado;
• : total: Nome do parâmetro que deverá aparecer ao usuário no momento de preenche-lo.

Para agendar um relatório, é preciso ter permissão para agendar funcionalidades. Então:

1. Acesse Tecnologia > Customização > Relatórios > Visões Dinâmicas;
2. Crie uma visão dinâmica nova ou edite alguma já existente;
3. Clique no botão Agendar execução;
4. Se o relatório possuir parâmetros, eles deverão ser preenchidos. Informe o formato e para quem enviar. O usuário será redirecionado para a tela de agendamento, onde todos os campos necessários para o relatório já estarão preenchidos;
5. Preencha a seção Execução, escolhendo a data de início, periodicidade, horário entre outros.

Anexe a visão dinâmica a um item de menu para que outro colaborador ou usuário possa imprimi-la ou visualizá-la:

1. Acesse Tecnologia > Customização > Relatórios > Visões Dinâmicas;
2. Selecione a visão dinâmica para a qual o menu será criado;
3. Clique em Detalhes;
4. Na seção Menus da Visão Dinâmica, clique em Novo;

5. Defina onde o menu será exibido;
   • No menu principal: ao marcar esta opção, o sistema permitirá apenas a seleção de menus agrupadores.
     
     Exemplo: Tecnologia > Customização
     
   • No contexto de uma tela: ao marcar esta opção, o sistema não permitirá a seleção de menus agrupadores, somente menus que são telas.
     
     Exemplo: Tecnologia > Customização > Tela
     

6. Defina o redirecionamento ao clicar no menu;
   • Exibir na tela de edição: ao marcar esta opção, o usuário será redirecionado para a tela de edição do registro.
     
     
   • Exibir na tela de geração: ao marcar esta opção, o usuário será redirecionado para a tela de geração de relatório do registro.
     
     
7. Em Rótulo, informe o nome do menu;
8. Clique em Adicionar e, em seguida, em Salvar.

Para cadastrar Expressões de Domínio utilizando Visões Dinâmicas, acesse a documentação de Expressões de Domínio nas Ferramentas de Dados.

1. Acesse Tecnologia > Administração > Autorização > Gestão dos Papéis;
2. Acesse o papel desejado ou crie um novo papel;
3. Associe os usuários com os quais deseja compartilhar as visões dinâmicas ao papel;
4. Em Permissões do Papel, no domínio Custom, expanda o serviço DYNAMICVIEWS e para cada uma das visões desejadas marque a opção de Visualizar;
5. Ainda em Permissões do Papel, agora no domínio Platform, expanda o serviço REPORT_DATABASE e marque a opção de Visualizar para Metadados.
6. Clique em Salvar na parte inferior da tela.

1. Acesse Tecnologia > Administração > Autorização > Gestão dos Papéis;
2. Acesse o papel desejado ou crie um novo papel;
3. Associe os usuários com os quais deseja compartilhar as visões dinâmicas ao papel;
4. Em Permissões do Papel, no domínio Custom, expanda o serviço DYNAMICVIEWS e para cada uma das visões desejadas marque a opção de Alterar e/ou Visualizar;
5. Ainda em Permissões do Papel, agora no domínio Platform, expanda o serviço REPORT_DATABASE e marque a opção de Visualizar para Metadados e Base de dados para relatórios. No domínio serviço DynamicViews, marque a mesma opção para Visões Dinâmicas;
6. Clique em Salvar na parte inferior da tela.

1. Acesse Tecnologia > Administração > Autorização > Gestão dos Papéis;
2. Acesse o papel desejado ou crie um novo papel;
3. Associe os usuários com os quais deseja compartilhar as visões dinâmicas ao papel;
4. Em Permissões do Papel, no domínio Custom, expanda o serviço Report_database_metadata e marque a opção de Visualizar para a tabela escolhida;
5. Ainda em Permissões do Papel, agora no domínio Platform, expanda o serviço REPORT_DATABASE e marque a opção de Visualizar para Metadados e Base de dados para relatórios. No domínio serviço DynamicViews, marque a mesma opção para Visões Dinâmicas;
6. Clique em Salvar na parte inferior da tela.

1. Acesse Tecnologia > Administração > Autorização > Gestão dos Papéis;
2. Acesse o papel desejado ou crie um novo papel;
3. Associe os usuários com os quais deseja compartilhar as visões dinâmicas ao papel;
4. Em Permissões do Papel, no domínio Custom, expanda o serviço Report_database_metadata e marque a opção de Visualizar para a tabela escolhida. Para o serviço Dynamicviews, marque a mesma opção para a visão dinâmica escolhida;
5. Ainda em Permissões do Papel, agora no domínio Platform, expanda o serviço REPORT_DATABASE e marque a opção de Visualizar para Metadados e Base de dados para relatórios. No domínio serviço DynamicViews, marque a mesma opção para Visões Dinâmicas;
6. Clique em Salvar na parte inferior da tela.

1. Acesse Tecnologia > Administração > Autorização > Gestão dos Papéis;
2. Acesse o papel desejado ou crie um novo papel;
3. Associe os usuários com os quais deseja compartilhar as visões dinâmicas ao papel;
4. Em Permissões do Papel, no domínio Custom, expanda o serviço Report_database_metadata e marque a opção de Visualizar para a tabela escolhida;
5. Ainda em Permissões do Papel, agora no domínio Platform, expanda o serviço REPORT_DATABASE e marque a opção de Visualizar para Metadados e Base de dados para relatórios. No domínio serviço DynamicViews, marque a opção de Visualizar e Editarpara Visões Dinâmicas;
6. Clique em Salvar na parte inferior da tela.

1. Acesse Tecnologia > Administração > Autorização > Gestão dos Papéis;
2. Escolha o papel do usuário que terá essa permissão de acesso às tabelas;
3. Em Permissões do Papel, no domínio Custom, expanda o serviço REPORT-DATABASE-METADATA;
4. Escolha os recursos que este papel terá permissão;
5. Clique em Salvar;
6. Acesse novamente o papel deste usuário;
7. Pesquise pela permissão PLATFORM e expanda o serviço DYNAMICVIEWS;
8. No recurso Visões Dinâmicas, selecione Alterar e Visualizar;
9. Clique em Salvar.

Após isto, o usuário terá permissão para acessar o menu das visões dinâmicas e criar uma tabela na base de dados.

A permissão para emitir um relatório deve ser utilizada quando houver necessidade do usuário associar a visão dinâmica a um item do menu durante a sua criação.

Desta maneira, com essa permissão, essa visão ficará disponível para que qualquer usuário que desejar imprimir este relatório. Por exemplo, no caso de um gestor que criou o relatório, solicitar ao seu liderado a impressão, que não possui a permissão para criar as visões dinâmicas e nem para acessar as tabelas.

Para isso:

1. Acesse Tecnologia > Administração > Autorização > Gestão dos Papéis;
2. Escolher o papel do usuário que terá essa permissão;
3. Em Permissões do Papel, no domínio Custom, expanda o serviço DYNAMICVIEWS;
4. Selecione a visão criada e marque a opção de Visualizar;
5. Clique em Salvar.

Após isso, todos os usuários com permissões para esta visão dinâmica poderá visualizá-la no menu e gerar seu relatório.