Este artigo contém os seguintes tópicos:
...
Excerpt |
---|
O serviço web de saída permite que o CA o ServiceAide Cloud Service Management interaja com sistemas externos, usando chamadas de serviços web SOAP ou RESTful. A operação de serviço web de saída está vinculada a uma ação do fluxo de trabalho. Quando um analista executa a ação do fluxo de trabalho em um ticket, a operação de serviço web de saída é iniciada. Se o aplicativo externo retorna uma resposta para a chamada de serviço web, o produto aceita a resposta e atualiza o ticket. |
...
Chamadas de serviço web com base em SOAP
O CA O ServiceAide Cloud Service Management usa WSDL (Web Service Description Language - Linguagem de Descrição de Serviço Web) para se comunicar com aplicativos com base em SOAP. O arquivo WSDL do aplicativo externo contém as informações que são necessárias para configurar as operações de serviço web. O documento WSDL contém informações tais como métodos, mapeamento de campo e muito mais.
...
- Verifique se o aplicativo externo oferece serviços web. Você não pode continuar se o aplicativo externo não oferecer serviços web.
- Verifique se o aplicativo externo oferece suporte a chamadas de serviço web com base em SOAP ou em RESTful.
- Para um aplicativo que oferece suporte a chamadas com base em SOAP, determine o caminho para a entrada da WSDL e o nível de autenticação. Colete informações que podem ser usadas para configurar as credenciais.
- Para um aplicativo que suporta chamadas de serviço web RESTful, determine se os serviços web suportados foram definidos. Quando os serviços web tiverem sido definidos, colete informações sobre o caminho para a entrada da WADL. Você pode continuar sem especificar o caminho WADL para serviços web não definidos.
- Verifique se você consegue conectar o produto ao aplicativo externo. Execute ping no servidor do aplicativo externo pelo servidor web do CA do ServiceAide Cloud Service Management. Verifique se há erros no resultado. Você não pode continuar se o servidor web do CA do ServiceAide Cloud Service Management não for capaz de estabelecer conexão com o aplicativo externo.
- Identifica o URL que é chamado para acessar a entrada de WSDL/WADL para o aplicativo externo. Quando identificar o URL, confirme os seguintes requisitos:
- O acesso e a autenticação necessários para chamar o serviço web.
- Confirme se o aplicativo externo requer autenticação básica. Obtenha o nome de usuário e a senha do aplicativo externo.
- Confirme se o aplicativo usa controle com base na sessão. Você pode obter essas informações do WSDL.
- Identifica o mapeamento do campo que você deseja configurar. Confirme se os campos que você deseja mapear estão disponíveis no produto. Identifique todos os campos adicionais que você precisa para a configuração que planeja.
- Identifique o tipo de operação que deseja configurar. Você pode configurar as operações de serviços web e as ações de fluxo de trabalho relacionadas de acordo com este plano.
...
- Vá para ESPAÇOS DE TRABALHO, ADMINISTRAÇÃO, Ferramentas e selecione Operações dos serviços web.
- Forneça o nome, a descrição e as credenciais do serviço web para o aplicativo externo.
- Especifique os detalhes do mapeamento de campo para a operação de serviço web. Especifique informações como:
- Tipo de entidade da operação ou o tipo de ticket aplicável.
- Endereço do terminal do serviço web.
- Método usado para a operação.
- Duração de tempo limite da operação.
- (Opcional) Especifica o mapeamento de saída. O valor do campo do ticket que você especifica aqui preenche o campo correspondente do aplicativo externo. Quando uma WADL é configurada para o serviço web, os valores de aplicativo externo são processados em um menu suspenso. Os valores que são processados dependem do método que você seleciona no campo Selecionar método. Você pode selecionar um valor no menu suspenso para configurar o mapeamento de saída. Quando uma WADL não está configurada, os campos são exibidos como áreas de texto. Você pode inserir manualmente os valores válidos. Os campos que são exibidos como campos obrigatórios na exibição de documento da WADL nos campos externos por padrão.
- (Opcional) Para usar o arquivo XML ou JSON, marque a caixa de seleção Configuração avançada. Você pode fornecer o mapeamento do campo de saída, especificando os valores em nós relevantes. Quando você usa as Configurações avançadas, é exibida uma caixa de texto para inserir o conteúdo XML ou JSON. Você pode usar o ícone de pesquisa para abrir a pesquisa de entidade e selecionar os tokens de entidade. Os tokens de entidade que você selecionar são substituídos como valores de campo externo. No XML ou JSON da solicitação REST, os tokens são inseridos, colocando o cursor sobre ou selecionando o texto que precisa ser substituído pelo token. Os tokens de entidade que você selecionar são substituídos como valores de campo externo quando a solicitação é enviada para o aplicativo externo.
- (Opcional) Especifica o mapeamento de entrada. O valor do aplicativo externo é atualizado no campo de ticket correspondente no produto. Mencione o campo do ticket e o caminho para o campo do aplicativo externo.
Observação:- Não use caracteres curinga ou operadores no caminho de pesquisa do XML para mapeamentos de entrada.
Verifique se que você mapeou apenas o nó obrigatório do arquivo de resposta para configurar o valor de entrada do mapeamento. Por exemplo, no seguinte trecho de código, se você deseja preencher a ID do atributo, então, digite o nó como employees.employee.id. Especificar o nó como employees.employee não preenche nenhum atributo.
- Clique em Salvar.
...
É possível relacionar uma operação de serviço web a uma ação do fluxo de trabalho na página ESPAÇOS DE TRABALHO, ADMINISTRAÇÃO, Ferramentas, Ações do fluxo de trabalho. Use o campo Operações dos serviços web de uma ação do fluxo de trabalho para relacionar a ação a uma configuração de serviço web.
Você pode configurar ações de fluxo de trabalho usando chamadas de serviço web SOAP e RESTful.
Para obter informações sobre as ações de fluxo de trabalho, consulte Criar e gerenciar ações do fluxo de trabalho.
...