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.


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.

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:

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, podendo ainda ser combinada com a busca simples:

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
TipoInforma se o que será integrado será um relatório, uma tabela dinâmica ou uma visão de dados.
Id do Smart ViewRelatório/tabela/visão que está cadastrada no portal do Smart View.
Id do ProtheusFonte do Protheus que irá abrir o que foi informado no campo Id do Smart View. O fonte deve estar compilado com a extensão .trp.
DescriçãoDescrição do registro. Exemplo: Relatório de funcionários admitidos até mês X.


  1. Caso o fonte (Id do Protheus) não esteja compilado no RPO com a extensão .trp, não será possível incluir o registro.
  2. Não é permitido incluir mais de um registro com o mesmo Id do Protheus e Tipo.

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.


  • Não é possível adicionar campos MEMO ou virtual;
  • Só é possível customizar os objetos de negócio que contenham o annotation "customTables" informando quais tabelas poderão ser customizadas. Para mais informações: Smart View - Campos Personalizados

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. Sendo que, só serão apresentados àqueles que possuírem o annotation "customTables" informando quais tabelas poderão ser customizadas.


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: