Como criar 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(a).

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 de 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 como ele aparece para a tabela de conjuntos para 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.

Conjuntos para importação de serviços web de mapeamento

Durante a criação do conjunto para importação de serviços 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 do 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 para importação de serviços web de notificação.

Figura 2. Mapa de transformação de notificação

Como adicionar valores de resposta de serviço web

No script do mapa de transformação associado a um conjunto para 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 de 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 seguinte resposta sendo gerada de volta para o consumidor de 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 para 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 como falso quando terminar para manter o tamanho do log do sistema em um tamanho gerenciado.