Skip to content
赞助合作

本站右侧赞助位长期招租

联系我投放

Property 属性

属性(Property)是 ItemType 的数据载体,每一个 Property 对应物理数据表中的一列。Aras 区分三种属性来源:系统自动创建的 System Properties、管理员手动添加的 Custom Properties,以及跨 ItemType 共享的 Extended Properties


系统属性

每当新建一个 ItemType 并保存后,Aras 会自动为其创建 23 个系统属性。这些属性由平台内部管理,不应删除或修改其功能语义。

属性名类型说明
idString32 位全企业唯一 GUID,记录的物理主键
config_idString跨版本共享的配置标识,所有 Generation 记录保持一致
created_by_idItem创建该记录的 User ID
created_onDate创建时间
modified_by_idItem最后修改该记录的 User ID
modified_onDate最后修改时间
current_stateItem当前 Lifecycle State 的 ID
stateString当前状态名称(文本)
is_currentBoolean是否为最新版本
is_releasedBoolean是否处于已发布状态
generationInteger版本代次,每次编辑并保存后自动递增
major_revString主修订版本号(如 A、B、C)
minor_revString次修订版本号(保留字段,默认未使用)
keyed_nameString键名,用于界面显示的友好标识
permission_idItem当前生效的权限包 ID
locked_by_idItem锁定该记录的 User ID(Edit 状态时设置)
owned_by_idItem拥有者身份 ID,对应 Owner 动态身份
managed_by_idItem管理者身份 ID,对应 Manager 动态身份
team_idItem当前关联的 Team ID
not_lockableBoolean是否允许被锁定编辑(Lifecycle 状态控制)
new_versionBoolean标记该版本是否为新版本
classificationString扩展分类路径
cssString级联样式表标识

自定义属性

管理员为特定 ItemType 创建的业务字段。建议在自定义属性名前加下划线前缀(如 _title_cost),便于与系统属性区分。

数据类型一览

数据类型存储方式说明
Stringnchar(n)固定长度字符串,需指定 Length
Textnvarchar(max)可变长度字符串,最大长度由数据库决定
Integerint整数
Decimaldecimal(p,s)定点数,需配置 Precision(总位数)和 Scale(小数位数)
Floatfloat浮点数
Booleanbit真/假,界面显示为复选框
Datedatetime日期与时间,支持日历选择控件和多种格式掩码
ImageVault 引用图片文件,存储在 Vault 中,数据库记录文件 ID
Listnchar(n)下拉列表,关联一个预定义的 List 元数据
Filter Listnchar(n)级联过滤列表,列表项受另一个属性值约束
Color Listnchar(n)彩色下拉列表,每项显示不同背景色,存储十六进制颜色值
Multi Value Listnchar(n)多选列表,选中值以逗号分隔存储
ItemGUID外键关联,指向另一个 ItemType 的具体记录
Foreign计算字段联动属性,通过 Item 类型属性拉取关联记录的其他字段值,不在物理表中存储
Federated无存储联合字段,数值在运行时由 Server Method 从外部系统获取,不在数据库中存储
Sequencenchar(n)自动编号,基于 Sequence 模板每次创建时递增
MD5nchar(32)密码散列字段,存储 32 位十六进制 MD5 值
Formatted Textnvarchar(max)富文本,支持 HTML 格式化编辑
Multilingual String多语言存储多语言字符串,每种已安装语言可存储独立值

属性配置项

属性的各项配置项在 ItemType 的 Properties 标签页中设置:

基本设置

配置项说明
LengthString 类型的最大字符长度
PrecisionDecimal 类型的总有效位数
ScaleDecimal 类型的小数位数
Required是否必填。设为 true 时,保存前会强制校验字段不为空
Unique是否唯一。对多个属性同时设为 Unique,表示这些属性的组合值必须唯一
Indexed是否在该列上创建数据库索引,提升查询性能
Default Value新建记录时的默认值,必须与数据类型匹配

网格显示设置

配置项说明
Hidden是否在主搜索网格中隐藏该列
Hidden2是否在关系网格中隐藏该列
Alignment网格中的对齐方式:Left / Right / Center
Width列宽(像素)
Sort Order列的显示顺序,数值小的靠左
Order By排序优先级,数值小的先排序

Keyed Name(键名)

键名决定了 Item 在快速搜索、标签标题、外键引用等场景下的显示文本。没有配置键名时,默认显示 GUID。

通过为属性设置 Keyed Name Order(整数值),可以将多个属性拼接为键名,数值表示拼接顺序:

例:User 的 last_name 设为 1,first_name 设为 2,键名显示为 Smith Peter


特殊配置说明

Pattern(格式掩码)

针对 Date 类型和 String 类型,Pattern 提供格式约束:

Date 类型支持的内置格式:

格式名称示例
Short Datemm/dd/yyyy
Short Date and Timemm/dd/yyyy hh:mm:ss AM/PM
Long DateDayOfWeek, Month dd, yyyy
Long Date and TimeDayOfWeek, Month dd, yyyy hh:mm:ss AM/PM

String 类型 支持正则表达式约束,例如要求输入电话号码格式:

[0-9]{3}-[0-9]{3}-[0-9]{4}$

Foreign Property(联动属性)

当一个属性的数据类型为 Item 时,可以再创建一个 Foreign 类型属性,通过 Foreign Property 字段指定要拉取关联 Item 的哪个属性值。

示例:在采购单中关联了 Vendor(Item 类型),再添加一个 Foreign 属性拉取 Vendor 的电话号码,实现数据联动展示。

Item Behavior(版本行为)

当 Item 类型属性的目标 ItemType 开启了版本控制时,需要设置关联行为:

行为说明
Fixed固定关联到添加时的那个版本,不会随目标记录升版而变化
Float始终指向目标记录的最新版本

Extended Properties(扩展属性)

扩展属性由 Classification Administrator 在全局范围内创建,通常用于存储跨 ItemType 共享的通用信息(如型号、尺寸、颜色、重量等)。

扩展属性可以组织成树形分类结构(Extended Classification),在 Item 上通过 classification 字段选择分类路径,系统自动关联对应的扩展属性集。

扩展属性 vs 自定义属性

如果某个属性只属于一个 ItemType,用 Custom Property。如果需要在多个 ItemType 之间共享同一组属性定义,用 Extended Property。

本站内容仅供学习与参考

本站总访问量