Usando o Web Services › Como chamar serviços web › Como os clientes chamam métodos de logon e logoff

Como os clientes chamam métodos de logon e logoff

Ao chamar serviços web com um cliente Java, a chamada de métodos de logon e logoff por clientes para cada serviço web um processo necessário. O processo típico é o seguinte:

1. O cliente usa um método de logon e autenticação.

   Cada serviço web tem um conjunto de métodos de logon. Os aplicativos cliente podem usar vários métodos de logon para autenticação. Por exemplo, o método logIn usa os mesmos parâmetros que a janela Logon: ID do Usuário, Senha e Unidade de negócios.

   Para exibir as informações do parâmetro do método, inclusive as assinaturas, use os seguintes recursos:

   • Documentação de API dos serviços web
   • Interface de administração do SOAP para implantar ou cancelar a implantação de serviços web
2. O sistema do Catalog autentica o usuário e determina sua função.

   As chamadas de método subsequentes operam dentro do escopo de direitos de acesso do usuário, como se o usuário tivesse acessado a GUI.

3. O cliente faz o seguinte:
   • Determina o serviço que está chamando
   • Fornece o nome do método e seus parâmetros correspondentes antes de iniciar a chamada de procedimento remoto
   • Verifica essas informações no arquivo WSDL, se elas forem desconhecidas

     Normalmente, o cliente já tem essas informações.

4. O serviço web retorna a ID da sessão. Essa ID da sessão é um parâmetro obrigatório que o cliente usa para as outras chamadas de serviços web. Como o protocolo de transporte subjacente pode ser HTTP ou não HTTP, a autenticação usa um serviço web logIn comum.

   Você pode compartilhar a ID da sessão entre os serviços web. Por exemplo, é possível usar o método UserService logIn para obter uma ID da sessão. Em seguida, você pode usar a ID da sessão em uma chamada para um método de serviço web da unidade de negócios.

5. Essa seção se encerra quando ocorre uma das seguintes opções:
   • O cliente chama o método do serviço web logOut.

     Assim que terminar de usar a ID da sessão, chame o serviço web logOut para encerrar a sessão e invalidar tal ID. Esse modo de gerenciar sessões eficientemente é útil para se obter o melhor desempenho.

   • O cliente está ocioso por um tempo maior que o valor do tempo de expiração da sessão.

     O cliente pode usar a ID da sessão repetidamente no período de tempo de expiração. Se a sessão atingir o tempo de expiração, a ID da sessão se tornará inválida.

     Para alterar o valor do tempo de expiração, atualize a configuração de administração denominada Padrão do usuário: tempo de expiração.

     Observação: para obter instruções sobre como modificar as configurações, consulte o Guia de Implementação.