使用法と例
日付ピッカー 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 の日付範囲を利用できます。
- 状態: 制御状態を [有効]、[無効] または [読み取り専用] として定義します。指定しない場合、デフォルトは ["有効"] になります。
- エラー:エラーテキストが文字列で指定されると、そのコントロールはエラー状態で表示されます。空の文字列 [""] を使用すると、エラー状態を非表示にできます。
この例では、日付ピッカーを作成し、選択された日付をレポート変数に保存して後続処理に利用する方法を説明します。