プロンプト
ユーザーがテキストを入力するためのテキスト ボックスを表示し、ユーザーが入力したテキストを返します。
構文
プロンプト(メッセージ、選択リスト、フィールド領域の幅、フィールド領域の高さ、パスワード、必須、デフォルト値)有効
ビジネス オブジェクト カテゴリの説明については、「有効な対象」に関する注意事項 ( 「有効」に関する注意事項
ビジネスオブジェクトカテゴリ | はい/いいえ |
|---|---|
ビジネスルール: 保存前ルール | はい¹ |
ビジネス ルール: 計算ルール (保存後、ロード時に再計算の有無) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算なし) | はい¹ |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算) | はい |
ビジネスルール: ルールの編集 | はい² |
ビジネスルール: 初期化ルール | はい¹ |
ビジネスルール: 読み取り専用ルール | いいえ |
ビジネスルール: 必須ルール | はい² |
ビジネスルール: 検証ルール | はい¹ |
クライアントの表現 | いいえ |
オブジェクトの権限 | いいえ |
サービス | はい |
LDAP の | はい |
携帯 | はい |
クイックアクション(UI クイックアクションを除く) | はい¹ |
UI クイックアクション | いいえ |
レポート | はい¹ |
フィールド参照のない検索/ダッシュボード | はい¹ |
フィールド参照付き検索/ダッシュボード | いいえ |
1. サービスを除く。 | |
2. サービス内、およびこのフィールドがフォームに表示される場合、またはこのようなフィールドによってトリガーされる場合を除きます。 | |
パラメータ
この関数は少なくとも 1 つのパラメータを取り、最大 7 つのパラメータを取ることができます。 前のパラメータの値を入力せずにパラメータを入力するには、値がないパラメータに「」と入力します。 たとえば、 message、 pickList、および fieldAreaHeight パラメータを入力し、 fieldAreaWidth パラメータを入力しない場合は、 $(Prompt(message, pickList, "", 25))と入力します。 この例では、アプリケーションは fieldAreaHeight パラメータの値として 25 を使用し、 fieldAreaWidth パラメータの値としては使用しません。
パラメータ | 説明 |
|---|---|
メッセージ | プロンプトとして表示されるメッセージ。 |
ピックリスト | (オプション) ユーザーが選択できる値を提供する選択リストの名前。 このパラメータが null または空の場合、関数はリストを指定せず、代わりにテキスト ボックスを表示します。 |
フィールドエリア幅 | (オプション) テキスト領域の幅(ピクセル単位)。 |
フィールド領域の高さ | (オプション) テキスト領域の高さ(ピクセル単位)。 |
パスワード | (オプション) true または false のいずれかになります。 true の場合、アプリケーションは入力されたテキストをパスワードとして扱い、入力時にアスタリスクとして表示します。 |
必須 | (オプション) true または false のいずれかになります。 true の場合、ユーザーは値を入力または選択する必要があります。 |
デフォルト値 | (オプション) ユーザーが何も入力しなかったり値を選択しなかったりした場合に返されるテキスト値。 |
戻り値
テキスト値。
例
以下は、クイックアクションでこの機能を使用する例です。
$(Prompt("Select Cause Code", "Incident Cause Code", 400, 200, false, true))この例では、アプリケーションがユーザーに必要な値の入力を求めるため、 required パラメータは true に設定されています。 これは、クイックアクションが実行される前に、ユーザーが適切な値を具体的に選択していることを確認するためです。 この例では、デフォルト値が提供されていないため、 defaultValue パラメータはなく、したがって関数には 6 つのパラメータのみがあります。
インシデントの「 オブジェクトの更新 」クイック アクションの「 解決 」フィールドに次の式を追加します。
$(Prompt("Please enter resolution", "", 400, 200))これにより、幅 400 ピクセル、高さ 200 ピクセルの空のテキスト領域を含む解決メモのプロンプトが返されます。
もう 1 つの例は、ソーシャル ボードでクイック アクションによってビジネス オブジェクトが作成される場合です。
$(Prompt("Summary", "", 350, 25, "", "", "_ConversationTitle_"))
$(Prompt("Description", "", 400, 200, "", "", "_ConversationContent_"))まず、元の投稿は 概要 フィールドに含まれます。 2 番目の例では、元の投稿とコメントが 説明 フィールドに含まれています。
また、保存した検索でこの機能を使用して、検索の実行時に従業員チームにプロンプトを表示することもできます。
オブジェクトの更新 クイック アクションのコンテキストで Prompt() 関数を使用して、ユーザーにビジネス オブジェクト内のフィールドの値を入力するように要求できます。 これは通常、基になるフィールドも検証される場合に使用されます。
$(Prompt(TitleInPrompt, ""))
$(Prompt(TitleInPrompt, NamedValidationList))Prompt() 関数には 2 つのバリエーションがあります。
2 番目のパラメータが空の文字列の場合、フィールドに任意の値を入力できます。
2 番目のパラメータがテキスト値の場合、アプリケーションはこの値が名前付き検証リストであると想定し、それを使用してフィールドに入力できる許容値を制限します。
次の Prompt() 関数は、インシデントのオーナー チームを更新します。
$(Prompt("Incident Owner Team", "Team of StandardUserTeam used in Incident"))次の例は、インシデントの既存の オーナー チームの再割り当て クイック アクションの構文を示しています。
クイックアクションの例で値の入力を求める

