Portal de serviços e client scripts

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • Você pode usar scripts de cliente e scripts de cliente de catálogo no Portal de serviços Se o Tipo de IU estiver definido como Portal de serviços/Mobile 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 Mobile/Portal de serviços ou Todos Certifique-se de que você esteja usando somente as APIs para celular. 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 pelo 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ços APIs.

    Verificando o tempo de execução do desktop versus dispositivo móvel

    Você pode marcar um client script 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

    Os seguintes globais e APIs não estão disponíveis em scripts de cliente e scripts de cliente de catálogo usados em Portal de serviços:

    • $
    • $$
    • jj
    • angular
    • controle
    • documento
    • jQuery
    • janela
    Nota:
    Os controladores de cliente de widget são controladores angulares 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:

    • escopo.page.field
    • escopo.page.g_form()

    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 em scripts de cliente de 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 só está disponível em Portal de serviços scripts 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 :(");
}