固定動的フォームの作成
固定動的フォームでは、段落コードにハードコードされた値を使用して動的フォームが生成されます。
動的フォームの構造は${my-form-info}
です。 実行時、コードのプレースホルダーは、それぞれの入力フィールドのカスタム・ユーザー入力に置き換えられます。
現在サポートされている入力フィールドは次のとおりです:
- 「テキスト・ボックス」を使用して、任意の文字列を入力します。
${<name>(<label>)=<default_value>}
前述のコードで:
name
: 動的フォームの名前。 動的フォームの上に表示されます。 段落で動的フォームを複数回参照する場合は、同じname
を割り当てると、1回のみ表示されます。label
: 動的フォームの上に表示されるラベル。 カスタマイズされたラベルは、${name (myLabel)}
を使用して指定できます。default_value
(optional): 動的フォームが最初に作成されたときに与えられるデフォルト値。
たとえば:
%md My name is ${textbox(Title of textbox)=Graph Studio}
- 「選択」を使用して、ドロップダウン・リストから値を選択します。
${<name>(<label>)=<default_value>,<option_value_a>(<option_label_a>)|<option_value_b>(<option_label_b>)}
前述のコードで:
name
: 動的フォームの名前。 動的フォームの上に表示されます。 段落で動的フォームを複数回参照する場合は、同じname
を割り当てると、1回のみ表示されます。default_value
(optional): 動的フォームが最初に作成されたときに与えられるデフォルト値。 「オプション」値のいずれかである必要があります。- 「オプション」は、
option_value
およびoption_label
で構成されます。option_value
は、選択するdefault_value
を参照するために使用され、(オプション)option_label
はドロップダウン・リストまたはチェック・ボックスによって作成されたそれぞれのボックスに表示されます。 option_value
は、文字列または数値のいずれかです。- 解析された形式では、オプションは
|
文字で区切られます。
- 「オプション」は、
たとえば:
%md Country: ${country=US,US(United States)|UK|JP}
- 「複数選択」を使用して、リストから1つ以上の値を選択します。
${selectMultiple(<join_parameter>):<name>(<label>)=<default_value>,<option_value_a>(<option_label_a>)|<option_value_b>(<option_label_b>)}
前述のコードで:
name
: 動的フォームの名前。 動的フォームの上に表示されます。 段落で動的フォームを複数回参照する場合は、同じname
を割り当てると、1回のみ表示されます。label
: 動的フォームの上に表示されるラベル。default_value
(optional): 動的フォームが最初に作成されたときに与えられるデフォルト値。 「オプション」値のいずれかである必要があります。- 「オプション」は、
option_value
およびoption_label
で構成されます。option_value
は、選択するdefault_value
を参照するために使用され、(オプション)option_label
がドロップダウン・リストに表示されます。 option_value
は、文字列または数値のいずれかです。- 解析された形式では、オプションは
|
文字で区切られます。
- 「オプション」は、
join_parameter
: 選択した複数の値の間に挿入される値。 たとえば、結合パラメータがor
の2つの要素A
およびB
を持つ複数選択動的フォームがあるとします。 ユーザーがA
とB
の両方を選択して段落を実行すると、結果はA or B
になります。
たとえば:
${selectMultiple(OR):country=US|JP, US(United States)|UK|JP}
- 「スライダ」を使用して、指定した範囲内を選択します。
%md ${slider(<minimum>,<maximum>,<step_size>):<name>(<label>)=<default_value>}
前述のコードで:
name
: 動的フォームの名前。 動的フォームの上に表示されます。 段落で動的フォームを複数回参照する場合は、同じname
を割り当てると、1回のみ表示されます。minimum
: スライダの最小値。 数値にする必要があります。maximum
: スライダの最大値。 数値にする必要があります。step_size
: スライダのステップ・サイズ。 次の数値および除数である必要があります(最大 - minimum).default_value
(optional): 動的フォームが最初に作成されたときに与えられるデフォルト値 (minimum <= default_value <= maximum
)。
たとえば:
%md My age is: ${slider(18.0,30.0,5.0):My Age=25.0}
- 「チェックボックス」を使用して、指定した値を1つ以上選択します。
${checkbox(<join_parameter>):<name>(<label>)=<default_value>,<option_value_a>(<option_label_a>)|<option_value_b>(<option_label_b>)}
前述のコードで:
name:
動的フォームの名前。 動的フォームの上に表示されます。 段落で動的フォームを複数回参照する場合は、同じname
を割り当てると、1回のみ表示されます。default_value
(optional): 動的フォームが最初に作成されたときに与えられるデフォルト値。 「オプション」値のいずれかである必要があります。- 「オプション」は、
option_value
およびoption_label
で構成されます。option_value
は、選択するdefault_value
を参照するために使用され、(オプション)option_label
はドロップダウン・リストまたはチェック・ボックスによって作成されたそれぞれのボックスに表示されます。 option_value
は、文字列または数値のいずれかです。- 解析された形式では、オプションは
|
文字で区切られます。
- 「オプション」は、
join_parameter
: 選択した複数の値の間に挿入される値。 たとえば、結合パラメータがor
の2つの要素A
およびB
を持つチェックボックス動的フォームがあるとします。 ユーザーがA
とB
の両方のチェックボックスを選択して段落を実行すると、結果はA or B
になります。
たとえば:
%md ${checkbox( or ):country(Country)=US|JP, US(United States)|UK|JP}
- 日付を選択するには、「Dateピッカー」を使用します。
${date(<date_format>):<name>(<label>)=<default_value>}
前述のコードで:
name
: 動的フォームの名前。 動的フォームの上に表示されます。 段落で動的フォームを複数回参照する場合は、同じname
を割り当てると、1回のみ表示されます。date_format
(オプション、推奨): 選択した日付を入力フィールドに表示し、段落の実行時に結果の日付を書式設定するために使用される日付書式。default_value
(optional): 動的フォームが最初に作成されたときに与えられるデフォルト値。date_format
が指定されていない場合は、date_format
またはyyyy-MM-dd
形式に従って指定する必要があります。
たとえば:
%md ${date(EEEE):myName(my-label)=1994-06-15T09:00:00}
- 「Timeピッカー」を使用して時間を選択します。
${time(<time_format>):<name>(<label>)=T13:30}
前述のコードで:
name
: 動的フォームの名前。 動的フォームの上に表示されます。 段落で動的フォームを複数回参照する場合は、同じname
を割り当てると、1回のみ表示されます。time_format
(オプション、推奨): 選択した時間を入力フィールドに表示し、段落の実行時に結果の時間を書式設定するために使用する時間書式。
たとえば:
%md ${time(hh:mm:ss):myName(my-label)=1994-06-15T09:00:00}
- 「DateTimeピッカー」を使用して、指定した値を1つ以上選択します。
${dateTime(<dateTime_format>):<name>(<label>)=<default_value>}
前述のコードで:
name
: 動的フォームの名前。 動的フォームの上に表示されます。 段落で動的フォームを複数回参照する場合は、同じname
を割り当てると、1回のみ表示されます。dateTime_format
(オプション、推奨): 入力フィールドに選択した日時を表示したり、段落の実行時に結果の日時を書式設定するために使用するdateTime
形式。default_value
(optional): 動的フォームが最初に作成されたときに与えられるデフォルト値。dateTime_format
が指定されていない場合は、dateTime_format
またはyyyy-MM-dd HH:mm
形式に従って指定する必要があります。
たとえば:
%md ${dateTime(YYYY-M-dd hh:mm:ss):myName(my-label)=1995-06-15T09:00:00}