Cloud Software Group, Inc. EBX®
ドキュメント>開発者ガイド>データモデル
ナビゲーションモードドキュメント>開発者ガイド>データモデル

カスタムフォーム

この章では、TIBCO EBX®によってカスタムフォームがどのように定義および管理されるかについて詳しく説明します。

アクセス

アクセスするには、[データモデル] > [拡張機能] > [カスタムフォーム] > [フォーム]に移動します。

/access_custom.png

[+]ボタンをクリックしてフォームを作成します。

/add_form.png

新しいフォームに名前を付け、使用できるテーブルを示します。

/name_form.png

「保存」ボタンを押すと、レイアウトデザイナにリダイレクトされます。

/display_form.png

フォームとコンポーネント

フォームとコンポーネントの両方を「カスタムフォーム」データモデル拡張で作成できます。

エディター

フォームまたはコンポーネントは、ブロックの積み重ねに過ぎません。ブロックは、具体的なグラフィックエレメントまたはロジックの一部を表すことができ、権限、言語などの条件に基づいて異なるレイアウトを持つことができます。

ワークスペースには、事前定義されたルートブロック内にフォームの説明が含まれています。このルートに接続されていないブロックは、非アクティブとしてマークするためにグレー表示されます。 ブロックを移動するには、ドラッグアンドドロップする必要があります。ブロックをドラッグすると、その下に接続されているブロックもドラッグされます。ブロックを1つだけ移動する必要がある場合は、Ctrlキーを押しながらクリックします。ワークスペースのブロックを右クリックすると、展開/折りたたみ、コメント、ヘルプなどのオプションのリストも表示されます。

左側のツールボックスには、カテゴリのリストが表示されます。カテゴリをクリックすると、そのカテゴリに含まれるブロックが表示されます。一部のカテゴリには、関連する「テンプレート」セクションがあります。このセクションは、セクションのブロックのいくつかの組み合わせを提供し、便利なショートカットまたはサンプルと見なすことができます。

画面の右下には、[プレビュー]ボタンと[プレビューの構成]ボタンがあります。これらを使用して、フォームがどのように表示されるかを確認できます。

/overview.png

ブロック

ツールボックスに表示されるすべてのブロックのリストは次のとおりです。

算術演算子

2つの整数の演算。

/block_integer_operator.png

Array(配列)

アイテムのリスト。

/block_array.png

以下も参照してください。

配列アイテム

式ブロックを配列にするためのアダプター。

以下も参照してください。

ブール演算子

2つのブール値の操作。

/block_boolean_operator.png

Check box(チェックボックス)

チェックボックスウィジェットを表示します。

/block_checkbox.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

label enabled?

設定されている場合、ウィジェットの横にアイテムラベルを追加するかどうかを示します。

index

この列挙項目のインデックス。

specific nomenclature

設定されている場合、モデル駆動型の命名法を上書きします。

Check box group(チェックボックスグループ)

チェックボックスグループウィジェットを表示します。

/block_checkbox_group.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

columns number

設定されている場合、チェックボックスのレイアウトに使用する列の数を定義します。

specific nomenclature

設定されている場合、モデル駆動型の命名法を上書きします。

Children(子)

指定されたノードの子のリストを返します。

/block_node_children.png

パラメーター

入力

説明

node

子を抽出するための複雑なノード。

Choose(選択)

「when」/「otherwise」ブロックの内側の1つのコンテンツを返すブロック。

/block_choose.png

パラメーター

入力

説明

content

「when」ブロックのリスト、およびオプションで最後の 「otherwise」ブロック。

以下も参照してください。

Close button(閉じるボタン)

標準の「閉じる」ボタン。

/block_button_close.png

パラメーター

入力

説明

label

設定されている場合、デフォルトのラベルを上書きします。

default?

これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。

Color picker(カラーピッカー)

カラーピッカーウィジェットを表示します。

/block_color_picker.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

Combo box(コンボボックス)

コンボボックスウィジェットを表示します。

/block_combo_box.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

create button displayable?

設定されている場合、基になるノードが外部キーであるときに作成ボタンを表示するかどうかを定義します。

preview button displayable?

設定されている場合、基になるノードが外部キーであるときにプレビューボタンを表示するかどうかを定義します。

number of entries displayed on a page

設定されている場合、ドロップダウンリストの各ページのエントリ数を定義します。

width of the combo box

設定されている場合、コンボボックスの幅を定義します。

advanced selector available?

設定されている場合、基になるノードが外部キーであるときに詳細セレクターを表示するかどうかを定義します。

view name to use with the advanced selector

設定されている場合、関連する外部キーフィールドのコンボボックス選択で使用される公開ビューの名前を定義します。

specific nomenclature

設定されている場合、モデル駆動型の命名法を上書きします。

Comparator(コンパレータ、比較)

2つの整数を比較します。

/block_integer_comparator.png

比較

文字列、数値、またはブール値を比較します。

/block_comparator.png

配列の連結

指定された配列の連結を返します。

/block_array_concat.png

パラメーター

入力

説明

arrays

配列のリスト。

定数

定数値。コンテキストに応じて、この値はテキスト、ブール値、または数値として解釈される場合があります。

/block_constant.png

パラメーター

入力

説明

value

テキスト、ブール値、または数値。

コンテンツタイトル

ワークスペースのコンテンツタイトルを表示します。

/block_content_title.png

パラメーター

入力

説明

label

表示するテキスト。

horizontal alignment

エレメントの水平方向の配置。設定されている場合、受け入れられる値は「start」、「end」、「center」です。

Creating record?(レコードを作成しますか?)

フォームがレコードの作成または複製のコンテキストで表示されるかどうかを示すブール値を返します。

/block_is_creating_record.png

Custom action bar(カスタムアクションバー)

カスタムアクションバー。

/block_custom_action_bar.png

パラメーター

入力

説明

start

アクションバーの左側に表示する「ボタン」のリスト。

middle

アクションバーの中央に表示する「ボタン」のリスト。

end

アクションバーの右側に表示する「ボタン」のリスト。

Date time input(日時入力)

入力した日付/時刻を表示します。

/block_date_time_input.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

date picker button displayable?

日付ピッカーを開くボタンが表示されているかどうかを示します(読み取り/書き込みモードのみ)。

now button displayed?

日付を現在時刻に設定するボタンが表示されているかどうかを示します(読み取り/書き込みモードのみ)。

Declare(宣言)

「with」ブロックでの変数の宣言。

/block_declare.png

パラメーター

入力

説明

name

変数の名前。特定の 「with」ブロックに対して一意である必要があります。

content

これを参照する 「var」ブロックによって返される変数の値。

以下も参照してください。

Default action bar(デフォルトアクションバー)

デフォルトのアクションバー。

/block_default_action_bar.png

Default toolbar(デフォルトツールバー)

モデル駆動型ツールバー。

/block_default_toolbar.png

Duplicating record?(レコードを複製しますか?)

フォームがレコード複製のコンテキストで表示されるかどうかを示すブール値を返します。

/block_is_duplicating_record.png

Expand/Collapse(展開/折りたたみ)

展開/折りたたみブロック内にコンテンツを表示します。

/block_expand_collapse.png

パラメーター

入力

説明

label

矢印の横に表示されるラベル。

collapsed?

グループが最初に折りたたまれているかどうかを示します。

content

折りたたみ可能なコンポーネントのリスト。

Flow(フロー)

その内容を流動的に表示します。エレメントが1つの行または列に収まらない場合、エレメントは折り返され、新しいエレメントが開始されます。

/block_flow.png

パラメーター

入力

説明

direction

「horizontal」または「vertical」は、コンテンツをキューに入れる方向を示します。

item spacing

エレメント間のスペース(ピクセル単位)。

content

水平または垂直に表示するエレメントのリスト。

For each

「of」配列の各項目に適用された 「body」関数の結果で構成される配列を返します。

/block_for_each.png

パラメーター

入力

説明

item

現在のアイテムを含む変数の名前。

array

変換するアイテムを含む配列。

return

現在のアイテムに対して何を返すか。

Form(フォーム)

左側にラベル、右側に値がある標準のテーブルのようなレイアウト。

/block_form.png

パラメーター

入力

説明

content

「フォーム行」、「フォームグループ」またはノードのリスト。ノードはモデル駆動型の表示になり、「フォーム行」と「フォームグループ」でカスタムコンテンツを表示できます。

以下も参照してください。

Form definition(フォーム定義)

フォームの実際の定義。

/block_form_definition.png

パラメーター

入力

説明

toolbar

フォームの上部に表示されるツールバーの定義。

action bar

フォームの下に表示されるアクションバーの定義。

help URL

ヘルプページのURL。

content

レイアウトの内容。

Form group(フォームグループ)

「フォーム」内に、折りたたみ可能なアイテムのグループを表示します。

/block_form_group.png

パラメーター

入力

説明

node

設定されている場合、グループラベル、説明、およびコンテンツはモデル駆動型になります。

label

グループのラベル。ノードとラベルが設定されている場合、モデル駆動ラベルをオーバーライドできます。

description

グループの説明。ノードと説明が設定されている場合、モデル駆動型の説明を上書きできます。

open?

グループが最初に開いているかどうかを示します。

content

「フォーム行」、「フォームグループ」またはノードのリスト。ノードはモデル駆動型の表示になり、「フォーム行」と「フォームグループ」でカスタムコンテンツを表示できます。

以下も参照してください。

Form row(フォーム行)

「フォーム」または「フォームグループ」内に、基本的にラベルと値である行を表示します。

/block_form_row.png

パラメーター

入力

説明

node

設定されている場合、ラベル、説明、およびコンテンツはモデル駆動型になります。

display label?

ラベルを表示するかどうかを示します。 「フォーム」でfalseに設定すると、コンテンツはラベルとコンテンツ領域の両方にまたがります。

label

行のラベル。ノードとラベルが設定されている場合、モデル駆動ラベルをオーバーライドできます。

description

行の説明。ノードとラベルが設定されている場合、モデル駆動ラベルをオーバーライドできます。

content

ラベルの横に表示されるコンテンツ。

以下も参照してください。

Form parameter(フォームパラメーター)

「レコード」は、表示されたレコードを表すノードです。 「現在のページ」は、表示されているページを表す番号(デフォルトでは1)です。この値は、[前へ]ボタンと[次へ]ボタンで変更できます。

/block_form_parameter.png

From...get(から...取得)

オブジェクトまたはノードから値を抽出します。

<from "node" get "path/to/value">は<var "node/path/to/value">と同等です。

/block_get.png

パラメーター

入力

説明

from

データを抽出するベースオブジェクトまたはノード。

get

「from」のオブジェクト内で抽出するデータのパス。

Function(関数)

無名関数の定義。関数は、本体のパラメーターを使用して結果を返します。

/block_function.png

パラメーター

入力

説明

parameters

「param」ブロックのリスト。この関数で受け入れられるパラメーターを定義します。

body

パラメーターを使用して、関数の結果を説明する本文。

以下も参照してください。

Function call(関数呼び出し)

パラメーターに実際の値を設定して関数を呼び出します。

/block_call.png

パラメーター

入力

説明

function

呼び出す関数。

args

関数に渡す引数。

以下も参照してください。

Function call argument(関数呼び出し引数)

呼び出された関数のパラメーターに渡す実際の値。

/block_argument.png

パラメーター

入力

説明

name

パラメーターの名前。

value

パラメーターを渡すための実際の値。

以下も参照してください。

Function parameter(関数パラメーター)

これは、関数のパラメーターの宣言です。

/block_parameter.png

パラメーター

入力

説明

name

パラメーターの名前。

mandatory?

このパラメーターを呼び出し元が指定する必要があるかどうかを示します。

default value

設定されている場合、これは、呼び出し元が指定しない場合にこのパラメーターがとるデフォルト値です。

以下も参照してください。

Grid(グリッド)

座標を使用してコンポーネントをグリッドに配置できるレイアウト。

/block_grid.png

パラメーター

入力

説明

item spacing

エレメント間のスペース(ピクセル単位)。

content

グリッドエレメントのリスト。コンテンツを表示する場所を指定します。

以下も参照してください。

Grid element(グリッドエレメント)

「グリッド」内で、そのコンテンツの場所を指定します。

パラメーター

入力

説明

row

エレメントが始まる行。最小値は1です。

column

エレメントが始まる列。最小値は1です。

width

グリッドセルでのエレメントの幅。最小値は1です。

height

グリッドセルでのエレメントの高さ。最小値は1です。

vertical alignment

エレメントの垂直方向の配置。設定されている場合、受け入れられる値は「start」、「end」、「center」です。

horizontal alignment

エレメントの水平方向の配置。設定されている場合、受け入れられる値は「start」、「end」、「center」です。

content

セル内のコンテンツ。

以下も参照してください。

If

テストの結果に基づいて、「then」のコンテンツまたは「else」のコンテンツのいずれかを返すブロック。

/block_if.png

パラメーター

入力

説明

test

返す値を決定するテスト。これはブール値である必要があります。

then

テストがtrueの場合に返される値。

else

テストがfalseの場合に返される値。

Input parameter(入力パラメーター)

入力パラメーターの生の値を返します。

/block_input_parameter.png

パラメーター

入力

説明

name

パラメーター名。

In role?(役割は?)

現在のユーザーが要求されたロールを持っているかどうかを示すブール値を返します。

/block_is_in_role.png

Label(ラベル)

指定されたノードのラベルを表示します。

/block_label.png

パラメーター

入力

説明

node

ラベルを表示するノード。

Localized(ローカライズ)

どの結果がユーザーロケールに依存するかをブロック化します。

/block_localized.png

パラメーター

入力

説明

locale

各パラメーターはロケールに関連しています。ブロック化の結果は、現在のユーザーのロケールに対応するものになります。

Message(メッセージ)

javaのような{0}、{1}などのプレースホルダーを指定されたインデックスの引数に置き換えることにより、指定されたテキストをフォーマットします。

/block_message.png

パラメーター

入力

説明

pattern

指定された引数に置き換えられるプレースホルダー({0}、{1}など)を含むテキスト。

arguments

パターン内のプレースホルダーを置き換える値のリスト。

Next button(次へボタン)

「現在のページ」の値を1つインクリメントするボタン。

/block_button_next.png

パラメーター

入力

説明

label

設定されている場合、デフォルトのラベルを上書きします。

default?

これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。

ノード

既存のノードの定義を上書きします。

/block_node.png

パラメーター

入力

説明

base

オーバーライドするノード。

mandatory?

設定されている場合、ベースノードの必須インジケーターをオーバーライドします。

label

設定されている場合、ノードのラベルを上書きします。

description

設定されている場合、ノードのラベルを上書きします。

widget

設定されている場合、ノードのデフォルトウィジェットをオーバーライドします。

Nomenclature item(命名項目)

命名項目は(キー、ラベル)ペアです。

/block_nomenclature_item.png

パラメーター

入力

説明

value

アイテムの値。

label

アイテムのラベル。

Not

指定されたブール値の逆数を返します。

/block_not.png

Object(オブジェクト)

(キー、値)ペアのリストで構成されるオブジェクト。

/block_object.png

パラメーター

入力

説明

content

「property」ブロックのリスト。

以下も参照してください。

Otherwise(それ以外の場合)

「choose」ブロックの最終選択。大文字と小文字が一致しない場合に返されます。

/block_otherwise.png

パラメーター

入力

説明

content

「When」ケースとの一致がない場合に返す値。

以下も参照してください。

Paragraph title(段落タイトル)

段落のタイトルを表示します。

/block_paragraph_title.png

パラメーター

入力

説明

label

表示するテキスト。

horizontal alignment

エレメントの水平方向の配置。設定されている場合、受け入れられる値は「start」、「end」、「center」です。

パスワード

入力パスワードウィジェットを表示します。

/block_password.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

Previous button(前のボタン)

「現在のページ」の値を1つ減らすボタン。

/block_button_previous.png

パラメーター

入力

説明

label

設定されている場合、デフォルトのラベルを上書きします。

default?

これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。

Property(プロパティ)

オブジェクトのプロパティ。

/block_object_property.png

パラメーター

入力

説明

name

プロパティの名前。特定のオブジェクトに対して一意である必要があります。

value

プロパティの値。

Radio button(ラジオボタン)

ラジオボタンウィジェットを表示します。

/block_radio_button.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

label enabled?

設定されている場合、ウィジェットの横にアイテムラベルを追加するかどうかを示します。

index

この列挙項目のインデックス。

specific nomenclature

設定されている場合、モデル駆動型の命名法を上書きします。

Radio button group(ラジオボタングループ)

ラジオボタングループウィジェットを表示します。

/block_radio_button_group.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

columns number

設定されている場合、ラジオボタンのレイアウトに使用する列の数を定義します。

specific nomenclature

設定されている場合、モデル駆動型の命名法を上書きします。

Revert button(元に戻すボタン)

標準の「元に戻す」ボタン。

/block_button_revert.png

パラメーター

入力

説明

label

設定されている場合、デフォルトのラベルを上書きします。

default?

これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。

Save button(保存ボタン)

標準の「保存」ボタン。

/block_button_save.png

パラメーター

入力

説明

label

設定されている場合、デフォルトのラベルを上書きします。

default?

これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。

Save and close button(保存して閉じるボタン)

標準の[保存して閉じる]ボタン。

/block_button_save_and_close.png

パラメーター

入力

説明

label

設定されている場合、デフォルトのラベルを上書きします。

default?

これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。

Tab(タブ)

「タブコンテナ」内のタブ。

/block_tab.png

パラメーター

入力

説明

node

存在する場合、タブのタイトル、説明、およびコンテンツはモデル駆動型になります。

title

タブのタイトル。ノードとタイトルが設定されている場合、モデル駆動型タイトルをオーバーライドできます。

description

タブの説明。ノードと説明が設定されている場合、モデル駆動型の説明を上書きできます。

content

タブの内容。ノードとコンテンツが設定されている場合、モデル駆動型コンテンツをオーバーライドする可能性があります。

以下も参照してください。

Tab container(タブコンテナ)

タブ名のリストと1つのアクティブなタブを表示するタブのコンテナ。

/block_tab_container.png

パラメーター

入力

説明

content

「タブ」のリスト。

以下も参照してください。

Text input(テキスト入力)

テキスト入力ウィジェットを表示します。

/block_text_input.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

height

設定されている場合、ウィジェットの高さをピクセル単位で定義します。

width

設定されている場合、ウィジェットの幅をピクセル単位で定義します。

multiline?

設定されている場合、ウィジェットが複数の行にまたがるかどうかを定義します。

background

設定されている場合、16進形式で背景色を定義します。

foreground

設定されている場合、前景色を16進形式で定義します。

Toolbar named(名前の付いたツールバー)

指定された名前のツールバー。

/block_toolbar_named.png

パラメーター

入力

説明

name

表示するツールバーの名前。

Variable(変数)

「with ... declare」ブロックによって宣言された変数への参照。変数がオブジェクトまたはノードの場合も、パスが受け入れられます。

/block_variable.png

パラメーター

入力

説明

expression

「with ... declare」ブロックによって宣言された変数への参照。変数がオブジェクトまたはノードの場合も、パスが受け入れられます。

When

「choose」ブロックでの選択。テストがtrueの場合、「then」コンテンツが返されます。それ以外の場合は、次のブロックがテストされます。

/block_when.png

パラメーター

入力

説明

when

このケースを解決する必要があるかどうかを示すブールテスト。

then

テストがtrueの場合、この値が返されます。

以下も参照してください。

Widget(ウィジェット)

デフォルトのウィジェットを表示します。

/block_widget.png

パラメーター

入力

説明

node

ウィジェットを表示するノード。

readonly?

ウィジェットを読み取り専用モードにする必要があるかどうかを示します。

With

「return」ステートメントで使用できる変数を宣言します。

/block_with.png

パラメーター

入力

説明

variables

「declare」ブロックのリスト。

return

返す値。 「variables」ステートメントで宣言された変数は、ここで 「var」ブロックとともに使用できます。

以下も参照してください。
ドキュメント>開発者ガイド>データモデル