Personnaliser les opérations de modèle

  • Rversion finale: Washingtondc
  • Mis à jour 10 janv. 2026
  • 3 minutes de lecture

    • Dans le cadre de la création ou de la modification d'un modèle de détection, modifiez les opérations personnalisées existantes qui font partie du système de base ou ajoutez-en de nouvelles.

    Avant de commencer

    Rôle requis : pd_admin

    Des connaissances pratiques sur le scripting Java sont requises.

    Pourquoi et quand exécuter cette tâche

    Pour les opérations de modèle standard, vous pouvez uniquement définir les paramètres d'entrée. Toutefois, il existe des opérations personnalisées pour lesquelles vous pouvez définir la logique métier et le mécanisme de l'opération elle-même, en plus des paramètres d'entrée. Par exemple, vous pouvez rendre un paramètre obligatoire ou définir les paramètres d'entrée à utiliser.

    Les opérations personnalisées suivantes sont disponibles :
    Appel REST dans le cloud
    Extrait des informations des éléments de configuration du type PaaS (Platform-as-a-Service, plateforme en tant que service), tels que Microsoft Azure ou Amazon Web Services. Cette opération personnalisée basée sur Java fait partie du système de base.
    HTTP Get Call
    Extrait des informations des éléments de configuration (CI) qui utilisent le protocole HTTP. Cette opération personnalisée fait partie du système de base.
    Requête REST dans le cloud
    Extrait des informations des éléments de configuration du type PaaS (Platform-as-a-Service, plateforme en tant que service), tels que Microsoft Azure ou Amazon Web Services. Cette opération personnalisée basée sur un script Java n'est disponible qu'après le téléchargement de la version 1.0.24 ou d'une version ultérieure des modèles à partir de ServiceNow Store. Utilisez cette opération au lieu de l'opération d'appel REST dans le cloud.

    En plus de ces opérations personnalisées, vous pouvez créer vos propres opérations pour répondre aux besoins de votre processus de détection. Les opérations personnalisées que vous avez créées apparaissent dans la liste des opérations, ainsi que les opérations qui font partie du système de base.

    Procédure

    1. Accédez à la Tous > Concepteur de modèle > Opérations personnalisées.
    2. Pour ajouter une opération personnalisée, cliquez sur Nouveau.
      Ou
    3. Pour modifier une opération personnalisée existante, cliquez sur son nom dans la table.
    4. Pour la nouvelle opération personnalisée, saisissez un nom la décrivant dans le champ Nom.
      Par exemple, si l'objectif de cette opération est d'extraire des informations à l'aide d'un certain protocole, vous pouvez la nommer « Requête de protocole NetApp ».
    5. Saisissez ou modifiez l'objectif ou la description de l'opération dans le champ Description.
    6. Écrivez le script Java dans le volet Script pour définir la logique métier de l'opération.
      Le script doit respecter les directives suivantes :
      • Créer des variables pour les paramètres d'opération à l'aide du signe dollar devant le nom de la variable, par exemple $fileName.
      • CTX est un objet contenant toutes les informations résultant d'une exécution de modèle.
      • Utilisez rtrn pour indiquer la chaîne, qui est le résultat de votre opération personnalisée.
      Par exemple : 
      ms.info('message from Custom operation MIDLogWrite ' + $logMessage);

      Où ms.info est le journal Serveur MID. La variable $logMessage fait référence au message qui est créé à l'intérieur de ce journal Serveur MID.

    7. Dans la liste connexe Paramètres de l'opération personnalisée, définissez les paramètres d'entrée que vous avez utilisés dans le script Java.

      Par exemple, si vous avez utilisé une variable pour le fichier de message de journal dans le script Java, vous devez également définir le paramètre de cette variable :


      Définissez les paramètres des variables utilisées dans le script.
      Champ Description
      Étiquette Saisissez une étiquette courte et descriptive pour le paramètre. L'étiquette s'affiche dans la table. Par exemple, netapp_query.
      Nom Saisissez un nom court et clair pour le paramètre, sans utiliser d'espace, par exemple, NetAppquery. Ce nom apparaît dans la liste des opérations sur la page de l'étape de modèle.
      Valeur par défaut Le cas échéant, saisissez la valeur par défaut. Par exemple, POST.
      Obligatoire Définissez la valeur sur true si ce paramètre est obligatoire pour cette opération.

      Sinon, définissez la valeur sur false.
      Ordre Définissez l'ordre selon lequel les paramètres apparaissent sur la page de l'opération. Utilisez des nombres naturels, où 1 signifie que ce paramètre apparaît en haut de la page de l'opération.
      Domaine Pour les environnements séparés par domaine, spécifiez le nom du domaine pour lequel ce paramètre est pertinent.
      Regex de validation Spécifiez une expression régulière Java avec laquelle valider le paramètre. Pendant le processus de détection, le Serveur MID valide le résultat de l'opération. Le module Concepteur de modèle exécute également la validation lorsque vous cliquez sur Test sur la page de l'étape de modèle.