使用法と例

ドロップダウン Web 拡張機能を構成するには、次のパラメーターを指定する必要があります。

  • テーマ: 色のテーマを指定します。オプションは ["Vibrant"] と ["Subtle"] です。["Subtle"] がデフォルトです。
  • モード: 色を指定します。値は、["Light"]、["Dark"]、["High Contrast"]、[""] です。空の文字列値 [""] は ["Light"] に相当します。
  • ラベル: コントロールのラベルを設定します。空の文字列値 [""] は、ラベル、必要なインジケーター、およびツールヒントの情報アイコンを非表示にします。
  • 項目データ: ドロップダウンに表示する項目のテーブルを、次の列で定義します。
    • 項目 ID。この列は、選択変更時のアクションを定義します。
    • 項目キャプション
    • 選択済 (FALSE = 空の文字列 "" または TRUE)
    • 無効。オプション列 (FALSE = 空の文字列 "" または TRUE)
    • 可視。オプション列 (TRUE = 空の文字列 "" または FALSE)
  • 複数選択: ドロップダウンで単一選択または複数選択を許可するかどうかを指定します。単一選択の場合は空の文字列 [""] または ["FALSE"] を、複数選択の場合は ["TRUE"] を使用します。
  • 必須: エレメントの選択が必要かどうかを定義します。指定しない場合、デフォルトは ["TRUE"] です。
  • 情報: [情報] アイコンのツールヒントテキストを提供します。空の文字列 [""] は、情報アイコンを非表示にします。
  • 状態: 制御状態を [有効]、[無効] または [読み取り専用] として定義します。指定しない場合、デフォルトの [有効] が使用されます。
  • ヒントテキスト: 日付が選択されていない場合に表示される、ヒントテキストを文字列で定義します。空の文字列 [""] には、地域設定に依存する日付形式が表示されます。

この例は、単一選択ドロップダウンを作成し、後続の処理のためにレポート変数の選択を保存する方法を示しています。

  1. Application Studio レポートを作成します。
  2. Selection という名前のレポート変数を作成します。
  3. [プロパティ - レポート] ペインで、[即時書き戻し] オプションを [自動] に設定します。
  4. セル B2:D5 にドロップダウン Web 拡張機能を挿入します。
  5. [Web 拡張機能の設定] ダイアログボックスで、次の値を指定します。
    テーマ
    [="Vibrant"] を指定します。
    モード
    [="Light"] を指定します。
    ラベル
    [="Position"] を指定します。
    品目データ
    [=B7:F11] を指定します。
    複数選択
    [="TRUE"] を指定します。
    必須
    [="TRUE"] を指定します。
    情報
    [=”1 つ以上のポジションを選択できます"] を指定します。
    状態
    [="有効"] を指定します。
    ヒントのテキスト
    [="位置を選択"] を指定します。
  6. セル範囲 B7:F11 で、次のサンプルテーブルと値を指定します。
    ID キャプション 選択済 無効 可視
    Id1 オプション 1 =GETPROPERTY(ReportVariables.Selection.Text,B8,"selected")="True" FALSE TRUE
    Id2 オプション 2 =GETPROPERTY(ReportVariables.Selection.Text,B9,"selected")="True" FALSE TRUE
    Id3 オプション 3 =GETPROPERTY(ReportVariables.Selection.Text,B10,"selected")="True" FALSE TRUE
    Id4 オプション 4 =GETPROPERTY(ReportVariables.Selection.Text,B11,"selected")="True" FALSE TRUE

    パラメーター Item Data は、このセル範囲に接続されています。各エレメントのステータスがテーブルから読み取られます。この例では、すべてのエレメントは有効化され、表示されます。エレメントを選択すると、[選択済] 列の選択状況のみが変更されます。GETPROPERTY 関数は、現在の選択内容を Selection 変数から読み取ります。

  7. [ID] 列の各項目について、次の設定でのアクションを定義します。
    • アクション
      タイプ
      [パラメーターを設定] を指定します。
      条件
      [=TRUE] を指定します。
      モード
      [Web 拡張機能] を指定します。
    • パラメーター
      名前
      [reportvariable.Selection] を指定します。
      プロパティ
      [Value(.Text)] を指定します。
      [=Actions.Input.Text] と指定します。
  8. [OK] をクリックします。
  9. レポートを保存して Web ブラウザーで表示します。