テキスト入力スクリプトコンポーネント


テキスト入力コンポーネントは、エージェントにテキスト入力を要求し、テキストを検証できます。テキスト入力コンポーネントの値を変数にバインドできます。

  1. コンポーネントツールバーの[入力]アイコンをクリックします。 

  2. プロパティパネルで、 プレースホルダー 読者に入力する内容を指示するプロンプトをコントロールに事前入力するためのボックス。変数にプレースホルダーテキストが格納されることはありません。プレースホルダーテキストは、エージェントに指示する一時的なテキストであり、 ユーザー入力によって自動的に置き換えられます。例えば:

    プレースホルダーテキストの例

    フィールドに変数の値を事前に入力できます。そのためには、コンポーネントプロパティの[値]リストから変数を選択します。値は、実行時にユーザー自動的に表示されます。変数の値は、 ユーザーが入力したテキストで自動的に更新され、オプションの検証が行われます。

  3. ユーザー入力を検証するには、 一般 グループ。次に 検証 リスト。

    text_input_validation_drop_list2

  4. 選ぶ 選択する または カスタム 検証方法を選択します。

    選択する プリセットの検証パターンを選択できます。検証プリセットは次のとおりです。

    Eメール 入力は電子メールアドレスの構文に準拠する必要があります。
    アルファベット アルファベット入力のみを許可します(数字は不可)。
    アルファベット–スペースあり アルファベット入力のみを許可し、単語間にスペースが必要です。たとえば、「cool beans」は受け入れられますが、「cool_beans」は受け入れられません。
    アルファベット–アンダースコア付き アルファベット入力のみ(数字なし)と単語間のアンダースコアが必要です。たとえば、「cool_beans」は受け入れられますが、「cool bean」は受け入れられません。
    英数字 テキスト入力には文字と数字の両方を含める必要があります。
    英数字–スペースあり テキスト入力には、スペースで区切られた単語を含む文字と数字の両方が含まれている必要があります。
    英数字-アンダースコア付き テキスト入力には、アンダースコアで区切られた単語を含む文字と数字の両方が含まれている必要があります。

    パッケージ済みの検証では不十分な場合は、 正規表現を使用してテキスト入力を検証できます。選択する カスタム から 検証 リスト。次に、テキストボックスに正規表現を入力します。正規表現は、このトピックの範囲を超えています。しかし、たとえば、 ユーザーテキスト入力内のどこかに「dog」というフレーズを入力させたいとします。タイピング カスタム検証プロパティで、dog、sundog、hotdog、my good dog Penny、または大文字小文字を区別する文字列を含むがDOG Doggieなどを含まない文字のその他の組み合わせを受け入れる単純な正規表現を設定します。

    別の例は ^ [az] + $ 小文字のアルファベット文字のみを受け入れます。

    先端:インターネットは、正規表現について学ぶための多くのリソースを提供しています。例は http ://www.regular-expressions.info/ そして https ://en.wikipedia.org/ ?title=Regular_expression

    フォーカスがテキストボックスを離れると、テキスト入力コンポーネントの値が検証され、選択した検証ルールに準拠していることが確認されます。ユーザー入力が検証に合格しなかった場合、境界線は検証の問題を示すために赤に変わります。エディターのプレビューモードでカスタムおよび事前パッケージ化された検証をテストできます。

    無効なテキスト入力エントリ

  5. をセットする 価値が必要 ユーザーがコンポーネントに値を入力する必要がある場合は、はいに切り替えます。この設定はデフォルトは「いいえ」です。つまり、 ユーザー入力はオプションです。

  6. アクションを設定するには、をクリックします アクションが選択されていません 未満 アクションを変更 [詳細設定]プロパティグループ。

  7. アクションを選択するには、リスト内の行をクリックします。以前に定義したアクションを割り当てるか、新しいアクションを作成できます。

  8. [アクションの選択]リストを閉じます。

  9. オプションで、このコンポーネントの他のプロパティを設定します。たとえば、マージン設定を使用して、このコンポーネントの周囲の間隔を調整できます。

    一般



    値は、選択した変数にコンポーネントをバインドします。例えば、テキスト入力コンポーネントを変数にバインドすると、入力ボックスには常にその変数の値が表示され、指定したプレースホルダー テキストは無視されます。変数はユーザーが入力したテキストで自動的に更新されます。ただし、検証処理の対象となります。

    その他のコントロール、ラジオボタンなど、選択した値テキスト設定で値を使用します。{"error" :{"code" :400000,"message" :"One of the request inputs is not valid."}} これにより、各ラジオ ボタンは同じ変数に別の値を割り当てることができます。

    カレンダコントロールが変数にバインドされている場合、その値はコントロールによって選択された日付に設定されます。変数は視覚コントロールの値をプリセットしたり、コントロールにより設定できるため、バインドは頻繁に使用される強力な方法です。




    プレースホルダーテキストはにヒントを表示するユーザー 。

    プレースホルダープロパティの例

    テキスト入力のために、プレースホルダテキストがまで示されているユーザータイプ入力。ユーザー入力ボックスの内容をクリアすると、プレースホルダーテキストが再表示されます。

    プレースホルダーの表示例

    ドロップダウンの場合、プレースホルダーテキストはユーザー選択を促します。

    図は、ドロップダウンから選択が行われる前のプレースホルダーテキストを示しています

    後にプレースホルダが交換されるユーザーの項目を選択します。

    選択によるプレースホルダー置換

    ヒント: コンポーネントが変数にバインドされている場合、手動で入力したプレースホルダーテキストは無視されます。変数が選択されている場合、その値は常に表示されます。



    検証により、エージェントが入力したテキストが適切にフォーマットされていることが確認されます。フォーカスが離れるとき テキスト入力 ボックスでは、その値がテストされ、選択した検証ルールに準拠していることが確認されます。ユーザー入力が検証に合格しなかった場合、ボーダーは赤に変わり、入力されたものに検証の問題があることを示します。

    ドロップリストを使用して、検証方法を選択します。

    検証方法の選択

    • 選択する-事前設定された検証パターンを選択できます。

      Eメール 入力は電子メールアドレスの構文に準拠する必要があります。
      アルファベット アルファベット入力のみを許可(数字は不可)
      アルファベット-スペースあり アルファベット入力のみを許可し、単語間にスペースが必要です。たとえば、「cool beans」は受け入れられますが、「cool_beans」は受け入れられません。
      アルファベット-アンダースコア付き アルファベット入力のみ(数字なし)と単語間のアンダースコアが必要です。たとえば、「cool_beans」は受け入れられますが、「cool bean」は受け入れられません。
      英数字 テキスト入力には文字と数字の両方を含める必要があります。
      英数字-スペースあり テキスト入力には、スペースで区切られた単語を含む文字と数字の両方が含まれている必要があります。
      英数字-アンダースコア付き テキスト入力には、アンダースコアで区切られた単語を含む文字と数字の両方が含まれている必要があります。
    • カスタム-文字列変数を選択できます。たとえば、文字列変数を正規表現にし、その変数を複数のページで使用して、検証を同じに保つことができます。




    ユーザーが値を入力または選択する必要があるかどうかを指定します。既定値は No で、ユーザーの操作は省略可能です。

    ユーザインタフェースは、ユーザ入力がオプションであるかどうかを視覚的に示します。

     

    オプションの入力は、コンポーネントの下のラベルで示されます。

    要求-値-false




    テキスト入力 ボックスはデフォルト単一の回線をサポートします。MultilineがNo( デフォルト設定されている場合、テキスト入力はテキストをラップしたり、垂直方向にサイズを変更したりしません。

    multiline-false

    [マルチライン]が[いいえ]に設定されている場合、このアイコンをクリックして、以前に入力したテキストをクリアできます。

    multiline-false-clear-button

    MultilineをYesに設定すると、テキスト入力は複数行のテキストを受け入れます。

    複数行真



    レイアウト



    サイズ調整に影響する重み付けを使用して、幅を固定サイズに設定し、コンテンツを表示するために必要に応じて拡大したり、他のコンポーネントに比べてできるだけ多くのスペースを消費したりします。

    設定 説明
    settings-sizing-auto-size 自動サイズ設定は、コンポーネントをその内容に従って縮小または拡大するように設定します。例えば、ラベルの幅はテキストの量に応じて拡大することができます。
    settings-sizing-stretch

    ストレッチでは、サイズ調整に影響を与えるために重み付けを使用して、コンポーネントが他のコンポーネントに比べてできるだけ多くのスペースを消費することができます。

    2つのコンポーネントが両方とも伸縮するように設定されている場合、デフォルトで残りのスペースの50%が割り当てられます。この比率は、重量値を変更することによって調整できます。

    たとえば、1つのコンポーネントを200の重みに設定し、もう1つのコンポーネントを100の重みに設定すると、最初のコンポーネントは残りのスペースの3分の2を占め、もう1つは3分の1しかかかりません。最初のコンポーネントは、その重量が2番目のコンポーネントの重量の2倍であるため、他のコンポーネントのサイズの2倍になります。

    settings-sizing-pixels 固定サイズをピクセル単位で設定します。ボックスに整数を入力するか、上向き矢印か下向き矢印を使ってサイズを増加または減少します。コンポーネントにフォーカスがあると、これらの矢印が表示されます。



    サイズ調整に影響する重み付けを使用して、高さを固定サイズに設定し、コンテンツを表示するために必要に応じて拡大したり、他のコンポーネントに比べてできるだけ多くのスペースを消費したりします。

    設定 説明
    settings-sizing-auto-size 自動サイズ設定は、コンポーネントをその内容に従って縮小または拡大するように設定します。
    settings-sizing-pixels 固定サイズをピクセル単位で設定します。ボックスに整数を入力するか、上向き矢印か下向き矢印を使ってサイズを増加または減少します。コンポーネントにフォーカスがあると、これらの矢印が表示されます。
    settings-sizing-stretch

    ストレッチでは、サイズ調整に影響を与えるために重み付けを使用して、コンポーネントが他のコンポーネントに比べてできるだけ多くのスペースを消費することができます。

    2つのコンポーネントが両方とも伸縮するように設定されている場合、デフォルトで残りのスペースの50%が割り当てられます。この比率は、重量値を変更することによって調整できます。

    たとえば、1つのコンポーネントを200の重みに設定し、もう1つのコンポーネントを100の重みに設定すると、最初のコンポーネントは残りのスペースの3分の2を占め、もう1つは3分の1しかかかりません。最初のコンポーネントは、その重量が2番目のコンポーネントの重量の2倍であるため、他のコンポーネントのサイズの2倍になります。




    親コンテナを基準にして、コンポーネントを左、右、または中央に揃えます。

    ヒント: 親コンテナの高さ設定が 自動サイジング。これを修正するには、親コンテナのHeightをに設定します。 ストレッチ またはの一定の高さに ピクセル数
    設定
    align-left2 align-left-example2
    align-center2 align-center-example2
    align-right2 align-right-example2
    align-start align-start-example
    align-vertical-center align-vertical-center-example
    align-vertical-end align-vertical-end-example



    余白は、境界線の周囲の上下左右の間隔を設定します。

    画像は、余白、境界線、およびスペース設定の関係を示しています

    1. 必要に応じて一度にすべてのマージン値を更新するには、を押します。 すべて設定 プロパティパネルの[余白]ボタンをクリックします。

      すべて設定ボタンの画像

    2. 余白の値フィールドをクリックします。そのフィールドにスピン コントロールが表示されます。

    3. スピンコントロールを使用して、余白を増減します。もし すべて設定 を選択した場合、変更はすべての余白に適用されます。

      settings-margin-spinner

      コンポーネントは新しいマージン設定を使用してすぐに再配置されます。




    ブール(TrueまたはFalse)変数の値に基づいてコンポーネントの表示/非表示を設定します。

    1. クリック レイアウト プロパティグループVisibleの下にあるをクリック 変数を選択
    2. 変数を選択するか、オプションで新しいYes / No変数を作成してから、その新しい変数を 見える 財産。
    3. 実行時には、変数の値がTrueのときにコンポーネントが表示されます。逆に、変数の値が


    詳細設定



    値は、選択した変数にコンポーネントをバインドします。例えば、テキスト入力コンポーネントを変数にバインドすると、入力ボックスには常にその変数の値が表示され、指定したプレースホルダー テキストは無視されます。変数はユーザーが入力したテキストで自動的に更新されます。ただし、検証処理の対象となります。

    その他のコントロール、ラジオボタンなど、選択した値テキスト設定で値を使用します。{"error" :{"code" :400000,"message" :"One of the request inputs is not valid."}} これにより、各ラジオ ボタンは同じ変数に別の値を割り当てることができます。

    カレンダコントロールが変数にバインドされている場合、その値はコントロールによって選択された日付に設定されます。変数は視覚コントロールの値をプリセットしたり、コントロールにより設定できるため、バインドは頻繁に使用される強力な方法です。




    プレースホルダーテキストはにヒントを表示するユーザー 。

    プレースホルダープロパティの例

    テキスト入力のために、プレースホルダテキストがまで示されているユーザータイプ入力。ユーザー入力ボックスの内容をクリアすると、プレースホルダーテキストが再表示されます。

    プレースホルダーの表示例

    ドロップダウンの場合、プレースホルダーテキストはユーザー選択を促します。

    図は、ドロップダウンから選択が行われる前のプレースホルダーテキストを示しています

    後にプレースホルダが交換されるユーザーの項目を選択します。

    選択によるプレースホルダー置換

    ヒント: コンポーネントが変数にバインドされている場合、手動で入力したプレースホルダーテキストは無視されます。変数が選択されている場合、その値は常に表示されます。



    すべてのコンポーネントはデフォルトで有効になっています。無効にしたプロパティは、True/False 変数をコンポーネントにバインドし、変数の実行時の値に基づいて無効または有効にします。

    1. True/False 変数を作成するには、[ 変数 ] タブ。

    2. クリック + 変数を追加します。

      図は、新しい変数を追加するボタンを示しています

    3. 選択 True/False データ型として。

      図は、変数のデータ タイプを示しています

    4. 名前ボックスにわかりやすい名前を入力します。

      currently-enabled-variable

    5. 既定値を設定する True または False.

      • 変数が True の場合、コンポーネントは無効になります。

      • 変数が False の場合、コンポーネントは有効になります。

    6. クリック 適用 変数を保存します。
    7. 無効にしたプロパティに変数を割り当てます。以下に 無効クリック 変数の選択.

      disabled-property-setting

    8. True/False 変数を選択します。

      currently-enabled-variable-selected

    9. 作業をテストするには、 プレビュー.



    検証により、エージェントが入力したテキストが適切にフォーマットされていることが確認されます。フォーカスが離れるとき テキスト入力 ボックスでは、その値がテストされ、選択した検証ルールに準拠していることが確認されます。ユーザー入力が検証に合格しなかった場合、ボーダーは赤に変わり、入力されたものに検証の問題があることを示します。

    ドロップリストを使用して、検証方法を選択します。

    検証方法の選択

    • 選択する-事前設定された検証パターンを選択できます。

      Eメール 入力は電子メールアドレスの構文に準拠する必要があります。
      アルファベット アルファベット入力のみを許可(数字は不可)
      アルファベット-スペースあり アルファベット入力のみを許可し、単語間にスペースが必要です。たとえば、「cool beans」は受け入れられますが、「cool_beans」は受け入れられません。
      アルファベット-アンダースコア付き アルファベット入力のみ(数字なし)と単語間のアンダースコアが必要です。たとえば、「cool_beans」は受け入れられますが、「cool bean」は受け入れられません。
      英数字 テキスト入力には文字と数字の両方を含める必要があります。
      英数字-スペースあり テキスト入力には、スペースで区切られた単語を含む文字と数字の両方が含まれている必要があります。
      英数字-アンダースコア付き テキスト入力には、アンダースコアで区切られた単語を含む文字と数字の両方が含まれている必要があります。
    • カスタム-文字列変数を選択できます。たとえば、文字列変数を正規表現にし、その変数を複数のページで使用して、検証を同じに保つことができます。




    ユーザーが値を入力または選択する必要があるかどうかを指定します。既定値は No で、ユーザーの操作は省略可能です。

    ユーザインタフェースは、ユーザ入力がオプションであるかどうかを視覚的に示します。

     

    オプションの入力は、コンポーネントの下のラベルで示されます。

    要求-値-false




    変更アクション このコンポーネントの状態または値が変更されたときに実行されるアクションを設定することができます。

    Scripterアクション、Outboundアクション、またはカスタムアクションを選択できます。アウトバウンド アクションは、アウトバウンド プロパティが有効になっていない限り、利用できません。




    テキスト入力 ボックスはデフォルト単一の回線をサポートします。MultilineがNo( デフォルト設定されている場合、テキスト入力はテキストをラップしたり、垂直方向にサイズを変更したりしません。

    multiline-false

    [マルチライン]が[いいえ]に設定されている場合、このアイコンをクリックして、以前に入力したテキストをクリアできます。

    multiline-false-clear-button

    MultilineをYesに設定すると、テキスト入力は複数行のテキストを受け入れます。

    複数行真