4D Doc Center : Serviços Web (Cliente)

4D v12.4

Serviços Web (Cliente)

Constante	Tipo	Valor	Comentário
Web Service Deflate compression	Inteiro longo	1
Web Service Detailed Message	Inteiro longo	1	Mensagem detalhada que descreve o erro. O tipo de mensagem difere segundo o tipo de erro principal. - Se o erro principal = 9910 (Error Soap): é retornada a causa do erro SOAP (ex.: "o método remoto não existe"). - Se o erro principal = 9911 (Erro do analisador xml): é retornada a localização do erro no documento XML. - Se o erro principal = 9912 (Erro HTTP): - Se o erro HTTP está localizado no intervalo [300-400] (problemas relacionados com a localização do documento solicitado), é retornada a nova localização da URL solicitada. - Para qualquer outro código de erro HTTP, é retornado o <body>. - Se o erro principal = 9913 (Erro de rede): é retornada a causa do erro de rede (ex.: “ServerAddress: error DNS”) - Se o erro principal = 9914 (Erro interno): é retornada a causa do erro interno.
Web Service display auth dialog	Inteiro longo	4	valor = 0 (não mostrar a caixa de diálogo) ou 1 (mostrar a caixa de diálogo) Esta opção administra a visualização da caixa de diálogo de atualização enquanto o comando CALL WEB SERVICE é executado. Por padrão, este comando nunca mostra a caixa de diálogo, geralmente, para fazê-lo tem que usar o comando AUTHENTICATE WEB SERVICE. Contudo, se quiser que a caixa de diálogo de autenticação apareça, a fim de que o usuário possa introduzir seus identificadores, deverá usar a seguinte opção: passe 1 em valor a fim de mostrar a caixa de diálogo, do contrário passe 0. A caixa de diálogo somente é mostrada se o serviço web precisa de autenticação.
Web Service Dynamic	Inteiro longo	0
Web Service Error Code	Inteiro longo	0	Código do erro principal (definido por 4D). Este código é também retornado na variável sistema Erro. Lista de códigos que podem ser retornados: 9910: Erro Soap (veja também Web Service Fault Actor) 9911: Erro de analisador xml 9912: Erro HTTP (veja também Web Service HTTP Error code) 9913: Erro rede 9914: Erro interno.
Web Service Fault Actor	Inteiro longo	3	Causa do erro (retornado pelo protocolo SOAP, a ser usado no caso de erro principal 9910) - Version Mismatch (a versão não corresponde) - Must Understand (um parâmetro definido como obrigatório não pode ser interpretado pelo servidor) - Client Fault (erro cliente) - Server Fault (erro servidor) - Encoding Unknown (codificação desconhecida)
Web Service HTTP Compression	Inteiro longo	6	valor = Web Service Deflate Compression Esta opção permite a activação de um mecanismo interno de compressão das petições SOAP a fim de acelerar as trocas entre aplicações 4D. Quando a instrução SET WEB SERVICE OPTION(Web Service HTTP Compression; Web Service Deflate Compression) no cliente 4D do serviço web, os dados da próxima petição SOAP enviado pelo cliente serão comprimidos usando um mecanismo padrão HTTP antes de serem enviados ao servidor SOAP 4D. O servidor fará a descompressão e o analise da petição, depois irá responder automaticamente usando o mesmo mecanismo. Somente é afectada a petição que segue a chamada ao comando SET WEB SERVICE OPTION. Portanto deverá chamar este comando toda vez que quiser usar a compressão. Por padrão, 4D não comprime as petições HTTP de serviços web. Nota: "Deflate" é o nome do algorimo de compressão usado internamente por 4D. Este mecanismo não pode ser usado para as petições enviadas para unm servidor SOAP 4D de uma versão anterior à 11.3. De maneira que você poderá otimizar mais este funcionamento, as opções adicionais configuram o limiar e a taxa de compressão das petições. Estas opções são acessíveis via o comando SET DATABASE PARAMETER.
Web Service HTTP Error code	Inteiro longo	2	Código de erro HTTP (para ser usado no caso do erro principal 9912).
Web Service HTTP Timeout	Inteiro longo	1	valor = "timeout" da parte cliente expressado em segundos. O timeout da parte clientes é o período de espera do cliente serviço web caso não haja resposta do servidor. Após este período, o cliente fecha a sessão e a petição é perdida. Por padrão, o timeout é de 180 segundos. Pode ser modificado por razões específicas (status da rede, especificações do serviço web, etc.).
Web Service Manual	Inteiro longo	3
Web Service Manual In	Inteiro longo	1
Web Service Manual Out	Inteiro longo	2
Web Service reset auth settings	Inteiro longo	5	valor = 0 (não apagar a informação) ou 1 (apaga a informação) Esta opção permite indicar ao 4D para memorizar a informação de autenticação do usuário (nome de usuário, senha, método, etc.), para que possa ser utilizada mais tarde. Por Padrão, esta informação é apagada após cada execução do comando CALL WEB SERVICE. Passe 0 em valor para salvar a informação e 1 para excluí-la. Note que quando passar 0, a informação é conservada durante a sessão mas não é armazenada.
Web Service SOAP Header	Inteiro longo	2	valor = referência do elemento XML raiz a ser inserido como cabeçalho da petição SOAP. Esta opção permite inserir um cabeçalho na petição SOAP gerada fazendo uso do comando CALL WEB SERVICE. Por padrão, as petições SOAP não contém um cabeçalho específico. Contudo, alguns serviços web requerem um cabeçalho, por exemplo para a gestão dos parâmetros de identificação.
Web Service SOAP Version	Inteiro longo	3	valor = Web Service SOAP_1_1 ou Web Service SOAP_1_2 Esta opção permite especificar a versão do protocolo SOAP usado na petição. Passe a constante Web Service SOAP_1_1 para valor a fim de indicar a versão 1.1 e a constante Web Service SOAP_1_2 para indicar a versão 1.2.
Web Service SOAP_1_1	Inteiro longo	0
Web Service SOAP_1_2	Inteiro longo	1