---
sourceDocument: Interface do usuário da Now Platform Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-user-interface

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interface do usuário da Now Platform Yokohama

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Scripts do cliente e do portal de serviços

# Scripts do cliente e do portal de serviços {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Você pode usar scripts de cliente e scripts de cliente de catálogo no Portal de serviçosSe o Tipo de IU estiver definido como Portal de serviços/celular ou Todos . Scripts de cliente e scripts de cliente de catálogo são usados com o widget de formulário e o widget de item do catálogo SC, em vez de um controlador de cliente de widget.

Antes de sinalizar um script como Portal de serviços/celular ou Todos , Certifique-se de que você esteja usando apenas as APIs para dispositivos móveis. Definindo um client script como Mobile não garante que funcionará, ele simplesmente sinaliza que o script deve ser tentado pelo aplicativo para celular ou o. Portal de serviços. Muitos de seus scripts de cliente existentes podem ser definidos como Todos Desde que as chamadas de API sejam compatíveis com o ambiente de script do cliente móvel.

Os tópicos nesta seção exigem conhecimento avançado de codificação e compreensão de Portal de serviçosAPIs.

## Verificando o tempo de execução para desktop versus celular

Você pode marcar um script de cliente compatível com desktop e celular, mas incluir um comportamento que depende do tempo de execução. Você pode usar este script:

      if (window === null)
        // Write your mobile compatible code here
      else
        // Write your desktop compatible code here

## Scripts de cliente globais incompatíveis

As seguintes APIs globais e APIs não estão disponíveis nos scripts de cliente e nos scripts de cliente de catálogo usados no Portal de serviços:  
* $
* $$
* j
* angular
* controle
* documento
* jQuery
* janela
{#unsupported_client_scripts__ul_z44_yzh_hy}  
Nota:  
Os controladores de cliente de widget são controladores Angular completos e não estão sujeitos aos globais de script de cliente incompatíveis listados aqui. Use jQuery e Angular conforme necessário.

## Widgets incorporados e g_form

Ao usar o tipo de variável Catálogo de serviços Macro e. Macro com rótulo , você pode escolher um widget para incorporar em um formulário de item do catálogo. No controlador do cliente para o widget incorporado, você pode acessar o objeto de campo e a instância g_form do item do catálogo usando:  
* `scope.page.field`
* `escopo.page.g_form()`
{#unsupported_client_scripts__ul_dzx_rb3_hy}  

## Scripts de cliente usados com Portal de serviços

. g_list Global ajuda a definir o filtro de um elemento de lista Glide ou uma variável de coletor de lista. Use esta API no lugar da API g_filter nos scripts de cliente para desktop.

    function onLoad() {
      var myListCollector = g_list.get("my_list_collector");
      myListCollector.reset();
      myListCollector.setQuery("active=true^category=8c7b22230b402200b0b02c6317673a62");
      myListCollector.addItem('3a700d39af5f4fc0aab978df90f4c692', 'Power Supply');
      myListCollector.addItem('1cb93419a3a248318da8f814140b42f6', 'Backpack');
    }

g_service_catalog está disponível somente em Portal de serviçosscripts de item do catálogo de serviços. Use esta API para saber se o script do item do catálogo é executado como parte de um guia de pedido ou por conta própria.

    function onLoad() {
      if (window) // if CMS, don't run this
       return;

       // g_service_catalog api for Service Portal and Mobile
       var isOrderGuide = g_service_catalog.isOrderGuide();
       g_form.setValue("is_order_guide", isOrderGuide ? "Yes!" : "Nope :(");
    }

* **[APIs e tipos de script de cliente compatíveis](https://servicenow-prod.fluidtopics.net/H2tl26JJMPKIUSZPI~cZ8w)**   
  Alguns scripts de cliente não são compatíveis com Portal de serviços. Os outros devem ter um tipo de IU definido como Todos ou Portal de serviços/celular . Se estiver usando um client script no Portal de serviços, Somente APIs do lado do cliente compatíveis com um ambiente móvel podem ser usadas.