カスタムフォーム
この章では、TIBCO EBX®によってカスタムフォームがどのように定義および管理されるかについて詳しく説明します。
関連する概念:
Related information
アクセス
フォームとコンポーネント
フォームとコンポーネントの両方を「カスタムフォーム」データモデル拡張で作成できます。
-
**フォームはレコードのレイアウトを記述します。**フォームは、レコードや入力パラメーターなどのコンテキスト情報にアクセスできます。フォームを作成するとき、ユーザーはそのターゲットテーブルを提供するように求められます。作成されると、テーブルのデフォルトフォームとして宣言できます。拡張機能の「デフォルトフォーム」テーブル、またはターゲットテーブルの「拡張機能」タブのいずれかで宣言できます。テーブルのデフォルトではないフォームは使用されません。
-
コンポーネントは再利用可能なフラグメントです。フォームと他のコンポーネント間で共有できます。フォームとは異なり、コンポーネントはコンテキスト情報にアクセスできません。このような情報が必要な場合は、呼び出し元から明示的に提供する必要があります。
エディター
フォームまたはコンポーネントは、ブロックの積み重ねに過ぎません。ブロックは、具体的なグラフィックエレメントまたはロジックの一部を表すことができ、権限、言語などの条件に基づいて異なるレイアウトを持つことができます。
ワークスペースには、事前定義されたルートブロック内にフォームの説明が含まれています。このルートに接続されていないブロックは、非アクティブとしてマークするためにグレー表示されます。 ブロックを移動するには、ドラッグアンドドロップする必要があります。ブロックをドラッグすると、その下に接続されているブロックもドラッグされます。ブロックを1つだけ移動する必要がある場合は、Ctrlキーを押しながらクリックします。ワークスペースのブロックを右クリックすると、展開/折りたたみ、コメント、ヘルプなどのオプションのリストも表示されます。
左側のツールボックスには、カテゴリのリストが表示されます。カテゴリをクリックすると、そのカテゴリに含まれるブロックが表示されます。一部のカテゴリには、関連する「テンプレート」セクションがあります。このセクションは、セクションのブロックのいくつかの組み合わせを提供し、便利なショートカットまたはサンプルと見なすことができます。
ブロック
ツールボックスに表示されるすべてのブロックのリストは次のとおりです。
算術演算子
2つの整数の演算。
Array(配列)
配列アイテム
ブール演算子
2つのブール値の操作。
Check box(チェックボックス)
チェックボックスウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
label enabled? |
設定されている場合、ウィジェットの横にアイテムラベルを追加するかどうかを示します。 |
index |
この列挙項目のインデックス。 |
specific nomenclature |
設定されている場合、モデル駆動型の命名法を上書きします。 |
Check box group(チェックボックスグループ)
チェックボックスグループウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
columns number |
設定されている場合、チェックボックスのレイアウトに使用する列の数を定義します。 |
specific nomenclature |
設定されている場合、モデル駆動型の命名法を上書きします。 |
Children(子)
指定されたノードの子のリストを返します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
子を抽出するための複雑なノード。 |
Choose(選択)
「when」/「otherwise」ブロックの内側の1つのコンテンツを返すブロック。
パラメーター
Close button(閉じるボタン)
標準の「閉じる」ボタン。
パラメーター
| 入力 | 説明 |
|---|---|
label |
設定されている場合、デフォルトのラベルを上書きします。 |
default? |
これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。 |
Color picker(カラーピッカー)
カラーピッカーウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
Combo box(コンボボックス)
コンボボックスウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
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つの整数を比較します。
比較
文字列、数値、またはブール値を比較します。
配列の連結
指定された配列の連結を返します。
パラメーター
| 入力 | 説明 |
|---|---|
arrays |
配列のリスト。 |
定数
定数値。コンテキストに応じて、この値はテキスト、ブール値、または数値として解釈される場合があります。
パラメーター
| 入力 | 説明 |
|---|---|
value |
テキスト、ブール値、または数値。 |
コンテンツタイトル
ワークスペースのコンテンツタイトルを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
label |
表示するテキスト。 |
horizontal alignment |
エレメントの水平方向の配置。設定されている場合、受け入れられる値は「start」、「end」、「center」です。 |
Creating record?(レコードを作成しますか?)
フォームがレコードの作成または複製のコンテキストで表示されるかどうかを示すブール値を返します。
Custom action bar(カスタムアクションバー)
カスタムアクションバー。
パラメーター
| 入力 | 説明 |
|---|---|
start |
アクションバーの左側に表示する「ボタン」のリスト。 |
middle |
アクションバーの中央に表示する「ボタン」のリスト。 |
end |
アクションバーの右側に表示する「ボタン」のリスト。 |
Date time input(日時入力)
入力した日付/時刻を表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
date picker button displayable? |
日付ピッカーを開くボタンが表示されているかどうかを示します(読み取り/書き込みモードのみ)。 |
now button displayed? |
日付を現在時刻に設定するボタンが表示されているかどうかを示します(読み取り/書き込みモードのみ)。 |
Declare(宣言)
「with」ブロックでの変数の宣言。
パラメーター
| 入力 | 説明 |
|---|---|
name |
変数の名前。特定の 「with」ブロックに対して一意である必要があります。 |
content |
これを参照する 「var」ブロックによって返される変数の値。 |
以下も参照してください。:
Default action bar(デフォルトアクションバー)
デフォルトのアクションバー。
Default toolbar(デフォルトツールバー)
モデル駆動型ツールバー。
Duplicating record?(レコードを複製しますか?)
フォームがレコード複製のコンテキストで表示されるかどうかを示すブール値を返します。
Expand/Collapse(展開/折りたたみ)
展開/折りたたみブロック内にコンテンツを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
label |
矢印の横に表示されるラベル。 |
collapsed? |
グループが最初に折りたたまれているかどうかを示します。 |
content |
折りたたみ可能なコンポーネントのリスト。 |
Flow(フロー)
その内容を流動的に表示します。エレメントが1つの行または列に収まらない場合、エレメントは折り返され、新しいエレメントが開始されます。
パラメーター
| 入力 | 説明 |
|---|---|
direction |
「horizontal」または「vertical」は、コンテンツをキューに入れる方向を示します。 |
item spacing |
エレメント間のスペース(ピクセル単位)。 |
content |
水平または垂直に表示するエレメントのリスト。 |
For each
「of」配列の各項目に適用された 「body」関数の結果で構成される配列を返します。
パラメーター
| 入力 | 説明 |
|---|---|
item |
現在のアイテムを含む変数の名前。 |
array |
変換するアイテムを含む配列。 |
return |
現在のアイテムに対して何を返すか。 |
Form(フォーム)
左側にラベル、右側に値がある標準のテーブルのようなレイアウト。
パラメーター
Form definition(フォーム定義)
フォームの実際の定義。
パラメーター
| 入力 | 説明 |
|---|---|
toolbar |
フォームの上部に表示されるツールバーの定義。 |
action bar |
フォームの下に表示されるアクションバーの定義。 |
help URL |
ヘルプページのURL。 |
content |
レイアウトの内容。 |
Form group(フォームグループ)
「フォーム」内に、折りたたみ可能なアイテムのグループを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
設定されている場合、グループラベル、説明、およびコンテンツはモデル駆動型になります。 |
label |
グループのラベル。ノードとラベルが設定されている場合、モデル駆動ラベルをオーバーライドできます。 |
description |
グループの説明。ノードと説明が設定されている場合、モデル駆動型の説明を上書きできます。 |
open? |
グループが最初に開いているかどうかを示します。 |
content |
「フォーム行」、「フォームグループ」またはノードのリスト。ノードはモデル駆動型の表示になり、「フォーム行」と「フォームグループ」でカスタムコンテンツを表示できます。 |
以下も参照してください。:
Form row(フォーム行)
「フォーム」または「フォームグループ」内に、基本的にラベルと値である行を表示します。
パラメーター
Form parameter(フォームパラメーター)
From...get(から...取得)
オブジェクトまたはノードから値を抽出します。
<from "node" get "path/to/value">は<var "node/path/to/value">と同等です。
パラメーター
| 入力 | 説明 |
|---|---|
from |
データを抽出するベースオブジェクトまたはノード。 |
get |
「from」のオブジェクト内で抽出するデータのパス。 |
Function(関数)
無名関数の定義。関数は、本体のパラメーターを使用して結果を返します。
パラメーター
Function call(関数呼び出し)
パラメーターに実際の値を設定して関数を呼び出します。
パラメーター
Function call argument(関数呼び出し引数)
呼び出された関数のパラメーターに渡す実際の値。
パラメーター
Function parameter(関数パラメーター)
これは、関数のパラメーターの宣言です。
パラメーター
| 入力 | 説明 |
|---|---|
name |
パラメーターの名前。 |
mandatory? |
このパラメーターを呼び出し元が指定する必要があるかどうかを示します。 |
default value |
設定されている場合、これは、呼び出し元が指定しない場合にこのパラメーターがとるデフォルト値です。 |
以下も参照してください。:
Grid(グリッド)
座標を使用してコンポーネントをグリッドに配置できるレイアウト。
パラメーター
| 入力 | 説明 |
|---|---|
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」のコンテンツのいずれかを返すブロック。
パラメーター
| 入力 | 説明 |
|---|---|
test |
返す値を決定するテスト。これはブール値である必要があります。 |
then |
テストがtrueの場合に返される値。 |
else |
テストがfalseの場合に返される値。 |
Input parameter(入力パラメーター)
入力パラメーターの生の値を返します。
パラメーター
| 入力 | 説明 |
|---|---|
name |
パラメーター名。 |
In role?(役割は?)
現在のユーザーが要求されたロールを持っているかどうかを示すブール値を返します。
Label(ラベル)
指定されたノードのラベルを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ラベルを表示するノード。 |
Localized(ローカライズ)
どの結果がユーザーロケールに依存するかをブロック化します。
パラメーター
| 入力 | 説明 |
|---|---|
locale |
各パラメーターはロケールに関連しています。ブロック化の結果は、現在のユーザーのロケールに対応するものになります。 |
Message(メッセージ)
javaのような{0}、{1}などのプレースホルダーを指定されたインデックスの引数に置き換えることにより、指定されたテキストをフォーマットします。
パラメーター
| 入力 | 説明 |
|---|---|
pattern |
指定された引数に置き換えられるプレースホルダー({0}、{1}など)を含むテキスト。 |
arguments |
パターン内のプレースホルダーを置き換える値のリスト。 |
Next button(次へボタン)
「現在のページ」の値を1つインクリメントするボタン。
パラメーター
| 入力 | 説明 |
|---|---|
label |
設定されている場合、デフォルトのラベルを上書きします。 |
default? |
これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。 |
ノード
既存のノードの定義を上書きします。
パラメーター
| 入力 | 説明 |
|---|---|
base |
オーバーライドするノード。 |
mandatory? |
設定されている場合、ベースノードの必須インジケーターをオーバーライドします。 |
label |
設定されている場合、ノードのラベルを上書きします。 |
description |
設定されている場合、ノードのラベルを上書きします。 |
widget |
設定されている場合、ノードのデフォルトウィジェットをオーバーライドします。 |
Nomenclature item(命名項目)
命名項目は(キー、ラベル)ペアです。
パラメーター
| 入力 | 説明 |
|---|---|
value |
アイテムの値。 |
label |
アイテムのラベル。 |
Not
指定されたブール値の逆数を返します。
Object(オブジェクト)
(キー、値)ペアのリストで構成されるオブジェクト。
パラメーター
Otherwise(それ以外の場合)
「choose」ブロックの最終選択。大文字と小文字が一致しない場合に返されます。
パラメーター
Paragraph title(段落タイトル)
段落のタイトルを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
label |
表示するテキスト。 |
horizontal alignment |
エレメントの水平方向の配置。設定されている場合、受け入れられる値は「start」、「end」、「center」です。 |
パスワード
入力パスワードウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
Previous button(前のボタン)
「現在のページ」の値を1つ減らすボタン。
パラメーター
| 入力 | 説明 |
|---|---|
label |
設定されている場合、デフォルトのラベルを上書きします。 |
default? |
これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。 |
Property(プロパティ)
オブジェクトのプロパティ。
パラメーター
| 入力 | 説明 |
|---|---|
name |
プロパティの名前。特定のオブジェクトに対して一意である必要があります。 |
value |
プロパティの値。 |
Radio button(ラジオボタン)
ラジオボタンウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
label enabled? |
設定されている場合、ウィジェットの横にアイテムラベルを追加するかどうかを示します。 |
index |
この列挙項目のインデックス。 |
specific nomenclature |
設定されている場合、モデル駆動型の命名法を上書きします。 |
Radio button group(ラジオボタングループ)
ラジオボタングループウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
columns number |
設定されている場合、ラジオボタンのレイアウトに使用する列の数を定義します。 |
specific nomenclature |
設定されている場合、モデル駆動型の命名法を上書きします。 |
Revert button(元に戻すボタン)
標準の「元に戻す」ボタン。
パラメーター
| 入力 | 説明 |
|---|---|
label |
設定されている場合、デフォルトのラベルを上書きします。 |
default? |
これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。 |
Save button(保存ボタン)
標準の「保存」ボタン。
パラメーター
| 入力 | 説明 |
|---|---|
label |
設定されている場合、デフォルトのラベルを上書きします。 |
default? |
これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。 |
Save and close button(保存して閉じるボタン)
パラメーター
| 入力 | 説明 |
|---|---|
label |
設定されている場合、デフォルトのラベルを上書きします。 |
default? |
これが「Enter」を押したときにトリガーされるアクションであるかどうかを示します。デフォルトのボタンは1つだけにする必要があります。 |
Tab(タブ)
「タブコンテナ」内のタブ。
パラメーター
| 入力 | 説明 |
|---|---|
node |
存在する場合、タブのタイトル、説明、およびコンテンツはモデル駆動型になります。 |
title |
タブのタイトル。ノードとタイトルが設定されている場合、モデル駆動型タイトルをオーバーライドできます。 |
description |
タブの説明。ノードと説明が設定されている場合、モデル駆動型の説明を上書きできます。 |
content |
タブの内容。ノードとコンテンツが設定されている場合、モデル駆動型コンテンツをオーバーライドする可能性があります。 |
以下も参照してください。:
Tab container(タブコンテナ)
タブ名のリストと1つのアクティブなタブを表示するタブのコンテナ。
パラメーター
Text input(テキスト入力)
テキスト入力ウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
height |
設定されている場合、ウィジェットの高さをピクセル単位で定義します。 |
width |
設定されている場合、ウィジェットの幅をピクセル単位で定義します。 |
multiline? |
設定されている場合、ウィジェットが複数の行にまたがるかどうかを定義します。 |
background |
設定されている場合、16進形式で背景色を定義します。 |
foreground |
設定されている場合、前景色を16進形式で定義します。 |
Toolbar named(名前の付いたツールバー)
指定された名前のツールバー。
パラメーター
| 入力 | 説明 |
|---|---|
name |
表示するツールバーの名前。 |
Variable(変数)
「with ... declare」ブロックによって宣言された変数への参照。変数がオブジェクトまたはノードの場合も、パスが受け入れられます。
パラメーター
| 入力 | 説明 |
|---|---|
expression |
「with ... declare」ブロックによって宣言された変数への参照。変数がオブジェクトまたはノードの場合も、パスが受け入れられます。 |
When
「choose」ブロックでの選択。テストがtrueの場合、「then」コンテンツが返されます。それ以外の場合は、次のブロックがテストされます。
パラメーター
Widget(ウィジェット)
デフォルトのウィジェットを表示します。
パラメーター
| 入力 | 説明 |
|---|---|
node |
ウィジェットを表示するノード。 |
readonly? |
ウィジェットを読み取り専用モードにする必要があるかどうかを示します。 |
With
「return」ステートメントで使用できる変数を宣言します。
パラメーター
| 入力 | 説明 |
|---|---|
variables |
「declare」ブロックのリスト。 |
return |
返す値。 「variables」ステートメントで宣言された変数は、ここで 「var」ブロックとともに使用できます。 |
以下も参照してください。:






