パターン操作のカスタマイズ

  • リリースバージョン: Washingtondc
  • 更新日 2026年01月10日
  • 読む3読むのに数分

    • 検出パターンの作成または変更の一環として、ベースシステムに含まれている既存のカスタム操作を変更するか、新しい操作を追加します。

    始める前に

    必要なロール：pd_admin

    Java スクリプティングに関する実践的な知識が必要です。

    このタスクについて

    標準的なパターン操作では入力パラメーターのみを定義できます。ただし、入力パラメーターに加えて、ビジネスロジックと操作自体のメカニズムを定義できるカスタム操作があります。たとえば、パラメーターを必須にしたり、使用する入力パラメーターを定義したりできます。

    次のカスタム操作を利用できます。
    クラウド REST コール (Cloud REST Call)
    Microsoft Azure、Amazon Web サービスなど、PaaS (Platform-as-a-Service) タイプの構成アイテムから情報を抽出します。この Java ベースのカスタム操作は基本システムに含まれています。
    HTTP Get コール (HTTP Get Call)
    HTTP プロトコルを使用する構成アイテム (CI) から情報を抽出します。このカスタム操作は基本システムに含まれています。
    クラウド REST クエリー (Cloud REST Query)
    Microsoft Azure、Amazon Web サービスなど、PaaS (Platform-as-a-Service) タイプの構成アイテムから情報を抽出します。この Java スクリプトベースのカスタム操作は、ServiceNow Storeからバージョン 1.0.24 以降のパターンをダウンロードした後でのみ利用可能になります。この操作は、[クラウド REST コール (Cloud REST Call)] 操作に代えて使用します。

    これらのカスタム操作に加えて、検出プロセスのニーズに合わせて独自の操作も作成できます。作成したカスタム操作は、基本システムに含まれている操作とともに操作のリストに表示されます。

    手順

    1. 移動先 すべて > パターンデザイナー > カスタム運用.
    2. カスタム操作を追加するには、[新規] をクリックします。
      または
    3. 既存のカスタム操作を変更するには、テーブル内のその名前をクリックします。
    4. 新しいカスタム操作について、新しい操作を説明する名前を [名前] フィールドに入力します。
      たとえば、この操作の目的が特定のプロトコルを使用して情報を抽出することであれば、NetApp プロトコルクエリーという名前にすることができます。
    5. [説明] フィールドで、操作の目的または説明を入力または変更します。
    6. [スクリプト] ペインで Java スクリプトを作成し、操作のビジネスロジックを定義します。
      スクリプトは、次のガイドラインに準拠する必要があります。
      • 変数名の前にドル記号を使用して、操作パラメーターの変数を作成します (例：$fileName)。
      • CTX は、パターン実行から得られたすべての情報を含むオブジェクトです。
      • rtrn を使用して、カスタム操作の結果である文字列を示します。
      例： 
      ms.info('message from Custom operation MIDLogWrite ' + $logMessage);

      この場合、ms.info は MID サーバー ログです。$logMessage 変数は、この MID サーバー ログ内に作成されるメッセージを参照します。

    7. [カスタム運用パラメーター] 関連リストで、Java スクリプトで使用する入力パラメーターを定義します。

      たとえば、Java スクリプトのログメッセージファイルに変数を使用した場合は、この変数のパラメーターも定義する必要があります。


      スクリプトで使用される変数のパラメーターを定義します。
      フィールド 説明
      ラベル パラメーターの簡単な説明ラベルを入力します。このラベルがテーブルに表示されます。たとえば、「netapp_query」と入力します。
      名前 「NetAppquery」などのようにスペースを含めずに、パラメーターの簡潔な名前を入力します。この名前は、パターンステップページの操作のリストに表示されます。
      デフォルト値 必要であれば、デフォルト値を入力します。たとえば、「POST」と入力します。
      必須 この操作にこのパラメーターが必須である場合は true に設定します。

      それ以外の場合は false に設定します。
      順序 パラメーターが操作ページに表示される順番を定義します。自然数を使用します。1 を指定すると、このパラメーターが操作ページの最上部に表示されます。
      ドメイン ドメイン分離環境では、このパラメーターが関連するドメインの名前を指定します。
      検証用の正規表現 パラメーターを検証する Java 正規表現を指定します。検出プロセス中に MID サーバー によって操作結果が検証されます。パターンデザイナーモジュールは、パターンステップページで [テスト] をクリックしたときにも検証を実行します。