Histórico da Página

...

O comando do tipo SQL deve retornar obrigatoriamente um único valor, pois o Sistema está preparado para trabalhar apenas com o resultado final a ser retornado por este comando, sendo que atualmente este campo comporta até 255 caracteres.

Exemplo:

SELECT SUM(minha_tabela.meu_campo)
SELECT COUNT(m.campo_nao_padrao)
SELECT MAX(d.campo_nao_padrao)
SELECT AVG(m.qtd_volumes) #Média de volumes expedição por dia. m -> wms_exp_mestre_?

...

Neste campo é possível cadastrar uma função que pode manipular os comandos SQL (SELECT, FROM e WHERE ) padrões antes da execução na função padrão de apuração, sendo que esta função será executada antes do PREPARE do SQL utilizado para efetuar a leitura do valor calculado do operando no período, atuando como um “beforebefore_prepare”prepare.

Esta função vai receber por SET as variáveis cmd_select , cmd_from e cmd_where que estarão com os valores padrões como, por exemplo:

...

Deve obrigatoriamente retornar TRUE ou FALSE. Nesta função é possível, por exemplo, alterar o comando FROM que a função padrão executará, informando uma tabela específica ou adicionar um filtro no comando WHERE.

Exemplo básico:

FUNCTION wmsyXXXX_customiza_operando()
DEFINE l_cmd_from CHAR(1000)

LET l_cmd_from = LOG_getVar("cmd_from")

# ‘m’ representa o alias da tabela mestre do processo
LET l_cmd_from = l_cmd_from CLIPPED,
" INNER JOIN minha_tabela",
" ON minha_tabela.empresa = m.empresa",
" AND minha_tabela.ctr_ent_sai_veic_docum = m.ctr_ent_sai_veic_docum"

CALL LOG_setVar("cmd_from", l_cmd_from)

RETURN TRUE
END FUNCTION

...

CALL LOG_setVar("valor_operando",l_valor_operando)

Exemplo:

# Comando para ser executado após o calculo do valor do operando
# e a gravação da tabela padrão wms_geracao_dados_operando
FUNCTION wmsyXXXX_comando_retorno_valor()

...

Com esse campo é possível criar gerar filtros adicionais nas tabelas padrão de dados base como, por exemplo:

...

Exemplo de filtro utilizando parametrização customizada:

AND minha_tabela.meu_depositante = ?
AND minha_tabela.meu_campo_data_hora >= ?
AND minha_tabela.meu_campo_data_hora <= ?
AND minha_tabela.meu_campo_customizado = ?

...

É especificada uma função customizada, que será executa antes do EXECUTE do SQL usado para fazer a leitura do valor calculado do operando no período, atuando como um “beforebefore_execute” do execute do operando.

• Não possui parâmetros que podem ser recuperados pela função LOG_getVar().
• Pode ser utilizada para carregar os valores retornados pelas funções dos parâmetros customizados
• Deve obrigatoriamente retornar TRUE ou FALSE.

...

A função especificada customizada, fará o processamento e tratamento de datas de período início e fim, de forma que possam ser recuperadas por variáveis modulares ou tabelas temporárias, através de outra função que deverá ser informada no grid na grade Parâmetros.

2.

...

6.

...

Grade Parâmetros

3. INFORMAÇÕES ADICIONAIS SOBRE OS COMANDOS CUSTOMIZADOS

Criar Gerar funções customizadas que podem ser utilizadas para o Comando customizado, Comando retorno valor , ou Comando carga parâmetro requer alguns padrões a serem seguidos, para que a execução da função ocorra da forma desejada e apresente o resultado esperado. 

...

...

• Recebe como parâmetros que podem ser setados através da pela função LOG_setVar().

...

• Deve obrigatoriamente retornar TRUE ou FALSE

3.2. 

...

Gerando uma Função Customizada

Para criar gerar uma função customizada que poderá ser utilizada no Comando Customizado devem ser observados alguns padrões, pois dentro da rotina o comando SQL deve ser quebrado em três partes: SELECT, FROM e WHERE, conforme está descrito a seguir:

• Definição das Definir as variáveis l_select_stmt, l_from_stmt ,l_where_stmt com os respectivos tamanhos a seguir:

DEFINE l_select_stmt          VARCHAR(255)
            ,l l_from_stmt            VARCHAR(1000)
             l_where_stmt         VARCHAR(5000)

• Definir Record para receber as informações do operando:

DEFINE lr_operand_fatur       RECORD
                             tip_processo                CHAR(20)                                ,tip_operando_faturamento SMALLINT
                            ,dat_base_operando        SMALLINToperando     SMALLINT
                            ,filtro_customizado       LIKE wms_operando_faturamento.filtro_customizado
                            ,forma_cobranca           LIKE wms_operando_faturamento.forma_cobranca
                           END RECORD

DEFINE l_depositante CHAR(15)
LET l_depositante = wmsr48_get_depositante()

• Utilizar o código do depositante para montar os nomes das tabelas no SELECT, pois as informações estão divididas em tabelas com prefixo padrão, porém, com código do depositante compondo o nome. Mais detalhes podem ser obtidos a seguir, em Tabelas e Alias.
  
  
• Utilizar a função abaixo para obter as informações do operando de faturamento:

...

Montagem do SELECT

• Processo: "RECEBIMENTO"
  LET l_from_stmt = " FROM wms_rec_mestre_", l_depositante CLIPPED, " m"
  
  
• Processo: "EXPEDICAO"
  LET l_from_stmt = " FROM wms_exp_mestre_", l_depositante CLIPPED, " m"
  
  
• Processo: "ARMAZENAGEM"
  LET l_from_stmt = " FROM wms_armaz_end_", l_depositante CLIPPED, " m"
  
  
• Processo: "SEGURO"
  LET l_from_stmt = " FROM wms_seg_detail_", l_depositante CLIPPED, " d"
  
  
• Processo: "ATRIBUTO"
  LET l_from_stmt = " FROM wms_atr_mestre_", l_depositante CLIPPED, " m"

4. ASSUNTOS RELACIONADOS

Documento de Referência

• Operando - WMS6401

5. ANEXO

• Customização de operandos de faturamento de serviço.pdf

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>