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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Crie uma tabela de conjunto de importação de serviço web para definir como preparar e transformar dados importados.

    Navegar até Tudo > Serviços web do sistema > Entrada > Criar novo(a).

    Figura 1. Criar serviço web

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

    Se você quiser criar um mapa de transformação depois de criar o serviço web, verifique Criar mapa de transformação e escolha a tabela de destino na qual os dados serão transformados. Após Criar selecionado, o serviço web é criado e você será colocado imediatamente em Mapa de transformação de tabela formulário. Você pode continuar a especificar o mapa de transformação ou o script.

    Campos de serviço da Web

    Os campos disponíveis para este serviço web. Por padrão, todos os campos são publicados como Tipo XSD de xsd:cadeia de caracteres . . Nome É o campo exposto para o serviço web e, portanto, aparece como o nome do campo no WSDL. . Rótulo é o rótulo do campo como ele aparece na tabela de conjuntos para importação.

    Você pode Adicionar marca para Excluir ou modifique (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ço web

    Opcionalmente, durante a criação do conjunto de importação de serviço web, você pode 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

    Adicionando valores de resposta de serviço da Web

    No script do 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. Adicionando valores de resposta de serviço da 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 geração da seguinte resposta 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>

    Depurando conjuntos de importação de serviço 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 de manter o tamanho do log do sistema em um tamanho gerenciado.