Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Cadastro de Query - DB0141

Visão Geral do Programa

Facilita a integração das informações e permite a utilização de queries padrões ou a customização de acordo com a necessidade.

Atualizar os dados APS via leitura de informações por meio de queries.


Informações
titlePré-requisitos:

Parametrizações do APS (DB1000) do banco de dados do ERP devem estar informadas e validadas.

Pode ser aberto somente quando integrado ao ERP Protheus e Logix.

Cadastro de Query

Objetivo da tela:

O cadastro de queries permite a visualização das queries executadas na Atualização de Dados do TOTVS APS (responsável por realizar a leitura das informações do ERP), possibilitando também, a exportação dos dados em planilhas e a customização das queries, sem a necessidade de alterar o programa por meio de UPCs, pois o texto das queries é armazenado em banco de dados.

 

Outras Ações/Ações Relacionadas:

Ação:

Descrição:

Info complementares

Quando acionado, apresenta a tela Informações Complementares, que exibe informações que podem auxiliar o usuário a investigar possíveis alterações de cadastro. 

Nota
titleNota:
  • Permite ao usuário cadastrar um texto explicativo para as queries de origem "Usuário".
  • Quando a tela principal de Cadastro de Query estiver em modo de alteração/inclusão, é possível incluir/alterar um comentário para a query, desde que esta possua origem "Usuário".  

Verificar atualizações de queries

Quando acionado, efetua a verificação de versão de queries do sistema. 

Nota
titleNota:
  • A tela apresentada é populada com as entidades cuja versão de sistema existente na base seja menor que a versão expedida. Para efetuar tal verificação, é comparada a versão da query na base contra a última versão expedida retornada pelo Container de Queries.
  • O campo "Ativar" é automaticamente selecionado, entretanto é possível escolher não ativá-lo, mas a query será importada automaticamente (é emitido um alerta ao usuário informando que uma nova versão da query foi importada, porém não foi ativada).
  • Ao clicar em "Confirmar", o sistema importa todas as queries, mas somente ativa aquelas selecionadas como "ativar".
    Exemplo: Se uma query de origem "Usuário" estiver com o campo "Ativar" selecionado, a rotina importa a query expedida e a ativa (é emitido alerta ao usuário referente à atualização de query e que a query antiga foi desativada).
  • Ao escolher ativar uma query, o sistema grava a data e usuário de ativação.

Zoom

Quando acionado, exibe uma listagem das queries existentes no sistema somente para o ERP e Banco integrados ao APS. 

Nota
titleNota:

Por padrão, somente são apresentadas as queries ativas, mas respeita a opção “Mostrar queries inativas” no Cadastro de Queries. Desta forma, todas as queries são apresentadas.  

Executar Query

Quando acionado, exibe uma prévia da execução da query informada pelo usuário.

Mostrar versões inativas

Quando acionado, determina que as versões inativas serão apresentadas.

  

Principais Campos e Parâmetros: 

Campo:

Descrição:

ERP Origem

Exibe o ERP de Origem, previamente parametrizado no DB1000.

As opções disponíveis são:

  • Protheus (2);

  • Logix (3).

Banco de Dados

Exibe o tipo de banco de dados do ERP origem, previamente parametrizado no DB1000.

As opções disponíveis são:

  • Oracle (1);

  • Sql Server (2);

  • Informix (3).

Empresa

Exibe o código da empresa, previamente parametrizado no DB1000.

Informações
titleImportante:

Visível somente quando o ERP Origem for Protheus. 

Entidade

Exibe o código da entidade ou query integrada ao APS.

Origem Query

Exibe o identificador da origem da Query.

  1. Query de sistema – São as queries expedidas pela TOTVS, não podem ser excluídas ou editadas;
  2. Query do usuário - São as queries customizadas, podendo sofrer alterações em qualquer momento.

Versão

Exibe a versão da query. É incrementada automaticamente.

Informações
titleImportante:
  • Versões de 0001 até 4999 reservam-se às queries de Sistema;
  • Versões de 5000 até 9999 reservam-se às queries de Usuário.

Ativa?

Quando assinalado, indica que a query está ativa e será executada na Atualização de Dados. Pode existir apenas uma query ativa por entidade, para garantir que apenas uma query por entidade seja lida e executada na Atualização de Dados. Uma query de Usuário pode ser ativada somente se passar pela validação realizada internamente, onde é verificado o número de campos e se os campos resultantes da query possuem o mesmo nome da query de sistema.

Query

Inserir a digitação da query de atualização de dados. 

Nota
titleNota:

Possíveis valores:

Quando a origem for “Usuário”, fica a critério do usuário, devendo respeitar a quantidade e nome dos campos retornados nas queries de sistema.

Quando for “Sistema”, é atualizada pelo APS e não está habilitado para edição.

Comportamento: São apresentadas somente as queries existentes para o conjunto de parâmetros existentes no DB1000 (ERP, Banco).

Todas as entidades com origem “Sistema” possuem uma query previamente cadastrada e não podem sofrer alteração e exclusão.

Quando o ERP integrado com o APS for o Protheus, a query necessita respeitar o campo “Empresa” existente no DB1000, pois os nomes das tabelas do Protheus incluem o código da empresa.

 


Cadastro de Query – Visualização de Dados

Caso

Objetivo da tela:

Essa tela é apresentada ao acionar o botão Executar Query, localizado na tela Cadastro de Query.

Ao acionar a função Cadastro de Query - Botão Executar Query, caso haja erros encontrados nas Validações de Tela, eles são apresentados no browser inferior da tela de Visualização de Dados.

 

Outras Ações/Ações Relacionadas:

Ação:

Descrição:

Exportar para Excel

Quando acionado, exporta somente os dados da query executada (não são exportadas as validações).

  

...


 Conteúdo Relacionado:

Conector de Widget
width800
urlhttps://www.youtube.com/watch?v=BrPqPNvQWDQ&t=14s
height600