埋め込みヘルプの詳細

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:4分
  • 埋め込みヘルプは、ユーザーのロールに基づいて、UI ページでターゲットを絞ったヘルプコンテンツを提供します。一部の埋め込みヘルプコンテンツは、ベースインスタンスに付属しています。組織は埋め込みヘルプコンテンツを追加または置換できます。

    埋め込みヘルプの概要

    埋め込みヘルプを使用すると、ユーザーが必要とするヘルプを提供するだけでなく、ベースシステムで利用可能なヘルプトピックの恩恵を受けることができます。 新しい埋め込みヘルプコンテンツを追加したり、コンテンツを置換したりできます。コンテンツの置換には、既存のトピックを非アクティブ化してトピックを追加する必要があります。

    組織では、次のような理由で埋め込みヘルプコンテンツを追加または置換することができます。
    • カスタムアプリケーションのヘルプを提供します。
    • ビジネスプロセスを説明する、より具体的な手順または埋め込みビデオを提供します。
    • ページにヘルプコンテンツが存在しないところに埋め込みヘルプコンテンツを提供する。
    • 英語 (デフォルト) 以外の言語で埋め込みヘルプコンテンツを提供します。
    • 異なるロールに異なるコンテンツを提供する。

    埋め込みヘルプコンテンツを識別する UI ページ名。ページ名を見つけるには、そのビューの URL でテーブル名を探します。たとえば、[アセスメントメトリクスタイプ] のリストビューのページ名は asmt_metric_type_list で、 instancename.service-now.com/nav_to.do?uri=%2Fasmt_metric_type_list.do%3Fsysparm_userpref_module% というアドレスにあります。フォームビューのページ名は asmt_metric_type です。

    ベースシステムトピックのコンテンツは編集できません。基本システムトピックでは、読み取り専用の [ServiceNow ヘルプ ] チェックボックスがオンになっています。 コンテンツを編集して変更を保存しようとすると、エラーメッセージが表示されます。ベースシステムのトピックに表示される情報を変更するには、トピックのコピーを作成します。これにより、[ ServiceNow ヘルプ ] チェックボックスがオフになります。トピックをコンテンツに変更して保存します。 カスタマイズされたコンテンツは ServiceNow ヘルプコンテンツよりも優先され、ユーザーがその UI ページのヘルプを開くと表示されます。

    このリリース以降、 埋め込みヘルプ は最後にアップロードされた言語のコンテンツを上書きすることなく、英語以外のコンテンツのインポートもサポートしています。

    埋め込みヘルプワークフロー

    ServiceNow データセンターには、埋め込みヘルプコンテンツが保存されるコンテンツ配信ネットワーク (CDN) が含まれています。ローカル (インスタンス) 埋め込みヘルプコンテンツ [sys_embedded_help_content] テーブルのトピックは、CDN から入力されます。CDN のヘルプコンテンツは 30 日ごとに更新されます。

    ユーザーが UI ページにアクセスすると、ユーザーのロールにカスタムトピックが存在する場合は、埋め込みヘルププロセスに表示されます。カスタムトピックがない場合は、次の手順が実行されます。
    1. 最初にブラウザーのキャッシュをチェックし、キャッシュに見つかった場合はコンテンツを表示します。次に、埋め込みヘルプコンテンツ [sys_embedded_help_content] テーブルで、対応する埋め込みヘルプトピックをロールと修飾子とともにチェックします (該当する場合)。
      • トピックが見つかった場合は、[ 最終同期 ] フィールドの日付を確認します。日付が 15 日以上経過している場合は、最終同期日とリソース ID を使用して埋め込みヘルプキュー [sys_embedded_help_queue] テーブルに要求が配置されます。
      • トピックが見つからない場合は、現在の日付とリソース ID を使用して埋め込みヘルプキュー [sys_embedded_help_queue] テーブルに要求が配置されます。
    2. ページが表示されてから 1 分以内に、システムは要求を処理し、CDN をチェックします。最初のケースでは、 最終同期 日以降にトピックが更新されたかどうかを確認します。いずれの場合も、1 分後にページを更新してコンテンツを表示します。
      • トピックが更新された場合は、更新されたトピックがテーブルにプルされ、 最終同期 日が更新されます。
      • トピックが更新されなかった場合は、ローカルのキャッシュされたトピックまたはデータベーストピックが表示され、 最終同期 日が更新されます。
    3. トピックがローカルデータベースにない場合、トピックが CDN に存在する場合は、そのトピックがテーブルにプルされます。存在しない場合、アクションはありません。

    アドミニストレーターは、システムプロパティでデフォルトの 15 日間の同期期間を変更できます