Portail de services et scripts clients

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 le widget de formulaire et le widget d’é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 n’utilisez que les API mobiles. La définition d’un script client sur Mobile ne garantit pas qu’il fonctionnera, elle signale simplement que le script doit être tenté par l’application mobile ou le Portail de services. Un grand nombre de vos scripts clients existants peuvent être définis sur All (Toutes ) 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 à l’environnement mobile

    Vous pouvez marquer un script client compatible avec le bureau et l’appareil mobile, 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

    Scripts clients globaux non pris en charge

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

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

    Widgets et g_form incorporés

    Lorsque vous utilisez les variables de type Macro de Catalogue de services et Macro avec étiquette, vous pouvez choisir un widget à incorporer dans un formulaire d’élément de catalogue. Dans le contrôleur client du widget intégré, vous pouvez accéder à l’objet de champ et à l’élément de catalogue g_form instance à l’aide de :

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

    Scripts clients utilisés avec Portail de services

    Le g_list global vous aide à 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 Portail de services scripts d’élément de 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 :(");
    }