Criação de um serviço Web de conjunto de importação

Crie uma tabela de conjunto de importação de serviço Web para definir como preparar e transformar os dados importados.

Navegar até Todos > Serviços web do sistema > Entrada > Criar novo.

Figura 1. Criar serviço web

O Nome do serviço Web é o nome da tabela do conjunto de importação, enquanto o campo Rótulo é o campo da tabela resultante.

Se você quiser criar um mapa de transformação depois de criar o serviço Web, marque a caixa de seleção Criar mapa de transformação e escolha a tabela de destino na qual deseja que os dados sejam transformados. Depois que o botão Criar for selecionado, o serviço Web será criado e você será colocado imediatamente no formulário Mapa de transformação da tabela. Você pode continuar a especificar o mapa de transformação ou o script.

Campos do serviço Web

Os campos disponíveis para este serviço Web. Por padrão, todos os campos são publicados como o tipo XSD de xsd:string. O Nome é o campo exposto para o serviço Web e, portanto, aparece como o nome do campo no WSDL. O Rótulo é o rótulo do campo conforme ele aparece para a tabela de conjuntos de importação.

Você pode Adicionar, marcar para Excluir ou modificar (clique duas vezes no campo) um campo de serviço Web existente nesta lista.

Nota:

Depois de adicionar campos de serviço Web, clique em Criar para criar a tabela de conjunto de importação de serviço Web.

Para adicionar outros campos após a criação do serviço Web, localize a tabela de destino e adicione os campos a essa tabela.

Mapeamento de conjuntos de importação de serviços Web

Durante a criação do conjunto de importação de serviço Web, você pode opcionalmente criar o mapa de transformação para ele.

Todos os mapas de transformação são executados para o serviço quando ele é invocado e o modo de conjunto de importação é definido como "Síncrono" (o padrão).

A imagem a seguir é um exemplo do mapa de transformação associado ao conjunto de importação de serviço Web de notificação.

Figura 2. Mapa de Transformação de Notificação

Como adicionar valores de resposta do serviço Web

No script de mapa de transformação associado a um conjunto de importação de serviço Web, alguns valores de variáveis podem mudar os valores de resposta do serviço Web. Além das variáveis normais que estão disponíveis em um script de mapa de transformação , a tabela documenta as variáveis que estão disponíveis e seus efeitos.

Tabela 1. Como adicionar valores de resposta do serviço Web

Nome da variável	Tipo	Descrição
resposta	Objeto de saída	Objeto Javascript que contém elementos de resposta criados dinamicamente usados para personalizar a resposta de saída de uma inserção de conjunto de importação de serviço Web.

Exemplo

// create new elements called "transaction_id" 
// and "hello" in the web service response
response.transaction_id="abc123";
response.hello="world";
 
status_message="message 1";
// this is the normal status_message variable

O exemplo de snippet de código resulta na resposta a seguir sendo gerada de volta para o consumidor do serviço Web

<soapenv:Envelopexmlns:imp="http://www.service-now.com/imp_notification"                  
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/><soapenv:Body>
<insertResponse xmlns="http://www.service-now.com/imp_notification">
  <sys_id>969d157c0a0a0baf008ba5770ffa798c</sys_id>
  <table>incident</table>
  <display_name>number</display_name>
  <display_value>INC0010091</display_value>
  <status>inserted</status>
  <status_message>message 1</status_message>
  <transaction_id>abc123</transaction_id>
  <hello>world</hello>
</insertResponse>
</soapenv:Body></soapenv:Envelope>

Depuração de conjuntos de importação de serviços Web

Para depurar uma solicitação SOAP que entra no sistema, crie a propriedade do sistema glide.processor.debug.SOAPProcessor.

Depois de criá-lo, defina-o como verdadeiro para que todas as solicitações SOAP sejam registradas no log do sistema. Defina-o como falso quando terminar para manter o tamanho do log do sistema em um tamanho gerenciado.