使用法と例

日付ピッカー Web 拡張機能を構成するには、以下のパラメータを指定する必要があります:

  • テーマ: 色のテーマを指定します。オプションは ["Vibrant"] と ["Subtle"] です。["Subtle"] がデフォルトです。
  • モード: 色を指定します。値は、["Light"]、["Dark"]、["High Contrast"]、[""] です。空の文字列 [""] の値は ["Light"] の値と等しくなります。
  • ラベル: コントロールのラベルを設定します。空の文字列値 [""] を指定すると、ラベル、必須マーク、ツールヒント付きの情報アイコンが非表示になります。
  • :日付ピッカーの現在値を、数値形式の日付として表します。たとえば日付ピッカーなら YYYY-MM-DD、日付と時刻ピッカーなら YYYY-MM-DDThh:mm:ss のように表記されます。値が変更されると、編集済みセルに対して設定されたアクションが実行されます。
  • 必須: エレメントの選択が必須かどうかを定義します。指定しない場合、デフォルトは ["TRUE"] です。
  • 情報: [情報] アイコンのツールヒントテキストを提供します。空の文字列 [""] は、情報アイコンを非表示にします。
  • ヒントテキスト: 日付が選択されていない場合に表示される、ヒントテキストを文字列で定義します。空の文字列 [""] には、地域設定に依存する日付形式が表示されます。
  • ダーティフラグ:選択された日付が変更されたかどうかを示します。["TRUE"] または空の文字列 [""] を使用して、ダーティフラグインジケーターを使用します。["FALSE"] を使用すると、フラグは無視されます。
  • Type: デフォルトの日付ピッカーを使うか、日付時刻ピッカーを使うかを定義します。
  • 日付範囲:開始日、終了日、無効にする範囲や日付の条件を指定したカンマ区切りのリストが含まれます。指定しない場合、2000-01-01 ~ 2099-12-31 の日付範囲を利用できます。
  • 状態: 制御状態を [有効]、[無効] または [読み取り専用] として定義します。指定しない場合、デフォルトは ["有効"] になります。
  • エラー:エラーテキストが文字列で指定されると、そのコントロールはエラー状態で表示されます。空の文字列 [""] を使用すると、エラー状態を非表示にできます。

この例では、日付ピッカーを作成し、選択された日付をレポート変数に保存して後続処理に利用する方法を説明します。

  1. Application Studio レポートを作成します。
  2. Selected_Date という名前のレポート変数を作成します。
  3. [プロパティ - レポート] ペインで、[即時書き戻し] オプションを [自動] に設定します。
  4. セル B5:C6 に日付ピッカー Web 拡張機能を挿入します。
  5. [Web 拡張機能の設定] ダイアログボックスで、次の値を指定します。
    テーマ
    [="Vibrant"] を指定します。
    モード
    [="Light"] を指定します。
    ラベル
    [="開始日"] を指定します
    [=B9] を指定します。
    必須
    [="TRUE"] を指定します。
    情報
    [="従業員の入社日を設定"] を指定します
    ヒントのテキスト
    [=""] を指定します。
    ダーティフラグ
    [=""] を指定します。
    タイプ
    [="日付"] を指定します
    日付範囲
    [=""] を指定します。
    状態
    [="有効"] を指定します。
    エラー
    [=""] を指定します。
  6. B9 セルをクリックし、Getproperty("XML_properties","key","property") 関数を追加します:
    =
    	IF(
    		GETPROPERTY(ReportVariables.Selected_Date.Text,"ID1","value")="",
    		NOW(),
    		GETPROPERTY(ReportVariables.Selected_Date.Text,"ID1","value“))
  7. B9 セルに以下の設定でアクションを定義します:
    • アクション
      タイプ
      [パラメーターを設定] を指定します
      条件
      [=TRUE] を指定します。
      モード
      [セルを編集] を指定します
    • パラメーター
      名前
      [Selected_Date] を指定します
      プロパティ
      [Value(.Text)] を指定します。
      =SETPROPERTY(ReportVariables.Selected_Date.Text,"ID1","value",B9) を指定
  8. [OK] をクリックします。
  9. レポートを保存して Web ブラウザーで表示します。