Provedores de serviços

Um provedor de serviços é um provedor lógico que contém os serviços a serem executados pelo sistema, diferenciando-se entre provedor de serviços Senior e Provedor de serviços de terceiro.

Tipos de provedores de serviços

Provedor interno

O provedor interno é um provedor lógico que contém os serviços fornecidos pelo sistema que está sendo executado. Este provedor é criado implicitamente na inicialização do sistema e não pode ser alterado e nem excluído, mas é possível adicionar serviços e portas a ele.

Os dados necessários para a execução dos serviços deste provedor são obtidos diretamente das configurações dos serviços do sistema.

Provedor de serviços Senior

Provedor que contém os serviços de sistemas Senior, que podem ou não estar no mesmo servidor que o sistema em execução.

A indicação de como os serviços estão organizados em relação ao sistema de execução depende da opção Mesma base:

• Se a opção Mesma base estiver desmarcada, significa que o provedor contém serviços que não estão no mesmo servidor que o sistema em execução.
  
  Ao adicionar um provedor deste tipo, devem ser preenchidas todas as informações necessárias para acessar os serviços no servidor em questão.
• Se a opção Mesma base estiver marcada, significa que o provedor contém serviços que estão no mesmo servidor e usando a mesma base do sistema em execução.
  
  Ao adicionar um provedor deste tipo, as configurações referentes ao servidor serão obtidas automaticamente das configurações de serviços, restando ao usuário informar apenas o nome do provedor e o usuário para execução de serviços.

Exemplos:

Situação dos web services (quando o provedor de serviços Senior é utilizado)	Situação da opção Mesma base
Web services de aplicações que compartilham o mesmo usuário de banco de dados. Exemplos: Ronda Senior x Administração de Pessoal Administração de Pessoal x Recrutamento e Seleção	✓ A opção Mesma base deve ser selecionada.
Web services de aplicações que não compartilham o mesmo usuário de banco de dados. Exemplo: Web services do Gestão Empresarial | ERP inseridos no Gestão de Pessoas | HCM (ou vice-versa)	✘ A opção Mesma base não deve ser selecionada.

Provedor de serviços de terceiros

Um provedor de serviços de terceiros permite que um sistema Senior execute serviços de sistemas que não são da Senior. Após adicionar um provedor de terceiro, o usuário deverá cadastrar todos os serviços de acordo com a especificação passada pelo fornecedor do sistema em questão.

Edição de provedores

Estas são as possíveis maneiras de editar os provedores:

• No Editor de web services em Arquivo > Provedor;
• Através das opções do menu do botão de provedores;
• Com um duplo clique sobre o item desejado na lista de provedores;
• Através dos menus pop-up da treeview e da lista, e dos atalhos do teclado (Insert, Enter e Delete) correspondentes a cada item.

Configurações do provedor

Ao adicionar ou editar um provedor de serviços, existem seguintes opções para configurações:

Tipo do provedor
Permite selecionar o tipo do provedor que está sendo adicionado.

Nome do provedor
Nome do provedor que está sendo editado. Esse nome deve ser único para o sistema, e não pode conter espaços ou caracteres especiais.
Ao adicionar um provedor Senior, de mesma base ou não, é possível informar o formato do nome, que será usado para gerar o nome do provedor de acordo com o sistema selecionado na lista (após clicar em Avançar). 

Timeout
Tempo em segundos que o serviço deverá aguardar um retorno da execução.

URL do servidor
URL do servidor que contém os serviços a serem consumidos.

Contexto
Contexto onde estão disponíveis os serviços deste provedor. É usado apenas para provedor de serviços de terceiros, pois para os provedores Senior ele é implícito. O contexto de um serviço é relacionado entre a URL do servidor e o nome do serviço que vai ser executado.

Separador de Contexto
Esta opção será utilizada para definir o caractere utilizado para separar a URL do contexto e do serviço. Por padrão é utilizado o caractere "/", podendo variar conforme implementação do serviço de terceiro.

Módulo de dispatch da chamada
Neste campo pode ser informado o nome da biblioteca (*.dll) que faz a ligação entre o sistema Senior e os serviços do provedor que está sendo editado, a qual deve ser implementada seguindo as especificações do módulo de dispatch para serviços de terceiros. 

Se o módulo de dispatch for informado, a execução do serviço será feita através deste módulo, senão a execução do serviço será feita normalmente, como qualquer outro serviço Senior. Isto permite que um fabricante implemente tratamentos especiais para os serviços dele que não são implementados pelos sistemas Senior.

Configurações de proxy
Configurações do servidor de proxy para ter acesso à URL do servidor.

Identificador do servidor e Porta
Endereço e porta do servidor de proxy utilizado. Exemplo: Identificador do servidor: meuproxy.com.br / Porta: 3128.

Usuário e Senha
Usuário e senha para autenticação no servidor Proxy.

Usuário para execução dos serviços
Usuário para autenticação do serviço executado. Para provedores de serviços Senior, indica qual o usuário padrão a ser utilizado para a execução dos serviços quando o usuário não for informado explicitamente no momento que o serviço é chamado, podendo-se optar por usar sempre o usuário que estiver logado no sistema. No caso de provedores de serviços de terceiros, este usuário será utilizado para fazer autenticação HTTP ou SOAP, caso o servidor exija tal autenticação. Se a opção for autenticação SOAP, deverá ser informado o nome do nó de autenticação (TAG: authentication), o nome dos atributos de nome e senha do usuário e se necessário, o identificador universal (NameSpace).

Exemplo:

Quando utilizadas as configurações de autenticação, será gerada uma sessão de cabeçalho (header) no XML de acordo com a opção separar os parâmetros em nós.

1. Se a opção separar os parâmetros em nós estiver selecionada, a sessão de cabeçalho utilizado para autenticação no XML será gerada da seguinte forma:
   <S:Header xmlns="urn:teste">
     <Authentication >
          <User></User>
          <Password>*******</Password>
     </Authentication >
</S:Header>
2. Se a opção separar os parâmetros em nós não estiver selecionada, a sessão de cabeçalho utilizado para autenticação no XML será gerada da seguinte forma:
   <S:Header>
     <Authentication User="*******" Password="*******" xmlns="urn:teste" />
</S:Header>

Avançar
Quando estiver sendo incluído um novo provedor de serviços Senior, ao clicar em Avançar será exibida uma lista com todos os sistemas disponíveis no servidor informado, permitindo que sejam adicionados mais de um provedor do mesmo servidor sem a necessidade de repetir várias vezes a operação de inclusão.

Ao confirmar a inclusão destes provedores todos os serviços do sistema correspondente serão importados automaticamente, sem necessidade do usuário cadastrá-los manualmente. Quando estiver incluindo ou alterando um provedor de serviços de terceiros,  ao clicar em Avançar o usuário poderá informar um serviço de catálogo de serviços. 

Formato de nomes de provedores Senior
O formato de nomes de provedores Senior deve obedecer a seguinte sintaxe: [prefixo]%s[sufixo], onde o %s será substituído pelo nome do sistema que contém os serviços.

Pode ser usado o prefixo e o sufixo simultaneamente, bem como apenas um ou apenas outro.