DataSource de Preço
Conceito
O DataSource de Preços (-1897035178 /* /products/INTEQerp infrastructure/library/dataSources/preco/preco.ids */) tem como objetivo resgatar os dados relativos aos preços que estejam vigentes em uma determinada data/hora. Também é possível selecionar os preços alterados em um determinado período, ou ainda visualizar o histórico de alteração de preço de uma determinada tabela. Formas de utilização do datasource de preços.
Exibindo o preço válido do recurso cujo preço esteja vigente em uma determinada data.
Deverão ser utilizados os filtros Data Vigência e Hora Vigência.
Exibindo o preço válido do recurso cujo preço esteja vigente em uma determinada data, filtrando apenas os recursos que tiveram o preço alterado em um determinado período.
Deverão ser utilizados os filtros Data Vigência e Hora Vigência em conjunto com os filtros Data Alteração Início, Hora Alteração Início, Data Alteração Fim e Hora Alteração Fim.
Exibindo todos os preços do recurso, filtrando apenas os recursos que tiveram o preço alterado em um determinado período, exibindo assim o histórico de alterações do preço do recurso.
Deverão ser utilizados os filtros Data Alteração Início, Hora Alteração Início, Data Alteração Fim e Hora Alteração Fim.
Exibindo todos os preços do recurso que tiveram preços iniciados e ou finalizados em um determinado período.
Deverão ser utilizados os filtros Início e Fim da tabela de preços.
Atenção: a combinação de filtros poderão trazer diferentes preços para o mesmo recurso, e precisa ser tratado o agrupamento ou filtro pela tabela de preço pela interface.
Filtros
Este DataSource fornece acesso a filtros de todos os campos da classe a seguir e de suas filhas, exceto os campos ASSINATURAPAF, VALORREPASSE, PERCENTUALREPASSE, PESSOAREPASSE, LOTE, OBSERVACAO, MARGEMZERO, RECURSODEST, UNIFICADOR, COMISSAO, CRIACAO e CRIACAOH.
-1897053416, Fatores de Preços, prefixo: FAT;
Permissão
O filtro calculado XVALIDAPERMISSAO do tipo booleano com valor default verdadeiro é utilizado para habilitar ou desabilitar a visão das permissões de classe sobre os registros retornados pelo datasource. Ele atua sobre todos os registros originados a parte da classe de Fatores de Preços assim como de suas classes filhas.
Vigência
Os filtros calculados FAT_XDATAVIGENCIA (tipo Date) e FAT_XHORAVIGENCIA (tipo string no formato hh:mm) foram disponibilizados com o objetivo de buscar os preços vigentes no período especificado, o resultado do uso destes filtros é trazer um único preço vigente na data e hora informada (por recurso e tabela).
Os filtros FAT_INICIO, FAT_INICIOH, FAT_FIM e FAT_FIMH buscam pelos próprios campos da tabela fator, e podem ser utilizados para pesquisar preços iniciados ou finalizados em uma determinada data.
Não será possível a utilização dos filtros _START e _END para os filtros de vigência FAT_XDATAVIGENCIA, FAT_XHORAVIGENCIA, FAT_INICIO, FAT_INICIOH, FAT_FIM e FAT_FIMH.
Período de Alteração
Os filtros calculados FAT_XDATAALTERACAOINICIO FAT_XDATAALTERACAOFIM, FAT_XHORAALTERACAOINICIO, FAT_XHORAALTERACAOFIM foram disponibilizados com o objetivo de possibilitar que o usuário identifique os recursos que tiveram os preços alterados em um determinado período.
Não será possível a utilização dos filtros _START e _END para os filtros de alteração FAT_XDATAALTERACAOINICIO, FAT_XHORAALTERACAOINICIO, FAT_XDATAALTERACAOFIM e FAT_XHORAALTERACAOFIM.
As características que determinam se um recurso teve o preço alterado são.
Recurso não tinha preço cadastrado e teve, no período informado, a inclusão do preço na tabela.
Recurso tinha um preço cadastrado em data anterior ao período informado e teve, no período informado, a inclusão do preço na tabela.
Recurso tinha um preço cadastrado no período informado e teve, no período informado, a inclusão do preço na tabela.
Recurso que tenha tido um preço finalizado no período informado.
Colunas
Este DataSource também fornece acesso a todos os campos da classe a seguir e de suas filhas, exceto os campos ASSINATURAPAF, VALORREPASSE, PERCENTUALREPASSE, PESSOAREPASSE, LOTE, OBSERVACAO, MARGEMZERO, RECURSODEST, UNIFICADOR, COMISSAO, CRIACAO e CRIACAOH.
-1897053416, Fatores de Preços, prefixo: FAT;
Preço Anterior
A coluna calculada FAT_XPRECOANTERIOR foi disponibilizada com o objetivo de exibir o preço imediatamente anterior ao preço do recurso exibido.
Exemplo de uso do DataSource de preço
__includeOnce(-1898141835); // /products/INTEQengine/configuration/iDBCsql library.ijs
__includeOnce(-1898142156 /* /products/UNUMengine/library/dataSource/DataSource.ijs */);
var dts = new DataSource(-1897035178 /* /products/INTEQerp infrastructure/library/dataSources/preco/preco.ids */);
var filtrosDoFator = [];
filtrosDoFator.push( {name: "FAT_TABFATOR", operator: "=", value: "377788551" } );
filtrosDoFator.push( {name: "FAT_XDATAALTERACAOINICIO", operator: "=", value: (new Date(2015, 2, 1)) } );
filtrosDoFator.push( {name: "FAT_XDATAALTERACAOFIM", operator: "=", value: (new Date(2015, 2, 10)) } );
var colunasDaConsulta = [];
colunasDaConsulta.push( {name: "FAT_CHAVE" , alias: "CHAVE" } )
colunasDaConsulta.push( {name: "FAT_CLASSE" , alias: "CLASSE" } )
colunasDaConsulta.push( {name: "FAT_RECURSOORIG" , alias: "RECURSO" } )
colunasDaConsulta.push( {name: "FAT_TABFATOR" , alias: "TABFATOR" } )
colunasDaConsulta.push( {name: "FAT_INICIO" , alias: "INICIOH" } )
colunasDaConsulta.push( {name: "FAT_FATOR" , alias: "FATOR" } )
colunasDaConsulta.push( {name: "FAT_XPRECOANTERIOR" , alias: "PRECO_ANTERIOR" } )
colunasDaConsulta.push( {name: "FAT_FIM" , alias: "FIM" } )
colunasDaConsulta.push( {name: "FAT_FIMH" , alias: "FIMH" } )
var ds = dts.getDataSet( dts.createFilters( filtrosDoFator ), dts.createColumns( colunasDaConsulta ) );