フィールド・タイプとフィールド・プロパティ
フィールドは、数値フィールドや式フィールドなど、複数のタイプのいずれかになります。 また、各フィールド・タイプには標準プロパティのセットがあります。 フィールド・タイプおよび共通フィールド・プロパティについて学習するには、このトピックを参照してください。
このトピックの内容は、次のとおりです。
-
作成できるフィールドのタイプ
-
フィールドが他のコンポーネントと連携する方法
-
フィールドに指定できるフィールド・プロパティの共通セット
ほとんどのプロパティはすべてのタイプのフィールドに共通ですが、作成しているフィールドのタイプに固有のプロパティもあります。 たとえば、全てのフィールド・タイプには表示ラベルがありますが、検索用にインデックスを作成できるのは一部のフィールド・タイプのみです。
-
検索を高速化するためにフィールドを索引付けする方法
-
標準フィールドの変更
フィールド・タイプ
アプリケーション・コンポーザには、オブジェクトの新規フィールドを作成する際に、そこから選択できる標準フィールド・タイプ・セットが用意されています。
作成できるフィールドのタイプは次のとおりです。
-
チェック・ボックス
レコードの真または偽の属性を指定する場合に選択します。
-
通貨
通貨金額を入力します。
-
日付
日付を入力するか、カレンダから日付を選択します。
-
日時
日付を入力するか、カレンダから日付を選択し、時間を入力します。 フィールドの作成時に、日付または時刻を表示するかどうかを選択します。
-
動的選択リスト
別のオブジェクトのレコード・セットから移入された値のリストから選択します。
-
固定選択リスト
FND参照タイプから移入された静的値のリストから選択します。
-
Formula
formulaフィールドの定義に含まれるGroovyベースの式を使用してランタイム・アプリケーションで計算されます。 これは、ランタイム・アプリケーションのユーザーが更新しない読取り専用フィールドです。 ただし、アプリケーション・ロジックを記述して更新することはできます。
-
長いテキスト
文字、数字または記号の組合せを入力します。 このフィールド・タイプは32,000文字をサポートしています。
-
数値
数値を入力します。
-
パーセント
パーセントを入力します。 パーセント記号が自動的に追加されます。
-
レコード・タイプ
FND参照タイプから移入された静的値のリストから選択します。 ロールまたはページ・レイアウトに各選択リスト値を関連付けることができます。
-
テキスト
文字、数字または記号の組合せを入力します。 このフィールド・タイプには1500文字までの制限があります。
フィールドが他のコンポーネントと連携する方法
オブジェクトの新しいフィールドを作成する場合、アプリケーション・コンポーザでは一連の標準フィールド・タイプに制限されます。 選択できるフィールド・タイプは、拡張フレームワークの他のコンポーネントとすでに統合されているため、実装を拡張する際に最大限の柔軟性が提供されます:
-
すべてのフィールド・タイプはAPIデータ型に対応しています。 各フィールド・タイプには、customfield_cなどのAPI名があります。
式ビルダーを使用してサーバー・スクリプトを記述する場合は、この_cフィールド名を使用してフィールドを参照します。
-
すべてのフィールド・タイプは、webサービスXSDペイロードに対応しています。
-
アプリケーション・コンポーザのインポートおよびエクスポート機能を使用する場合、すべてのフィールド・タイプはインポートODIマッピングに対応します。
-
ほとんどのフィールド・タイプは、レポート用のカスタム・サブジェクト領域の作成に使用できるフィールドに対応しています。 例外には、長いテキスト・フィールドとフォーミュラ・フィールドが含まれます。
カスタム・フィールドの共通プロパティ
カスタム・フィールドを作成するときは、最初にフィールド・タイプを選択します。 フィールドの作成後にフィールド・タイプを変更することはできません。 指定したフィールド・タイプは、フィールドの作成時に定義する必要があるフィールド・プロパティを制御します。 一部のプロパティはフィールド・タイプ間で共通ですが、他のプロパティは特定のフィールド・タイプに固有です。
次の表に、カスタム・フィールドに対して定義できる共通フィールド・プロパティと、それらが表示されるフィールド構成ページのリージョン、およびこれらのプロパティを設定する必要がある適用可能なフィールド・タイプのリストを示します。 この表を使用して、新規フィールドの作成時に定義する必要がある共通プロパティを理解します。
|
フィールドのプロパティ |
説明 |
フィールド・プロパティ・リージョン |
関連フィールド・タイプ |
|---|---|---|---|
|
ラベル |
フィールドの表示ラベルを指定します。 ラベルは最大長80文字に制限する必要がありますが、最大長は適用されません。 |
外観 これらのプロパティによって、ランタイム・アプリケーションでユーザーがフィールドを表示する方法が制御されます。 |
このプロパティは、すべてのフィールド・タイプに対して設定します。 |
|
ヘルプ・テキスト |
ユーザーがランタイム・アプリケーションのフィールドにポインタを重ねると表示されます。 ラベルは最大長80文字に制限する必要がありますが、最大長は適用されません。 |
外観 |
このプロパティは、すべてのフィールド・タイプに対して設定します。 |
|
表示幅 |
使用しないでください。 フィールドの表示幅は、フィールド・タイプと解像度に基づいて動的に計算されます。 |
外観 |
使用しないでください。 |
|
名前 |
内部使用のみの一意のフィールド名。 フィールド名は、入力したフィールド・ラベルに基づいて自動的に入力されますが、スペースは表示されません。 フィールド名に使用できるのは、アンダースコアと英数字のみです。 次のことが必要です:
このプロパティは、フィールドの作成後に変更できません。 ヒント: 異なる名前で同じ表示ラベルを持つカスタム・フィールドを作成できます。 ただし、ユーザー・インタフェース・ページの構成時に同じ表示ラベルの2つのフィールドが表示されないようにするには、このシナリオは避けてください。
Groovyスクリプトで使用されるAPI名も、論理名を取得し、_cを追加して、フィールドに対して自動的に生成されます。 API名に特殊文字を使用しないでください。 また、API名は英語である必要があります。 そうしないと、どのページにもフィールドを追加できません。 |
名前 |
このプロパティは、すべてのフィールド・タイプに対して設定します。 |
|
説明 |
内部使用のみの一意のフィールド摘要。 |
名前 |
このプロパティは、すべてのフィールド・タイプに対して設定します。 |
|
必須 |
フィールドが必須かどうかを示します。 オプションで、式ビルダーを使用して、このフィールドを必須にするために適用する必要がある条件を指定する式を記述することもできます。 フィールドが必須かどうかを制御する式を記述する場合は、「依存先」選択リストも構成する必要があります。 この選択リストには、現在のオブジェクトのフィールドが含まれ、実行時に式の評価に使用されます。 必須フィールドにはデフォルト値は必要ありません。 ただし、オブジェクトの作成ページおよび詳細(更新および編集)ページ上のすべての必須フィールド(アプリケーション、モバイル、Outlook UIなど)を表示する必要があります。 デフォルト値を持たない必須フィールドは、オブジェクトの作成ページに自動的に追加されます。 ただし、デフォルト値を持つ必須フィールドは、手動で作成ページに追加する必要があります。 また、必須フィールドは詳細ページに自動的に追加されません。手動で追加する必要があります。 これにより、ユーザーは実行時にフィールドに入力できます。 サンドボックスがメイン・ライン・メタデータに公開される場合、オブジェクトのwebサービスにも必須フィールドが反映されます。 |
制約 制約を指定すると、フィールドの実行時の動作を制御できます。 |
このプロパティは、式フィールドを除くすべてのフィールド・タイプに対して設定します。 |
|
更新可能 |
フィールドが更新可能かどうかを示します。 オプションで、式ビルダーを使用して、このフィールドを更新可能にするために必要な条件を指定する式を記述することもできます。 フィールドが更新可能かどうかを制御する式を記述する場合は、「依存先」選択リストも構成する必要があります。 この選択リストには、現在のオブジェクトのフィールドが含まれ、実行時に式の評価に使用されます。 次に、更新可能なプロパティについて注意する点を示します:
|
制約 |
このプロパティは、式フィールドを除くすべてのフィールド・タイプに対して設定します。 |
|
検索可能 |
拡張検索モードで「フィールドの追加」選択リストから追加の検索基準としてこのフィールドを選択できるようにするかどうかを指定します。 |
制約 |
このプロパティは、長いテキスト・フィールドと式フィールドを除くすべてのフィールド・タイプに対して設定します。 「検索可能フィールドの作成」を参照してください。 |
|
索引付き |
フィールドを索引付けして、様々なオブジェクト作業領域での保存済検索のパフォーマンスを高速化します。 グローバル検索は影響を受けません。 このオプションを最も頻繁に検索されるカスタム・フィールドでのみ使用して、検索のパフォーマンスを最適化します。 「索引付けフィールド」を参照してください。 |
制約 |
このプロパティは、作成時または編集時に、次のフィールド・タイプに対して設定します:
次のフィールド・タイプはインデックス作成できません:
|
|
サービス・ペイロードに含める |
webサービス・リクエストまたはレスポンスにフィールド値を含めることができるかどうかを指定します。 |
制約 |
このプロパティは、すべてのフィールド・タイプに対して設定します。 |
|
固定値 |
フィールドのリテラルのデフォルト値を指定します。 実行時エラーが発生する可能性があるため、必須かつ一意となることを意図したフィールドにリテラル・デフォルト値を割り当てないでください。 |
デフォルト値 |
このプロパティは、式フィールドと動的選択リストを除くすべてのフィールド・タイプに対して設定します。 |
|
式 |
式ビルダーを使用して、実行時にフィールドのデフォルト値を動的に設定する式を記述します。 |
デフォルト値 |
このプロパティは、次のものを除くすべてのフィールド・タイプに対して設定します:
これらのフィールド・タイプについては、サーバー・スクリプトを記述します。 |
標準フィールドの変更
一部の標準フィールドのプロパティも変更できます。 次の表に、変更できるプロパティを示します。
|
フィールドのプロパティ |
説明 |
フィールド・プロパティ・リージョン |
|---|---|---|
|
必須 |
フィールドが必須かどうかを示します。 オプションで、式ビルダーを使用して、このフィールドを必須にするために適用する必要がある条件を指定する式を記述することもできます。 ただし、標準フィールドがOracleで必須にすでに設定されている場合は、フィールドを必須にしないように変更できません。 フィールドが必須かどうかを制御する式を記述する場合は、「依存先」選択リストも構成する必要があります。 この選択リストには、現在のオブジェクトのフィールドが含まれ、実行時に式の評価に使用されます。 必須フィールドにはデフォルト値は必要ありません。 ただし、オブジェクトの作成ページおよび詳細(更新および編集)ページに、これらのページが表示される場所(デスクトップ、アプリケーション、モバイル、Outlook UIなど)にすべての必須フィールドを公開する必要があります。 デフォルト値を持たない必須フィールドは、オブジェクトの作成ページに自動的に追加されます。 ただし、デフォルト値を持つ必須フィールドは、手動で作成ページに追加する必要があります。 また、必須フィールドは詳細ページに自動的に追加されません。手動で追加する必要があります。 これにより、ユーザーは実行時にフィールドに入力できます。 サンドボックスがメイン・ライン・メタデータに公開される場合、オブジェクトのwebサービスにも必須フィールドが反映されます。 |
制約 |
|
更新可能 |
フィールドが更新可能かどうかを示します。 オプションで、式ビルダーを使用して、このフィールドを更新可能にするために必要な条件を指定する式を記述することもできます。 フィールドが更新可能かどうかを制御する式を記述する場合は、「依存先」選択リストも構成する必要があります。 この選択リストには、現在のオブジェクトのフィールドが含まれ、実行時に式の評価に使用されます。 次に、更新可能なプロパティについて注意する点を示します:
|
制約 |
オブジェクト当たりのフィールド・タイプ数
オブジェクトには、合計625個のフィールドを含めることができます。 次の表では、この数値を様々なフィールド・タイプに分散する方法について説明します:
|
フィールド数 |
予約対象... |
|---|---|
|
350 |
|
|
200 |
|
|
50 |
|
|
25 |
長いテキスト・フィールド |
|
制限なし |
計算式フィールド ノート: 算式フィールドは計算済属性であり、実行時にのみ存在します。 これは、データベースに表の列として保持されない一時的なタイプの属性です。 したがって、オブジェクトには式フィールドの最大数が存在しません。
|