使用法と例

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

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

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

  1. Application Studio レポートを作成します。
  2. Selection という名前のレポート変数を作成します。
  3. [プロパティ - レポート] ペインで、[即時書き戻し] オプションを [自動] に設定します。
  4. セル B2:D5 にドロップダウン Web 拡張機能を挿入します。
  5. [Web 拡張機能の設定] ダイアログボックスで、次の値を指定します。
    テーマ
    [="Vibrant"] を指定
    モード
    [="Light"] を指定
    ラベル
    [="Position"] を指定
    品目データ
    [=B7:F11] を指定
    multiselect (複数選択)
    [="TRUE"] を指定
    必須
    [="TRUE"] を指定
    情報
    [="You can select one or more positions"] を指定
    状態
    [="Enabled"] を指定
    ヒントのテキスト
    [="Select positions"] を指定
  6. セル範囲 B7:F11 で、次のサンプルテーブルと値を指定します。
    ID Caption Selected Disabled Visible
    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] 列の各項目について、次の設定でのアクションを定義します。
    • アクション
      タイプ
      [Set parameter] を指定
      条件
      [=TRUE] を指定
      モード
      [Web Extension] を指定
    • パラメーター
      名前
      [reportvariable.Selection] を指定
      プロパティ
      [Value(.Text)] を指定
      [=Actions.Input.Text] を指定
  8. [OK] をクリックします。
  9. レポートを保存して Web ブラウザーで表示します。