Criar um novo serviço web SOAP com script

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura
  • Siga estes exemplos para criar um novo serviço web SOAP com script.

    Quando o plug-in Provedor de serviços web - Scripted é ativado, um novo módulo de serviços web com script fica disponível na aplicação Serviços web do sistema.

    Figura 1. Scripted SOAP Web Services

    Serviços Web SOAP com script

    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 processar o 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 retorná-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: Como solicitar um Blackberry

    Os serviços web diretos operam em tabelas e 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 seguintes parâmetros de entrada e saída são compatíveis com o exemplo do Blackberry:

    Figura 4. Entrada/saída Blackberry

    Parâmetros de entrada de OrderblackBerry

    Parâmetros de saída de 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');