字段

所有与数据库中数据表关联的实体项都有一个 fields 属性 —— 一个字段对象列表，用于表示实体项对应的表中的字段。

每个字段都有以下属性：

客户端	服务器端	描述
owner	owner	拥有此字段的实体项。
owner	owner	拥有此字段的实体。
field_name	field_name	字段的名称，将在编程代码中用于访问字段对象。
field_name	field_name	字段的名称，将在编程代码中用于访问字段对象。
field_caption	field_caption	向用户显示的字段标题。
field_caption	field_caption	向用户显示的字段名称。
field_type	field_type	字段类型，为以下值之一： text 、 integer 、 float 、 currency 、 date 、 datetime 、 boolean 、 blob 。
field_type	field_type	字段类型，为以下值之一： text 、 integer 、 float 、 currency 、 date 、 datetime 、 boolean 、 blob 。
field_size	field_size	类型为 text 的字段的大小。
field_size	field_size	类型为 text 的字段的大小。
required	required	指定字段是否需要非空值。
required	required	指定字段是否需要非空值。

为了访问实体项对应的数据集数据，Field 类具有以下属性：

Client	Server	Description
value	value	使用此属性获取或设置当前记录的字段值。读取时，值会转换为字段的类型。因此，对于 integer、float 和 currency 类型的字段，如果数据库表记录中此字段的值为 NULL，则此属性的值为 0。要获取未转换的值，请使用 raw_value 属性。
text	text	使用此属性以文本形式获取或设置字段的值。
lookup_value	lookup_value	使用此属性获取或设置查找值，请参阅查找字段。
lookup_text	lookup_text	使用此属性以文本形式获取或设置字段的查找值，请参阅查找字段。
display_text	display_text	表示字段值在数据感知控件中的显示形式。如果字段是查找字段，则其值为 lookup_text 值；否则，根据项目区域设置参数，取其 text 值。此行为可由拥有该字段的实体的 on_field_get_text 事件处理程序覆盖。
raw_value	raw_value	使用此属性获取当前记录的字段值，这与存储在数据库中的形式一致。不进行任何转换。

此外，每个字段都是其所属实体的一个属性。因此，要访问实体的字段，请使用以下语法： item.field_name

invoices.total.value

invoices.total 是对 发票(Invoices) 实体的 总计(Total) 字段的引用，而 invoices.total.value 是该字段的值。

以下是演示项目中 发票(Invoices) 实体项的字段的属性值：

customer integer
   value:  2
   text:  2
   lookup_value:  Köhler
   lookup_text:  Köhler
   display_text:  Leonie Köhler
firstname integer
   value:  2
   text:  2
   lookup_value:  Leonie
   lookup_text:  Leonie
   display_text:  Leonie
billing_address integer
   value:  2
   text:  2
   lookup_value:  Theodor-Heuss-Straße 34
   lookup_text:  Theodor-Heuss-Straße 34
   display_text:  Theodor-Heuss-Straße 34
id integer
   value:  1
   text:  1
   lookup_value:  None
   lookup_text:
   display_text:  1
date date
   value:  2014-01-01
   text:  01/01/2014
   lookup_value:  None
   lookup_text:
   display_text:  01/01/2014
total currency
   value:  2.08
   text:  $2.08
   lookup_value:  None
   lookup_text:
   display_text:  $2.08