Páginas filhas
  • Amarração Protheus x Smart View
Sobre

O processo de amarração Protheus x Smart View consiste em uma ferramenta que simplifica a utilização e manutenção dos recursos criados via Smart View. A ferramenta disponibiliza uma interface para que o administrador Protheus consiga visualizar todos os recursos disponíveis, realizar alterações, mudar a amarração entre um relatório padrão e um relatório customizado e cadastrar novos recursos customizados.

Os recursos cadastrados na tabela de amarração (Home) podem ser executados através da classe totvs.framework.smartview.callSmartView


Observação:

A ferramenta estará disponível no menu do Configurador a partir da release 12.1.2310, porém é possível adicioná-la manualmente, chamando a função APCFG770.

Informações complementares

Pré-requisitos:

  • A amarração Protheus x Smart View encontra-se disponível a partir da lib 20230626;
  • Obrigatória ativação da Porta Multiprotocolo e Interface Protheus com PO UI (vide Nova interface do Protheus com PO UI);
  • Novo Smart View implantado.


Documentações complementares:

Processos

A opção de menu "Home", apresenta a lista de integrações do Protheus com o Smart View. Nela também é possível incluir, alterar ou excluir integrações.



Ao acessar a rotina, a tela abaixo será apresentada:

 


Campos apresentados:

  • Id do Smart View - Código do recurso (relatório, tabela ou visão) dentro do Smart View.
  • Id do Protheus - Código do recurso dentro do Protheus.
  • Descrição - Descrição do recurso para identificação.
  • Dt. Criação - Data da criação do recurso
  • Dt. Ult. Atualização - Data da última alteração
  • Tipo - Tipo do recurso (pivot-table para Tabela de Dados, data-grid para Visão de Dados ou report para Relatório).
  • Status - Indica se o recurso está atualizado no Protheus, ou seja, se não há divergências no recurso entre o Smart View e o Protheus.

Nesta tela, é possível realizar dois tipos de pesquisa, a busca simples ou a busca avançada.

  • Simples - Localizada no topo da página, permite digitar um valor que será buscado nos campos principais (Id do Smart View, Id do Protheus, Descrição e Tipo)


  • Busca Avançada - Permite buscas mais específicas, direcionadas a um ou mais campos:

Para visualizar os detalhes de uma integração, basta clicar na opção 'Detalhes' à esquerda do item:

Na inclusão, podem ser incluídos três tipos de integração: Relatórios, Tabelas dinâmicas ou Visões de Dados. Esses tipos correspondem ao que foi cadastro no portal do Smart View.

Para incluir uma nova integração, basta clicar na opção 'Novo' e preencher os campos, sendo que o campo "Id do Smart View" só será liberado para edição quando o campo "Tipo" for preenchido.


CampoDescrição
Id do ProtheusNome do recurso que será chamado via callSmartView.
SubtítuloNome complementar para o recurso, pois um mesmo objeto de negócio pode ser utilizado para N layouts.
DescriçãoDescrição do registro. Exemplo: Relatório de funcionários admitidos até mês X.
TipoTipo do recurso, podendo ser Relatório, Tabela dinâmica ou Visão de dados.
Id do Smart ViewRelatório/tabela/visão que está cadastrada no portal do Smart View.


Importante

Não é permitido incluir mais de um registro com o mesmo Id do Protheus, Tipo e Subtítulo. Em caso de duplicidade, será apresentada a mensagem "Registro com o ID ID_DO_PROTHEUS.SUBTITULO e tipo data-grid/report/pivot-table já existente".

A alteração segue as mesmas regras da inclusão, sendo que, para ser realizada, basta clicar nos três pontos à esquerda do registro e clicar na opção "Editar".

Para excluir um registro, basta clicar nos três pontos à esquerda do item e selecionar a opção "Excluir". Será apresentada uma mensagem para que a exclusão seja confirmada.

A opção de menu "Personalização de Campos", permite adicionar novos campos em um objeto de negócio. Por exemplo: o módulo de Faturamento liberou um objeto de negócio para que pudessem ser criados recursos para a visualização de clientes, porém não foi disponibilizado o campo A1_TIPO para visualização. Sendo assim, o usuário pode utilizar essa rotina para adicionar esse campo e qualquer outro que seja de seu interesse.



Atenção

  • Não é possível adicionar campos MEMO ou virtual.

Ao clicar na opção de menu, a primeira tela que será apresentada, é a de listagem com todos os objetos de negócio disponíveis para customização.


A listagem também disponibiliza uma busca simples, podendo buscar por qualquer uma das colunas: Nome, Tabelas customizáveis, Objeto de Negócio ou Módulo:

Para adicionar novos campos no objeto de negócio, basta clicar na opção "Editar" do lado esquerdo do item que deseja customizar:


Ao clicar em "Editar", será apresentada uma tela com todas as tabelas customizáveis e seus respectivos campos. Sendo que a tela é dividida em duas partes:

  1. Adicionar campos
    1. Essa é a seção para selecionar a tabela desejada no campo "Tabela", selecionar o campo que deseja adicionar em "Campo" e informar uma descrição para ele em "Descrição";
    2. Ao clicar em "Adicionar" o campo fica com o status de "Adicionado", informando que o mesmo foi adicionado, porém ainda não foi enviado para o objeto de negócio.
  2. Campos atuais
    1. Essa é a seção que apresenta uma tabela com os campos atuais do objeto de negócio e os novos que forem sendo adicionados;
    2. A tabela possui três colunas, sendo que a última (Customização) apresenta o status de customização para aquele campo, sendo:
      1. Padrão: campo que foi adicionado por padrão pelo módulo;
      2. Customizado: campo que foi adicionado pelo usuário e já está disponível para uso no objeto de negócio;
      3. Adicionado: campo que foi adicionado pelo usuário mas que ainda não está disponível para uso no objeto de negócio.
    3. Nessa parte, é possível excluir campos. Porém, só é possível excluir aqueles com status de "Adicionado".


Uma vez que os campos foram adicionados e a alteração já foi confirmada, agora os campos adicionados aparecerão para utilização no objeto de negócio. Exemplo: no gif acima, foi adicionado o campo A2_INSCRM da tabela SA2 com a descrição "Meu novo campo". Agora consigo visualizá-lo nos recursos do Smart View:



Após a confirmação da inclusão do campo no objeto de negócio, não será possível excluí-lo, pois ele poderá ser utilizado em algum recurso do Smart View. A exclusão do campo pode causar erros no sistema.

Para visualizar os campos e tabelas de um objeto de negócio, basta clicar na opção "Visualizar" à esquerda do item desejado:


Ao clicar em "Visualizar", será apresentada uma tela com todas as tabelas customizáveis e seus respectivos campos. Sendo que a tela é dividida em duas partes:

  1. Adicionar campos
    1. Essa é a seção para selecionar de qual tabela serão visualizados os campos.
  2. Campos atuais
    1. Essa é a seção que apresenta uma tabela com os campos atuais do objeto de negócio, de acordo com a tabela selecionada em Adicionar campos;
    2. A tabela possui três colunas, sendo que a última (Customização) apresenta o status de customização para cada campo, sendo:
      1. Padrão: campo que foi adicionado por padrão pelo módulo;
      2. Customizado: campo que foi adicionado pelo usuário e já está disponível para uso no objeto de negócio;
      3. Adicionado: campo que foi adicionado pelo usuário mas que ainda não está disponível para uso no objeto de negócio (esse aparece somente na tela de edição).
    3. Na tela de visualização não é possível excluir ou alterar nenhum item.