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ão | 1.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
Descrição
Método construtor da classe.
Retorno
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
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
cEmp | Caractere | Código da empresa |
|
|
|
cFil | Caractere | Código da filial |
|
|
|
cModulo | Caractere | Código do modulo |
|
|
|
aTabelas | Array | Array de string com a relação de alias das tabelas que deverão ser abertas |
|
|
|
cFunName | Caractere | Estabelece 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
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
cRotina | Caractere | Nome 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
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
nRetry | Numérico | Número de tentativas de reconexão | 3 |
|
|
SetTimeOut
Sintaxe
FWRPC():SetTimeOut(<nTimeOut>)-> NIL
Descrição
Estabelece o tempo que será atribuído ao timeout de conexão.
Parâmetros
Nome | Tipo | Descrição | Default | Obrigatório | Referência |
nTimeOut | Numérico | Indica 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 |
|
|