Usina BRAdvPL Guia
Entrar
← Todos os tópicos
GUIA PRÁTICOEm revisão

SOAP e Web Services em AdvPL

Organiza contrato, cliente gerado e cabeçalhos de uma integração SOAP.

SOAP e Web Services em AdvPLAdvPL
01 · VISÃO GERAL

Visão geral

Comece pelo WSDL e pelo cliente gerado pelo assistente do TDS: a página WSCLIENT orienta seu uso para essa geração, com TOTVSWebSrv.ch. WSMETHOD declara os métodos de cliente/servidor; não confundir SOAP com os contratos REST. O artigo de autenticação documenta _HEADOUT para headers HTTP. O recorte prepara somente esse header em objeto já gerado, sem montar credenciais, enviar requisição ou registrar segredos. Configure endpoint, TLS, timeout e política de falha no contrato da integração. Em serviço cujo ambiente foi aberto pelo framework, não reabrir empresa com RpcSetEnv; a documentação registra restrição adicional a partir de 12.1.2510. (Fontes: refs. 1–4.)

03 · EXEMPLO PRÁTICO

Exemplo comentado

// Fragmento: oClient gerado do WSDL, cAuthHeader obtido de armazenamento protegido.
// Nao registrar o header; nao ha chamada de rede neste recorte.
If oClient:_HEADOUT == Nil
    oClient:_HEADOUT := {}
EndIf
AAdd(oClient:_HEADOUT,cAuthHeader)
Resultado esperado

Adiciona um header HTTP completo ao cliente existente; não invoca operação SOAP. Evitar duplicar Authorization em chamadas reutilizadas. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Base64 não cifra credenciais. Usar HTTPS validado e conta de menor privilégio; tratar fault, indisponibilidade e repetição sem duplicar efeitos.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. WSCLIENT. Geração pelo TDS. Consulta em 2026-10-28.
  2. TOTVS. WSMETHOD. Consulta em 2026-10-28.
  3. TOTVS. Classe WSCLIENT para SOAP: passar autenticação. Artigo consultado. Consulta em 2026-10-28.
  4. TOTVS. RpcSetEnv: ambientes de serviços. Consulta em 2026-10-28.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha