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

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Painel
borderColor#29b6c5
titleColor#FFFFFF
titleBGColor#29b6c5
borderStylesolid
titleSobre

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.

Expandir
titleAdicionar ferramenta no menu

Painel
borderColor#29b6c5
titleColor#FFFFFF
titleBGColor#29b6c5
borderStylesolid
titleInformaçõ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:

Painel
borderColor#29b6c5
titleColor#FFFFFF
titleBGColor#29b6c5
borderStylesolid
titleProcessos
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.
Expandir
titleHome - Integração Smart View

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.



Expandir
titleVisualização dos registros

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.
Expandir
titleFiltros

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:

Expandir
titleDetalhes

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


Expandir
titleInclusão de registro

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 um novo registrouma 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.

Totvs custom tabs box
tabsCampos,Incluindo relatório,Incluindo tabela dinâmica,Incluindo visão de dados
idsfields,report,table,grid
Totvs custom tabs box items
defaultyes
referenciafields
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.

Image Added


Totvs custom tabs box items
defaultno
referenciareport

Ao selecionar o tipo Relatório, serão listados todos relatórios que foram cadastrados no portal do Smart View:

Image Removed

Totvs custom tabs box items
defaultno
referenciatable

Ao selecionar o tipo Tabela dinâmica, serão listadas todas tabelas que foram cadastradas no portal do Smart View:

Image Removed

Totvs custom tabs box items
defaultno
referenciagrid

Ao selecionar o tipo Visão de dados, serão listadas todas visões que foram cadastradas no portal do Smart View:

Image Removed

Aviso
titleImportante
  1. Não é permitido incluir mais de um registro com o mesmo Id do Protheus e Tipo.
Expandir
titleAlteração de registro

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".

Image RemovedImage Added

Expandir
titleExclusão de registro

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.

Image Modified

Expandir
titlePersonalização de Campos - A partir da lib 20230918

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.



Aviso
titleAtenção
  • Não é possível adicionar campos MEMO ou virtual.
Expandir
titleListagem dos objetos de negócio

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.

Image Added


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:

Image Added

Expandir
titleAdicionar campos

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

Image Added


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:

Image Added

Expandir
titleVisualizar campos

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

Image Added


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.