Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Classe: FWRPC


Compatível Países:Todos
Sistemas Operacionais:Todos
Compatível às Bases de Dados:Todos
Nível de Acesso:Nível 1 (Acesso Clientes)
Idiomas:Português, Inglês, Espanhol
Versão1.0


Descrição
Classe de controle de conexão RPC sem transação, com controle de recorrência em caso de falha de conexão, em qualquer situação.


New

Sintaxe
FWRPC():New()-> oSelf

Descrição
Método construtor da classe.


Retorno
oSelf Objeto da classe.

Connect

Sintaxe
FWRPC():Connect()-> lResult

Descrição
Método que estabelece a conexão com o servidor alvo.


Retorno
Retorna um valor lógico informando se foi possível estabelecer a conexão, sendo Verdadeiro (.T.) indicando sucesso e Falso (.F.) falha.

SetEnv

Sintaxe
FWRPC():SetEnv(<cEmp>, <cFil>, <cModulo>, <aTabelas>, <cFunName>)-> lResult

Descrição
Método que prepara o ambiente no servidor alvo.

Parâmetros

NomeTipoDescriçãoDefaultObrigatórioReferência
cEmpCaractereCódigo da empresa


cFilCaractereCódigo da filial


cModuloCaractereCódigo do modulo


aTabelasArrayArray de string com a relação de alias das tabelas que deverão ser abertas


cFunNameCaractereEstabelece a rotina de execução no servidor alvo




Retorno
lResult Informa se a preparação do ambiente foi realizada com sucesso quando o retorno é Verdadeiro (.T.) e falha quando o retorno é Falso (.F.).

CallProc

Sintaxe
FWRPC():CallProc(cRotina, Param01, Param02, ... Param26)-> xResult

Descrição
Método de execução de uma rotina no servidor alvo.


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência
cRotinaCaractereNome da rotina que deverá ser executada


Param01 ao Param26
Parâmetros que serão utilizados na execução da rotina alvo.



 Exemplo:
FWRPC:CallProc( 'U_MinhaRotina', <primeiro_parâmetro_U_MinhaRotina>, <segundo_parâmetro_U_MinhaRotina>)
Podendo receber até 26 Parâmetros onde o tipo do dado deve respeitar o valor esperado na rotina alvo.

Retorno
xResult: indica o retorno que a da rotina alvo que foi chamada/executada.

Disconnect

Sintaxe
FWRPC():Disconnect()-> lResult

Descrição
Executa a desconexão com o servidor alvo.


Retorno
lResult retorna verdadeiro (.T.) ao realizar a desconexão.

SetRetryConnect

Sintaxe
FWRPC():SetRetryConnect(<nRetry>)-> NIL

Descrição
Estabelece o número máximo de tentativas de reconexões com os servidores alvo.


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência
nRetryNuméricoNúmero de tentativas de reconexão3



SetTimeOut

Sintaxe
FWRPC():SetTimeOut(<nTimeOut>)-> NIL

Descrição
Estabelece o tempo que será atribuído ao timeout de conexão.


Parâmetros


NomeTipoDescriçãoDefaultObrigatórioReferência
nTimeOutNuméricoIndica o tempo em segundos de time-out para a conexão ser estabelecida. Caso não especificado ( Default = 0 ), o tempo de retorno depende do sistema operacional e da condição de erro encontrada na tentativa de estabelecer a conexão. Por exemplo, no caso do servidor de destino da conexão estar desligado, ou seja colocado um IP que não esteja na rede, a operação de conexão demora de 20 a 30 segundos para retornar uma condição de falha.0