アプリケーションナビゲーターカテゴリ

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む19読むのに数分

    • アプリケーションナビゲーターのメニューとモジュールの機能を確認します。

    アプリケーションメニューの表示

    アプリケーションナビゲーター(左側のナビゲーションバー)で選択されたアプリケーションメニューの可視性または可視性の欠如を検証します。たとえば、まずユーザーの代理操作を実行してから、指定したアプリケーションメニュー(セルフサービスやレポートなど)がそのユーザーに表示されているかまたは表示されていないかを確認するテストを作成します。

    表 : 1. 入力
    フィールド 説明
    実行順序 テストのこのステップの実行順序を指定する整数。

    ステップを作成すると、各ステップに増分値が自動的に割り当てられます。この値により、テストでは、ステップが作成された順に実行されます。このデフォルトを変更するには、[実行命令] 値を編集します。
    有効 このテストステップの使用をアクティブ化するオプション。
    アプリケーション システムがこのテストまたはテストスイートを実行するアプリケーションスコープ。
    テスト ステップを追加するテストの読み取り専用の名前。
    ステップ構成 ステップの読み取り専用の名前。
    説明 テストステップの説明。このフィールド値はテストステップのフィールド値に基づいて自動的に設定されます。このフィールドは、テストステップが送信された後に表示されます。
    メモ テストステップに関するメモ。
    ナビゲーター アサートするナビゲーターバージョン
    • コア UI (UI16)：新しいステップを作成する場合は、デフォルトで コア UI があります。
    • Next Experience： Next Experience が有効になっている場合、Next Experience がデフォルトのナビゲーターです。無効になっている場合、コア UI がデフォルトのナビゲーターです。
    表示されるアサーションタイプ [表示されるアプリケーションメニュー] フィールドで選択されたアプリケーションメニューの可視性をアプリケーションナビゲーターでテストする方法を指定します。
    • 少なくともこれらのアプリケーションメニューは表示されます：最小限でも、選択したすべてのアプリケーションメニューがアプリケーションナビゲーターに表示されます。
    • これらのアプリケーションメニューのみが表示されます：選択したアプリケーションメニューのみがアプリケーションナビゲーターに表示されます。
    表示されるアプリケーションメニュー アプリケーションナビゲーターでの可視性が検証されているアプリケーションメニュー。
    表示されないアサーションタイプ [表示されないアプリケーションメニュー] フィールドで選択されたアプリケーションメニューの可視性の欠如をアプリケーションナビゲーターでテストする方法を指定します。
    • 少なくともこれらのアプリケーションメニューは表示されません：最小限でも、選択したすべてのアプリケーションメニューがアプリケーションナビゲーターに表示されません。
    • これらのアプリケーションメニューのみが表示されません：選択したアプリケーションメニューのみがアプリケーションナビゲーターに表示されません。
    表示されないアプリケーションメニュー アプリケーションナビゲーターでの可視性の欠如が検証されているアプリケーションメニュー。

    アプリケーションメニューの作成

    アプリケーションメニューは、ユーザーがアプリケーションナビゲーターでアクセスできるメインコンテンツを定義します。アプリケーションナビゲーターに表示するアプリケーションを構成できます。

    始める前に

    必要なロール：管理者

    このタスクについて

    アプリケーションメニューを作成するときは、モジュールなどを統合アプリケーションメニューにグループ化することを検討してください。既存のメニューを編集するときは、アプリケーションメニューに有用なモジュールをさらに追加し、不要なモジュールを削除します。

    手順

    1. 移動先 すべて > システム定義 > アプリケーションメニュー.
    2. [新規] をクリックします。
    3. フォームに入力します。
      フィールド 説明
      タイトル アプリケーションメニューの表示名を定義します。
      ロール 指定されたロールにアクセスを制限します。アプリケーションメニューがアクティブな場合は、すべてのユーザーがそれを表示できます。
      カテゴリ ナビゲーションメニューのスタイルを定義するメニューカテゴリを指定します (デフォルト値は [カスタムアプリケーション] です)。
      ヒント ユーザーがこのアプリケーションメニューにカーソルを合わせたときにツールヒントに表示されるテキストを定義します。
      有効 アプリケーションメニューをアクティブ化するには、チェックボックスをオンにします。アクティブなアプリケーションメニューのみが、アプリケーションナビゲーターに表示されます。
      説明 このアプリケーションの機能について、より詳細な説明を提供します。
      その他のフィールド
      順番 アプリケーションナビゲーター内のアプリケーションメニューの相対位置を定義します。順序を指定しない場合は、メニューカテゴリのデフォルトの順序が使用されます。
      デフォルトのデバイスタイプ このフィールドは使用されません。モバイルデバイス用のアプリケーションメニューは別のテーブルで定義できます。
      注:
      すべてのフィールドが表示されるようにフォームを設定する必要がある場合があります。
    4. [送信] をクリックします。
    5. アプリケーションメニューに表示されるモジュールを作成します。
      モジュールを含むアプリケーションメニューのみがアプリケーションナビゲーターに表示されます。

    モジュールの作成

    モジュールは子、つまりアプリケーションナビゲーター内のアプリケーションの第 2 階層のナビゲーションオプションです。多くの場合、モジュールはプラットフォーム内の他のページやレコードにリンクされています。アプリケーションナビゲーターにどのモジュールを表示するかを、アプリケーションメニューモジュールを使用して構成できます。

    始める前に

    必要なロール：管理者

    このタスクについて

    アプリケーションナビゲーターにアプリケーションメニューとモジュールを追加する方法については、この 5 分間のビデオをご覧ください。

    手順

    1. 次のいずれかの方法を使用して、アプリケーションメニューレコードを開きます。
      • 移動先 システム定義 > アプリケーションメニュー をクリックし、リストからアプリケーションメニューを選択します。
      • アプリケーションメニューをポイントし、[アプリケーションの編集] (鉛筆) アイコンをクリックします。
      図 : 1. モジュールを作成する 2 つの方法
      モジュールを作成するための 1 番目と 2 番目の方法を示す GIF
    2. [モジュール] 関連リストまで下にスクロールし、[新規] をクリックします。
    3. [モジュール] フォームのフィールドに入力して、モジュールを定義します。
      表 : 2. モジュールフォーム
      フィールド 説明
      タイトル モジュール名を定義します。モジュールを明確に識別するタイトルを選択します。
      アプリケーションメニュー モジュールが表示されるアプリケーションメニューの名前を指定します。
      ヒント ユーザーがモジュール名をポイントするときに表示されるツールヒントを定義します。
      注:
      モジュールヒントは コア UI で廃止されました
      順番 他のモジュールに関連してモジュールが表示される順序。
    4. [可視性] タブで、フィールドに入力します。
      表 : 3. [可視性] タブ
      フィールド 説明
      ロール モジュールのアクセスを指定されたロールに制限します。このフィールドを空白のままにすると、モジュールはアプリケーションメニューにアクセスできるすべてのユーザーに表示されます。
      有効 モジュールがアプリケーションナビゲーターに表示されるようにするかどうかを定義します。
      アプリケーションメニューロールを上書き 含まれているアプリケーションメニューを表示する権限がない場合でも、ユーザーにこのモジュールへのアクセスを許可します。ユーザーはこのモジュールのロール要件を満たしている必要があります。
    5. [リストタイプ] タブで、フィールドに入力します。

      表示されるフィールドは、選択した [リンクタイプ] によって異なります。すべてのモジュール URI をエンコードする必要があります。モジュール URI に引数を指定する場合は、ユーザー自身または ServiceNow のいずれかが指定します。モジュール URI をエンコードする方法の詳細については、「モジュール URI のエンコーディング」を参照してください。

      表 : 4. [リストタイプ] タブ
      フィールド 説明
      リンクタイプ このモジュールで開かれる関連付けのタイプを指定します。リンクタイプに基づいて追加情報を指定する必要があります。「モジュールのリンクタイプ」を参照してください。
      テーブル モジュールが使用するテーブルを指定します。
      注:
      このリストには、モジュールと同じスコープ内にあるテーブルビューとデータベースビューのみが表示されます。
      フィルター モジュールに表示されるアイテムの条件。たとえば、「アクティブ = true」などです。
      Argument モジュール URI を作成するために URI に追加される文字列。sysparm_query を指定できます。これらの値は、 ユーザー自身または ServiceNow がエンコードする必要があります。モジュール URI をエンコードする方法の詳細については、「モジュール URI のエンコーディング」を参照してください。
      順番 アプリケーションでモジュールが表示される順序を指定します。

    モジュールのリンクタイプ

    [モジュール] フォームの [リンクタイプ] フィールドは、モジュールが開くリンクのタイプを指定します。

    表 : 5. モジュールのリンクタイプ
    リンクタイプ 説明
    アセスメント [アセスメント] 参照フィールドで選択したアセスメントベースのサーベイへのリンク。「サーベイモジュールの作成」を参照してください。
    コンテンツページ [コンテンツページ] 参照フィールドで選択したコンテンツページを表示します。「コンテンツページの作成」を参照してください。
    ドキュメントリンク ドキュメントページにリンクし、新しいタブまたはウィンドウで開きます。このリンクタイプは、ドキュメントトピックの埋め込みメタデータとともに使用されます。モジュールから内部ドキュメントを開くには、[URL ([引数] から)] モジュールリンクタイプを使用します。
    ホームページ [ホームページ] 参照フィールドで選択したホームページが表示されます。
    HTML (引数から) アプリケーションナビゲーターに HTML を配置します。このリンクタイプは、フラット URL では十分にカスタマイズできない複雑なリンクに使用します。
    注:
    • [HTML ([引数] から)] リンクタイプは、従来の UI15 および UI11 インターフェイスでのみサポートされています。コア UI では、代わりに [URL ([引数] から)] リンクタイプを使用します。
    • [引数] フィールドに値を入力します。
    リストフィルター [テーブル] フィールドで選択したテーブルの未設定のリストビューを表示します。最初にリストをロードせずにユーザーがフィルターを指定できるようにします。[フィルター] フィールドを使用して、リストのデフォルトのフィルターを定義します。[ビュー名] フィールドを使用して、[ビュー管理] を指定します。
    レコードリスト [テーブル] フィールドで選択したテーブルのリストビューを表示します。[フィルター] フィールドを使用して、リストのデフォルトのフィルターを定義します。[ビュー名] フィールドを使用してビューを指定します。
    マップページ [マップページ] 参照フィールドで選択したマップページが表示されます。
    新規レコード [テーブル] フィールドで選択したテーブルにレコードを作成するためのフォームを表示します。
    レポートを実行 [レポート] フィールドで選択した保存済みレポートを実行します。
    スクリプト (引数から) [引数] フィールドで定義されているスクリプトを実行します。
    注:
    [引数] フィールドに値を入力します。
    検索画面 テーブル内のレコードを検索するための空白のフォームを表示するリンク。[ビュー名] フィールドを使用してビューを指定します。
    注:
    パラメーター &sysparm_result_view=view_name を使用して、結果がレンダリングされるビューを定義します。

    すべての検索では、[は次の値で始まる] クエリを使用して、一致するテキストを検索します。他のクエリタイプは検索画面ではサポートされていません。
    セパレーター モジュール間の分割を作成します。[タイトル] フィールドに名前を入力して、ユーザーが折りたたみまたは展開できるセクション名を追加します。
    単一レコード テーブル上の単一のレコードのフォームを表示します。[ビュー名] フィールドを使用してビューを指定します。
    サーベイ [サーベイ] 参照フィールドで選択した旧サーベイへのリンク。[サーベイの上書き] チェックボックスを使用して、サーベイを複数回実施できるかどうかを決定します。
    注:
    [サーベイ] リンクタイプは旧サーベイでのみ使用され、アセスメントベースのサーベイに置き換えられます。モジュールをアセスメントベースのサーベイにリンクするには、[アセスメント] リンクタイプを選択します。
    タイムラインページ [タイムラインページ] 参照フィールドで選択したタイムラインページが表示されます。「タイムラインページ」を参照してください。
    URL (引数から) [引数] フィールドで定義されている URL を開きます。

    オプション：[ウィンドウ名] フィールドを使用して、新しいウィンドウで開くリンクを定義します。

    注:
    • 内部リンクの場合は、./catalog_home.do?sysparm_view=catalog_default または catalog_home.do?sysparm_view=catalog_default などの相対リンクを常に使用します。ServiceNow インスタンスへの絶対リンクは使用しないでください。URL は引き続き開発インスタンスを参照しているため、更新セットを開発インスタンスから本番インスタンスに移動すると問題が発生します。
    • [引数] フィールドに値を入力します。

    モジュール URI のエンコーディング

    ナビゲーションペインでモジュール名をクリックすると、コンテンツペインでモジュールのページを開く URI が実行されます。モジュール URI のすべての文字を URL エンコードする必要があります。そうしないと、リンクは破損します。

    注:
    New York より前のリリースから New York リリース以降にアップグレードする場合に、このトピックに記載されている規則に従わないと、モジュール UI が破損する可能性があります。

    モジュールを作成するときは、コンテンツペインに表示される結果の数をソートしたり減らしたりする引数条件とフィルター条件を追加できます。でモジュール名をクリックすると システム定義 > アプリケーション定義の場合、これらの条件と引数は [ リンクの種類 ] タブで確認できます。

    [リンクタイプ] タブ

    [引数] の引数の定義と、[フィルター] で定義されたフィルター条件は、モジュールの URI の一部になり、URL エンコードする必要があります。ServiceNow はフィルター条件を自動的に URL エンコードし、sysparm_query を使用してモジュール URI に追加します。たとえば、フィルター条件「アクティブ = true」を追加すると、sysparm_query=active%3Dtrue がモジュールの URI に追加されます。%3D は、等号 (=) の URL エンコーディングです。

    次の表は、[引数] フィールドの引数を URL エンコードする必要がある場合と、ServiceNow で引数を URL エンコードする場合を示しています。

    表 : 6. 引数のエンコーディングのルール
    フィルター条件はありますか？ 次で始まる引数の定義 誰が引数をエンコードしますか？ 引数の処理方法
    なし ^

    ServiceNow

    		 引数からキャレット (^) を削除してエンコードし、sysparm_query を使用してモジュール URI に追加します。
    なし & あなた 引数からアンパサンド (&) を削除し、モジュール URI に追加します。
    なし その他 ServiceNow 引数をエンコードし、sysparm_query を使用してモジュール URI に追加します。
    あり ^ ServiceNow フィルター定義と引数を URL エンコードし、sysparm_query を使用して、この組み合わせをモジュール URI に追加します。
    あり その他 あなた フィルター定義を URL エンコードし、sysparm_query を使用して、それと (未変更の) 引数をモジュール URI に追加します。

    glide.ui.encode_module_uri プロパティを使用して、モジュール UI の URL エンコーディング要件をオン (デフォルト) またはオフにすることができます。

    例

    次の例は、[引数] の引数定義を URL エンコードする必要がある状況を示しています。
    • フィルター条件がなく、[引数] の引数定義がアンパサンドで始まる (&sysparm_fixed_query=assigned_to=javascript:gs.user_id() など)。

      等号とコロンが URL エンコードされておらず、アンパサンドによって ServiceNow が引数を URL エンコードできないため、この引数によりモジュール URI が破損します。引数を URL エンコードします： &sysparm_fixed_query=assigned_to%3Djavascript%3Ags.user_id()

    • フィルター条件があり、[引数] の引数定義がキャレット (^) で始まっていない (sysparm_name=Barnes & Noble's など)。

      アンパサンドとスペースが URL エンコードされていないため、この引数によりモジュール URI が破損します。引数を URL エンコードします： sysparm_name=Barnes%20%26%20Nobel

    モジュールの可視性

    アプリケーションナビゲーター (左側のナビゲーションバー) で選択されたモジュールの可視性または可視性の欠如を確認します。たとえば、まずユーザーの代理操作を実行してから、次に指定したモジュール (ホームページや自分の要求など) がそのユーザーに表示されているかまたは表示されていないかを確認するテストを作成します。

    表 : 7. 入力
    フィールド 説明
    実行順序 テストのこのステップの実行順序を指定する整数。

    ステップを作成すると、各ステップに増分値が自動的に割り当てられます。この値により、テストでは、ステップが作成された順に実行されます。このデフォルトを変更するには、[実行命令] 値を編集します。
    有効 このテストステップの使用をアクティブ化するオプション。
    アプリケーション システムがこのテストまたはテストスイートを実行するアプリケーションスコープ。
    テスト ステップを追加するテストの読み取り専用の名前。
    ステップ構成 ステップの読み取り専用の名前。
    説明 テストステップの説明。このフィールド値はテストステップのフィールド値に基づいて自動的に設定されます。このフィールドは、テストステップが送信された後に表示されます。
    メモ テストステップに関するメモ。
    ナビゲーター アサートするナビゲーターバージョン
    • コア UI (UI16)：新しいステップを作成する場合は、デフォルトで コア UI があります。
    • Next Experience： Next Experience が有効になっている場合、Next Experience がデフォルトのナビゲーターです。無効になっている場合、コア UI がデフォルトのナビゲーターです。
    表示されるアサーションタイプ [表示されるモジュール] フィールドで選択されたモジュールの可視性をアプリケーションナビゲーターでテストする方法を指定します。
    • 少なくともこれらのモジュールが表示されます：最小限でも、[表示されるモジュール] フィールドで選択されたモジュールがアプリケーションナビゲーターに表示されます。
    • これらのモジュールのみが表示されます：[表示されるモジュール] フィールドで選択された特定のモジュールのみがアプリケーションナビゲーターに表示されます。
    表示されるモジュール アプリケーションナビゲーターでの可視性が検証されているモジュール。
    表示されないアサーションタイプ [表示されないモジュール] フィールドで選択されたモジュールの可視性の欠如をアプリケーションナビゲーターでテストする方法を指定します。
    • 少なくともこれらのモジュールは表示されません：最小限でも、[表示されないモジュール] フィールドで選択されたモジュールはアプリケーションナビゲーターに表示されません。
    • これらのモジュールのみが表示されません：[表示されないモジュール] フィールドで選択された特定のモジュールのみがアプリケーションナビゲーターに表示されません。
    表示されないモジュール アプリケーションナビゲーターでの可視性の欠如が検証されているモジュール。

    モジュールに移動

    ユーザーがクリックしたかのように、アプリケーションナビゲーターからモジュールを開きます。モジュールに移動するには、現在実行中のユーザーにモジュールが表示されている必要があります。

    注:
    現在、テスト可能でないページがあります。モジュールからの移動先にかかわらず、自己責任で移動してください。
    表 : 8. 入力
    フィールド 説明
    実行順序 テストのこのステップの実行順序を指定する整数。

    ステップを作成すると、各ステップに増分値が自動的に割り当てられます。この値により、テストでは、ステップが作成された順に実行されます。このデフォルトを変更するには、[実行命令] 値を編集します。
    有効 このテストステップの使用をアクティブ化するオプション。
    タイムアウト ステップが失敗するまでの秒数。検証に失敗すると、タイムアウトの時間になるまでステップが繰り返されます。タイムアウト経過後に検証が失敗すると、ステップは失敗します。
    アプリケーション システムがこのステップを実行するアプリケーションスコープ。
    テスト ステップを追加するテストの読み取り専用の名前。
    ステップ構成 ステップの読み取り専用の名前。
    説明 テストステップの説明。このフィールド値はテストステップのフィールド値に基づいて自動的に設定されます。このフィールドは、テストステップが送信された後に表示されます。
    メモ テストステップに関するメモ。
    モジュール 開く必要があるモジュール。選択したモジュールに移動するには、アプリケーションナビゲーターで現在実行中のユーザーにモジュールが表示されている必要があります。
    次のモジュールは、サポートされていないため、テストできません。
    • セパレーターであるモジュール
    • 特定のページにリンクしない代わりにクライアント側の JavaScript を実行するモジュール (Studio やスクリプトデバッガーなど)
    • ServiceNow ドキュメントサイト (docs.servicenow.com) などの外部 Web サイトにリンクするモジュール
    • ページ全体を再ロードまたはリダイレクトするモジュール