Criar um novo serviço Web SOAP com script

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 1 min. de leitura
  • Siga estes exemplos para criar um novo serviço Web SOAP com script.

    Quando o plug-in Web Services Provider - Scripted é ativado, um novo módulo Scripted Web Services fica disponível na aplicação System Web Services.

    Figura 1. Scripted SOAP Web Services

    Scripted SOAP Web Services

    Exemplo 1: Recuperando uma propriedade do sistema

    A primeira etapa é definir os parâmetros de entrada e de retorno. Isso é feito adicionando uma entrada aos Parâmetros de entrada e aos Parâmetros de saída. Esses parâmetros são usados para construir e apresentar um WSDL significativo e não adicionam à funcionalidade de processamento do próprio serviço Web real.

    Figura 2. Parâmetros de entrada e saída GetProperty

    Parâmetros de entrada GetProperty

    Parâmetros de saída GetProperty

    Os parâmetros são referenciados no script do serviço Web. Qualquer um dos parâmetros de entrada é recuperado usando a seguinte sintaxe:
    var a= request.property;
    Os parâmetros de saída são definidos usando a seguinte sintaxe:
    response.property="ABC";

    O exemplo a seguir demonstra como recuperar uma propriedade do sistema e devolvê-la como parte da resposta SOAP. O exemplo mostra como criar um serviço Web com script personalizado para fazer algo específico que os serviços Web diretos do sistema base ServiceNow não podem.

    Figura 3. Serviço Web GetProperty

    Serviço Web GetProperty

    Exemplo 2: Solicitando um Blackberry

    Os serviços Web diretos operam em tabelas e em seus dados. O exemplo a seguir mostra como iniciar uma solução de negócios, como solicitar um Blackberry, invocando um serviço Web com script. Os parâmetros de entrada e saída a seguir são compatíveis com o exemplo do Blackberry:

    Figura 4. Entrada/saída Blackberry

    Parâmetros de entrada OrderblackBerry

    Parâmetros de saída OrderblackBerry

    Este script mostra como usar os parâmetros acima para adicionar um Blackberry ao carrinho de compras do catálogo de serviços e solicitá-lo. O número da solicitação é retornado no campo request_number da resposta SOAP.
    var cart = new Cart();
    var item = cart.addItem('e2132865c0a8016500108d9cee411699');
    cart.setVariable(item,'original', request.phone_number);
     
    // set the requested for
    var gr = new GlideRecord("sys_user");
    gr.addQuery("user_name", request.requested_for);
    gr.query();
    
    if(gr.next()){
      var cartGR = cart.getCart();
      cartGR.requested_for = gr.getUniqueValue();
      cartGR.update();
    }
     
    var rc = cart.placeOrder();
    response.request_number= rc.getValue('number');