Portail de services et scripts clients

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • Vous pouvez utiliser des scripts clients et des scripts clients de catalogue si le type d’interface Portail de services utilisateur est défini sur Mobile / Portail de services ou Tous. Les scripts clients et les scripts clients de catalogue sont utilisés avec les widgets Formulaire et Élément de catalogue SC, par opposition à un contrôleur client de widget.

    Avant de marquer un script comme Mobile/Portail de services ou Tous, assurez-vous que vous utilisez uniquement les API mobiles. La définition d’un script client sur Mobile ne garantit pas qu’il fonctionnera, elle indique simplement que le script doit être tenté par l’application mobile ou le Portail de services. La plupart de vos scripts clients existants peuvent être définis sur Tous tant que les appels d’API sont pris en charge par l’environnement de script client mobile.

    Les rubriques de cette section nécessitent des connaissances avancées en codage et une compréhension des Portail de services API.

    Vérification de l’exécution bureau par rapport au temps d’exécution mobile

    Vous pouvez marquer un script client compatible avec les ordinateurs de bureau et les appareils mobiles, mais inclure un comportement qui dépend de l’exécution. Vous pouvez utiliser ce script :
      if (window === null)
    // Write your mobile compatible code here
  else
    // Write your desktop compatible code here

    Scripting client global non pris en charge

    Les API et globales suivants ne sont pas disponibles dans les scripts clients et les scripts clients de catalogue utilisés dans :Portail de services

    • $
    • $$
    • $j
    • angulaire
    • control
    • document
    • jQuery
    • fenêtre
    Remarque :
    Les contrôleurs clients de widgets sont des contrôleurs d’angle complets et ne sont pas soumis aux globaux de script client non pris en charge répertoriés ici. Utilisez jQuery et Angular selon vos besoins.

    Widgets intégrés et g_form

    Lorsque vous utilisez les variables de Catalogue de services Macro et Macro avec étiquette, vous pouvez sélectionner un widget à intégrer dans un formulaire d’élément de catalogue. Dans le contrôleur client pour le widget intégré, vous pouvez accéder à l’objet de champ et à l’élément de catalogue g_form instance en utilisant :

    • $scope.page.champ
    • $scope.page.g_form()

    Scripts clients utilisés avec Portail de services

    Le g_list global vous permet de définir le filtre d’un élément de liste Glide ou d’une variable de collecteur de liste. Utilisez cette API à la place de l’API g_filter sur les scripts clients de bureau.
    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 n’est disponible que dans les scripts d’éléments de Portail de services catalogue de services. Utilisez cette API pour savoir si votre script d’élément de catalogue est exécuté dans le cadre d’un guide de commande ou seul.
    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 :(");
}