Gestão de Pessoas - Manual do Usuário > Customizações > Funções > BuscaValorItemCalculo

BuscaValorItemCalculo

O objetivo desta função de programador é disponibilizar para a regra, durante o cálculo do orçamento por cenário, os valores integrais e proporcionais de determinado item(passado como parâmetro na função) e em determinado mês de cálculo (também passado como parâmetro).

Sintaxe: BuscaValorItemCalculo(Numero IteOrc, Numero MesOrc, Numero AnoOrc, Numero End ValOrcInt, Numero End ValOrcPro, Numero End Retorno);

Parâmetros:

Nome	Tipo	Descrição
IteOrc	Numérico	Código do item de cálculo que será a referência de busca dos valores.
MesOrc	Numérico	Mês de cálculo. Esse mês pode ser 0(zero) e, nesse caso, serão trazidos os valores do mês que está sendo calculado. No cálculo da variação do quadro de vagas não é possível buscar os valores de meses anteriores ao cálculo, sempre trará os valores do mês que está calculando. Se for informado um mês inferior ao início do cálculo ou posterior ao mês final de cálculo não será possível trazer os valores, pois neste caso não terá nada calculado nesse mês. Se for passar o mês como parâmetro deve informar um mês válido, ou seja de 01(Janeiro) até 12(Dezembro).
AnoOrc	Numérico	Ano de cálculo. Se este parâmetro for 0(zero) o cálculo irá retornar o valor do item referente ao primeiro registro igual ao mês passado como parâmetro. Exemplo: se estiver calculando um período de 24 meses - 01/2008 até 12/2009 - se na função informar somente o mês 1, a função sempre retornará o mês de 01/2008, pois será o primeiro mês igual ao parâmetro. Por isso, é importante passar no parâmetro o ano do qual deseja o valor do item calculado. Se não for passado o mês no parâmetro, conforme anteriormente informado será considerado o mês de cálculo. O ano deve ser passado no formato de 4 dígitos, ou seja: 2008, 2009, 2010, etc.
ValOrcInt	Numérico	Valor integral do item solicitado, passado como parâmetro para a função.
ValOrcPro	Numérico	Valor proporcional do item solicitado, passado como parâmetro para a função.
Retorno	Numérico	Ver abaixo.

Tipo de Retorno: Essa variável servirá para que sejam identificadas algumas situações em que não é possível trazer os valores do item solicitado:

Foi possível buscar os valores do item solicitado;
Mês informado é inválido e não foi possível buscar as informações do item;
Mês informado como parâmetro é menor que o mês de início de cálculo e por isso não foi possível encontrar o valor do item;
Ao buscar os itens da variação do quadro sempre será considerado o mês de cálculo, não sendo possível buscar as informações de meses anteriores. Os valores retornados são referentes ao mês de cálculo.

Exemplo:

BuscaValorItemCalculo(99, 1, 2008, xValOrcInt, xValOrcPro, xRet);
Se (xValOrcInt <> 0)
{
    Se (TipCalind = 1)
    {
      R185VLI.ValOrc = xValOrcPro;
    }
    Senao
    {
      Se (TipCalind = 2)
      {
        R185VCI.ValOrc = xValOrcPro;
      }
      Senao
      {
        Se (TipCalind = 3)
        {
          R185VLO.ValOrc = xValOrcPro;
        }
        Senao
        {
          Se (TipCalind = 4)
          {
            R185VCC.ValOrc = xValOrcPro;
          }

Senao

{

Se (TipCalind = 5)

{

R185VPI.ValOrc = xValOrcPro;

}

Senao

{

Se (TipCalind = 6)

{

R185VPO.ValOrc = xValOrcPro;

}

        }
      }
    }
    ValOrcInt = xValOrcInt;
}

Utilização: Regras utilizadas no cálculo do orçamento por cenário.

Disponível para o módulo: QL.