---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Criar um novo serviço web SOAP com script

# Criar um novo serviço web SOAP com script {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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

## Exemplo 1: Recuperando uma propriedade do sistema {#createSOAPwebservice__section_yn2_1y2_f3b}

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

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

## Exemplo 2: Como solicitar um Blackberry {#createSOAPwebservice__section_zn2_1y2_f3b}

[Os serviços web diretos](https://servicenow-prod.fluidtopics.net/pB3G2X2s04helLp1ikJ6jw "Um serviço web direto estará disponível para qualquer tabela no sistema se a lista de controle de acesso correta estiver configurada.") 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

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');