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

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

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

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

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

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

始める前に

必要なロール：admin

このタスクについて

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

手順

次のように移動する。 All (すべて) > システム定義 > アプリケーションメニュー.
[New] をクリックします。

フォームに入力します。


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

注:

すべてのフィールドが表示されるようにフォームを設定する必要がある場合があります。

[送信] をクリックします。
アプリケーションメニューに表示されるモジュールを作成します。
モジュールを含むアプリケーションメニューのみがアプリケーションナビゲーターに表示されます。

モジュールの作成

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

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

始める前に

必要なロール：admin

手順

次のいずれかの方法を使用して、アプリケーションメニューレコードを開きます。
- 次のように移動する。システム定義 > アプリケーションメニューをクリックし、リストからアプリケーションメニューを選択します。
- アプリケーションメニューをポイントし、[アプリケーションの編集] (鉛筆) アイコンをクリックします。
図 : 1. モジュールを作成する 2 つの方法
[モジュール] 関連リストまで下にスクロールし、[新規] をクリックします。

[モジュール] フォームのフィールドに入力して、モジュールを定義します。

表 : 2. モジュールフォーム
フィールド	説明
タイトル	モジュール名を定義します。モジュールを明確に識別するタイトルを選択します。
アプリケーションメニュー	モジュールが表示されるアプリケーションメニューの名前を指定します。
ヒント	ユーザーがモジュール名をポイントするときに表示されるツールヒントを定義します。注: モジュールヒントはコア UI で廃止されました
順番	他のモジュールに関連してモジュールが表示される順序。

[可視化] タブで、フィールドに入力します。

表 : 3. [可視化] タブ
フィールド	説明
ロール	モジュールのアクセスを指定されたロールに制限します。このフィールドを空白のままにすると、モジュールはアプリケーションメニューにアクセスできるすべてのユーザーに表示されます。
有効	モジュールがアプリケーションナビゲーターに表示されるようにするかどうかを定義します。
アプリケーションメニューロールを上書き	含まれているアプリケーションメニューを表示する権限がない場合でも、ユーザーにこのモジュールへのアクセスを許可します。ユーザーはこのモジュールのロール要件を満たしている必要があります。

[リストタイプ] タブで、フィールドに入力します。

表示されるフィールドは、選択した [リンクタイプ] によって異なります。すべてのモジュール 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 があります。ネクストエクスペリエンス：ネクストエクスペリエンスが有効になっている場合、ネクストエクスペリエンスがデフォルトのナビゲーターです。無効になっている場合、コア UI がデフォルトのナビゲーターです。
表示されるアサーションタイプ	[表示されるモジュール] フィールドで選択されたモジュールの可視化をアプリケーションナビゲーターでテストする方法を指定します。少なくともこれらのモジュールが表示されます：最小限でも、[表示されるモジュール] フィールドで選択されたモジュールがアプリケーションナビゲーターに表示されます。これらのモジュールのみが表示されます：[表示されるモジュール] フィールドで選択された特定のモジュールのみがアプリケーションナビゲーターに表示されます。
表示されるモジュール	アプリケーションナビゲーターでの可視化が検証されているモジュール。
表示されないアサーションタイプ	[表示されないモジュール] フィールドで選択されたモジュールの可視化の欠如をアプリケーションナビゲーターでテストする方法を指定します。少なくともこれらのモジュールは表示されません：最小限でも、[表示されないモジュール] フィールドで選択されたモジュールはアプリケーションナビゲーターに表示されません。これらのモジュールのみが表示されません：[表示されないモジュール] フィールドで選択された特定のモジュールのみがアプリケーションナビゲーターに表示されません。
表示されないモジュール	アプリケーションナビゲーターでの可視化の欠如が検証されているモジュール。

モジュールに移動

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

注:

現在、テスト可能でないページがあります。モジュールからの移動先にかかわらず、自己責任で移動してください。

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