Addon - Acelerador
01. Visão Geral
1. Visão Geral
Este Acelerador tem por objetivo disponibilizar outros modelos de consultas padrões para:.
Principais vantagens do produto:
- Produtos
- Fornecedores
- Clientes
ATENÇÃO: É necessário relacionar a novas consultas aos campos necessários – consultar Boletim Técnico.
02. Menu
2. Menu
Não se Aplica
03. Rotinas personalizadas específicas do Pacote
3. Rotinas personalizadas específicas do Pacote
Funções personalizadas contidas no pacote:
| Rotina | Descrição |
|---|---|
| T997041 | Consulta Padrão Modelo 1 |
| T997042 | Consulta Padrão Modelo 2 |
| T997043 | Consulta Padrão com Mark |
| UPD997F | Programa compatibilizador do Dicionário de Dados para aplicação do Acelerador. |
04. Pontos de Entradas Disponiveis para Desenvolvimento
4. Pontos de entrada Disponível no ADD-ON
| Nome | Descrição | Programa Fonte | Sixtaxe | Exemplo |
|---|---|---|---|---|
| PE997042 | Ponto de Entrada para validação ao pressionar o botão OK, consulta padrão Produtos Modelo 2. |
T997042 | Validação total PE997042( |
ADVPL
PE997042
|
05. Tabelas (SX2)
5. Tabelas (SX2)
Não se Aplica
06. Campos (SX3)
6. Campos (SX3)
Não se Aplica
07. Parâmetros (SX6)
7. Parâmetros (SX6)
| Nome | Tipo | Descrição | Conteúdo |
|---|---|---|---|
| MV_X997041 | Caracter | Campos considerados para a composicao da coluna de saldo em estoque na consulta personalizada de produtos. | SB2.B2_QATU-(SB2.B2_QEMP+SB2.B2_RESERVA) |
| MV_X997042 | Caracter | Define se apresenta coluna de Saldo em Contrato de Parceria na consulta personalizada de produtos. | .F. |
| MV_X997043 | Caracter | Armazens considerados para a composicao da coluna de saldo em estoque na consulta personalizada de produtos. | 001 |
| MV_X997044 | Numérico | Numero máximo de registros apresentados junto a consulta personalizada de produtos. | 50 |
| MV_X997045 | Lógico | Define se deve apresentar os registros bloqueados na consulta personalizada de produtos. | .T. |
| MV_X997046 | Lógico | Determina se deve somar a quantidade em itens já existentes ou gerar novos itens atraves daconsulta personalizada de produtos. | .T. |
| MV_X997047 | Caracter | Codigo TES Inteligente considerado para carga do TES na rotina de Pedidos de Venda atraves da consulta personalizada de produtos. | 01 |
| MV_X997048 | Caracter | Codigo TES Inteligente considerado para carga do TES Cobranca no Ct. Parceria atraves da consulta personalizada de produtos. | 01 |
| MV_X997049 | Caracter | Codigo TES Inteligente considerado para carga do TES Remessa no Ct. Parceria atraves da consulta personalizada de produtos. | 01 |
08. Gatilhos (SX7)
8. Gatilhos (SX7)
Não se Aplica
09. Índices (SIX)
9. Índices (SIX)
Não se Aplica
10. Consulta Padrão (SXB)
10. Consulta Padrão (SXB)
| Tipo | Nome | Descrição | Tabela | Expressao | Retorno |
|---|---|---|---|---|---|
| Consulta Específica | SA1041 | Consulta Clientes | SA1 | U_T997041( "Consulta Clientes", "SA1", 2, "A1_NOME", "A1_NOME<>'XX'", .T.) | SA1->A1_COD, SA1->A1_LOJA |
| Consulta Específica | SA2041 | Consulta Fornecedores | SA2 | U_T997041( "Consulta Fornecedores", "SA2", 2, "A2_NOME", "A2_NOME<>'XX'", .T.) | SA2->A2_COD, SA2->A2_LOJA |
| Consulta Específica | SB1041 | Consulta Produtos | SB1 | U_T997041( "Consulta Produtos", "SB1", 2, "B1_DESC", "B1_TIPO<>'XX'", .T.) | SB1->B1_COD |
| Consulta Específica | SB1042 | Consulta Produtos | SB1 | U_T997042() | __cCodPro |
11. Manual de operação
11. Manual de operação
1. CONSULTA DE PRODUTOS Mod.1
Modelo de consulta disponível para Produtos, Fornecedores e Clientes.

2. CONSULTA DE PRODUTOS Mod.2
Disponibilizado consulta padrão personalizada referente ao cadastro de produtos. Esta nova consulta, possui funcionalidades as quais tem por objetivo disponibilizar uma maior agilidade na pesquisa, localização e seleção de produtos para movimentação junto ao ERP Protheus.
Esta nova consulta, possui funcionalidades de integração especificas com as rotinas padrões do ERP Protheus abaixo elencadas:
- Venda Direta – FATA701.PRW
- Orçamentos – MATA415.PRW
- Pedido de Venda – MATA410.PRW
- Contrato de Parceria – FATA400.PRW
Ao executar à consulta padrão personalizada de produtos à partir destas rotinas, dentre as funcionalidades presentes na mesma, também será disponibilizado recurso referente à mult-seleção de produtos, ou seja, funcionalidade que possibilita ao usuário para que esteja através da interface da própria consulta, selecionando um ou mais produtos.
Para selecionar os produtos, pode-se clicar com o mouse ou utilizar à tecla “enter”. Uma vez que o produto é selecionado, este passa a ser apresentado com o fundo vermelho, visando facilitar ao usuário. Caso seja desejado mais de uma unidade do mesmo produto, basta alterar o campo quantidade existente no grid inferior da tela.

DICA: também é possível determinar à quantidade do produto através da tecla “enter”, ou seja, a cada vez que a tecla é aciona sob um mesmo produto, o campo quantidade é incrementado.
Quando a consulta é executada a partir das rotinas descritas anteriormente, o recurso de mult-seleção é disponibilizado, logo, ao confirmar à interface, é retornado ao grid de itens da rotina pela qual a mesma foi chamada, onde todos os produtos e quantidades são atualizadas conforme selecionado na consulta.
Caso exista tabela de preços informada no cabeçalho da rotina, será apresentado o preço dos itens já na interface da consulta de produtos, bem como, será atualizado o preço dos respectivos itens na interface de venda.
Ainda em relação a carregar os itens\produtos da consulta para a rotina padrão, existem parâmetros conforme abaixo, para que seja configurado o código do TES Inteligente considerado na busca do código do Tipo de Saída (TES) considerado na comercialização dos produtos selecionados na interface da consulta.
Pedido de Venda - MV_X997047
Contrato de Parceria - MV_X997048 - MV_X997049
OBSERVAÇÃO: caso não seja localizado o TES para o item ou até mesmo o preço de venda, o item em questão será carregado como deletado no grid da rotina padrão do sistema.
Ao realizar à utilização da consulta personalizada de produção, é possível realizar filtro em torno da busca de registros específicos a serem considerados em sua execução. Para isto, basta informar o conteúdo desejado no cabeçalho da consulta.

Após informar o conteúdo da busca, basta acionar duas vezes à tecla “enter”. Havendo registros para o filtro informado, será posicionado no grid de itens, onde pode ser possível selecionar o produto desejado utilizando também a tecla “enter”. Caso não sejam encontrados registros para pesquisa informada, o foco será retornado ao filtro para que seja informado um novo conteúdo de busca\filtro.
Ainda em relação ao filtro dos produtos, pode-se utilizar o caracter coringa “%” para realizar um filtro mais refinado considerando-se do conceito de “está contido”.

Para uma pesquisa dos produtos ainda mais refinada, pode-se adicionar várias informações de filtro, para isto, utilize o caracter coringa “+” conforme exemplo abaixo.

Vale ressaltar, que ao realizar à pesquisa por uma determinada descrição, os registros localizados no cadastro de produtos que atendem ao conteúdo do filtro são apresentados de forma ordenada considerando como critério de ordenação à descrição dos mesmos e não o código.
DICA: através da tecla de atalho F12 é retornado o foco na interface da consulta de produtos para à edição do conteúdo de filtro\pesquisa, ou seja, estando entre os produtos por exemplo, ao acionar a tecla F12 o foco é retornado para que seja informado um novo conteúdo de pesquisa, considerando-se dos mesmos critérios descritos anteriormente.
Outra informação presente na interface da consulta padrão personalizada de cadastro de produtos, se refere à coluna de saldo em estoque.

Esta coluna se refere ao saldo disponível em estoque (SB2) dos produtos apresentados. A configuração a respeito de quais campos da tabela SB2 serão considerados para a composição da posição em estoque apresentada na interface da consulta é realizada através do parâmetro MV_X997041 o qual por default é configurado considerando-se dos campos abaixo:
- SB2.B2_QATU-(SB2.B2_QEMP+SB2.B2_RESERVA)
Outro detalhe referente à coluna de saldo em estoque dos produtos, se refere aos armazéns considerados para a composição da posição em estoque. Por padrão, são considerados todos os armazéns existentes para cada produto na tabela SB2, porém, caso devam ser considerados apenas armazéns específicos, estes poderão ser vinculados junto ao parâmetro abaixo:
- MV_X997043
Por final, está disponível na interface da consulta de produtos à tecla de atalho F4 a qual aciona à interface padrão de consulta da posição em estoque a partir do produto em que se está posicionado na interface.

Através da configuração do parâmetro MV_X997042, é possível apresentar a coluna Saldo em Contrato de Parceria.
3.CONSULTA Mod.3 com Mark
Modelo de consulta disponível para qualquer tabela do Protheus.
Deverá ser incluída como “consulta específica”.

cAliasM, Caracter: Alias da tabela consultada aCamposM, Array: Campos que serão montados na grid de marcação cFiltroM, Caracter: Filtragem da tela (SQL) nTamanM, Numérico: Tamanho do campo de retorno cCheckM, Caracter: Campo que será checado lEditM, Lógico: Permite editar o retorno cSepM, Caracter: Caracter de separação do texto lAllFilM, Lógico: Identifica se são todas as filiais (inclusive de todas as empresas) lRetorn: retorno se a consulta foi confirmada ou não
| Parâmetro | Tipo | Descrição |
|---|---|---|
| cAliasM | Caracter | Alias da tabela consultada |
| aCamposM | Array | Campos que serão montados na grid de marcação |
| cFiltroM | Caracter | Filtragem da tela (SQL) |
| nTamanM | Numérico | Tamanho do campo de retorno |
| cCheckM | Caracter | Campo que será checado |
| lEditM | Lógico | Permite editar o retorno |
| cSepM | Caracter | Caracter de separação do texto |
| lAllFilM | Lógico | Identifica se são todas as filiais (inclusive de todas as empresas) |
| lRetorn | Lógico | Retorno se a consulta foi confirmada ou não |
IMPORTANTE: O Retorno da consulta padrão deve ser __cRetorn
Exemplo de cadastramento da consulta CTT (consulta específica):

