Histórico da Página
Exemplo de Rotina Automática CNTA300
Características do Requisito
Linha de Produto: | Microsiga Protheus | ||||
Segmento: | Serviços | ||||
Módulo: | Gestão de Contratos | ||||
Rotina: |
| ||||
País(es): | Todos | ||||
Banco(s) de Dados: | Todos | ||||
Sistema(s) Operacional(is): | Todos |
Descrição
A Rotina CNTA300 foi desenvolvida em MVC, portanto para realizar a inclusão, alteração e exclusão de um contrato, automaticamente, deve-se fazer uso do modelo de dados. A Seguir mostraremos um exemplo de como realizar a inclusão de um contrato utilizando o modelo de dados da rotina CNTA300.
Para mais detalhes sobre a utilização do MVC, consulte a pagina: http://tdn.totvs.com/display/public/mp/AdvPl+utilizando+MVC
Exemplo de Rotina Automática - Inclusão
Bloco de código | ||
---|---|---|
| ||
#Include 'Protheus.ch' #INCLUDE "FWMVCDEF.CH" User Function CN300AUTO() Local oModel := FWLoadModel("CNTA300") //Carrega o modelo oModel:SetOperation(MODEL_OPERATION_INSERT) // Seta operação de inclusão oModel:Activate() // Ativa o Modelo //Cabeçalho do contrato oModel:SetValue( 'CN9MASTER' , 'CN9_DTINIC' , Ctod("24/02/2017") ) oModel:SetValue( 'CN9MASTER' , 'CN9_NUMERO' , '000000000000069' ) oModel:SetValue( 'CN9MASTER' , 'CN9_UNVIGE' , '3' ) oModel:SetValue( 'CN9MASTER' , 'CN9_VIGE' , 1 ) oModel:SetValue( 'CN9MASTER' , 'CN9_MOEDA' , 1 ) oModel:SetValue( 'CN9MASTER' , 'CN9_CONDPG' , '001' ) oModel:SetValue( 'CN9MASTER' , 'CN9_TPCTO' , '001' ) oModel:SetValue( 'CN9MASTER' , 'CN9_FLGREJ' , '2' ) oModel:SetValue( 'CN9MASTER' , 'CN9_FLGCAU' , '2' ) oModel:SetValue( 'CN9MASTER' , 'CN9_ASSINA' , Ctod("24/02/2017") ) //Cliente/Fornecedor do Contrato oModel:SetValue( 'CNCDETAIL' , 'CNC_CODIGO' , '001 ' ) oModel:SetValue( 'CNCDETAIL' , 'CNC_LOJA' , '01' ) //Planilhas do Contrato oModel:LoadValue( 'CNADETAIL' , 'CNA_CONTRA' , '000000000000069' ) oModel:SetValue( 'CNADETAIL' , 'CNA_NUMERO' , '000001' ) oModel:SetValue( 'CNADETAIL' , 'CNA_FORNEC' , '001 ' ) oModel:SetValue( 'CNADETAIL' , 'CNA_LJFORN' , '01' ) oModel:SetValue( 'CNADETAIL' , 'CNA_TIPPLA' , '004' ) oModel:SetValue( 'CNADETAIL' , 'CNA_FLREAJ' , '2' ) //Itens da Planilha do Contrato oModel:SetValue( 'CNBDETAIL' , 'CNB_ITEM' , '001' ) oModel:SetValue( 'CNBDETAIL' , 'CNB_PRODUT' , '001 ' ) oModel:SetValue( 'CNBDETAIL' , 'CNB_QUANT' , 1 ) oModel:SetValue( 'CNBDETAIL' , 'CNB_VLUNIT' , 1000 ) oModel:SetValue( 'CNBDETAIL' , 'CNB_PEDTIT' , '1' ) //Cronograma Financeiro oModel:GetModel('CNFDETAIL'):SetNoInserLine(.F.) oModel:GetModel('CNFDETAIL'):SetNoUpdateLine(.F.) oModel:LoadValue( 'CNFDETAIL' , 'CNF_NUMERO' , '000071' ) oModel:SetValue( 'CNFDETAIL' , 'CNF_PARCEL' , '01' ) oModel:SetValue( 'CNFDETAIL' , 'CNF_COMPET' , '02/2017' ) oModel:SetValue( 'CNFDETAIL' , "CNF_VLPREV" , 500 ) oModel:SetValue( 'CNFDETAIL' , "CNF_VLREAL" , 0 ) oModel:SetValue( 'CNFDETAIL' , "CNF_SALDO" , 500 ) oModel:SetValue( 'CNFDETAIL' , 'CNF_PRUMED' , Ctod("24/02/2017") ) oModel:SetValue( 'CNFDETAIL' , 'CNF_DTVENC' , Ctod("24/02/2017") ) oModel:SetValue( 'CNFDETAIL' , 'CNF_TXMOED' , 1 ) oModel:GetModel('CNFDETAIL'):AddLine() oModel:LoadValue( 'CNFDETAIL' , 'CNF_NUMERO' , '000071' ) oModel:SetValue( 'CNFDETAIL' , 'CNF_PARCEL' , '02' ) oModel:SetValue( 'CNFDETAIL' , 'CNF_COMPET' , '02/2017' ) oModel:SetValue( 'CNFDETAIL' , "CNF_VLPREV" , 500 ) oModel:SetValue( 'CNFDETAIL' , "CNF_VLREAL" , 0 ) oModel:SetValue( 'CNFDETAIL' , "CNF_SALDO" , 500 ) oModel:SetValue( 'CNFDETAIL' , 'CNF_PRUMED' , Ctod("24/02/2017") ) oModel:SetValue( 'CNFDETAIL' , 'CNF_DTVENC' , Ctod("24/02/2017") ) oModel:SetValue( 'CNFDETAIL' , 'CNF_TXMOED' , 1 ) //Validação e Gravação do Modelo If oModel:VldData() oModel:CommitData() EndIf Return |
Exemplo de Rotina Automática - Revisão de Realinhamento
A Rotina CNTA300 foi desenvolvida em MVC, portanto para realizar a revisão automaticamente, deve-se fazer uso do modelo de dados. A Seguir mostraremos um exemplo de como realizar a revisão de um contrato utilizando o modelo de dados da rotina CNTA300.
Para mais detalhes sobre a utilização do MVC, consulte a pagina: http://tdn.totvs.com/display/public/mp/AdvPl+utilizando+MVC
É necessário utilizar a função A300STpRev("< TIPO_DE_REVISÃO >") para definir o tipo de revisão que será realizada. São tipos de revisão validos:
"1" - Aditivo
"2" - Reajuste
"3" - Realinhamento
"4" - Readequação
"5" - Paralisação
"6" - Reinício
"7" - Cláusulas
"8" - Contábil
"9" - Índice
"A" - Fornecedor/Cliente
"B" - Grupo de Aprovação
"C" - Renovação
"D" - Multa/Bonificação
"E" - Caução
"F" - Orçamento de Serviços GS
Caso seja necessário identificar o tipo de revisão que está sendo realizada no contrato, utilizar a função A300GTpRev(), que retorna o tipo de revisão definido com o uso da função A300STpRev("< TIPO_DE_REVISÃO >").
Bloco de código | ||
---|---|---|
| ||
#Include 'Protheus.ch' #Include "FWMVCDEF.CH" User Function CN300AUTO() Local oModel := Nil Local cContra := ' < NÚMERO_DO_CONTRATO > ' Local cTipRev := ' < TIPO_DE_REVISÃO > ' Local cJustific := 'Justificativa da revisão do contrato' Local lRet := .F. //=== Preparação do contrato para revisão ============================================================================================= CN9->(DBSetOrder(1)) If CN9->(DbSeek(xFilial("CN9")+cContra)) //- Posicionamento no contrato que será revisado. A300STpRev("3") //- Define o tipo de revisão que será realizado. oModel := FWLoadModel("CNTA300") //- Carrega o modelo de dados do contrato. oModel:SetOperation(MODEL_OPERATION_INSERT) //- Define operação do modelo. Será INSERIDA uma revisão. oModel:Activate(.T.) //- Ativa o modelo. É necessária a utilização do parâmetro como true (.T.) para realizar uma copia. //=== Preenchimento das alterações da revisão. ======================================================================================= //== Cabeçalho oModel:SetValue( 'CN9MASTER' , 'CN9_TIPREV' , cTipRev) //- É obrigatório o preenchimento do tipo de revisão do contrato. oModel:SetValue( 'CN9MASTER' , 'CN9_JUSTIF' , cJustific') //- É obrigatório o preenchimento da justificativa de revisão do contrato. //== Qualquer alteração possível na execução manual pode ser automatizada. oModel:SetValue( 'CNBDETAIL' , 'CNB_VLUNIT' , 0.0010) //- Alteração do valor unitário do item. //== Validação e Gravação do Modelo lRet := oModel:VldData() .And. oModel:CommitData() EndIf Return lRet |