サービスカタログ変数のタイプ

各変数タイプの詳細については、次のセクションを参照してください。変数の作成の詳細については、「サービスカタログ変数の作成」を参照してください。サービスカタログ変数のヘルプテキストを表示することもできます。ヘルプ情報の定義の詳細については、「サービスカタログ変数のヘルプ情報を定義する」を参照してください。

さまざまなチャネルでのサポート

サービスカタログ変数はさまざまなチャネルでサポートされています。可用性については「さまざまなチャネルでの変数サポート」を参照してください。

添付ファイル

カタログアイテム要求を送信する際に、この変数によってアイテムの質問の添付ファイルをアップロードできます。添付ファイルをアップロードした後で、そのファイルをダウンロード、更新、削除できます。要求を実行する場合でも、要求されたアイテムまたはカタログタスクの添付ファイルをダウンロード、更新、削除できます。max_file_size と allowed_extensions の変数属性を使用して、ファイルサイズと拡張子の制限を指定できます。これらの変数属性については、「サービスカタログ変数の属性」を参照してください。

重要:

以下には整数値のみを指定する必要があります。
- max_file_size 変数属性
- glide.sc.variable.attachment.default_max_size システムプロパティ (catalog-level)。デフォルト値は 20 です。
max_file_size 変数属性が指定されていない場合は、glide.sc.variable.attachment.default_max_size システムプロパティ値が添付ファイルサイズの上限と見なされます。
変数で許可されているファイルサイズに関係なく、添付ファイルのサイズは com.glide.attachment.max_size システムプロパティで指定されているサイズを超えられません。これは Now Platform 全体の添付ファイルに適用されます。
g_form.setValue() API は、カタログクライアントスクリプトでサポートされています。

注:

添付ファイルを編集すると、既存の添付ファイルが削除されて新しい添付ファイルがアップロードされます。

この変数に添付ファイルをアップロードすると、添付ファイル [sys_attachment] テーブルにエントリーが作成されます。アイテム要求を送信、買い物かごに追加、または (履行者フローで) 編集中にレコードを保存するまで、変数は更新されません。対応するカタログアイテムを送信する前に添付ファイルを削除または更新すると、添付ファイル [sys_attachment] テーブルのエントリーが消去されます。

この変数に対してアップロードされた添付ファイルは、次のシナリオでコピーされます。

注文ガイドで、変数がルールベースのカタログアイテムにカスケードされるとき
重要:
個々の変数属性は、ルールベースのカタログアイテムでは優先されません。たとえば [ニーズを説明] セクションの変数には .pdf 添付ファイルが、ルールベースのカタログアイテムの変数には .txt 添付ファイルが許可されているとします。[ニーズを説明] セクションで、ある変数に対して .pdf タイプの添付ファイルをアップロードすると、最初はカタログアイテムの変数にもカスケードされ、カタログアイテムで指定された変数属性は優先されません。ただし、最初にカスケードされたこの添付ファイルを個々のアイテムから削除して新しい添付ファイルをアップロードしようとすると、カタログアイテムの個々の変数属性が優先されます。
レコードプロデューサーで、変数がタスクテーブルフィールドにマッピングされるとき。この変数は、タスクテーブルの [ファイルの添付] フィールドタイプにのみマッピングできます。

重要:

添付ファイルのコピー後は、個々の添付ファイルに対する変更は独立しています。たとえば、注文ガイドの添付ファイルに対する変更は、ルールベースのカタログアイテムにカスケードされた同じ添付ファイルには影響しません。

警告:

添付ファイルはコピーされるため、サイズが大きくなるとパフォーマンスの問題が発生する可能性があります。

システム全体のウイルス対策チェックが有効になっている場合は、次の場合に添付ファイルに対してウイルス対策チェックが実行されます。

対応するカタログアイテムに対する要求を送信する
カタログアイテムを買い物かごまたはウィッシュリストに追加する

注:

複数行の変数セットでは、この変数はサポートされていません。
この変数はフローとワークフローでサポートされています。
この変数は条件ビルダーで利用できます。
この変数では、注文ガイドでのアイテム変数の割り当てはサポートされていません。

ブレーク

ブレーク変数はフォーム全体に横線を表示します。この行は、データを収集しない書式設定要素です。

チェックボックス

チェックボックス変数を使用すると、オプションをオンまたはオフにすることで有効または無効にできます。

必須のチェックボックスを作成するには、変数を作成するときに [選択する必要があります] オプションを選択します。たとえば、このオプションを使用して、ユーザーが合意フォームの [同意する] チェックボックスをオンにするように要求します。ユーザーがチェックボックスを選択せずに契約フォームを送信しようとすると、チェックボックスをオンにする必要があることをユーザーに伝える警告メッセージが表示されます。

連続したチェックボックス変数を作成すると、チェックボックス変数のグループが作成されます。これらのチェックボックス変数は、グループ内の順序によってソートされます。チェックボックスのグループにカスタムラベルを定義する場合は、連続的したチェックボックス変数の開始位置でラベル変数を作成します。ラベルはこのグループの一部と見なされ、グループのラベルとして機能します。カスタムラベルがない場合、チェックボックスは [オプション] ラベルの下でアプリケーションごとにグループ化されます。

チェックボックス変数のグループで：

グループ内のいずれかのチェックボックス変数が必須の場合は、必須チェックボックス変数が表示されるかどうかに関係なく、グループ全体が必須になります。グループラベルの横にアスタリスク (*) が表示され、これらのチェックボックスの少なくとも 1 つをオンにする必要があります。
ラベルを非表示にすると、グループ全体が非表示になります。
必須チェックボックスグループの他のすべてのチェックボックス変数が非表示になっていて選択されない場合は、以下のシナリオが適用されます。
- グループに、表示されていてオフのチェックボックスが 1 つある限り、グループは必須のままです。
- このグループの最後のチェックボックスは、オフの場合は非表示にできません。

Service Portal でチェックボックス変数のグループを必須にするには、少なくとも 1 つのチェックボックス変数を必須として設定します。チェックボックスのグループのラベルを定義する際にラベルを必須に設定しても、チェックボックス変数のグループは必須になりません。

カタログビルダーでは、次のシナリオが適用されます。

2 つ連続するチェックボックスがある場合は、チェックボックスのグループに対して仮想コンテナが作成されます。グループに追加できるのはチェックボックス変数タイプのみです。
チェックボックスのグループの直後にチェックボックス変数が追加された場合でも、グループに自動で追加されます。

[タイプ仕様] タブで、異なる通貨タイプで価格を指定することができます。また、次の価格設定モデルで価格を設定することもできます。

計算済み
固定
複数

価格設定モデルの詳細については、「価格フィールド」を参照してください。

チェックボックス変数の詳細については、次のビデオを参照してください。

コンテナ開始、コンテナ分割、コンテナ終了

コンテナ開始、コンテナ分割、およびコンテナ終了の変数は、多くの変数を保持できるようにコンテナのレイアウトを定義します。コンテナ開始とコンテナ終了の変数を使用して、コンテナレイアウトの開始点と終了点を定義します。コンテナ終了は、コンテナを閉じるためにコンテナ開始とともに使用する必要があります。

コンテナレイアウトは、コンテナ分割変数を使用して 2 つまたは 3 つの列に分割できます。デフォルトでは、分割は 50％マークで計算されます。

コンテナは変数セットに似ています。変数セットとは異なり、コンテナは変数セット内を含むどこでも使用することができます。また、コンテナは相互にネストすることもできます。

適切なコンテナタイプの選択に関する詳細については、HI ナレッジベースで「適切なコンテナ変数を使用するかどうかを判断する [KB0539982]」を参照してください。

注:

コンテナ変数はモバイル端末ではまだサポートされていません。
コンテナ開始、コンテナ分割、およびコンテナ終了の変数は、サービスポータルでサポートされています。ただし、最上位のコンテナで設定が完了している場合は、レイアウトを最大 2 列に設定できます。
また、変数セットもコンテナと見なされます。そのため、変数セット下に 2 列のレイアウトが設定されたコンテナ開始変数は、サービスポータルではサポートされていません。

次の図に示すコンテナを再現するには、コンテナ開始変数を作成する場合に次の設定を入力します。

[2 列幅、両側交互] の [レイアウト] を選択します。
折りたたみ可能なタイトルバーを使用するには、[タイトル表示] チェックボックスをオンにします。

日付

日付変数により、日付を選択するためのフィールドとカレンダーを持つウィジェットが作成されます。

日時

日時変数により、日時を選択するためのカレンダーとフィールドを持つウィジェットが作成されます。時刻の値はグリニッジ標準時 (GMT) で保存され、ユーザーのタイムゾーンで表示されます。

期間

期間変数を使用して、カタログアイテムが使用可能な期間を指定します。

この変数がサポートする属性については、変数の属性を参照してください。

注:

変数のデフォルト値を設定し、g_form.getValue() と g_form.setValue() 関数で指定する場合は、期間を DD HH:MM:SS 形式で入力します。

メール

メール変数により、メールアドレスを入力および選択するためのウィジェットが作成されます。この変数は、@ およびドメイン情報を含む有効なメール式だけを受け入れます。

注:

変数の妥当性確認は、サービスポータルではサポートされていません。

HTML

HTML 変数を使用すると、カタログアイテムのコンテンツ (画像を含む) を詳細フォーマットで表示できます。

この変数を使用して、ユーザー入力用のフィールドを作成します。また、契約条件など、変数セットに入力すると、再利用可能なコンテンツの変数を使用することもできます。

この変数は、編集と読み取り専用の 2 つのモードで使用できます。編集モードでは、ツールバーを使用できますが、リンクは機能しません。read-onlyモードでは、ツールバーは無効になりますが、リンクは機能します。モードを切り替えるには、資格付与を使用するか、UI ポリシーを作成して、HTML フィールドを読み取り専用モードに設定します。

注:

HTML 変数は、買い物かごのサマリー画面または承認サマリー画面には表示されません。

IP アドレス

IP アドレス変数を使用して、カタログアイテムの IPv4 および IPv6 データを指定します。サブモジュール下では、この変数に関連付けられた妥当性確認スクリプトタイプを使用できます。

注:

変数の妥当性確認は、サービスポータルではサポートされていません。
[IP アドレス] 変数のデフォルト値を設定する場合、または g_form.getValue() と g_form.setValue() の関数のデフォルト値を指定する場合、区切り文字は (.) です。

IP アドレス変数のスクリーンショット — 図 : 10. 例：IP アドレス変数

ラベル

ラベル変数はフォーム全体にラベルを表示します。ラベルは書式設定要素です。データは収集されません。

ラベルを使用して質問をセクションに配置することができます。また、複数のオプションを使用して質問にラベルを使用することもできます。たとえば、質問のさまざまなオプションのチェックボックスにラベルを付けます。

ラベル変数を必須として設定することはできません。ただし、ラベル変数に続くチェックボックス変数のグループを必須にすることができます。

リストコレクター

リストコレクター変数は、ユーザーがテーブルから複数のレコードを選択して追加できるインターフェイスを作成します。この変数がサポートする属性については、変数の属性を参照してください。

リストコレクター変数の使用の詳細については、次のビデオを参照してください。

注:

参照修飾子および glide_list 属性は、Helsinki 以降のリリースにのみ適用されます。この属性は Geneva には適用されません。
カタログのクライアントスクリプトで g_form.setValue() 関数を使用すると、この変数に値を設定できます。
glide_list 属性が true でないとき、設定できるのは、g_form.setValue() 関数を使用した [利用可能] リストに表示される値のみです。この機能は、setValue() 関数が onLoad で呼び出された場合は適用されません。
大量のデータを含むテーブルでは、ページのロード時にパフォーマンスの問題が発生します。参照修飾子を使用してデータを減らすか、glide_list 属性を使用します。
ユーザーがログインしていない場合、参照先テーブルの値は表示されません。
リストコレクターは、リスト内に最大 100 個のアイテムを表示します。アイテムを [選択済み (Selected)] リストに移動した後、[フィルター実行] をクリックして [利用可能] リストを更新することができます。このアクションにより、最大 100 個の使用可能なアイテムをリストに追加できます。

複数選択肢をルックアップ

「複数選択肢をルックアップ」変数は、テーブルのデータを使用してラジオボタンを作成します。その機能は、クエリーされるデータから選択リストを作成する、「選択ボックスをルックアップ」変数に似ています。この変数がサポートする属性については、変数の属性を参照してください。

注:

大量のデータを含むテーブルでは、ページのロード時にパフォーマンスの問題が発生します。参照修飾子を使用してデータを減らすか、参照タイプ変数を使用します。
10,000 を超えて選択肢を追加することはできません。

選択ボックスをルックアップ

「選択ボックスをルックアップ」変数は、テーブルからクエリーされたデータを使用して選択リストを作成します。その機能は、クエリーされるデータからラジオボタンを作成する、「複数選択肢をルックアップ」変数に似ています。この変数がサポートする属性については、変数の属性を参照してください。

次の図に示すような「選択ボックスをルックアップ」を作成するには、変数の作成時に次の値を入力します。

テーブルからルックアップ：Incident [incident]
値フィールドをルックアップ：Sys ID
ラベルフィールドをルックアップ：番号、カテゴリ、優先度
参照修飾子：caller_id=javascript:gs.getUserID()^active=true

注:

大量のデータを含むテーブルでは、ページのロード時にパフォーマンスの問題が発生します。参照修飾子を使用してデータを減らすか、参照タイプ変数を使用します。
10,000 を超えて選択肢を追加することはできません。

カスタム

この変数は、UI マクロをカタログアイテムに挿入します。

サービスカタログの UI マクロはクリックスルー、スラッシュバケット編集、メールフィールドの glide_list 関数をサポートしていません。

フェーズ 1 Jelly は、変数として追加された UI マクロにのみ使用します。マクロ内のフェーズ 2 Jelly は処理されず、標準コンテンツとしてページに表示されます。
この変数は、クラシックモバイルデバイスではまだサポートされていません。
この変数は、ウィジェットを介してサービスポータルでサポートされています。マクロと同じ機能を持つウィジェットを作成し、このウィジェットと変数をリンクします。

ラベル付きカスタム

この変数は、ラベル付きの UI マクロを挿入します。

この変数は、クラシックモバイルデバイスではまだサポートされていません。
この変数は、ウィジェットを介してサービスポータルでサポートされています。ラベル付きマクロと同じ機能のウィジェットを作成し、このウィジェットと変数をリンクします。

マスク済み

マスク済み変数は、入力したテキストをマスクするフィールドを挿入します。入力した各文字は、アスタリスク (*) として表示されます。この変数を使用すると、ユーザーにパスワードなどの機密データを要求できます。

[暗号化を使用] チェックボックスをオンにすると、データベースに格納する前にさまざまな暗号化アルゴリズムを使用して値を暗号化するように、変数を設定できます。RITM、カタログタスク、またはレコードプロデューサーを使用して作成されたタスク拡張レコードで now_GR.variables.var_name.getDecryptedValue() を使用してのみ、これらの値を復号化できます。

注:

デフォルトでは、[暗号化を使用] フィールドは true に設定され、情報を安全に保存できます。

変数エディターで [表示] および [非表示] ボタンを使用して、マスク済み変数の値を復号化および暗号化することもできます。これらのボタンは、catalog_view_masked ロールを持たない履行者 (itil) では使用できません。要求時に指定した値のみを表示できます。

表 : 1. 暗号化された変数に対するアクション
アクション	ロール
アクション	要求者	catalog_view_masked ロールを持つ履行者	catalog_view_masked ロールを持たない履行者
カタログフォームで暗号化された値を表示または非表示にする	はい	適用外	適用外
カタログフォームで暗号化された値を編集する	はい	適用外	適用外
変数エディターで暗号化された値を表示または非表示にする	はい	はい	いいえ
変数エディターで暗号化された値を編集する	はい注: マスク済み変数が変数エディターで読み取り専用である場合、変数値は編集できません	はい注: マスク済み変数が変数エディターで読み取り専用である場合、変数値は編集できません	いいえ

複数行テキスト

multi-lineテキスト変数は、複数行テキストを入力できるフィールドを作成します。

複数選択肢

複数選択肢変数は、質問の選択肢のラジオボタンを作成します。

数値スケール

数値スケール変数は、リッカート尺度のような一連のオプションのラジオボタンセットを作成します。

参照

参照変数は、別のテーブルのレコードを参照します。たとえば、point_of_contact という名前の変数は、User [sys_user] テーブルを参照します。この変数がサポートする属性については、変数の属性を参照してください。

参照変数を作成する場合は、次の情報を覚えておいてください。

参照変数は、オートコンプリート機能を使用します。選択するための十分な情報がユーザーに提供されるように、参照ルックアップリストを設定します。
参照変数には、選択したレコードの sys_id (参照フィールドなど) が格納されます。スクリプトで表示値を使用するには、参照フィールドと同じ方法を使用します。

current.variables.<variable name>.getDisplayValue()

要求元

カタログアイテム要求を送信する前に、この変数はこの要求の送信先ユーザーを指定する際に役立ちます。カタログアイテムの質問に回答するときに、この情報を指定する必要があります。

重要:

ユーザーを指定できるのはユーザー [sys_user] テーブルからのみです。
この変数のデフォルト値を指定しない場合は、アイテムを要求している現在ログイン中のユーザーがデフォルトの要求元変数の値と見なされます。
カタログアイテムに対するアクセスに基づいて、ユーザーへの要求を送信できます。カタログアイテムの [アクセスタイプ] フィールド。このフィールドを使用すると、カタログアイテムへのアクセス権を持たないユーザーに対して要求を送信できるかどうかを指定できます。
この変数では、注文ガイドのルールベースでのアイテム変数の割り当てはサポートされていません。注文ガイドに要求元変数が含まれている場合、値はルールベース内のアイテムの同等の変数に読み取り専用としてカスケードされます。

要求元変数の [追加要求の有効化] フィールドを使用すると、1 つの要求で複数のユーザーにカタログアイテムを要求できます。

委任された要求エクスペリエンスについては、「委任された要求エクスペリエンス」を参照してください。

重要:

この変数をカタログアイテムまたは変数セットに追加できます。ただし、要求を送信する際は、カタログアイテムに指定できる要求元変数は 1 つのみです。
変数セットに追加できる要求元変数は 1 つのみです。
複数行の変数セットでは、この変数はサポートされていません。
要求が送信されると、この変数値は変数エディターと変数サマライザーに表示できます。

リッチテキストラベル

この変数は、カタログアイテムフォームに書式設定されたラベルを表示します。TinyMCE リッチテキストエディターでは、ラベルを書式設定して画像やリンクを追加できます。この変数は HTML タグをサポートしています。

注:

カタログクライアントスクリプトやカタログ UI ポリシーを使用して、この変数を表示できます。
この変数は注文ガイドにカスケードできません。
この変数は必須に設定できません。
Automated Test Framework では、この変数は可視性を確認するための変数ステータスの検証ステップでのみサポートされています。
この変数は、以下ではサポートされていません。
- 変数サマライザー
- 複数行の変数セット
- 条件ビルダーとレポート
この変数に以下は指定できません。
- ヘルプテキストと手順
- ツールヒント
- 権限
- 変数の幅
- サンプルテキスト
g_form.setValue()、g_form.setReadOnly()、g_form.setMandatory() API は、カタログクライアントスクリプトではサポートされていません。g_form.setVisible() API のみがサポートされています。