Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Funções

Função fo_New
Sintaxe fo_New( @oObj, cAlias , nOrder , cKey, cQueryWhere, lSqlWhere , lTopFilter)
Descrição Construtor da Classe GetDetFormula.
Obtem as informações da tabela solicitada:
Carrega o aHeader com os campos da tabela solicitada.
Carrega o aCols com os dados da tabela solicitada.
Parâmetros oObj => Objeto onde ficarão armazenado os dados.
cAlias => Alias da tabela para a carga dos dados.
nOrder => Ordem de pesquisa. Opcional. DEFAULT: 1
cKey => Chave para o posicionamento (filtro) na tabela solicitada.
cQueryWhere => Query para seleção de dados. Opcional.
lSqlWhere => Opcional. DEFAULT: .F.
lTopFilter => Opcional. DEFAULT: .T.
Retorno Self
Exemplos Obter informações do SRC do funcionário "000003" da filial "01", utilizando a ordem de
pesquisa 1("RC_FILIAL+RC_MAT+RC_PD+RC_CC+RC_SEMANA+RC_SEQ")
cQueryWhere :=
lSqlWhere :=
lTopFilter :=
fo_New( @oSRC,
"SRC", // Alias
1, // Ordem
"01000003", // Chave
cQueryWhere,
lSqlWhere,
lTopFilter)

Função fo_Put
Sintaxe lGravou := fo_Put( @oObj , uFieldsDel , uCntDel )
Descrição Grava os dados na respectiva tabela.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uFieldsDel => String ou Array de campos. Opcional.
uCntDel => String ou Array de conteúdos. Opcional.

Esses parâmetros são utilizados para verificar a deleção de alguns registros do objeto. Será
excluído todos os registro cujo o(s) campo(s) passado(s) em uFieldsDel estiver(em) com a(s)
informação(oes) passada(s) em uCntDel.
Retorno lPutOk => .T. - se conseguiu gravar os dados
.F. - se não conseguiu gravar os dados
Exemplos Gravar todos as informações do objeto oSRJ em SRJ.
fo_Put( @oSRJ )

Versão 001 Desenvolvimento Sistemas R.H.

 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Gravar todos as informações do objeto oSRJ em SRJ, exceto o(s) registro(s) cujo campo
"RJ_MAOBRA" for igual a "I", ou seja, se a mão-de-obra for indireta.
fo_Put( @oSRJ , "RJ_MAOBRA" , "I")

Gravar todos as informações do objeto oSRJ em SRJ, exceto o(s) registro(s) cujo campo
"RJ_MAOBRA" for igual a "I" e o campo "RJ_SALARIO" for igual a 0 (zero).
Fo_Put( @oSRJ , {"RJ_MAOBRA", "RJ_SALARIO"} , {"I", 0} )

Função fo_Add
Sintaxe lAdicionou := fo_Add( @oObj , uFields,uCnts,uFieldsKey,uCntFieldsKey,lChkUnique)
Descrição Adiciona um novo registro ou substitui algum(s) valor(es) de um registro já existente no aCols
do objeto.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uFields => String ou Array com os campos que deverão ser atualizados/adicionados.
uCnts => String ou Array com o conteúdo de cada campo que está em uFields e que
deverá ser atualizado/adicionado .
uFieldsKey => String ou Array com os campos chave para verificar se o registro deverá ser
atualizado ou adicionado. Opcional.
uCntFieldsKey => String ou Array com o conteúdo de cada campo chave que está em
uFieldsKey. Opcional.
lChkUnique => Opcional. DEFAULT: .T.

Os parâmetros uFieldsKey e uCntFieldsKey são utilizados para verificar se o registro já existe

no objeto. Será atualizado o(s) campo(s) de uFields com o(s) conteúdo(s) de uCnts o registro
cujo campo(s) passado(s) em uFieldsKey estiver(em) com a(s) informação(oes) passada(s) em
uCntFieldsKey. Se não for passado os parâmetros uFieldsKey e uCntFieldsKey ou se não for
encontrado nenhum registro que satisfaz a condição passada, será adicionado ao objeto o
registro pedido.
Retorno lAddOk => .T. - se conseguiu gravar os dados
.F. - se não conseguiu gravar os dados
Exemplos Caso não exista a verba "001",adicionar a verba ao objeto oSRV. Caso exista a verba "001",
substituir no objeto oSRV os campos descrição, tipo do codigo e imprime verba com os
conteúdos passados.
fo_Add( @oSrv , {"RV_COD","RV_DESC","RV_TIPOCOD","RV_IMPRIPD"},
{"001", "VERBA 001", "1", "1"}, "RV_COD", "001" )

Caso não exista a verba "001" para a data de referência "01/01/2004", adicionar o lançamento
ao objeto oSRC. Caso exista a verba "001" para a data de referência "01/01/2004", substituir os
campos passados para o lançamento no objeto oSRC.
fo_Add( @oSrv , {"RC_PD","RC_TIPO1","RC_VALOR"},{"001","V", 100},
{"RC_PD","RC_DTREF"}, {"001","01/01/2004"})

Adicionar uma verba ao objeto oSRV.

Versão 001 Desenvolvimento Sistemas R.H.

 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

fo_Add( @oSrv , {"RV_COD", "RV_DESC", "RV_TIPOCOD", "RV_IMPRIPD"} ,

{"002", "VERBA 002", "1", "1"})

Função fo_Get
Sintaxe aDados := fo_Get( @oObj , uCposGet , uFieldsKey , uCntFieldsKey , lAscAllKeys)
Descrição Obtem as informações dos campos conforme parâmetros.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uCposGet => String ou Array de campos cujo conteúdo será retornado.
uFieldsKey => String ou Array com os campos chave que será utilizado com filtro.
Opcional.
uCntFieldsKey => String ou Array com o conteúdo de cada campo chave que está em
uFieldsKey. Opcional.
lAscAllKeys =>.T. para retornar todos os registros, dependendo do filtro passado
.F. para retornar apenas o primeiro registro encontrado, dependendo do
filtro passado.
Opcional. DEFAULT .F.
Retorno uGetDet => Array com o conteúdo dos campos solicitado em uCposGet.
Exemplos Retornar os campos valor e horas de todos os registros do objeto SRC.
aDados := fo_Get( @oSrc , { "RC_VALINFO" , "RC_HORINFO" } )
Retorno: aDados[1][1] = 100 // RC_VALINFO
aDados[1][2] = 0 // RC_HORINFO
aDados[2][1] = 0 // RC_VALINFO
aDados[2][2] = 8 // RC_HORINFO

Retornar os campos valor e horas da verba "101" do objeto SRC.

aDados := fo_Get( @oSrc , { "RC_VALINFO" , "RC_HORINFO" } , "RC_PD" , "101" )
Retorno: aDados[1][1] = 100 // RC_VALINFO
aDados[1][2] = 0 // RC_HORINFO
aDados[2][1] = 0 // RC_VALINFO
aDados[2][2] = 8 // RC_HORINFO

Retornar o campo valor da verba "101" do objeto SRC.

aDados := fo_Get( @oSrc , "RC_VALINFO" , "RC_PD" , "101" )
Retorno: aDados[1][1] = 100 // RC_VALINFO
aDados[2][1] = 0 // RC_VALINFO

Retornar os campos valor e horas da verba "101" para a data de referência "01/01/2005" do
objeto SRC.
aDados := fo_Get( @oSrc , { "RC_VALINFO" , "RC_HORINFO" },
{ "RC_PD" , "RC_DTREF" },
{ "101" , "01/01/2005" } )
Retorno: aDados[1][1] = 100 // RC_VALINFO
aDados[1][2] = 0 // RC_HORINFO
aDados[2][1] = 0 // RC_VALINFO
aDados[2][2] = 8 // RC_HORINFO
Versão 001 Desenvolvimento Sistemas R.H.
 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Função fo_SetVal
Sintaxe fo_SetVal( @oObj , cCpo , uCnt , nLine )
Descrição Altera o conteúdo do campo conforme parâmetros.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
cCpo => Campo que será alterado.
uCnt => informação que será atualizada no campo.
nLine => Determina de qual registro deverá ser atualizado. Opcional. DEFAULT: elemento
posicionado.
Retorno uLstVal =>
Exemplos Atualizar o valor elemento posicionado do objeto oSRC.
fo_SetVal( @oSrc , "RC_VALINFO" , 100)

Atualizar o valor do elemento 3 do objeto oSRC.

fo_SetVal( @oSrc , "RC_VALINFO", 100, 3)

Função fo_GetVal
Sintaxe cConteúdo := fo_GetVal( @oObj , cCpo , nLine )
Descrição Obtem o conteúdo do campo conforme parâmetros.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
cCpo => Campo cujo qual o conteúdo será retornado.
nLine => Determina de qual registro deverá ser retornado o conteúdo. Opcional.
DEFAULT: elemento posicionado.
Retorno uGetVal => conteúdo do campo solicitado.
Exemplos Retornar a verba do elemento que está posicionado do objeto oSRC.
cConteúdo := fo_GetVal( @oSrc , "RC_PD")

Retornar a verba do elemento 3 do objeto oSRC.

cConteúdo := fo_GetVal( @oSrc , "RC_PD", 3)

Função fo_GetPos
Sintaxe aPosicoes := fo_GetPos( @oObj , uFieldsKey , uCntFieldsKey , lAscAllKeys )
Descrição Retorna Array com Posicionamento dos Itens.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uFieldsKey => String ou Array dos campos chave. Opcional.
uCntFieldsKey=> String ou Array com o conteúdo dos campos chave. Opcional.
lAscAllKeys => .T. para retornar a posição de todos os registros, dependendo do filtro
passado
.F. para retornar apenas a posição do primeiro registro encontrado,
dependendo do filtro passado.
Opcional. DEFAULT .F.
Retorno aGetPosDet => Array com o posicionamento dos registros, conforme parâmetros.
Exemplos Retornar o posicionamento de todos os registros do objeto oSRC.
aPosicoes := fo_GetPos( @oSrc )
Versão 001 Desenvolvimento Sistemas R.H.
 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Retornar o posicionamento da verba "101" do objeto oSRC.

aPosicoes := fo_GetPos( @oSrc , "RC_PD" , "101" )

Função fo_Count
Sintaxe nQuantidade := fo_Count( @oObj , uFieldsKey , uCntFieldsKey , lDeleted )
Descrição Retorna o número de elementos que atende a condição
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uFieldsKey => String ou Array dos campos chave. Opcional.
uCntFieldsKey=> String ou Array com o conteúdo dos campos chave. Opcional.
lDeleted => .T. para adicionar a uFiledsKey a coluna "GDDELETED" e ".F." em
uCntFieldsKey. Só será adicionado se o campo "GDDELETED" não
estiver em uFieldsKey.
.F. para não adicionar a uFiledsKey a coluna "GDDELETED".
Opcional. DEFAULT .F.
Retorno nCount => número de elementos que atenderam a condição.
Exemplos Retornar a quantidade de registros do objeto oSRC.
nQuantidade := fo_Count( @oSrc )

Retornar a quantidade de registros do centro de custo "11" do objeto oSRC.

nQuantidade := fo_Count( @oSrc , "RC_CC" , "11 ")

Função fo_Del
Sintaxe lDeletou := fo_Del( @oObj , uFiels , uCnts )
Descrição Deleta registro do aCols conforme uFields e uCnts
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uFields=> String ou Array de campos.
uCnts => String ou Array de conteúdos.

Esses parâmetros são utilizados para verificar a deleção do(s) registro(s) do objeto. Será
excluído todos os registro cujo campo(s) passado(s) em uFields estiver(em) com a(s)
informação(oes) passada(s) em uCnts.
Retorno lDelOk => .T. - se conseguiu excluir o(s) registro(s)
.F. - se não conseguiu excluir o(s) registro(s)
Exemplos Apagar todas as informações do SRC do funcionário "000001".
fo_Del( @oSrc , {"RC_MAT"} , {"000001"} )

Apagar todas as informações do SRC do funcionário "000001", processo "99999"

fo_Del( @oSrc , {"RC_MAT", "RC_PROCES"}, {"000001", "99999"})

Função fo_UnDel
Sintaxe lUnDel := fo_UnDel( @oObj , uFiels , uCnts )
Descrição Restaura registro do aCols conforme uFields e uCnts
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
Versão 001 Desenvolvimento Sistemas R.H.
 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

uFields=> String ou Array de campos.

uCnts => String ou Array de conteúdos.

Esses parâmetros são utilizados para verificar o(s) registro(s) do objeto que será(ão)
restaurado(s). Será restaurado todos os registro cujo campo(s) passado(s) em uFields
estiver(em) com a(s) informação(oes) passada(s) em uCnts e que foram deletados.
Retorno lUnDelOk => .T. - se conseguiu restaurar o(s) registro(s)
.F. - se não conseguiu restaurar o(s) registro(s)
Exemplos Restaurar as informações do SRC do funcionário "000001".
fo_UnDel( @oSrc , "RC_MAT" , "000001" )

Restaurar as informações do SRC do funcionário "000001", processo "99999"

fo_UnDel( @oSrc , {"RC_MAT", "RC_PROCES"}, {"000001", "99999"})

Função fo_Delete
Sintaxe fo_Delete( @oObj , nElem )
Descrição Deleta o elemento posicionado ou passado como parâmetro.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
nElem => posição do elemento que deverá ser excluído. Opcional. DEFAULT: elemento
posicionado.
Retorno lDeleted => .T. - se conseguiu excluir o elemento.
.F. - se não conseguiu excluir o elemento.
Exemplos Excluir o elemento que está posicionado do objeto oSRC.
fo_Delete( @oSrc )

Excluir o elemento 3 do objeto oSRC.

fo_Delete( @oSrc, 3)

Função fo_Deleted
Sintaxe fo_Deleted( @oObj , nElem )
Descrição Verifica se o elemento está deletado no aCols.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
nElem => elemento que será verificado. Opcional. DEFAULT: elemento posicionado.
Retorno lDeleted => .T. - se o elemento está excluído.
.F. - se o elemento não está excluído.
Exemplos Verificar se o elemento que está posicionado do objeto oSRC está excluído.
fo_Deleted( @oSrc )

Verificar se o elemento 3 do objeto oSRC está excluído.

fo_Deleted( @oSrc , 3)

Função fo_Restore
Sintaxe fo_Restore( @oObj , nElem )
Descrição Restaura um elemento específico no aCols.
Versão 001 Desenvolvimento Sistemas R.H.
 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
nElem => elemento que será restaurado. Opcional. DEFAULT: elemento posicionado.
Retorno lRestore => .T. - se o elemento foi restaurado.
.F. - se o elemento não foi restaurado.
Exemplos Restaurar o elemento que está posicionado do objeto oSRC.
fo_Restore( @oSrc )

Restaurar o elemento 3 do objeto oSRC.

fo_Restore( @oSrc , 3)

Função fo_Default
Sintaxe fo_Default( @oObj , uDefaultCpo , uFieldsKey , uCntFieldsKey , nLine , lInitPad)
Descrição Inicializa os valores DEFAULT para os campos.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uDefaultCpo => String ou Array com os campos que deseja inicializar. DEFAULT: Todos os
campos
uFieldsKey => String ou Array com os campos chave que serão utilizados como filtro para
inicializacao dos campos de uDefaultCpo. Opcional. Se não passado será
inicializado os campos de uDefaultCpo para todos os registro do objeto.
uCntFieldsKey=> String ou Array com o conteúdo dos campos chave. Opcional.
nLine => Determina para qual registro deverá ser feita a inicializacao dos campos
uDefaultCpo. Opcional. Se não passado será inicializado os campos de
uDefaultCpo para todos os registro do objeto, respeitando os filtros
(uFieldsKey e uCntFieldsKey).
lInitPad => Se deve carregar os inicializadores padroes. Opcional. DEFAULT: .T.
Retorno NIL
Exemplos Inicializar os campo horas, valor e data do objeto oSRC.
fo_Default( @oSrc , { "RC_HORAS" , "RC_VALOR" , "RC_DATA" } )

Inicializar os campo horas, valor e data do objeto oSRC, somente para os registros que o valor
está zerado.
fo_Default( @oSrc , { "RC_HORAS" , "RC_VALOR" , "RC_DATA" }, "RC_VALOR" , 0 )

Inicializar o campo horas do objeto oSRC, somente para o terceiro registro.

fo_Default( @oSrc , "RC_HORAS" , , , 3 )

Função fo_GetnElem
Sintaxe nQuantidade := fo_GetnElem( @oObj )
Descrição Retorna o número de elementos do objeto
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
Retorno nElem => Número de elementos do aCols.
Exemplos Retornar a quantidade de registros do objeto oSRC.
nQuantidade := GetnElem( @oSrc )

Versão 001 Desenvolvimento Sistemas R.H.

 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Função fo_Skip
Sintaxe fo_Skip( @oObj , nSkipper )
Descrição Salta registro(s) em aCols, a partir do elemento que está posicionado.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
nSkipper => Quantidade de registros que deverá saltar. Opcional. DEFAULT: 1.
Retorno nSkip => Retorna a posição do elemento para qual saltou.
Exemplos Saltar para o proximo elemento
fo_Skip( @oSrc )

Saltar 2 elementos
fo_Skip( @oSrc , 2 )

Função fo_Seek
Sintaxe fo_Seek( @oObj , uFieldsKey , uCntFieldsKey , lNoDeleted )
Descrição Procura e posiciona registro em aCols.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uFieldsKey => String ou Array com campos chave para procura em aCols
uCntFieldsKey=> String ou Array com o conteúdo dos campos chave.
lNoDeleted => .T. para adicionar a uFiledsKey a coluna "GDDELETED" e ".F." em
uCntFieldsKey. Só será adicionado se o campo "GDDELETED" não estiver
em uFieldsKey.
.F. para não adicionar a uFiledsKey a coluna "GDDELETED".
Opcional. DEFAULT .T.
Retorno lFound => .T. se encontrou o elemento de acordo com os parâmetros.
.F. se não encontrou.
Exemplos Procurar e posicionar na verba "101" do objeto oSRC
fo_Seek( @oSrc , "RC_PD" , "101" )

Procurar e posicionar na verba "101" e data de referência "01/01/2005" do objeto oSRC

fo_Seek( @oSrc , { "RC_PD" , "RC_DTREF" } , { "101" , "01/01/2005" } )

Função fo_Goto
Sintaxe lPosicionou := fo_Goto( @oObj , nGoto )
Descrição Posiciona em um determinado elemento em aCols
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
nGoto => indica qual o registro de aCols deseja posicionar. Opcional. DEFAULT: 1
Retorno lGoto => .T. se posicionou no registro.
.F. se não posicionou no registro.
Exemplos Posicionar no terceiro elemento de aCols do objeto oSRC.
fo_Goto( @oSrc , 3 )

Posicionar no primeiro elemento de aCols do objeto oSRC.

fo_Goto( @oSrc ) ou fo_Goto( @oSrc , 1 )

Versão 001 Desenvolvimento Sistemas R.H.

 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Função fo_GotoPrev
Sintaxe lPosicionou := fo_GotoPrev( @oObj , uFieldsKey , uCntFieldsKey )
Descrição Posiciona no proximo registros conforme chave ( do ultimo encontrado para o primeiro )
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uFieldsKey => String ou Array com os campos chave. Opcional.
uCntFieldsKey => String ou Array com o conteúdo dos campos chave. Opcional.
Retorno lGoto => .T. se posicionou no registro.
.F. se não posicionou no registro.
Exemplos Header => aHeader[1] = "RC_PD" Cols => aCols[1][1] = "101"
aHeader[2] = "RC_VALINFO" aCols[1][2] = "100"
aHeader[3] = "RC_HORINFO" aCols[1][3] = "0"
aHeader[4] = "RC_DTREF" aCols[1][4] = "01/01/2005"

aCols[2][1] = "101"
aCols[2][2] = "220"
aCols[2][3] = "0"
aCols[2][4] = "01/02/2005"

aCols[3][1] = "102"
aCols[3][2] = "222"
aCols[3][3] = "0"
aCols[3][4] = "01/02/2005"

aCols[4][1] = "101"
aCols[4][2] = "300"
aCols[4][3] = "0"
aCols[4][4] = "01/03/2005"

aCols[5][1] = "102"
aCols[5][2] = "333"
aCols[5][3] = "0"
aCols[5][4] = "01/03/2005"

aCols[6][1] = "999"
aCols[6][2] = "100"
aCols[6][3] = "0"
aCols[6][4] = "01/01/2005"

- fo_GotoPrev( @oSrc , "RC_PD" , "101" ):

Irá posicionar no elemento 4 do aCols.

- fo_GotoPrev( @oSrc , { "RC_PD" , "RD_DTREF" } , { "101" , "01/01/2005" } ):

Irá posicionar no elemento 1 do aCols.

- While <condição>
Versão 001 Desenvolvimento Sistemas R.H.
 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

fo_GotoPrev( @oSrc , "RC_PD" , "102" )

End
Na primeira vez que passar pela função fo_GotoPrev irá posicionar no elemento 5 do
aCols. Já na segunda vez que passar pela função irá posicionar no elemento 3 do
aCols.

Função fo_GotoNext
Sintaxe lPosicionou := fo_GotoNext( @oObj , uFieldsKey , uCntFieldsKey )
Descrição Posiciona no proximo registros conforme chave ( do primeiro encontrado para o ultimo )
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
uFieldsKey => String ou Array com os campos chave. Opcional.
uCntFieldsKey => String ou Array com o conteúdo dos campos chave. Opcional.
Retorno lGoto => .T. se posicionou no registro.
.F. se não posicionou no registro.
Exemplos Header => aHeader[1] = "RC_PD" Cols => aCols[1][1] = "101"
aHeader[2] = "RC_VALINFO" aCols[1][2] = "100"
aHeader[3] = "RC_HORINFO" aCols[1][3] = "0"
aHeader[4] = "RC_DTREF" aCols[1][4] = "01/01/2005"

aCols[2][1] = "101"
aCols[2][2] = "220"
aCols[2][3] = "0"
aCols[2][4] = "01/02/2005"

aCols[3][1] = "102"
aCols[3][2] = "222"
aCols[3][3] = "0"
aCols[3][4] = "01/02/2005"

aCols[4][1] = "101"
aCols[4][2] = "300"
aCols[4][3] = "0"
aCols[4][4] = "01/03/2005"

aCols[5][1] = "102"
aCols[5][2] = "333"
aCols[5][3] = "0"
aCols[5][4] = "01/03/2005"

aCols[6][1] = "999"
aCols[6][2] = "100"
aCols[6][3] = "0"
aCols[6][4] = "01/01/2005"
- fo_GotoNext( @oSrc , "RC_PD" , "101" ):
Irá posicionar no elemento 1 do aCols.
Versão 001 Desenvolvimento Sistemas R.H.
 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

- fo_GotoNext( @oSrc , { "RC_PD" , "RD_DTREF" } , { "101" , "01/03/2005" } ):

Irá posicionar no elemento 4 do aCols.

- While <condição>
fo_GotoNext( @oSrc , "RC_PD" , "102" )
End
Na primeira vez que passar pela função fo_GotoPrev irá posicionar no elemento 3 do
aCols. Já na segunda vez que passar pela função irá posicionar no elemento 5 do
aCols.

Função fo_GoTop
Sintaxe lPosicionou := fo_GoTop( @oObj )
Descrição Posiciona no primeiro elemento do aCols.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
Retorno lGoTop => .T. se posicionou no registro.
.F. se não posicionou no registro.
Exemplos fo_GoTop( @oSrc )

Função fo_GoBottom
Sintaxe lPosicionou := fo_GoBottom( @oObj )
Descrição Posiciona no ultimo elemento do aCols.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
Retorno lGoBottom => .T. se posicionou no registro.
.F. se não posicionou no registro.
Exemplos fo_GoBottom( @oSrc )

Função fo_Bof
Sintaxe fo_Bof( @oObj , lChkSkip )
Descrição Verifica se é início do arquivo.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
lChkSkip => Opcional. DEFAULT: .T.
Retorno lBof => .T. se é início do arquivo.
.F. se não é início do arquivo.
Exemplos fo_Bof( @oSrc )

Função fo_Eof
Sintaxe fo_Eof( @oObj , lChkSkip )
Descrição Verifica se é final de arquivo.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
lChkSkip => Opcional. DEFAULT: .T.
Retorno lEof => .T. se é final de arquivo.
.F. se não é final de arquivo.

Versão 001 Desenvolvimento Sistemas R.H.

 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Exemplos fo_Eof( @oSrc )

Função fo_AtOk
Sintaxe fo_AtOk( @oObj , nLine , lChkSkip )
Descrição Verifica se o número da linha passada é válido. Verifica se a linha passada existe em aCols.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
nLine => DEFAULT: linha posicionada de aCols.
lChkSkip =>
Retorno lAtOk => .T. se a linha é válida.
.F. se a linha não é válida.
Exemplos fo_AtOk( @oSrc , 1 , .T. )

Função fo_GetOk
Sintaxe fo_GetOk( @oObj )
Descrição Verifica se foi feita a carga das informações do arquivo para o objeto.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
Retorno lGetOk => .T. se estiver tudo ok com a carga das informações.
.F. se não foi feita a carga das informações.
Exemplos lGetOk := fo_GetOk (@oSrc )

Função fo_SomaAllRegs
Sintaxe nSoma := fo_SomaAllRegs( @oObj , cCpoSoma , uFieldsKey , uCntFieldsKey )
Descrição Retorna a Soma de Todos os valores do campo passado em cCpoSoma e de acordo com as
condições definidas em uFieldsKey e uCntFieldsKey
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
cCpoSoma => String ou Array com os campos cujo conteúdo será somado.
uFieldsKey => String ou Array com os campos chave que será utilizado com filtro.
Opcional.
uCntFieldsKey => String ou Array com o conteúdo de cada campo chave que está em
uFieldsKey. Opcional.
Retorno nSomaRegs => Soma dos valores dos campos solicitados.
Exemplos Somar o valor pago do objeto SRK.
nSoma := fo_SomaAllRegs( @oSrk , "RK_VLPAGO" )

Somar o valor pago do objeto SRK, para os centros de custo "11".

nSoma := fo_SomaAllRegs( @oSrk , "RK_VLPAGO" , "RK_CC" , "11 ")

Somar o valor pago e o valor resíduo do objeto SRK, para os centros de custo "11".
nSoma := fo_SomaAllRegs( @oSrk , {"RK_VLPAGO", “RK_VALORAR”} , "RK_CC" ,
"11 ")

obs: irá retornar a somatória do valor de todos os registros do centro de custo “11” + a
somatória do valor resíduo de todos os registros do centro de custo “11”.
Versão 001 Desenvolvimento Sistemas R.H.
 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Função fo_SomaIncSrv
Sintaxe fo_SomaIncSrv( @oObj , cCpoSoma , uRvCpos , uRvCnts , cSrvFilial )
Descrição Soma valores conforme incidencias do SRV
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
cCpoSoma => Campo que será somado.
uRvCpos => Campo do arquivo SRV que deverá ser verificado.
uRvCnts => Conteúdo do campo uRvCpos que deverá ser verificado para a somatória.
cSrvFilial => Opcional. DEFAULT: Filial do funcionário.
Retorno nSomaIncSrv => Soma dos valores do campo passado em cCpoSoma
Exemplos Somar o valor do arquivo SRC somente as verbas que tem incidencia de INSS ("S").
nSoma := fo_SomaIncSrv( @oSrc , "RC_VALINFO" , "RV_INSS" , "S" )

Função fo_GetCpoPdSrv
Sintaxe fo_GetCpoPdSrv( @oObj , cForcePD )
Descrição Retorna o Campo de Provento e Desconto conforme Alias do objeto.
Parâmetros oObj => Objeto onde estão armazenada as informações e que vai ser manipulado.
cForcePD =>
Retorno cCpoPd => campo de provento e desconto
Exemplos

Função fo_Clone
Sintaxe oClone := fo_Clone( oObj , uFields , uCnts , nElem, lDeleted )
Descrição Clona o objeto dependendo das condições passadas.
Parâmetros oObj => Objeto que será clonado.
uFields => String ou Array dos campos chave que serão copiados para o novo objeto.
Opcional.
uCnts => String ou Array com o conteúdo dos campos chave.
Opcional.
nElem => Elemento que deseja copiar. Se esse parâmetro for passado, os parâmetros
uFields e uCnts serão ignorados.
lDeleted => .T. para clonar todos os registros do objeto (oObj) inclusive os deletados.
.F. para clonar apenas os registros que não estão deletados.
Opcional.
DEFAULT .F.
Retorno oClone => objeto com os registros que atenderam as condições.
Exemplos Copiar para o objeto oClone todos os registros que não estão deletados do objeto oSRC.
oClone := fo_Clone( oSrc )
ou
oClone := fo_Clone( oSrc, , , , .F. )

Copiar para o objeto oClone todos os registros, inclusive os deletados, do objeto oSRC.
oClone := fo_Clone( oSrc, , , , .T. )

Versão 001 Desenvolvimento Sistemas R.H.

 Funções para uso nas Formula do Modulo “Sigagpe”.

_____________________________________________________________________

Copiar para o objeto oClone os registros que possuem a verba “101” e que não estão deletados
do objeto oSRC.
oClone := fo_Clone( oSrc, “RC_PD”, “101”)
ou
oClone := fo_Clone( oSrc, “RC_PD”, “101”, , .F.)

Copiar para o objeto oClone os registros que possuem a verba “101”, inclusive os deletados do
objeto oSRC.
oClone := fo_Clone( oSrc, “RC_PD”, “101”, , .T.)

Copiar para o objeto oClone o elemento 3 do objeto oSRC.

oClone := fo_Clone( oSrc, , , 3)
ou
oClone := fo_Clone( oSrc, , , 3, .F.)

Versão 001 Desenvolvimento Sistemas R.H.