Classe TecProvider

Microsiga Protheus

A Classe TecProvider tem como finalidade gerenciar a integração entre os módulos de Gestão de Serviços (SIGATEC) e Ativo Fixo (SIGAATF) por meio de um objeto AdvPL que concentra a maioria das informações relativas a Base de Atendimento (Base de Locação de Equipamentos) e o Ativo Fixo, como: Nome, Tipo, Saldos Bloqueados, Saldos Reservados, Saldos em Manutenção, entre outros. Esta classe facilita a manipulação e consulta das informações de maneira unificada sem a necessidade de execução de múltiplas consultas em diferentes tabelas. Seu formato também facilita o trabalho das equipes de campo e de customizações evitando redundâncias na escrita de funções AdvPL de contexto desta integração.

Métodos:

• New()

Método Construtor da Classe AdvPL

Parâmetros:

cNumSer

cFil

lLoadAll

Retorno:

oTecProvider

• ShowErro()

Apresenta uma mensagem com a lista de eventuais erros encontrados durante o instanciamento do objeto a partir dos dados informados como parâmetro; exceto se as informações passadas como parâmetro, por meio do método New(), estiverem coerentes.

Parâmetros:

Nil

Retorno:

Nil

• InsertTWH()

Permite relacionar um novo ativo imobilizado a base de atendimento instanciada no objeto através do método New. Para isto, cria um novo registro na tabela TWH - Relação Base x Ativo.

Parâmetros:

cFilAtivo

cAtivo

cItem

Retorno:

lRet

• InsertTWU()

Permite que sejam inseridos novos bloqueios de saldos na tabela TWU - Saldos Bloqueados. Sempre que necessário, um equipamento do tipo granel pode ter uma parte de seu saldo (quantidade de exemplares) passível de bloqueio em razão de algum motivo qualquer, como por exemplo "Reserva", "Manutenção", etc.

Parâmetros:

cCodTEW

cBase

nQtdBlq

cTipo

cOSTipo

cOsNum

cOsItem

lDesBloq

Retorno:

Nil

• UpdateTWU

Método responsável por atualizar uma quantidade liberada referente ao bloqueio de um registro já existente na tabela TWU - Bloqueio de Saldos. Neste caso o valor total liberado sera corresponde a quantidade ja liberada em momentos anteriores somada ao novo valor informado. O posicionamento na tabela TWU para atualização do saldo liberado pode ser realizado através de duas formas: Por meio do código de movimentação (Tabela TEW) ou através do código da OS relacionada.

Observação: Embora os parâmetros cIDReg e cChaveOs sejam opcionais, ao menos um deles deve ser corretamente preenchido.

Parâmetros:

cIdReg

nQtd

cChaveOS

Retorno:

lRet

• DeleteTWU

Método responsável por apagar um registro ja existente na tabela TWU - Bloqueio de Saldos. O posicionamento na tabela TWU para exclusão pode ser realizado através de duas formas: Por meio do código de movimentação (Tabela TEW) ou através do código da OS relacionada.
A utilização deste método deve ser feita com parcimônia, uma vez que a correta utilização da tabela TWU corresponde a inclusão de um saldo bloqueado e em seguida a liberação deste saldo, não exigindo a exclusão do registro em si.

Observação: Embora os parâmetros cIDReg e cChaveOs sejam opcionais, ao menos um deles deve ser corretamente preenchido.

Parâmetros:

cIdReg

cChaveOS

Retorno:

lRet

• BloqueiaBase()
  

Permite bloquear a utilização da base de atendimento definida no método construtor desta classe, de forma que a mesma não esteja mais apta para movimentações e utilização nas funcionalidades de Locação de Equipamentos do modulo Gestão de Serviços.

Parâmetros:

Nil

Retorno:

Nil

• DesbloqueiaBase()

Permite desbloquear a utilização da base de atendimento definida no método construtor desta classe, de forma que a mesma esteja apta para movimentações e utilização nas funcionalidades de Locação de Equipamentos do modulo Gestão de Serviços.

Parâmetros:

Nil

Retorno:

Nil

• SaldoDisponivel

Permite obter o saldo disponível do equipamento para locação partir de um período previamente informado.

Parâmetros:

Nil

Retorno:

nQtd

• SaldoTotal
  

Realiza o calculo da quantidade total dos Ativos Imobilizados associados a Base de Atendimento considerando as informações registradas na tabela TWH e o período inicial e final indicado como parâmetro.

Parâmetros:

Nil

Retorno:

nQtd

• SaldoAdquirido
  

Realiza o calculo da quantidade total de itens do Ativo Imobilizado associados a uma determinada base de atendimento, independente de um período de tempo. ("Fotografia Atual")

Parâmetros:

Nil

Retorno:

nQtd

• SaldoLocado

Obtém o saldo locado de uma determinada base de atendimento, podendo ainda se obter este valor a partir de uma determinada data.

Parâmetros:

Nil

Retorno:

nQtd

• SaldoReservado
  

Obtém o saldo total reservado do equipamento em questão.

Parâmetros:

Nil

Retorno:

nQtd

• SaldoManutencao
  

Obtém o saldo total do equipamento que encontra-se bloqueado na tabela TWU por conta do motivo 2 - OS do SIGAMNT

Parâmetros:

Nil

Retorno:

nQtd

• SaldoTravado
  

Obtém o saldo total do equipamento que encontra-se bloqueado na tabela TWU por conta do motivo 3 - Outros

Parâmetros:

Nil

Retorno:

nQtd

• SaldoBloqueado
  

Soma de todo o saldo bloqueado do equipamento na tabela TWU, independente do tipo de bloqueio

Parâmetros:

Nil

Retorno:

nQtd