カスタム スキャンエンジン 定義の作成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：8分

    • スキャンエンジンには、既存のベースシステム定義が含まれています。ただし、組織にこれらの定義で満たされない特定のスキャンニーズがある場合は、独自のスキャンを作成できます。

    始める前に

    必要なロール:スキャンエンジンアドミン (sn_se.scan_engine_admin)

    注:
    Guided 顧客は、1 つのインスタンスで 10 個のアクティブなカスタム定義のみを持つことができます。この数を超える定義は、スキャンが実行されるたびに無効になります。Total のお客様 (およびプラットフォームヘルスアドオンを使用する Guided のお客様) は、1 つのインスタンスでアクティブなカスタム定義を無制限に使用できます。

    手順

    1. 移動先 すべて > 影響 > プラットフォームヘルス > 定義.
    2. [新規] を選択します。
    3. 必要に応じて次のフィールドに入力します。
      フィールド/選択 説明
      番号 定義の一意の識別子。この番号は自動的に生成されます。
      注:
      定義番号の前に一意の会社コードが付けられます。会社コードを見つけるには、 sys_properties テーブルに移動して glide.appcreator.company.code プロパティを検索します。
      アクティブ スキャン中に検出結果 (問題) があるかどうかを確認するために、 スキャンエンジン にレコードを評価させる場合に選択します。
      検出結果のレベル リアルタイムモニタリングがアクティブな場合に表示する定義の結果の重大度レベルを選択します。
      • 処理:定義の条件が満たされるまで、ユーザーがレコードを変更できないようにします。
      • 推奨:定義に従わなかった理由について、または定義の条件が満たされるまで、ユーザーがレコードを変更できないようにします。
      • 提案:より良いソリューションが利用可能かどうかを確認するようにユーザーに求めます。
      • レビュー:それほど重要でないアイテムをレビュー対象として呼び出します。これは技術的負債の原因にはなりません。
      カテゴリ 定義のカテゴリ:
      • アップグレード性:新機能、改善、セキュリティパッチ、または互換性調整による ServiceNow インスタンスまたはアプリケーションの拡張の容易さを評価します。
      • 管理性:ServiceNow のインスタンス、アプリケーション、またはインフラストラクチャをどの程度効果的に監視、構成、維持できるかを測定します。
      • パフォーマンス:速度、応答性、リソース使用率、全体的な信頼性などの側面を含む、ServiceNow インスタンスの効率を測定します。
      • セキュリティ:ServiceNow インスタンス全体でのプロトコルの実装を測定して、不正アクセス、データ侵害、サイバー攻撃、潜在的な脆弱性を防止します。
      • ユーザーエクスペリエンス:使いやすさ、効率性、デザイン、応答性、アクセシビリティ、およびその感情的および機能的影響を考慮して、アプリケーションとのユーザーインタラクションの品質を評価します。
      簡単な説明 (必須) 定義の簡単な説明。
      定義の理由 定義が作成された理由。
      サポートドキュメント 定義の理由をさらに説明するドキュメントへのリンク。リンクはリアルタイムメッセージの一部として表示されます。
    4. [ 構成 ] タブで、必要に応じて次のフィールドの値を調整し、定義の動作方法およびインスタンス内の検出結果の識別方法を構成します。
      フィールド/設定 説明
      定義を評価 リアルタイムでスキャンされるレコードの範囲を指定します。
      • [一致するすべてのレコード]:該当するすべてのレコードをリアルタイムでスキャンします。
      • 新規レコードのみ (New Records Only):適用可能な新しいレコードのみをリアルタイムでスキャンします。
      実行する SN インスタンス 定義が適用される SN インスタンスを設定します。
      • すべての準本番インスタンスで実行
      • 指定したインスタンスで実行
      • 本番インスタンスでのみ実行
      注:
      [指定されたインスタンスで実行] は、[実行する特定の SN インスタンス] フィールドをアクティブ化します。
      実行する特定の SN インスタンス
      • 定義が適用される特定の ServiceNow インスタンスを設定します。
      • この設定を表示するには、次の条件を満たす必要があります。
        • スキャンエンジンプロパティで [インスタンス固有の定義を有効にする] を有効にする必要があります。
        • [自分の SN インスタンス] テーブルには、少なくとも 1 つのインスタンスが含まれている必要があります。
      注:
      ここでは、自分の SN インスタンステーブルで定義されたインスタンスのみを選択できます。
      ルールのタイプ (必須) 定義のルールタイプを設定します。
      • スクリプトにテキストが含まれている場合は失敗します
      • スクリプトでテキストが除外されると失敗します
      • XML にテキストが含まれている場合は失敗する
      • XML でテキストが除外されると失敗する
      • 条件に一致すれば失敗する
      • カスタム
      スキャン結果の制限
      • スキャン中に各定義に対して生成できる結果の最大数。
      • 制限は該当するテーブルごとに適用されます。たとえば、制限が 100 に設定されている場合、該当するテーブルごとに最大 100 件の検索結果が生成されます。
      • 過剰または冗長な検出結果を防止し、スキャンパフォーマンスを最適化します。
      修正を提案
      • ServiceNow のオブジェクトに推奨される変更を自動的に適用できるように定義を定義できます。
      • 選択すると、[ 提案された修正スクリプト ] フィールドが表示されます。
      注:
      この機能を使用するには、Impact Total パッケージまたはプラットフォームヘルスアドオンを購入する必要があります。
      修正スクリプトを提案
      • 表示しているレコードの自動修正バージョンをユーザーに表示するために使用されるカスタム関数を作成するためのスクリプトフィールドを提供します。
      • このフィールドは、[ 修正の提案] が有効になっている場合にのみ表示されます。
      検索タイプ (必須)
      • 正規表現:正規表現で検索します。
      • テキスト:テキストを検索します。
      • カスタム:JavaScript を使用したカスタム検索タイプ。
      • このフィールドは、[ ルールのタイプ ] が次のいずれかの場合にのみ表示されます。
        • スクリプトにテキストが含まれている場合は失敗します
        • スクリプトでテキストが除外されると失敗します
        • XML にテキストが含まれている場合は失敗する
        • XML でテキストが除外されると失敗する
      カスタムルール変数
      • [パラメーター 1 の値文字列] 入力フィールドを有効にします。
      • このフィールドは、[ ルールのタイプ] が [ カスタム] に設定されている場合にのみ表示されます。
      パラメーター 1 の値 カスタムスクリプトを変更せずにユーザーがパラメーターの値を変更できるようにする場合は、ここでデフォルト値を設定します。
      注:
      このフィールドは、[ カスタムルール ] が 有効な場合にのみ表示されます。
      パラメーター 1 の説明 パラメーター 1 の値の使用目的の説明。
      注:
      このフィールドは、[ ルールのタイプ] が [ カスタム] に設定されている場合にのみ表示されます。
      デルタスキャンは適用外 この定義は、すべてのスキャンタイプについて、デルタスキャンではなくフルスキャンとして常にスキャンします。つまり、前回のスキャン以降に更新されたレコードだけでなく、すべてのレコードの検出結果がスキャンされます。
      テーブル全体に対して 1 つの結果を返す
      • 定義がテーブル内の特定のレコードではなくテーブル全体に適用される場合、 スキャンエンジン は各レコードの結果ではなく、テーブルの 1 つの結果レコードを返します。
      • 可能であれば、スキャンされたテーブルとスキャンされたレコードが検出結果に入力されます。これが不可能な場合、スキャンされたレコード値は空になります。
      注:
      有効にすると、この定義はリアルタイムでスキャンされません。
      検索パターン ユーザーが正規表現を入力して、スクリプトおよび XML タイプのフィールドで結果を検索できるようにします。

      このフィールドは、[ ルールのタイプ] が次のいずれかに設定されている場合にのみ使用できます。

      • スクリプトにテキストが含まれると失敗する
      • スクリプトでテキストが除外されると失敗する
      • XML にテキストが含まれている場合は失敗する
      • XML でテキストが除外されると失敗する

      さらに、[ 検索タイプ ] を [正規表現] に設定する必要があります。
      関数を検索 ユーザーがカスタム関数を入力して、スクリプトおよび XML タイプのフィールドで検索結果を検索できるようにします。

      このフィールドは、[ ルールのタイプ] が次のいずれかに設定されている場合にのみ使用できます。

      • スクリプトにテキストが含まれると失敗する
      • スクリプトでテキストが除外されると失敗する
      • XML にテキストが含まれている場合は失敗する
      • XML でテキストが除外されると失敗します。

      さらに、[ 検索タイプ ] を [カスタム] に設定する必要があります。
      検索テキスト ユーザーがスクリプトおよび XML フィールド内のテキストを検索するためのフィールドを有効にします。1 つ以上のカンマ区切りテキスト値を入力します。

      このフィールドは、[ ルールのタイプ] が次のいずれかに設定されている場合にのみ使用できます。

      • スクリプトにテキストが含まれると失敗する
      • スクリプトでテキストが除外されると失敗する
      • XML にテキストが含まれている場合は失敗する
      • XML でテキストが除外されると失敗する

      また、[ 検索タイプ ] を [テキスト] (カンマ区切り) に設定する必要があります。
      カスタム関数 (必須)
      • 検出結果を識別するためのカスタム関数を作成するためのスクリプトフィールドを提供します。
      • このフィールドは、[ ルールのタイプ] が [ カスタム] に設定されている場合にのみ表示されます。
    5. [ 影響度] タブで、必要に応じて次のフィールドの値を調整し、この定義に関連する検索結果の影響度レベルを構成します。
      オプション説明
      インスタンスへの影響度 (必須)
      • 検出結果レベル内の検出結果の影響度レベルを設定します。たとえば、Act の結果ごとに異なる影響度レベルを割り当てることができます。個々の定義に優先度のレイヤーが追加されます。
      • 影響度は 1 〜 10 の範囲で設定できます。1 が最小の影響度で、10 が最大です。
      ビジネスインパクト 定義の結果がビジネス環境のインスタンスにどのように影響するかの説明。
    6. [ 解決] タブで、次のフィールドの値を調整して、この定義に関連する検出結果の解決方法と解決にかかる推定時間を変更します。
      オプション説明
      問題解決までの推定時間

      1 人の開発者が定義結果を解決するための推定時間 (日、時間、分、および秒単位)。
      解決手順 この定義に関連する検出結果を解決するための手順の説明。この説明はリアルタイムメッセージに表示されます。
    7. [他のアクション] ドロップダウンメニューで [保存 ] を選択して新しい定義を保存し、適用可能なテーブルを構成します。