注释
社区兴趣团体现已从 Yammer 迁移到Microsoft Viva Engage。 若要加入 Viva Engage 社区并参与最新讨论,请填写 “请求访问财务和运营 Viva Engage 社区 ”表单,然后选择要加入的社区。
本文介绍应用程序资源管理器中项Microsoft Visual Studio 的“属性” 窗口中显示的属性。
应用程序资源管理器中的许多节点表示具有关联属性的元素。 可以在 Microsoft Visual Studio 的 “属性” 窗口中读取或修改这些属性。
系统和通用属性
应用程序资源管理器中的大多数应用程序对象都有一组标准系统属性。 这些系统属性是只读的。 使用 “属性” 窗口查看应用程序资源管理器中任何项的属性。 若要打开 “属性” 窗口,请右键单击应用程序资源管理器中的节点,然后选择“ 属性”。 在“属性”窗口的“类别”选项卡上,许多系统属性显示在“统计信息”节点下。 本文列出了许多应用程序资源管理器节点上显示但并非全部的其他常见属性。 下表显示了几乎所有应用程序资源管理器节点上显示的系统属性。 所有这些系统属性都是只读的。
| 资产 | Description |
|---|---|
| ChangedBy | 上次更改对象的用户(通常是发布版本)。 |
| ChangedDate | 上次更改对象的日期。 |
| ChangedTime | 上次更改对象的时间。 |
| CreatedBy | 创建对象的用户。 |
| CreationDate | 创建对象的日期。 |
| CreationTime | 创建对象的时间。 |
下表显示了许多应用程序资源管理器节点上显示但并非全部的其他常见属性。
| 资产 | Description |
|---|---|
| ConfigurationKey | 指定控制对元素的访问或显示的配置键。 如果用户无权访问配置键,则元素不可见。 元素包括页面、页面、表和其他元素上的控件。 |
| LegacyID | 早期版本中的标识符元素。 从以前的版本升级期间,旧标识符将分配给 LegacyID。 未分配特定于安装的标识符,业务逻辑保持不变。 此属性不用于新元素。 |
| NeededAccessLevel | 用户所需的最低访问级别。 此属性为只读。 |
| Origin | 应用程序资源管理器元素的全局唯一标识符(GUID)。 此属性用于在同步和升级方案中标识元素。 它是一个只读属性,在系统分配该值后,该值永远不会更改。 系统中的任何位置都没有复制源 GUID 值。 |
| SecurityKey | 此属性已过时,但在从早期版本升级的系统中保留供参考。 |
基本枚举属性
下表描述了可用于枚举的属性。
| 资产 | Description |
|---|---|
| AnalysisUsage | 指定多维数据集中枚举的角色。 此设置会自动传播到引用枚举的所有表字段。 但是,可以替代表字段上的设置。 可使用以下选项: - Attribute - 引用枚举的字段是维度属性。 - None - 引用枚举的字段不是维度属性。 |
| ConfigurationKey | 指定配置键。 |
| CountryRegionCodes | 指定视图适用或有效的国家/地区的代码。 在单个字符串中将此属性作为国际标准化组织(ISO)国家/地区代码的逗号分隔列表实现。 这些值必须与全局通讯簿中的数据匹配。 客户端框架和应用程序可能使用此属性启用或禁用国家/地区特定的功能。 |
| DisplayLength | 指定显示的字符数。 默认值为 “自动”。 |
| Help | 为字段创建帮助字符串。 在页面上使用字段时,将显示帮助字符串。 |
| 标签 | 指定在页面和报表上显示的标签。 |
| 型号 | 指定表位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表和类。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| Name | 指定枚举名称。 枚举名称必须指示可能的枚举值或枚举值的类型。 根据可能的值命名的枚举示例包括 InclExcl 和 NextPrevious。 根据枚举值的类型命名的枚举示例是 ArrivalPostingType 和 ListStatus。 |
| Style | 更改枚举的默认外观。 可使用以下选项: - 组合框 - 单选按钮 |
| UseEnumValue | 值为 Yes 表示已修改 EnumValue 属性的默认值。 No 的值将 EnumValue 属性重置为默认值。 |
扩展数据类型属性
扩展数据类型 (EDT) 属性分为以下组,具体取决于它们是所有 EDT 通用的,还是仅适用于某些基数据类型。
所有 EDT 通用的属性
| 资产 | Description |
|---|---|
| 协调 | 更改文本的对齐方式。 可用选项为 Left、 Right 和 Center。 |
| AnalysisDefaultSort | 为具有此 EDT 的报表模型中的字段指定默认排序顺序。 |
| AnalysisDefaultTotal | 指定度量值的聚合函数。 当 AnalysisUsage 属性设置为 Measure 时,请使用此属性。 可使用以下选项: - Sum - 返回集中所有值的总和。 - Count - 返回集中非 null 项的数目。 - CountDistinct - 返回集中非 null 项的非空项数。 - 最小值 - 返回集中的最小值。 - Max - 返回集中的最大值。 - 无 - 未应用聚合函数。 - 自动 - 此选项适用于派生的 EDT。 使用父 EDT 的 AnalysisUsage 属性的值。 可以在字段级别重写聚合函数。 换句话说,可以使用该字段的 AnalysisDefaultTotal 属性更改字段的聚合函数。 |
| AnalysisGrouping | 使用报表生成器为 Microsoft SQL Server Reporting Services (SSRS)指定当字段添加到报表时,是否默认对具有此 EDT 的字段进行分组。 对于货币金额,此属性会自动设置为 “不鼓励 ”。 对于唯一的其他字段,请将此属性设置为“不鼓励”。 |
| AnalysisUsage | 指定多维数据集中 EDT 的角色。 此设置会自动传播到引用 EDT 的所有表字段。 但是,可以替代表字段上的设置。 可使用以下选项: - 属性 - 引用 EDT 的字段是维度属性。 - 度量 值 - 引用 EDT 的字段是度量值。 - 两者 - 引用 EDT 的字段既是维度属性,又是度量值。 - None - 引用 EDT 的字段既不是维度属性,也不是度量值。 - 自动 - 此选项适用于派生的 EDT。 使用父 EDT 的 AnalysisUsage 属性的值。 注意: 基于枚举的数据类型不能是度量值。 |
| ArrayLength | 此属性为只读。 默认值为 1。 若要将数组元素添加到 EDT,请右键单击 Array 元素 节点,然后单击“ 新建数组元素”。 ArrayLength 属性的值增加以反映此更改。 |
| ButtonImage | 指定当 EDT 用于页面上的查找按钮时显示的图像。 可使用以下选项: - 箭头 - 邮件 - 例如,可以为 电子邮件 类型选择此选项。 - URL - 例如,可以为 URL 类型选择此选项。 - ThreeDots (...) - OpenFile - 例如,可以为 FilenameOpen 和 FilenameSave 类型选择此选项。 - 日历 - 例如,可以为日期类型选择此选项。 默认值为 Arrow。 |
| CollectionLabel | 指定用于显示具有此 EDT 的字段的复数名称的标签。 |
| ConfigurationKey | 指定 EDT 的配置键。 |
| CountryRegionCodes | 指定菜单适用或有效的国家或地区的代码。 在单个字符串中将此属性作为 ISO 国家/地区代码的逗号分隔列表实现。 这些值必须与全局通讯簿中的数据匹配。 客户端使用此属性启用或禁用国家或地区特定的功能。 |
| DisplayLength | 指定页面或报表上显示的最大字符数。 |
| EnumType | 指定枚举数据类型。 必须为 枚举 类型的 EDT 设置此属性。 |
| 扩展 | 使用此属性将 EDT 基于另一个 EDT。 |
| FormHelp | 指定从页面上的字段执行查找时要使用的页面。 |
| HelpText | 为 EDT 创建帮助字符串。 当在页面上使用类型时,将显示帮助字符串。 |
| ID | 此属性为只读。 |
| 标签 | 指定在页面或报表上使用类型时用于该类型的标签。 |
| 型号 | 指定表位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表和类。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| Name | 指定类型的名称。 该名称用于引用 X++ 中的类型。 |
| PresenceClass | 指定与 PresenceMethod 属性一起使用以返回 PresenceInfo 对象的实例的 X++ 类。 |
| PresenceIndicatorAllowed | 指定引用 EDT 的控件是否应使用状态。 默认值为是。 |
| PresenceMethod | 对于 PresenceClass 属性中指定的 X++ 类,请指定应通过使用控件数据值调用的 X++ 静态类方法。 此方法返回 PresenceInfo 对象的实例,该对象包含状态指示器所需的数据。 |
| ReferenceTable | 指定此 EDT 引用且具有主键的表。 换句话说,此属性指示此 EDT 引用的主键表。 |
| Style | 更改 EDT 的默认外观。 可使用以下选项: -自动 - 组合框 - 单选按钮 |
仅适用于某些基本数据类型的属性
除非下表另有说明,否则请将所有这些属性都设置为 “自动”。
| 资产 | 属性所在的类型 | Description |
|---|---|---|
| 调整 | String | 对于长度固定的字符串,请指定输入的字符应存储在填充空格的左侧还是右侧。 可用选项为 Left 和 Right。 默认值为 Left。 |
| AllowNegative | IntegerInt64Real | 指定字段是否可以接受负值。 |
| AutoInsSeparator | 雷亚尔 | 指定系统是否应自动插入小数分隔符。 例如,如果输入 2222,系统会自动显示 2222.00。 |
| ChangeCase | String | 指定应如何设置字符串控件中输入的文本的格式。 例如,文本可以格式化为所有大写字母,也可以使用标题大写。 注意: 企业门户不支持此属性。 |
| DateDay | DateUtcDateTime | 指定应如何显示日期。 |
| DateFormat | DateUtcDateTime | 指定日期的布局。 |
| DateMonth | DateUtcDateTime | 指定应如何显示月份。 |
| DateSeparator | DateUtcDateTime | 指定年、月和日之间的分隔符。 |
| DateYear | DateUtcDateTime | 指定应如何显示年份。 |
| DecimalSeparator | 雷亚尔 | 指定小数分隔符。 使用默认设置(自动)时,将使用系统设置中指定的小数分隔符。 |
| DisplaceNegative | IntegerInt64Real | 指定是否将负数与左侧对齐。 |
| DisplayHeight | String | 指定在页面上显示 EDT 时要同时显示的行数。 |
| EnumType | Enum | 指定用于创建 EDT 的基本枚举。 |
| FormatMST | 雷亚尔 | 应设置主货币值的格式。 可用选项如下: -自动 - 是 - 否 默认值为 “自动”。 |
| NoOfDecimals | 雷亚尔 | 指定在页面上或报表上显示值时的小数位数。 |
| RotateSign | IntegerInt64Real | 选择此选项可反转数字的符号。 换句话说,将减号(–)更改为加号(+),或加号更改为减号。 |
| ShowZero | IntegerInt64Real | 指定是否将值为 0(零)的字段显示为空字段。 如果此类型的字段中的值为 0 表示 null/nothing,请将此属性设置为 No。 |
| SignDisplay | IntegerInt64Real | 指定是显示负数的符号,还是应在数字之前或之后显示该符号。 通常,将此属性设置为“自动”。但是,如果使用 DisplaceNegative 属性,则可以将其设置为 None。 |
| StringSize | String | 指定字符串的最大大小。 |
| ThousandSeparator | 雷亚尔 | 指定用于分隔千位的符号。 |
| TimeFormat | TimeUtcDateTime | 指定应如何设置时间的格式。 |
| TimeHours | TimeUtcDateTime | 指定是否包含小时。 |
| TimeMinute | TimeUtcDateTime | 指定是否包含分钟数。 |
| TimeSeconds | TimeUtcDateTime | 指定是否包含秒。 |
| TimeSeparator | TimeUtcDateTime | 指定用于时间的分隔符。 |
| TimezonePreference | UtcDateTime | 指定要将值从协调世界时(UTC)转换为的时区。 |
透视属性
在应用程序资源管理器的数据 字典 节点下,有一个 透视 节点。 透视是包含多维数据集度量值和维度的表和视图的集合。 下表描述了可以为每个透视设置的属性。 有关可用于透视的系统属性的信息,请参阅“系统和通用属性”部分。 有关与透视关联的表的属性的信息,请参阅“表属性”和“表字段属性”部分。
| 资产 | Description |
|---|---|
| ConfigurationKey | 指定分配给透视的配置键。 配置键确定在生成的报表模型中包括透视的配置。 |
| HelpText | 创建一个字符串,用作报表模型中透视的说明。 |
| ID | 指定透视的标识符。 |
| 标签 | 指定在报表模型中为透视显示的名称。 |
| 型号 | 指定透视位于的模型。 模型是层中元素的逻辑分组。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| SharedDimensionContainer | 指定是否在透视中共享项。 将此属性设置为 “是”时,透视中的项将添加到项目中的所有其他透视,并且不会为透视创建多维数据集。 默认值为 No。 |
| Usage | 指定透视的具体化选项。 可使用以下选项: - AdHocReporting - 透视用于生成事务性语义模型定义语言 (SMDL) 模型。 - OLAP - 透视用于在MICROSOFT SQL Server Analysis Services (SSAS) 商业智能项目中生成多维数据集。 - 这两者 - 透视用于在 SSAS 商业智能项目中生成事务 SDML 模型和多维数据集。 - 无 - 透视未具体化。 默认值为 None。 |
表属性
本部分介绍应用程序资源管理器中表元素的 “属性” 窗口中显示的属性。 表元素位于 数据字典>表下。
表属性
下表描述了应用程序资源管理器中表元素的属性。
| 资产 | Description |
|---|---|
| 摘要 | 指定表是否支持继承。 默认值为 No。 如果将值设置为“是”,则表不能是 X++ SQL 语句的直接目标,例如update_recordset并选择。 注意: 当 SupportInheritance 属性设置为 “否”时,此属性不可用。 |
| AnalysisDimensionType | 根据 IsLookup 属性的设置指定创建的维度类型。 如果 IsLookup 属性设置为 “是”,则以下选项可用: - 自动 - 表可以同时包含事实数据和维度数据。 BI 向导提取维度数据,并创建维度和属性。 提取事实数据以创建度量值。 创建一个子维度,其中包含父表中的属性。 - MasterInner - 内部(完整)联接用于创建此表与子表的关系。 此表和子表的每个记录组合均在维度中生成。 创建一个子维度,其中包含父表中的属性。 - MasterLeftOuter - 左外部联接用于创建此表与子表的关系。 维度具有其他属性,具体取决于此表中的值,也可以为空。 创建一个子维度,其中包含父表中的属性。 - 事务 - 表应仅用于生成事实数据(度量值)。 如果表仅包含事务数据,请使用此选项。 创建一个仅包含表中的枚举字段的子维度。 如果 IsLookup 属性设置为 “否”,则以下选项可用: - 自动 - 表可以同时包含事实数据和维度数据。 BI 向导提取维度数据,并创建维度和属性。 提取事实数据以创建度量值。 将创建一个父维度和子维度。 - MasterInner - 不适用。 此选项与 “自动”相同。 - MasterLeftOuter - 不适用。 此选项与 “自动”相同。 - 事务 - 表应仅用于生成事实数据(度量值)。 如果表仅包含事务数据,请使用此选项。 创建一个子维度,该维度仅包含表中的枚举值。 |
| AnalysisIdentifier | 指定要用作 SSAS 多维数据集中维度的标识符的字段。 |
| AOSAuthorization | 根据用户的权限,指定用户可以对表执行的作类型。 将此属性设置为 “无”时,不会执行授权检查。 |
| CacheLookup | 指定如何在查找作期间缓存检索的记录。 此属性仅存在于不继承自另一个表的表上。 在继承根表上,无法使用“应用程序资源管理器属性”窗口将此属性设置为 EntireTable。 不得使用其他技术将此值分配给继承根表。 例如,不要使用 TreeNode 类的 AOTsetProperty 方法来分配此值。 |
| ClusterIndex | 指定群集索引。 此属性仅用于 SQL 优化。 |
| ConfigurationKey | 指定表的配置键。 配置密钥允许系统管理员启用和禁用应用程序的特定部分。 |
| CountryRegionCodes | 指定表适用或有效的国家/地区的代码。 此属性在单个字符串中以逗号分隔的 ISO 国家/地区代码列表实现。 这些值必须与全局通讯簿中的数据匹配。 客户端框架使用此属性启用或禁用国家/地区特定的功能。 |
| CountryRegionContextField | 指定用于标识国家/地区上下文的字段。 此属性与 CountryRegionCodes 属性相关。 |
| CreatedBy | 指定系统是否维护表中记录的 CreatedBy 字段。 此字段包含有关创建记录的人员的信息。 |
| CreatedDateTime | 指定系统是否维护表中记录的 CreationDate 和 CreationTime 字段。 此字段包含创建记录的日期。 |
| CreatedTransactionId | 指定系统是否维护表中记录的 CreatedTransactionId 字段。 此字段包含有关创建记录的事务的信息。 |
| CreateRecIdIndex | 指定是否创建 记录 ID 字段上的索引。 |
| DeveloperDocumentation | 描述表的用途,并说明它在程序中的用法。 通常,说明包含不超过五个句子,并编写为单个段落。 |
| EntityRelationshipType | 根据常见的实体关系(ER)数据模型表示法对表进行分类。 表被归类为实体或关系。 实体表示对象,而关系表示两个对象之间的关联。 |
| 扩展 | 从指定的表派生该表。 当 SupportInheritance 属性设置为“是”时,此属性的值为 null。 |
| FormRef | 指定在引用表时激活的显示菜单项。 显示菜单项与页面相关联。 在报表上使用主索引字段时,此页可用作报表中的链接。 使用 PrimaryIndex 属性指定主索引。 如果将此属性留空,系统将尝试显示与表同名的页面。 |
| ID | 系统生成的表 ID。 |
| IsLookup | 对于报表模型,请使用此属性指定表信息是否合并到生成报表模型时引用它的其他表中。 对于联机分析处理(OLAP)多维数据集,请使用此属性指定是生成合并维度还是非重复维度。 可用选项如下: - 是 - 表的属性应合并到父维度(星型架构)。 - 否 - 应为表生成单独的维度(雪花架构)。 |
| 标签 | 指定表的标签。 |
| ListPageRef | 指定指向可显示此记录类型的列表的页面的显示菜单项。 |
| 型号 | 指定表位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表和类。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| 修改者 | 指定系统是否维护表中记录的 ModifiedBy 字段。 此字段包含有关上次修改记录的人员的信息。 |
| ModifiedDateTime | 指定系统是否维护表中记录的 ModifiedDate 字段。 此字段包含上次修改记录的日期。 |
| ModifiedTime | 指定系统是否维护表中记录的 ModifiedDateTime 字段。 此字段包含上次修改记录的日期和时间。 |
| Name | 指定表名称。 |
| OccEnabled | 指定是否为表启用乐观并发模式。 启用此模式后,从数据库提取数据时,数据不会从将来的修改中锁定。 仅当执行实际更新时,数据才会锁定。 |
| PreviewPartRef | 指定要在增强预览中使用的信息部件或表单部件。 信息部件显示来自指定查询的数据字段的集合。 它使用元数据来描述数据的显示方式。 窗体部件表示指向页面的指针。 |
| PrimaryIndex | 指定主索引。 只能选择唯一索引。 此属性用于数据库优化,并指示应将哪个唯一索引用作缓存键。 如果未指定主索引,则具有最低 ID 的唯一索引将用作缓存键。 |
| ReplacementKey | 指定要显示为某些页面控件中数据的标识符的字段。 |
| ReportRef | 指定引用表时激活的输出菜单项。 输出菜单项与报表相关联。 在报表上使用主索引字段时,此报表可用作报表中的链接。 使用 PrimaryIndex 属性指定主索引。 |
| SaveDataPerCompany | 指定是否保存当前公司的数据。 如果将属性设置为 “否”,则不带公司标识符(DataAreaId)保存数据。 注意: 如果表上的 SaveDataPerCompany 属性设置为 “是”,则使用表作为数据源的页面设计上的 SetCompany 属性也必须设置为 “是”。 提示: 状态行显示公司的首字母缩略词。 双击首字母缩略词以打开一个对话框,可在其中更改公司。 |
| SaveDataPerPartition | 一个值,该值指示表是否具有名为 Partition 的系统字段。 此属性旨在为只读。 如果表具有 “分区” 字段,则每个记录将分配给一个分区。 每个记录都隐藏在其他分区的上下文下运行的数据访问作。 |
| SearchLinkRefName | 指定链接到网站上有关企业门户搜索结果中列出的表记录的信息的菜单项的名称。 如果 SearchLinkRefType 属性设置为 URL,请选择链接到显示表数据的 Web 部件页的菜单项。 Web 部件页上的窗体和报表可以显示数据。 |
| SearchLinkRefType | 指定链接到网站上有关企业门户搜索结果中列出的表记录信息的菜单项的类型。 |
| SingularLabel | 指定在报表模型或多维数据集中使用的标签,以显示表中存储的项的单一名称。 |
| SupportInheritance | 将此属性设置为 “是”时,可以为其他继承相关属性(如 Extends 和 Abstract)设置值。 谨慎: 如果将此属性设置为 “是”,表上的任何字段都将被删除,必须再次创建。 |
| SystemTable | 指示表是否显示为系统表。 导出和导入期间可以筛选显示为系统表的表。 登录时,系统表始终同步。 因此,此属性对于登录后立即使用的表可能很有用。 |
| TableContents | 指定如何将设置/参数数据从一个客户重用到另一个客户。 可用选项如下: - 未指定 - 对大多数表使用此选项。 - 默认数据 - 对与客户无关的数据(例如邮政编码、单位和时间间隔)使用此选项。 - 基本数据 - 对依赖客户的数据(例如日历、组和参数)使用此选项。 - 默认+基本数据 - 对本地感知变化的数据使用此选项。 例如,德国客户关系图独立于客户,但在大多数其他地方都是客户依赖的。 |
| TableGroup | 指定表所属的组。 表组提供了一种根据表包含的数据类型对表进行分类的方法。 可以使用表组来定义系统在将表作为数据源更新或删除表中的数据时是否应提示用户。 导出数据时,可以使用表组筛选记录。 |
| TableType | 此属性替换 Microsoft Dynamics AX 2009 中找到的 Temporary 属性。 |
| TitleField1、TitleField2 | 可通过以下方式使用此属性: - 向窗体标题添加表字段数据。 - 在查找页上显示其他字段。 在页面上的字段中激活查找列表时,也会使用 TitleField1 属性。 可以为 TitleField1 和 TitleField2 属性指定的字段与键值合并。 - 在工具提示中显示字段信息。 |
| TypicalRowCount | 指定通常出现在表中的记录数。 如果未设置 AnalysisSelection 属性,则此属性确定如何使用 SSRS 的报表生成器选择记录。 此属性的设置会影响下拉列表、列表框还是筛选列表框用于选择表记录。 |
| ValidTimeStateFieldType | 指定系统在跟踪时间跨度内数据时使用的日期/时间字段的类型。 |
| 可见 | 当表用作页面或报表上的数据源时,请指定访问权限。 如果表用作页面上的数据源,页面上的访问权限不能超过为表定义的访问权限。 |
表和报表模型
以下属性与用于向报表添加信息的报表模型相关:
- AnalysisSelection
- AnalysisVisibility
- IsLookup
- SingularLabel
- TypicalRowCount
表字段属性
以下属性与用于向报表添加信息的报表模型相关:
- AnalysisDefaultTotal
- AnalysisLabel
- AnalysisTotaling
- AnalysisUsage
- AnalysisVisibility
- 货币代码
- CurrencyCodeField
- CurrencyCodeTable
| 资产 | Description |
|---|---|
| 调整 | 指定字符串字段在数据库中存储时是左对齐还是右对齐。 例如,如果 11 个字符的字符串“hello world”存储在右对齐的字段中,该字段的 StringSize 设置为 40,29 个空格字符存储为前缀。 |
| AliasFor | 指定字段是别名的表字段。 |
| AllowEdit | 指定是否允许用户修改页面上现有记录中的数据。 |
| AllowEditOnCreate | 指定在从页面创建新记录时是否允许用户在字段中输入数据。 |
| AnalysisDefaultTotal | 对于报表模型,使用此属性指定在使用 SSRS 和报表模型生成的报表中显示表的自动总计时如何聚合字段数据。 默认值为 “否”,指示字段不会自动显示为总计。 对于 OLAP 多维数据集,请使用此属性指定度量值的聚合函数。 当 AnalysisUsage 属性设置为 Measure 时,请使用此属性。 可用选项如下: - Sum - 返回集中所有值的总和。 - Count - 返回集中非 null 项的数目。 - CountDistinct - 返回集中非 null 项的非空项数。 - 最小值 - 返回集中的最小值。 - Max - 返回集中的最大值。 - 无 - 未应用聚合函数。 - 自动 - 此选项适用于派生的 EDT。 使用父 EDT 的 AnalysisUsage 属性的值。 |
| AnalysisLabel | 指定要用作表字段的 SSAS 多维数据集中的标题的标签。 标签应用于维度属性或度量值。 此属性适用于以下条件之一为 true 的情况: - 未定义 Label 属性。 - Label 属性不能用作维度属性或 SSAS 多维数据集中的度量值的标题。 |
| AnalysisUsage | 指定多维数据集中字段的角色。 以下选项可用 - 属性 - 字段是维度属性。 - 度量 值 - 字段是度量值。 - 两者 - 字段都是维度属性和度量值。 - None - 字段既不是维度属性,也不是度量值。 - 自动 - 应使用字段所基于的 EDT 或枚举的 AnalysisUsage 属性的值。 |
| ConfigurationKey | 设置字段的配置键。 |
| CountryRegionCodes | 指定表字段适用或有效的国家/地区的代码。 此属性在单个字符串中以逗号分隔的 ISO 国家/地区代码列表实现。 这些值必须与全局通讯簿中的数据匹配。 客户端框架和应用程序可能使用此属性启用或禁用国家/地区特定的功能。 |
| CountryRegionContextField | 指定标识国家/地区上下文的字段。 请参阅 CountryRegionCodes 属性的说明。 |
| ExtendedDataType | 指定要用于此字段的 EDT。 |
| GroupPrompt | 指定在组中显示字段时用于该字段的标签。 提示: 可以使用此属性来帮助保证字段标签不会重复在字段组的标签中显示的文本。 例如,如果页面上的字段组标记为 “客户”,请不要在字段组中包含的字段的 GroupPrompt 属性中包含此文本。 |
| HelpText | 指定字段的帮助字符串。 在页面上使用字段时,将显示帮助字符串。 |
| ID | 系统生成的字段 ID。 |
| IgnoreEDTRelation | 此属性在迁移 EDT 关系期间使用。 将关系从 EDT 节点迁移到表节点时,可以跳过给定表字段的无效关系。 若要跳过无效关系,请将此属性设置为 “是”。 默认值为 No。 |
| 标签 | 指定字段的标签。 此标签将显示在页面和报表上。 另请参阅下表前面的 AnalysisLabel 属性的说明。 |
| 强制的 | 指定用户是否必须将数据添加到页面上的字段。 将此属性设置为 “是 ”,以指示每个数据类型的默认或初始化值对于暂留到数据库中是不能接受的。 以下列表显示了一些不能用于页面上必填字段的默认值: - str(字符串)字段不能接受空。 - 日期时间字段(如日期和 utcdatetime)不能接受最小日期时间。 - 对于 int、real 和 enum 等数值字段,值 0(零)是不能接受的。 财务和操作不支持大多数 SQL 数据库产品中标准的 null 值的语义。 不能在数据库中为字段为 null。 因此, Mandatory 属性与 null 值的概念无关。 谨慎: 强制表字段可以将其 EnumType 属性设置为枚举。 可以将字段定义为枚举类型,其中包含一个整数值为 0 的项。 在这种情况下, 0 不是可用于在页面上选择的项目。 表单系统自动调用 validateWrite 方法以强制设置 强制 属性。 但是, 强制 属性对插入或更新表字段值的直接 X++ SQL 的行为没有影响。 在直接 X++ SQL 中,可以在表缓冲区变量中包含对 validateWrite 方法的调用。 缓冲区变量从 xRecord 类继承该方法。 |
| MinReadAccess | 指定自动授权功能的模式。 自动授权有两种作模式:代理外键和查找。 如果查询中的表已标记为代理外键授权,并且用户无权访问该表,但尚未显式拒绝,则向表授予视图访问权限。 但是,并非所有字段都可见。 可见性由以下规则确定: - 如果 MinReadAccess 设置为 “否”,则不会向该字段授予任何访问权限。 - 如果 MinReadAccess 设置为 “是”,则视图访问权限将授予该字段。 - 否则,如果字段是自然键自动标识组的一部分,或者它是一个系统字段,则授予查看访问权限。 如果查询中的表标记用于查找授权,则访问权限由以下规则确定: - 如果 MinReadAccess 设置为 “否”,则不会向该字段授予任何访问权限。 - 否则,将授予对字段的访问权限。 |
| 型号 | 指定表字段位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表或类。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| Name | 指定字段的名称。 |
| RelationContext | 指定字段与特定表关系的映射。 通常,此属性在度量单位方案中用于为与货币代码或数量相关的数据建模。 然后,可以使用与字段关联的关系来显示货币代码或数量查找。 没有默认值。 |
| SaveContents | 指定字段数据是保存在数据库中还是被视为虚拟字段数据。 显示字段时,在运行时计算虚拟字段数据。 此数据在数据库中没有物理表示形式。 提示: 可以使用显示和编辑方法,而不是虚拟字段。 |
| StringSize | 设置字段长度(以字符数为单位)。 最大字段长度取决于数据库。 值 (备注) 表示字段长度不受限制。 |
| 类型 | 指定字段的基类型。 |
| 可见 | 指定字段是否应在用户界面中可见。 |
表索引属性
下表描述了可用于表索引的属性。
| 资产 | Description |
|---|---|
| AllowDuplicates | 如果将此属性设置为 “是”,则索引可以是非统一的。 如果未创建至少一个唯一索引,则通过组合第一个索引和 RecId 创建唯一索引。 |
| AlternateKey | 指定此索引是否是备用键的一部分。 索引字段在每个记录中必须具有唯一值。 |
| ConfigurationKey | 设置配置密钥。 通过配置键禁用的索引字段会自动从索引中删除。 |
| 已启用 | 使用此属性可禁用索引。 |
| ID | 对象的内部标识符。 |
| 型号 | 指定表索引位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表或类。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| Name | 指定索引名称。 |
| UniqueAcrossCompanies | 此属性仅用于内部Microsoft使用。 可用值为 “是” 和 “否”。 默认值为 No。 当 AllowDuplicates 属性设置为 “否”时,将忽略此属性的值。 但是,如果 AllowDuplicates 设置为“是”,则 UniqueAcrossCompanies 的值可以提高某些跨公司查询的性能。 性能改进是由于数据缓存的更改造成的。 |
| ValidTimeStateKey | 指定此索引键是否用于确定与父表的有效时间状态关系。 默认值为 No。 提示: 若要启用此属性,请将 AllowDuplicates 属性设置为 “否 ”,将 AlternateKey 属性设置为 “是”。 |
| ValidTimeStateMode | 指定是否允许在两个有效日期记录之间存在差距。 默认值为 NoGap。 提示: 若要启用此属性,请将 AllowDuplicates 属性设置为 No, 将 AlternateKey 属性设置为 “是”,将 ValidTimeStateKey 属性设置为 “是”。 |
注释
第一个索引上的页面排序。
表关系属性
属性列表
下表描述了应用程序资源管理器中表关系的属性。
| 资产 | Description |
|---|---|
| 基数 | 引用表中每个主键值必须出现在当前表的外键列中的次数。 例如, OneMore 值表示一个或多个,但不表示零。 此值指示每个父键值必须至少在子表的外键列中发生一次。 当业务规则要求父 SalesTable 表中的每条记录至少与要销售的一个项目相关时,SalesLine 表下的关系节点可能会使用 OneMore 值。 目前未使用 基数 属性。 但是,将来的版本可能会使用此属性和 RelatedTableCardinality 属性。 |
| CreateNavigationPropertyMethods | 值为 Yes 指示系统为每个外键关系节点在表缓冲区类上生成导航方法。 |
| EDTRelation | 如果该值设置为 “是”,则软件工具用于将此关系从旧的 EDT 关系迁移到其当前位置。 |
| EntityRelationshipRole | 此属性阐明在表上定义的关系的语义。 角色名称应为名词或名词短语。 角色名称应指示关联表相对于关联对象的角色。 或者,角色名称应是一个短短语,该短语以现时动谓词开头,指示表在关系中扮演的角色。 如果关系明确,则不需要角色名称。 |
| 型号 | 此关系所属的模型。 |
| Name | 为关系选择的描述性名称。 |
| NavigationPropertyMethodNameOverride | 指定导航方法的名称。 如果未指定值,导航方法将使用 RelatedTableRole 属性中的值。 |
| RelatedTableCardinality | 指定当前表中的外键字段值在当前表的某些记录或所有记录中是否可以 为 null 。 可用选项如下: - ZeroOne 表示零或 1。 此值指示子记录中的外键字段可以为 null。 - ExactlyOne 指示外键字段在任何子记录中都不能 为 null 。 |
| RelatedTableRole | 输入文本值以描述此关系中引用的父表的用途。 当表只有一个引用给定父表的关系时,可以使用父表的名称。 有时,表与给定引用的父表具有多个关系。 在这种情况下, RelatedTableRole 属性的值应描述足以将关系的目的与同一父表的其他关系区分开来。 此属性的值可用作应用程序资源管理器查询下数据源关系的 JoinRelation 属性的值。 在标准情况下,建议使用此用法,因为它会减少非规范化。 此属性与 UseDefaultRoleNames 属互。 |
| RelationshipType | 选择一个值,该值描述两个表之间的微妙关系。 例如, Composition 值指示子记录不能有意义地存在,除非它与特定的父记录相关。 除非它引用父建筑表中的记录,否则地板表中第四楼的记录不存在。 注意: DeleteActions 应与此属性设置兼容。 对于合成关系,DeleteActions 应包括删除级联行为。 目前未使用 RelationshipType 属性。 但是,将来的版本可能会使用此属性。 |
| 角色 | 指定描述关系的含义或角色的名称。 例如,与部门表的一个关系可以跟踪员工当前所属的部门。 另一个关系可以跟踪员工请求转会到的部门。 虽然这两种关系都是与部门的关系,但它们填补了不同的角色。 作为此属性的值,最好使用下划线 (_) 字符联接子表和父表的名称。 例如,输入 SalesTable_SalesLine。 此属性与 UseDefaultRoleNames 属互。 |
| Table | 关系引用的表。 |
| UseDefaultRoleNames | 值为 “是 ”表示系统必须为 Role 和 RelatedTableRole 属性生成默认值。 即使将此属性设置为 “是”, 角色 和 RelatedTableRole 的生成值也不会显示在 “属性” 窗口中。 此外, TreeNode 类不使用生成的值。 但是, DictRelation 反射类确实使用生成的值。 |
| 驗證 | 值为 “是 ”表示当页面将记录插入子表中时,除非引用的父表中存在相关记录,否则将拒绝插入。 此外,当页面从父表中删除记录时,删除作将被拒绝或级联到子表中的相关记录。 将 RelationshipType 属性设置为 Link 时,将值设置为“否”。 还可以在特殊临时情况下将值设置为 “否” ,例如在某些升级方案中。 将该值设置为 “是”时,在值为 “否”时插入或删除的记录不会发生验证。 谨慎:Validate 属性的值为 Yes 不会阻止直接 X++ SQL 数据作删除父记录或插入违反外键数据完整性的子记录。 |
注释
将 SaveDataPerCompany 属性设置为两个表的 “是 ”时,系统将 DataAreaId 字段添加到每个关系。
RelatedTableRole 和查询 JoinRelation
本部分介绍如何使用 RelatedTableRole 属性简化新查询的创建。 如果在表关系上输入 RelatedTableRole 属性的显式值,则可以使用该值在应用程序资源管理器中的 Query> 节点下填充数据源关系的 JoinRelation 属性。 使用此方法在一个位置指定联接的字段。 如果联接字段发生更改,则必须仅在一个位置更新联接。 必须先删除 Field 和 RelatedField 属性的值,然后才能设置 JoinRelation 属性的值。
CreateNavigationPropertyMethods 和 RelatedTableRole
在表关系上将 CreateNavigationPropertyMethods 属性设置为 “是 ”时,系统会为表缓冲区类生成导航方法。 导航方法使用表的外键关系链接两个表缓冲区实例。 UnitOfWork 类是使用此导航链接的一个区域。 导航方法的名称来自表关系上 RelatedTableRole 属性的值。 如果在“属性”窗口中显式设置 RelatedTableRole 值,并且当系统生成 RelatedTableRole 值时,将发生此行为,因为 UseDefaultRoleNames 属性设置为“是”。 这些属性值在子 CustTable 缓冲区上生成以下导航方法。 最直接的是,导航方法名称是从 RelatedTableRole 属性的值复制的。
public final CustBankAccount BankAccounts([CustBankAccount relatedTable])
NavigationPropertyMethodNameOverride 属性
以下列表描述了必须重写系统为表缓冲区类上的导航方法生成的名称的情况:
- 表类已有一个与 RelatedTableRole 属性的值匹配的方法名称。
- RelatedTableRole 属性的值超过了可用于方法名称的最大长度。
在这些情况下,必须为导航方法选择有效的名称,并将该名称指定为表关系上的 NavigationPropertyMethodNameOverride 属性的值。
了解 RelationshipType 枚举
在表关系下添加节点时,可以为新关系设置 RelationshipType 属性的值。 RelationshipType 属性的可能值列表是 RelationshipType 枚举中的元素列表。 本部分介绍 RelationshipType 枚举中每个元素的含义。
元素的说明
下表描述了 RelationshipType 属性的元素。
| 元素名称 | Description | 自动推理 |
|---|---|---|
| 未指定 | 此元素通常是 RelationshipType 属性的默认值。 | 当 RelationshipType 属性的值为 NotSpecified 时,系统将推断出适当的值。 系统按以下顺序推断值: -专业化 -链接 -组成 -聚集 -协会 例如,如果满足组合和聚合的条件,则系统推断合成,因为合成发生在列表中前面。 |
| 专业化 | 此元素仅适用于表继承、基表和派生表之间的关系。 | 每当涉及表继承时,系统将 RelationshipType 属性设置为 专用化 。 |
| Link | 此元素是一种非关系关系。 它要求 将 Validate 属性设置为 “否”。 这种类型的关系支持在页面之间导航,这些页面列出表中的许多记录,以及为表中的一条记录提供详细信息字段的页面。 | 链接仅用于支持从早期版本升级期间迁移 EDT 链接关系。 迁移工具创建此类型关系,但不能。 |
| 组成 | 此元素是聚合关系的更强类型。 表不能具有多个组合关系。 例如,建筑物由房间组成,给定房间不能存在于多个建筑物中。 | 如果满足合成条件,但手动分配 聚合 或 关联值,系统将该值保留为 聚合 或 关联。 |
| 集合体 | 当子表被视为从属父表的实体时,此元素是合适的。 | 当以下条件之一为 true 时,系统会推断聚合: - 父表具有一个删除操作节点,该节点定义为使用此关系节点。 - 子表中此关系的任何外键字段都设置为“是”。 如果满足聚合条件,但手动分配 关联值,则系统会将该值保留为 关联。 |
| 关联 | 此元素是标准外键的概念。 | 如果系统未将属性的值设置为“关联”,并且“聚合”和“组合”都不合适,则必须将 RelationshipType 属性设置为 Association。 |
查看属性
视图的属性与表的属性相同。 但是,由于视图是只读的,因此不能更改其大部分属性。 某些属性具有固定值,有些属性继承自查询用于定义视图的数据源。 使用 SSRS 时,视图的以下属性与数据分析相关。 可以更改所有这些属性。
- AnalysisVisibility
- AnalysisSelection
- TypicalRowCount
- IsLookup
- SingularLabel
下表描述了可以为视图设置的属性。
| 资产 | Description |
|---|---|
| AOSAuthorization | 指定哪些数据访问操作需要验证用户权限。 |
| CacheLookup | 表的记录缓存级别。 |
| ClusterIndex | 表的群集索引(如果有群集索引)。 |
| ConfigurationKey | 设置视图的配置键。 |
| CountryRegionCodes | 指定菜单适用或有效的国家或地区的代码。 在单个字符串中将此属性作为 ISO 国家/地区代码的逗号分隔列表实现。 这些值必须与全局通讯簿中的数据匹配。 客户端使用此属性启用或禁用国家或地区特定的功能。 |
| CountryRegionContextField | 指定标识国家/地区上下文的字段。 请参阅 CountryRegionCodes 属性的说明。 |
| DeveloperDocumentation | 描述视图的用途,并说明它在程序中的用法。 通常,说明包含不超过五个句子,并编写为单个段落。 |
| EntityRelationshipType | 根据常见的实体关系(ER)数据模型表示法对视图进行分类。 视图被归类为实体或关系。 实体表示对象,而关系表示两个对象之间的关联。 |
| FormRef | 指定视图的默认页面。 默认页面是当用户使用页面上字段的快捷菜单激活跳转到主表时显示的页面。 该页面通过 显示 类型的菜单项进行引用。 如果将此属性留空,MorphX 将尝试激活与所引用的表同名的页面。 |
| ID | 对象的内部标识符。 |
| 标签 | 指定视图的用户友好名称。 |
| ListPageRef | 指定指向可显示此记录类型的列表的页面的显示菜单项。 |
| 型号 | 指定视图位于的模型。 模型是层中元素的逻辑分组。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| Name | 指定视图的名称。 从 X++ 语言引用视图时,将使用此名称。 |
| PreviewPartRef | 指定要在增强预览中使用的信息部件或表单部件。 信息部件显示来自指定查询的数据字段的集合。 它使用元数据来描述数据的显示方式。 窗体部件表示指向页面的指针。 |
| PrimaryIndex | 指定视图的主索引。 只能选择唯一索引。 此属性用于数据库优化,并指示应将哪个唯一索引用作缓存键。 如果未指定主索引,则具有最低 ID 的唯一索引将用作缓存键。 |
| Query | 指定查询,该查询是视图的数据源。 可以使用此属性,而不是将数据源直接添加到视图中。 |
| ReportRef | 表的默认报表的名称。 |
| SaveDataPerCompany | 对于特定于公司的表,请将此属性设置为 “是 ”。 如果数据与跨公司、安装、数据库、应用程序资源管理器、跟踪或 OLAP 相关,则将其设置为 “否 ”。 例如,SysTraceTable 或 OLAPServerTable 表指定是否应按公司为该表保存数据,或者数据是否应在没有任何公司关联的情况下可用。 如果表上的 SaveDataPerCompany 属性设置为 “是”,该表具有包含公司标识符的 DataAreaId 列。 如果表属性设置为 “否”,将从表中删除 DataAreaId 列。 |
| SaveDataPerPartition | 一个值,该值指示视图是否具有名为 Partition 的系统字段。 此属性旨在为只读。 如果视图具有 “分区” 字段,则每个记录将分配给一个分区。 每个记录都隐藏在其他分区的上下文下运行的数据访问操作。 |
| SearchLinkRefName | 链接到网站上有关企业门户搜索结果中列出的表记录的信息的菜单项的名称。 |
| SearchLinkRefType | 链接到网站上的有关企业门户搜索结果中列出的表记录信息的菜单项的类型。 |
| SystemTable | 一个值,该值指示表是否为系统表。 可以在导出和导入期间筛选系统表,并在登录时始终同步。 因此,此属性对于登录后立即使用的表可能很有用。 |
| TableContents | 指定如何将设置/参数数据从一个客户重用到另一个客户。 可用选项如下: - 未指定 - 对大多数表使用此选项。 - 默认数据 - 对与客户无关的数据(例如邮政编码、单位和时间间隔)使用此选项。 - 基本数据 - 对依赖客户的数据(例如日历、组和参数)使用此选项。 - 默认+基本数据 - 对本地感知变化的数据使用此选项。 例如,德国客户关系图独立于客户,但在大多数其他地方都是客户依赖的。 |
| TableGroup | 指定视图所属的组。 表组根据表包含的数据类型对表和视图进行分类。 视图可以属于与表相同的表组。 |
| TitleField1、TitleField2 | 视图的窗口标题中显示的信息。 标题是从以下元素构造的: - TitleField1 标签,后跟冒号(:)和空格) - 用于 TitleField1 的列中当前记录的值,后跟逗号 (,) - 用于 TitleField2 的列中当前记录的值 |
| ValidTimeStateEnabled | 指定视图是否支持基础表的有效时间状态功能。 默认值为 No。 仅当以下两个条件均为 true 时,才能将此属性设置为 “是 ” : - 基础表是有效的时间状态表。 - 该视图在其“字段”列表中具有 ValidFrom 和 ValidTo。 |
| 可见 | 当表用作页面或报表上的数据源时,请指定访问权限。 如果表用作页面上的数据源,页面上的访问权限不能超过为表定义的访问权限。 |
数据集属性
本部分介绍应用程序资源管理器中数据集元素的属性。 数据集节点是应用程序资源管理器中的高级节点。 使用数据集访问企业门户中的数据。
属性说明
下表描述了应用程序资源管理器中数据集节点上可用的属性。
| 资产 | Description |
|---|---|
| Name | 设置数据集的名称。 |
数据源属性
下表描述了数据集的 “数据源” 节点的属性。
| 资产 | Description |
|---|---|
| ChangeGroupMode | 指定对数据源的更改提交方式。 可用选项如下: - 无 - 对数据集的任何数据源的更改独立于对其他数据源的更改而提交。 - ImplicitInnerOuter - 作为单个单元工作,作为内部联接或外部联接的所有数据源。 所有更改都已成功提交,或者如果发生错误,则会回滚这些更改。 |
数据集数据源属性
下表描述了可用于数据集数据源的属性。
| 资产 | Description |
|---|---|
| AllowCheck | 指定在访问数据集之前是否进行安全检查。 可用选项如下: - 是 - 在访问数据集之前,将验证用户的读取权限。 - 否 - 只有在访问数据集后,才会验证用户的读取权限。 如果用户没有足够的基础数据源权限,则不会检索任何数据。 是 的默认值,通常建议使用。 |
| AllowCreate | 指定用户是否可以在数据源(即数据源的表中)创建新记录。 |
| AllowDelete | 指定用户是否可以删除数据源中的记录(即数据源的表中)。 |
| AllowEdit | 指定用户是否可以修改数据。 提示: 可以在此处设置整个数据源的 AllowEdit 属性。 数据源中的每个字段上也存在相同的属性,因此可以禁止修改各个字段。 |
| AutoNotify | 此属性不用于数据集。 |
| AutoQuery | 此属性不用于数据集。 |
| AutoSearch | 此属性不用于数据集。 |
| CounterField | 将数据源中的一个字段指定为数据集的计数器。 该字段必须是数据源的基础表的索引,并且该字段必须是 实际 类型。 此属性有助于保证在数据集中插入的记录具有与数据中实际顺序位置相对应的行号。 例如,如果在第 3 行和第 4 行之间插入新行,则新行将变为行号 3.5。 |
| CrossCompanyAutoQuery | 指定数据源是否从多个公司数据库检索数据。 |
| DelayActive | 使用此属性可延迟数据源的活动方法的执行。 如果将此属性设置为 “是”,则活动方法仅在延迟 20 毫秒后激活。 当用户滚动浏览数据源时,不会在每个记录上调用活动方法。 相反, 仅在用户选择的最终记录上调用它。 提示: 链接两个数据源(即 LinkType 属性设置为 Delayed 时)时,“DelayActive”属性非常有用。 此属性是 AutoJoin 系统的一部分。 |
| Index | 设置用于指定排序顺序的索引。 可以选择表上的任意索引。 如果以这种方式指定索引,则会将其用作对数据库的每个查询的索引提示。 索引根据此数据源指定数据集中记录的访问路径和排序顺序。 记录的初始排序顺序按以下方式确定优先级: - 如果将排序字段添加到数据源查询,则使用排序规范。 - 如果在数据源的 Index 属性中指定索引,则使用该索引中隐式指定的排序顺序。 - 如果数据源与另一个数据源自动联接,则系统会找到此联接的最合适的索引,然后根据该索引对数据进行排序。 - 如果未指定其他任何内容,则使用在第一个索引(具有最低 ID 的索引)中隐式指定的排序顺序。 如果未指定索引提示,数据库管理系统将找到适用的访问路径。 此访问路径基于提供的查询中的信息。 用户可以使用查询对话框更改页面的排序顺序。 |
| InsertAtEnd | 指定当用户将焦点移过表中最后一条记录时是否创建新记录。 |
| InsertIfEmpty | 指定在表中没有记录时是否插入空白记录。 如果将此属性设置为 “否”,则必须手动创建新记录。 |
| JoinSource | 使用此属性联接两个数据源。 当两个或多个表用作数据源时设置此属性,并且要联接它们。 |
| LinkType | 使用此属性可维护两个数据源之间的活动链接。 当焦点在第一个数据源中更改时,将选择第二个数据源中的相应记录或记录。 例如,客户表和事务表用于每个客户。 当用户从一个客户滚动到下一个客户时,事务列表会自动更新,以显示当前客户的事务。 将此属性设置为外部(外部链接)数据源 的延迟 。 仅当延迟为 100 毫秒后,才会更新链接的数据源。 此延迟有助于保证用户在滚动数据源时不会更新链接数据源。 只有在用户最终专注于记录之后,才会进行更新。 此属性是 AutoJoin 系统的一部分。 |
| Name | 设置数据源的名称。 此名称应与基础表的名称相同。 |
| OnlyFetchActive | 指定是提取数据源中的所有字段,还是仅提取数据集使用的所有字段。 当此属性设置为 “是”时,无法从数据集中删除记录。 此限制有助于保持数据完整性,因为它有助于保证从未在不完整的记录上尝试删除作。 |
| OptionalRecordMode | 指定外部联接表上的记录的创建和删除行为。 可用选项如下: - ImplicitCreate - 在数据库中未保存任何记录时,一旦父记录变为活动状态,就会创建外部联接的记录和联接表。 如果外部联接的记录或其子项未更改,则当父记录不再处于活动状态时,将删除这些记录。 - ExplicitCreate - 在数据库中未保存任何记录时,请将此记录视为已禁用,直到用户使用 “可选记录 ”复选框显式触发创建。 如果记录存在,清除复选框将删除此记录。 - 无 - 外部联接记录不会发生特殊的创建或删除行为。 |
| StartPosition | 指定访问数据集时,第一条记录还是最后一条记录应该是当前记录。 |
| Table | 设置用作数据源的表。 |
| ValidTimeStateAutoQuery | 指定日期效果的查询类型(AsOfDate 或 DateRange)。 |
| ValidTimeStateUpdate | 指定现有有效日期记录的更新类型。 可用选项如下: - CreateNewTimePeriod - 在成为上一条记录的记录上, ValidTo 日期字段设置为不晚于当前日期的日期。 在同一事务中,新当前记录的 ValidFrom 字段设置为在上一条记录 的 ValidTo 日期之后立即设置。 - 更正 - 必须修改现有行的 ValidFrom 或 ValidTo 值,以使日期生效的数据在记录集更新后有效。 - EffectiveBased - 无法编辑过去记录。 当前处于活动状态的记录以类似于 CreateNewTimePeriod 模式的方式进行编辑。 将来的记录以类似于更正模式的方式进行编辑。 默认值为 CreateNewTimePeriod。 |
窗体属性
本部分介绍在应用程序资源管理器中的窗体上设置的属性。 若要提供统一的应用程序接口,许多属性都具有 “自动” 值。 可以使用拖放操作创建窗体,然后手动设置多个属性。 若要指定窗体的名称,请在窗体的“属性”窗口中设置 Name 属性。 窗体的顶级节点上的所有其他属性都是系统属性,并且是只读的。
窗体设计属性
窗体 的设计 节点上的大多数属性也存在于单个控件上。 示例包括 Width 和 Height 属性。 但是,在 设计 节点上设置属性而不是在控件上设置属性时,该设置会影响整个窗体。 只有 设计 节点上存在一些属性。 下表描述这些属性。
| 资产 | Description |
|---|---|
| AlignChild | 指定组中的控件是遵循组的 AlignChildren 属性设置还是整个窗体设计。 例如,AlignChildren 在窗体的设计节点上设置为“是”,但不希望将特定组与其他组一起排列。 在这种情况下,请将 AlignChild 设置为该组的 No 。 |
| AlignChildren | 对齐容器中的子控件。 |
| AllowDocking | 指定是否可以将窗体附加到客户端工作区。 默认值为 No。 |
| AllowFormCompanyChange | 指定表单在用作具有跨公司动态链接库(DLL)的子窗体时是否支持公司更改。 默认值为 No。 |
| AllowUserSetUp | 指定用户是否可以移动窗体上的控件,并且可以更改控件属性的值。 此属性也位于窗体的设计上。 可用选项如下: - 否 - 用户无法自定义此容器中的任何控件。 - 受限 - 用户可以更改单个控件的属性,但不能移动控件。 - 是 - 用户设置没有限制。 默认值为是。 谨慎: 如果控件的任何父容器对用户设置级别有限制,则不允许完全用户设置。 表单数据源上的 AllowAdd 属性确定用户是否可以向窗体添加字段。 |
| AlwaysOnTop | 指定窗体是否始终以 z 顺序显示在其他窗口的顶部。 默认值为 No。 |
| ArrangeMethod | 指定是按列还是行排列子字段组。 |
| ArrangeWhen | 指定何时应排列容器中的控件。 可用选项如下: -启动 - 按需 -从来 没有 -违约 -自动 默认值为 Startup。 |
| BackgroundColor | 指定用于控件背景的颜色。 若要使背景不透明或透明,请使用 BackStyle 属性。 |
| BottomMargin | 设置窗体的下边距(以像素为单位)。 默认值为 “自动”。 |
| 标题 | 指定分组控件的标题。 使用此属性的标签。 |
| ColorScheme | 指定控件的调色板。 若要更改整个窗体的调色板,请设置最大容器的 ColorScheme 属性,并保留各个控件的默认值。 |
| 列 | 指定显示信息的列数。 谨慎: 基础表上的字段组永远不会拆分为多个列。 |
| ColumnSpace | 设置容器控件中的列之间的空间量。 |
| 数据源 | 指定控件中的数据来自的表。 若要设置表中的特定字段,请使用 DataField 属性。 如果控件打开另一个窗体,则控件的数据源(由此属性指定)和另一个窗体上的数据源之间的关系有助于保证动态选择第二个窗体中的记录。 例如,客户在一个窗体中选择,控件将打开一个显示客户交易的窗体。 在这种情况下,第二个窗体显示适用于当前客户的一系列客户交易。 谨慎: 如果设置 DataSource 和 DataField 属性,其设置将替代 DataMethod 或 ExtendedDataType 属性的任何设置。 |
| 字体 | 使用“ 字体 ”对话框更改控件的字体属性。 使用对话框字体指定字体、字体样式和字号。 |
| 框架 | 指定窗体使用的框架样式。 |
| 高度 | 以像素为单位指定窗体或控件的高度。 |
| HideIfEmpty | 如果容器控件为空,请使用此属性隐藏容器控件。 如果容器的 Width 和 Height 属性设置为 “自动”,则此属性不起作用,因为在这种情况下控件的大小为 0(零)。 |
| HideToolBar | 隐藏工具栏上特定于窗体的按钮。 |
| ImageMode | 定义 由 ImageName 属性指定的位图在控件中的显示方式。 可用选项如下: -正常 - 要适应的大小 -并排 -中心 默认值为 Normal。 |
| 图像名称 | 指定为控件显示的图像。 只能选择 .bmp 文件。 若要使用其中一个资源文件,请改用 ImageResource 属性。 |
| ImageResource | 使用图像资源文件中的一个图像作为控件的图像。 指定映像的 ID。 只能从集成资源文件中选择映像。 若要使用其他文件类型,请使用 ImageName 属性。 |
| LabelFont | 更改 Label 属性中提供的文本的字体。 |
| Left | 更改窗体左上角的位置。 有几个预定义的设置。 还可以指定精确位置(以像素为单位)。 以下预定义设置可用: - 自动(左) - 自动(右) - 左边缘 - 右边缘 -中心 默认值为“自动”(左)。 |
| LeftMargin | 更改窗体的默认左边距。 边距以像素为单位指定。 |
| MaximizeBox | 指定是否在封闭窗口的右上角包含最大化框。 默认值为是。 |
| MinimizeBox | 指定是否在封闭窗口右上角包含最小化框。 默认值为是。 |
| 模式 | 指定窗体的数据输入模式。 |
| 型号 | 指定窗体位于的模型。 模型是层中元素的逻辑分组。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| RightMargin | 更改窗体的默认右边距。 边距以像素为单位指定。 |
| SaveSize | 将此属性设置为 “是 ”以保存窗体的大小。 |
| ScrollBars | 指定是否在窗体中启用滚动条。 |
| SetCompany | 使系统在窗体收到焦点时更改公司。 注意: 如果表上的 SaveDataPerCompany 属性设置为 “是”,则使用表作为数据源的窗体设计上的 SetCompany 属性也必须设置为 “是”。 |
| StatusBarStyle | 指定状态栏在窗体中的显示方式。 使用此属性可隐藏状态栏、仅显示帮助信息、根据 WindowType 设置显示状态栏元素或始终显示完整状态栏。 注意: 具有 ListPage、 ContentPage 或 Workspace 的 WindowType 设置的窗体将忽略此属性。 |
| Style | 指定窗体的样式。 此属性控制用于窗体的窗体设计模式。 可用选项如下: -自动 - DetailsFormMaster - DetailsFormTransaction -对话 框 - DropDialog - FormPart - ListPage -查找 - SimpleList - SimpleListDetails - TableOfContents 默认值为 “自动”。 |
| TitleDataSource | 指定要在窗体标题中使用的数据源。 |
| Top | 更改窗体顶部的位置。 有几个预定义的设置。 还可以指定精确位置(以像素为单位)。 以下预定义设置可用: -自动 - 上边缘 - 下边缘 -中心 默认值为 “自动”。 |
| TopMargin | 设置窗体的上边距(以像素为单位)。 默认值为 “自动”。 |
| UseCaptionFromMenuItem | 指定是否将窗体标题替换为调用菜单项中的标签。 此属性允许在打开窗体时更改窗体的标题。 默认值为 No。 |
| ViewEditMode | 指定窗体是以只读模式打开还是作为允许更改字段的窗体打开。 可用选项如下: - 视图 - 以只读方式打开窗体。 - 编辑 - 在编辑模式下打开窗体。 - 自动 - 在适当的模式下打开窗体。 默认值为 “自动”。 |
| 可见 | 使用此属性可隐藏窗体。 谨慎: 无法使用 Visible 属性来强制实施访问限制。 用户可以更改 窗体设置 对话框中控件的可见性。 若要强制实施访问限制,请改用 Enabled 和 NeededAccessLevel 属性。 |
| 宽度 | 更改窗体的宽度(以像素为单位)。 |
| WindowResize | 指定是否可以调整窗体的大小。 |
| WindowType | 指定窗口的类型。 |
| WorkflowDataSource | 在窗体上设置工作流的根数据源。 指定的根数据源应与用于工作流模板上的 Document 属性的查询中指定的根数据源相同。 |
| WorkflowEnabled | 将此属性设置为 “是 ”以启用窗体上的工作流菜单栏。 默认值为 No。 |
| 工作流程类型 | 指定工作流类型,确定以下项和行为: - 要使用的工作流文档。 工作流文档公开计算字段,并标识公开工作流数据字段的查询。 - 用户是否可以配置任务和审批。 - 将工作流类型分配给特定模块时要使用的工作流类别。 - 菜单项和事件处理程序。 |
帮助文档集属性
文档集是与工作区关联的帮助文档的集合。 发布内容元素时,使用元数据将内容元素或目录信息添加到文档集。 若要管理工作区和文档集之间的关系,应用程序资源管理器包含名为 “帮助文档集”的节点。 帮助文档集节点中的每个文档集都包含属性集合。 添加新的文档集或更改文档集与工作区之间的关系时,可以编辑这些属性。 谨慎: 工作区只能与一个文档集相关联。 尽管应用程序资源管理器允许添加新的文档集并将其与工作区相关联,但你不再看到你替换的文档集中的文档。 通常,使用 UserDocumentation 作为发布到帮助服务器的任何内容元素或目录条目的文档集。 下表描述了应用程序资源管理器的 “帮助文档集” 节点中的文档集的属性。
| 资产 | 类型 | Description |
|---|---|---|
| DocumentSetName | String | 唯一标识文档集的名称。 名称限制为 40 个字符,不得包含空格。 在内容元素或目录文件中设置 DocumentSets 元数据元素的值时,请使用此属性的值。 |
| DocumentSetDescription | String | 要为文档集显示的文本或标签。 此值显示在帮助查看器的“选项”菜单列表中的“搜索”内容中。 |
| AddToApplicationHelpMenu | 布尔 | 如果希望文档集显示在应用程序工作区的“帮助”菜单上,请将此属性设置为“是”。 |
| AddToDeveloperHelpMenu | 布尔 | 如果希望文档集显示在开发人员工作区的“帮助”菜单上,请将此属性设置为“是”。 |
| UserDocumentSet | 布尔 | 将此属性设置为 “是 ”,将文档集与应用程序工作区相关联。 如果将此属性设置为 “否”,则无法查看Microsoft发布的上下文敏感(F1)帮助。 |
| DeveloperDocumentSet | 布尔 | 将此属性设置为 “是 ”,将文档集与开发工作区相关联。 如果将此属性设置为 “否”,则无法查看Microsoft发布的上下文敏感(F1)帮助。 |
| 1 | 帮助服务器 | 文档存储在帮助服务器上。 此选项与 UserDocumentation 文档集和在帮助服务器上发布文件的任何文档集一起使用。 |
| 2 | 万维网 | 文档存储在 MSDN 或类似网站上。 对于 DeveloperDocumentation 文档集,此选项是必需的,不应与任何其他文档集一起使用。 |
菜单属性
下表描述了应用程序资源管理器中 菜单 节点下菜单可用的属性。
| 资产 | Description |
|---|---|
| ConfigurationKey | 设置菜单的配置键。 |
| CountryRegionCodes | 指定菜单适用或有效的国家或地区的代码。 在单个字符串中将此属性作为 ISO 国家/地区代码的逗号分隔列表实现。 这些值必须与全局通讯簿中的数据匹配。 客户端使用此属性启用或禁用国家或地区特定的功能。 |
| DisabledImage | 指定禁用菜单时使用的按钮图像。 如果未设置此属性,系统将使用 NormalImage 属性的设置来生成图像。 |
| DisabledImageLocation | 指定用于禁用控件的图像的位置。 可以使用文件中的图像、应用程序资源管理器中的 “资源 ”节点或嵌入的资源。 为此属性选择的值确定可用于 DisabledImage 属性的值。 如果未设置此属性,系统将使用 ImageLocation 属性的设置来生成图像。 |
| ImageLocation | 指定使用的图像的位置。 可以使用文件中的图像、应用程序资源管理器中的 “资源 ”节点或嵌入的资源。 为此属性选择的值决定了 NormalImage 属性可用的值。 |
| 标签 | 设置向用户显示的菜单的名称。 |
| MenuItemName | 指定要包含在菜单上的菜单项。 可用的值取决于 MenuItemType 属性的值。 |
| MenuItemType | 指定菜单项的类型。 有三类菜单项: -显示 -输出 -行动 为此属性设置的值确定 MenuItemName 属性列表中出现的菜单项名称列表。 |
| 型号 | 指定菜单位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表或类。 元素可以正好位于层中的一个模型中。 同一元素可以位于位于较高层的模型中的自定义版本。 |
| NormalImage | 指定启用菜单时使用的图像。 |
| 参数 | 指定传递给对象的一个或多个值。 这些值类似于传递给方法的参数。 参数提供一个值,然后用于执行任务。 没有默认值。 |
| SetCompany | 如果将此属性设置为 “是”,则每次菜单打开时,公司都会更改为首次启动菜单时指定的公司。 |
| Shortcut | 指定打开菜单的键盘快捷方式。 例如,可以按 Ctrl+F3 打开菜单。 没有默认值。 |
| ShowParentModule | 根据菜单项的父模块指定是否更新导航窗格。 可用选项如下: - 是 - 始终基于菜单项的父模块更新导航窗格。 - 否 - 保持导航窗格不变,即使菜单项的父模块与当前模块不同。 默认值为是。 |
菜单项属性
所有菜单项(显示、输出和操作),包括 Web 菜单的菜单项,具有以下属性。
| 资产 | Description |
|---|---|
| ConfigurationKey | 选择启用菜单项的配置键。 使用对象所属的模块的密钥。 |
| CopyCallerQuery | 指定是否将查询从调用窗体复制到目标窗体。 此属性使目标窗体能够显示在原始窗体中查看的相同数据。 默认值为 “自动”。 |
| CorrectPermissions | 指定在向菜单项分配权限时是否应提供正确的权限以供选择。 可用选项如下: - 自动 - 权限可用于在此菜单项的“入口点”节点下的“特权”节点上选择。 - 否 - 权限不能作为菜单项的特权进行选择。 默认值为 “自动”。 |
| CountryConfigurationKey | 可选:除了或设置标准配置密钥之外,还可以设置国家/地区特定的密钥。 |
| CountryRegionCodes | 指定菜单项有效的国家/地区的代码。 在单个字符串中将此属性作为 ISO 国家/地区代码的逗号分隔列表实现。 这些值必须与全局通讯簿中的数据匹配。 客户端使用此属性启用或禁用国家/地区特定的功能。 |
| CreatePermissions | 指定在向菜单项分配权限时,是否应提供创建权限以供选择。 可用选项如下: - 自动 - 权限可用于在此菜单项的“入口点”节点下的“特权”节点上选择。 - 否 - 权限不能作为菜单项的特权进行选择。 默认值为 “自动”。 |
| DeletePermissions | 指定在向菜单项分配权限时,是否应提供删除权限以供选择。 可用选项如下: - 自动 - 权限可用于在此菜单项的“入口点”节点下的“特权”节点上选择。 - 否 - 权限不能作为菜单项的特权进行选择。 默认值为 “自动”。 |
| DisabledImage | 指定禁用菜单项时使用的图像。 如果未设置此属性,系统将使用 NormalImage 属性的设置来生成图像。 |
| DisabledImageLocation | 指定用于禁用控件的图像的位置。 可以使用文件中的图像、应用程序资源管理器中的 “资源 ”节点或嵌入的资源。 为此属性选择的值确定可用于 DisabledImage 属性的值。 如果未设置此属性,系统将使用 ImageLocation 属性的设置来生成图像。 |
| EnumTypeParameter 和 EnumParameter | 可选:选择枚举类型作为对象的参数,然后选择枚举值作为 EnumParameter 属性的值。 通常,在多种情况下使用一个窗体时使用这些属性。 可以根据 EnumParameter 值更改窗体的行为。 例如, PriceDiscGroup 窗体由三个显示菜单项(PriceDiscGroup_*)使用,每个菜单项具有不同的 EnumParameter 值。 在窗体的 init 方法中,开关构造将验证值,然后创建窗体。 |
| ExtendedDataSecurity | 指定菜单项是否在所有公司(而不是单个公司的上下文中)下显示。 默认值为 No。 |
| FormViewOption | 指定要使用的窗体模式。 可用选项如下: -自动 -网 格 -细节 默认值为 “自动”。 |
| HelpText | 为菜单项创建帮助字符串。 当您选择菜单项打开的对象(例如窗体)时,文本将显示在状态栏上。 注意: 若要为菜单项编写帮助文章,请在应用程序资源管理器的 “应用程序文档/菜单项 ”节点中找到与菜单项同名的文章。 本文将显示,而不是任何有关菜单项打开的对象编写的帮助文章。 |
| ImageLocation | 指定用于控件的图像的位置。 可以使用文件中的图像、应用程序资源管理器中的 “资源 ”节点或嵌入的资源。 为此属性选择的值决定了 NormalImage 属性可用的值。 |
| 标签 | 选择要用作菜单和按钮上项的名称的标签。 |
| LinkedPermissionObject | 如果另一个对象(例如窗体或报表)的权限应用于此菜单项,请选择该对象。 通常,将此属性用于操作菜单项。 |
| LinkedPermissionType | 指定 LinkedPermissionObject 属性指定的对象的类型。 |
| MultiSelect | 选择是否可以在窗体中的多个记录选择上使用菜单项。 |
| 型号 | 指定表位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表或类。 元素可以正好位于层中的一个模型中。 同一元素可以位于位于较高层的模型中的自定义版本。 |
| Name | 菜单项的名称。 |
| NeededAccessLevel | 定义菜单项在菜单或按钮上显示所需的最低访问权限。 使用此属性可设置对不同用户组的菜单项的访问权限。 |
| NeedsRecord | 指定是否在不存在任何记录的情况下启用表示菜单项的按钮。 默认值为 No。 使用此属性可帮助保证操作可以完成。 例如,你有一个菜单项按钮,用于打开详细信息窗体。 如果列表页上没有记录,可能需要禁用该按钮。 |
| NormalImage | 指定与启用的按钮控件关联的菜单项时使用的图像。 |
| 物体 | 选择 类属性中指定的 对象类型的对象。 |
| 对象类型 | 选择菜单项打开的对象类型。 谨慎: 将 SSRSReport 用于 SSRS 报表的菜单项。 不要对新菜单项使用 SQLReportLibraryReport 。 SQLReportLibraryReport 选项已过时,将在将来的版本中删除。 |
| OpenMode | 指定目标窗体的视图模式。 使用此属性可指定目标窗体是在编辑模式还是只读模式下打开。 可用选项如下: -自动 -视图 - 编辑 - 新建 默认值为 “自动”。 |
| 参数 | 可选:指定传递给对象的参数。 |
| Query | 选择传递给 InitialQuery 方法的目标窗体的查询。 |
| ReadPermissions | 指定向菜单项分配权限时,是否应对节提供读取权限。 可用选项如下: - 自动 - 权限可用于在此菜单项的“入口点”节点下的“特权”节点上选择。 - 否 - 权限不能作为菜单项的特权进行选择。 默认值为 “自动”。 |
| ReportDesign | 选择要用于特定 SSRS 报表模型的报表设计。 |
| RunOn | 选择是在客户端、服务器还是从中调用菜单项的位置运行菜单项。 此属性用于打开报表的菜单项。 此属性确定仅当对象的 RunOn 属性设置为 “从中调用”时,应用程序对象从何处运行。 - 窗体在客户端上实例化并运行,因为 FormRun 类始终在客户端上运行。 - 报表按菜单项的 RunOn 属性指定实例化并运行,因为 ReportRun 类始终运行从中调用它的位置。 将属性设置为 “从中调用”。 如果将报表设置为在客户端上运行,并且报表在批处理中运行,则报表会失败。 如果将报表设置为在服务器上运行,并且报表显示在屏幕上,则报表会失败。 - 类 的主 方法由其修饰符指定运行。 类本身由 其 RunOn 属性指定实例化。 实例化可能发生在 main 方法中。 |
| UpdatePermissions | 指定向菜单项分配权限时,是否应对节提供更新权限。 可用选项如下: - 自动 - 权限作为此菜单项的 Privileges 节点的“ 入口点 ”节点下的权限可供分区使用。 - 否 - 权限不适用于分区作为菜单项的特权。 默认值为 “自动”。 |
| Web | 指定运行菜单项时打开的 URL。 不再使用此属性的值。 请勿使用此属性。 |
| WebConfigurationKey | 可选:除了标准配置密钥之外,还可以选择特定于 Web 的配置密钥。 此属性仅适用于 Web 菜单项。 |
| WebMenuItemName | 指定要包含在 Web 菜单上的菜单项。 可用值取决于 WebMenuItemType 属性的设置。 |
| WebMenuItemType | 指定 Web 菜单项的类型。 Web 菜单项有两类: -Url -行动 选择的值确定可用于 WebMenuItemName 属性的 Web 菜单项名称。 |
| WebPage | 指定链接到菜单项的网页。 不再使用此属性的值。 请勿使用此属性。 |
| WebSecureTransaction | 选择菜单项是否需要安全事务(SSL)。 此属性仅适用于 Web 菜单项。 |
注释
使用 Parameters 或 EnumParameter 属性时,只能在运行时而不是在编译时找到类型不匹配等错误。
查询属性
在查询中,可以对查询本身、数据源、用于排序的字段以及用于分隔查询的范围设置属性。
查询属性
查询属性确定查询的总体行为。 例如,可以指定用户看到的窗体,以便他们可以与查询进行交互。
| 资产 | Description |
|---|---|
| AllowCheck | 系统忽略此属性进行查询。 它在表单和报表上有效。 |
| AllowCrossCompany | 指定是否检索用户有权读取的所有公司的数据。 如果将属性设置为 false(默认值),则系统仅检索当前会话公司的数据。 |
| Description | 可选:描述查询、返回的内容等。 此属性在 office 外接程序方案中Microsoft非常有用。 |
| 表格 | 指定 MorphX 在用户与查询交互时显示的查询窗体。 默认值为 SysQueryForm。 |
| 交互 | 指定用户是否可以通过分隔查询、设置打印机选项等来与报表交互。 |
| Literals | 指定如何在 SQL 语句中表示文本。 forceLiterals 选项指示内核在优化时向 Microsoft SQL Server 数据库显示子句中使用的实际值。 forcePlaceholders 选项指示内核不显示实际值。 注意: 不要使用 forceLiterals 选项,因为它可能会向 SQL 注入安全威胁公开代码。 |
| 型号 | 指定查询位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表或类。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| QueryType | 指定查询的类型。 可用选项如下: -加入 -联盟 默认值为 Join。 |
| 可搜索 | 指定查询是否可以是一组用于搜索 Microsoft SharePoint 业务目录的查询的一部分。 使用企业搜索功能时,此属性非常有用。 默认值为 No。 |
| Title | 查询的标题。 |
| UserUpdate | 指定查询窗体在重新打开时是否应保留其状态。 如果将此属性设置为 “是”,则还原以前的设置。 如果将其设置为 “否”,则可以查看数据,但不能对其进行编辑。 |
| 版本 | 每次更新查询时,都会增加版本。 此属性为只读。 |
数据源属性
以下属性控制数据源的特征。 嵌入的数据源和数据源之间的关系提供了其他属性。 还可以在数据源中的字段上设置一个属性。
| 资产 | 可用位置 | Description |
|---|---|---|
| AllowAdd | 数据源 | 指定用户是否可以在运行时向排序和范围添加字段。 |
| 公司 | 数据源 | 指定要从中检索数据的公司。 |
| 动态 | 数据源中的字段节点 | 指定是否使用数据源中表中的所有字段。 如果将此属性设置为 “是”,将使用数据源中的所有字段。 如果将其设置为 “否”,可以删除某些字段。 当数据源是基表时,值为 Yes 表示使用派生表中的所有字段。 |
| 已启用 | 数据源 | 如果将此属性设置为 “否”,查询系统将忽略数据源和所有嵌入的数据源。 |
| FetchMode | 嵌入数据源 | 指定数据源是否应通过 1:1 关系或 1:n 关系关联。 注意: 对于在报表上使用的数据源,请使用使用 1:1 提取模式的联接关系。 |
| Field、RelatedField | 嵌入数据源上的关系 | 父数据源和相关数据源中用于关系的字段的名称。 |
| FirstFast | 数据源 | 如果将此属性设置为 “是”,则数据库会收到一条提示,提示应在其他记录之前检索查询中的第一条记录。 此设置使某些数据库系统能够优化记录检索,从而有助于提高性能。 |
| FirstOnly | 数据源 | 如果将此属性设置为 “是”,则数据库会收到一条提示,指出只需要查询中的第一条记录。 此设置使某些数据库系统能够优化记录检索,从而有助于提高性能。 |
| JoinMode | 嵌入数据源 | 指定用于联接数据源输出的策略。 |
| Name | 数据源 | 指定数据源的名称。 |
| Relations | 嵌入数据源 | 指定查询系统是否应使用为表和 EDT 定义的关系。 如果将此属性设置为 “是”,则更改关系时,将自动更新查询。 |
| Table | 数据源 | 指定用作数据源的表、映射或视图。 定义排序顺序或范围后,无法修改此属性。 |
| 表,RelatedTable | 嵌入数据源上的关系 | 父数据源和相关数据源的名称。 |
| UniqueId | 数据源 | 数据源的唯一编号。 此属性为只读。 |
| Update | 数据源 | 指定查询是否可以更新数据库中的记录。 |
范围属性
以下属性确定范围规范的特征。 例如,可以指定用户是否可以在运行时修改范围。
| 资产 | Description |
|---|---|
| 已启用 | 使用此属性可禁用范围规范中的字段。 |
| 领域 | 指定要定义范围的字段。 |
| 标签 | 输入区域的标签。 |
| 状态 | 指定用户是否可以在运行时修改查询对话框中的范围。 可用选项如下: - 打开 - 用户可以查看和编辑范围。 - 锁定 - 用户只能查看范围。 - 隐藏 - 用户无法查看或编辑范围。 |
| 价值 | 指定检索的记录的范围。 如果使用枚举,请不要使用文本字符串。 使用枚举 ID。 |
报表属性
在应用程序资源管理器中设置报表的设计、设计节和控制节点的大多数属性。 有关报表上可用的系统属性的信息,请参阅“系统和通用属性”部分。 下表描述了报表的属性。
| 资产 | Description |
|---|---|
| AllowCheck | 指定当用户尝试运行他们无权查看的报表时是否显示消息。 选择 “是 ”以指定显示消息。 |
| AutoJoin | 指定 element.args 方法返回的记录是否用于设置报表查询上的范围。 |
| 交互 | 指定用户是否可以通过修改与报表关联的查询来选择要显示的记录。 |
| 型号 | 指定报表位于的模型。 模型是层中元素的逻辑分组。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于另一层的模型中的自定义版本中。 |
报表控件属性
下表介绍了报表控件属性。 有关可用于控件的其他属性的信息,请参阅“窗体控件属性”部分。
| 资产 | Description |
|---|---|
| 协调 | 指定控件中显示的值的对齐方式。 |
| AllowNegative | 指定控件是否接受负值。 此属性仅适用于整数和实际控件。 |
| ArrayIndex | 指定控件中显示的数组元素。 该控件基于具有数组元素的扩展数据类型。 此属性不适用于文本和形状控件。 |
| AutoDeclaration | 指定是否创建与控件同名的变量。 将此属性设置为 “是”时,更容易从 X++ 代码访问报表控件,并且可以在编译时找到错误。 |
| AutoInsSeparator | 指定是否显示小数分隔符。 此属性仅适用于实际控件。 |
| BackgroundColor | 指定控件的背景色。 可以使用 BackStyle 属性重写此属性的设置。 |
| BackStyle | 指定控件背景是不透明还是透明。 将此属性设置为 透明时,行为取决于控件的类型: - 对于位图控件,具有相同颜色的像素是透明的。 - 对于所有其他控件,前台颜色将用作背景色。 |
| Bold | 指定粗体文本格式。 |
| BottomMargin | 指定控件的边距。 |
| ChangeCase | 指定用户输入的文本大小写。 此属性仅适用于字符串、枚举、文本和提示控件。 |
| ChangeLabelCase | 指定打印报表时是否应修改控件的标签。 可用选项如下: -自动 - 无 - 大写 - 小写 - 标题案例 默认值为 “自动”。 |
| ColorScheme | 指定控件的调色板。 |
| ConfigurationKey | 指定控件的配置键。 |
| CSSClass | 指定用于在 HTML 中呈现值的级联样式表(CSS)。 |
| DataField | 指定控件的表字段。 此属性不适用于文本、形状、框和位图控件。 |
| DataMethod | 指定显示控件中的数据的显示方法。 此属性不适用于文本、形状和框控件。 |
| DateDay | 指定当天的格式。 此属性仅适用于日期控件。 |
| DateFormat | 指定日期的格式。 此属性仅适用于日期控件。 |
| DateMonth | 指定月份的格式。 此属性仅适用于日期控件。 |
| DateSeparator | 指定在月、日和年之间显示的分隔符。 此属性仅适用于日期控件。 |
| DateYear | 指定年份的格式。 此属性仅适用于日期控件。 |
| DecimalSeparator | 指定用于分隔十进制值的符号。 此属性仅适用于实际控件。 |
| DisplaceNegative | 当值为负数时,为网格控件中的值指定一个新位置。 此属性仅适用于整数和实际控件。 |
| DynamicHeight | 指定是否调整控件的大小以显示其他文本行。 将此属性设置为 “是”时,将自动根据需要添加页眉、页脚和重复列标题。 此属性仅适用于字符串控件。 |
| ExtendedDataType | 指定与控件关联的字段应基于的 EDT。 |
| ExtraSumWidth | 修改允许的总和的默认宽度。 此属性仅适用于整数和实际控件。 |
| 字体 | 指定字体。 |
| 字体大小 | 指定字号。 |
| ForegroundColor | 指定控件的前景色。 |
| FormatMST | 指定是否使用标准货币格式设置值的格式。 此属性仅适用于实际控件。 |
| 高度 | 指定控件的高度。 当控件与 EDT 关联时,控件的 Height 属性将替代 EDT 的 DisplayLength 属性。 如果将“ 高度 ”属性设置为位图控件的 “自动” ,则控件的大小取决于图形的大小。 |
| 图像名称 | 指定映像的文件名。 此属性仅适用于位图控件。 |
| ImageResource | 指定要显示的系统资源的 ID。 资源宏提供这些 ID 的列表。 宏位于应用程序资源管理器中的 “宏” 节点下。 此属性仅适用于位图控件。 |
| 斜体 | 指定斜体文本格式。 |
| 标签 | 指定控件的标题。 如果未在此处指定标签,则它继承自该字段。 |
| LabelBold | 设置或返回一个值,该值指示控件中标签的粗体设置。 |
| LabelCSSClass | 指定要用于在 HTML 中呈现标签的 CSS。 |
| LabelFont | 设置或返回一个字符串数据类型值,该值指示窗体组合框控件中标签文本的字体。 |
| LabelFontSize | 设置或返回窗体组合框控件中标签文本的字号(以磅为单位)。 |
| LabelItalic | 设置或返回一个值,该值指示控件标签中的文本是否应为斜体。 |
| LabelLineBelow | 指定控件标题的下划线的格式。 |
| LabelLineThickness | 指定列标题下方的行的格式。 |
| LabelPosition | 设置或返回控件标签的位置。 有效值为 Left 和 Above。 |
| LabelTabLeader | 指定是否追加一系列点以控制标签。 可用选项如下: -自动 - 不要追加 - 执行追加 默认值为 “自动”。 |
| LabelUnderline | 设置或返回一个值,该值指示控件标签中的文本是否应带下划线。 |
| LabelWidth | 指定控件标签的宽度。 |
| Left | 指定控件的左对齐方式。 |
| LeftMargin | 指定控件的左边距。 |
| 行 | 指定构成形状的线条的外观。 此属性仅适用于形状控件。 |
| LineAbove | 指定控件上边框的线条类型。 如果报表包含许多线条或框,请考虑在各个节中使用形状控件。 |
| LineBelow | 指定控件下边框的线条类型。 如果报表包含许多线条或框,请考虑在各个节中使用形状控件。 |
| LineLeft | 指定控件左边框的线条类型。 如果报表包含许多线条或框,请考虑在各个节中使用形状控件。 |
| LineRight | 指定控件右边框的线条类型。 如果报表包含许多线条或框,请考虑在各个节中使用形状控件。 |
| MenuItemLabel | 指定菜单项的标签。 |
| MenuItemName | 指定菜单项的名称。 可用的菜单项因 MenuItemType 属性的设置而异。 |
| MenuItemType | 指定菜单项是作、显示还是输出菜单项。 显示菜单项适用于窗体,输出菜单项用于报表。 输出菜单项适用于类、作业或查询。 |
| MinNoOfDecimals | 指定显示的最小小数位数。 不显示尾随零。 |
| ModelFieldName | 指定用于确定控件左对齐和宽度的字段。 |
| NoOfDecimals | 指定显示的小数位数。 默认值为 20。 此属性仅适用于实际控件。 |
| ResizeBitmap | 指定是否可以调整图像大小以适应控件的尺寸。 此属性仅适用于位图控件。 |
| RightMargin | 指定控件的边距。 |
| RotateSign | 指定控件的符号是否反转。 此属性仅适用于整数和实际控件。 |
| ShowLabel | 设置或返回一个值,该值指示控件的标签是否显示在窗体中。 值为 True 表示显示标签。 |
| ShowPicAsText | 指定是否显示图像的文件名而不是图像。 此属性仅适用于位图控件。 |
| ShowZero | 指定是否显示 0 (零) 值。 此属性仅适用于整数和实际控件。 |
| SignDisplay | 指定数字的符号的显示方式。 此属性仅适用于整数和实际控件。 |
| SumAll | 指定是否计算所有值的总和。 此属性仅适用于整数和实际控件。 |
| SumNeg | 指定是否计算所有负值的总和。 此属性仅适用于整数和实际控件。 |
| SumPos | 指定是否计算所有正值的总和。 此属性仅适用于整数和实际控件。 |
| Table | 指定控件的数据源。 此属性不适用于文本、形状、框和位图控件。 |
| 文本 | 指定控件中显示的文本字符串。 此属性仅适用于文本控件。 |
| TimeFormat | 指定时间是以 24 小时格式还是 AM/PM 格式显示。 此属性仅适用于时间控件。 |
| TimeHours | 指定是否显示小时数。 此属性仅适用于时间控件。 |
| TimeMinutes | 指定是否显示分钟数。 此属性仅适用于时间控件。 |
| TimeSeconds | 指定是否显示秒。 此属性仅适用于时间控件。 |
| TimeSeparator | 指定用于分隔小时、分钟和秒的符号。 此属性仅适用于时间控件。 |
| 厚度 | 指定控件边框的粗细。 |
| ThousandSeparator | 指定用于分隔千位的符号。 此属性仅适用于实际控件。 |
| Top | 指定控件的顶部对齐方式。 |
| TopMargin | 指定控件的边距。 |
| 类型 | 指定显示的形状的类型。 此属性仅适用于形状控件。 |
| TypeHeaderPrompt | 指定是否添加一行点以填充控件标题和控件值之间的空格。 此属性仅适用于文本和提示控件。 |
| 下划线 | 指定下划线文本格式。 |
| 可见 | 设置或返回一个值,该值指示控件是否可见。 True 值指示控件可见。 |
| WarnIfMissing | 指定是否显示报表中缺少图像的消息。 此属性仅适用于位图控件。 |
| WebMenuItemName | 指定要包含在 Web 菜单上的菜单项。 可用值取决于 WebMenuItemType 属性的设置。 |
| WebMenuItemType | 指定菜单项的类型。 Web 菜单项有两类: -Url -行动 选择的值确定可用于 WebMenuItemName 属性的 Web 菜单项名称。 |
| WebTarget | 指定控件在 Web 报表上的位置。 |
| 宽度 | 指定控件的宽度。 当控件与 EDT 关联时,该控件的 Width 属性将替代 EDT 的 DisplayLength 属性。 如果将 “Width ”属性设置为位图控件的 “自动” ,则控件的大小取决于图形的大小。 |
报表设计属性
下表描述了报表设计属性。
| 资产 | Description |
|---|---|
| ArrangeMethod | 指定报表节中控件的布局。 |
| ArrangeWhen | 指定报表控件的排列时间。 |
| BottomMargin | 指定下边距。 如果将此属性设置为 “自动”,则使用系统表存储的默认值。 |
| 标题 | 指定在用户界面中为报表显示的名称。 |
| ColorScheme | 指定调色板。 |
| 列 | 指定列数。 |
| ColumnSpace | 指定列之间的间距。 |
| 字体、字体大小、斜体、下划线和粗体 | 指定文本格式。 Font 和FontSize 属性的设置将覆盖通过单击“工具”菜单上的“选项>字体”设置的值。 |
| ForegroundColor | 指定前景色。 |
| 高度 | 指定高度。 |
| LeftMargin | 指定左边距。 如果将此属性设置为 “自动”,则使用系统表存储的默认值。 |
| LineAbove | 指定节上边框的线条类型。 如果报表包含许多线条和框,请考虑在节内使用形状控件。 |
| LineBelow | 指定节下边框的线条类型。 如果报表包含许多线条和框,请考虑在节内使用形状控件。 |
| LineLeft | 指定节左边框的线条类型。 如果报表包含许多线条和框,请考虑在节内使用形状控件。 |
| LineRight | 指定节右边框的线条类型。 如果报表包含许多线条和框,请考虑在节内使用形状控件。 |
| ResolutionX、ResolutionY | 指定网格线之间的距离。 |
| RightMargin | 指定右边距。 如果将此属性设置为 “自动”,则使用系统表存储的默认值。 |
| 标尺 | 为编辑设计时出现的标尺指定单位。 若要编辑设计,请右键单击 “AutoDesignSpecs ”或 “生成的设计”,然后选择“ 编辑”。 |
| 厚度 | 指定节边框的粗细。 |
| TopMargin | 指定上边距。 如果将此属性设置为 “自动”,则使用系统表存储的默认值。 |
报表设计节属性
下表介绍了报表设计部分的属性。 有关可用于报表设计的其他属性的信息,请参阅“报表设计属性”部分。
| 资产 | Description |
|---|---|
| ArrangeMethod | 指定报表节中控件的布局。 |
| ArrangeWhen | 指定何时应排列容器中的控件。 可用选项包括 “启动”、“ 按需”和“ 永不”。 |
| Bold | 获取或设置用于在控件中显示文本的字体的粗细。 |
| 向下 | 更改报表底部的位置。 |
| BottomMargin | 指定下边距。 如果将此属性设置为 “自动”,将使用存储在 UserInfo 系统表中的默认值。 |
| ColorScheme | 指定调色板。 |
| ColumnHeadingsStrategy | 指定列标题的布局。 如果将此属性设置为 WordWrap,则当标题的长度超过列中最长的字段时,标题将换行。 标题最多可换行 8 行。 超过八行的标题将被截断。 注意: 标题长度因语言而异。 |
| 列 | 指定列数。 |
| Columnspace | 指定列之间的间距。 |
| 字体 | 指定文本格式。 Font 和 FontSize 属性的设置将覆盖可以通过单击>”菜单上的“选项字体”设置的值。 |
| 字体大小 | 指定文本格式。 Font 和 FontSize 属性的设置将覆盖可以通过单击>”菜单上的“选项字体”设置的值。 |
| ForegroundColor | 指定前景色。 |
| GrandHeader | 指定是否显示 HeaderText 属性的值。 仅当报表具有多个未嵌套的数据源时, GrandHeader 属性才可用。 |
| GrandTotal | 指定是否显示 FooterText 属性的值。 仅当报表具有多个未嵌套的数据源时, GrandTotal 属性才可用。 |
| HeaderText | 指定当 GrandHeader 属性设置为 “是”时,节中第一条记录上方显示的文本。 仅当报表具有多个未嵌套的数据源时,此属性才可用。 |
| 高度 | 指定高度。 |
| 斜体 | 指定文本格式。 Font 和 FontSize 属性的设置将覆盖可以通过单击>”菜单上的“选项字体”设置的值。 |
| LabelTopMargin、LabelBottomMargin | 指定列标题上方和下方的边距。 |
| LeftMargin | 指定左边距。 如果将此属性设置为 “自动”,将使用存储在 UserInfo 系统表中的默认值。 |
| LineAbove、LineBelow、LineLeft、LineRight | 指定节边框的线条类型。 如果报表包含许多线条和框,请考虑在节内使用形状控件。 |
| 地图 | 指定要用于显示数据的映射。 可以将地图字段与一个或多个表中的字段相关联。 此属性允许使用相同的字段名称来访问在不同表中具有不同名称的字段。 |
| NoOfHeadingLines | 指定用于显示列标题的行数。 如果将属性设置为 0 (零),则不显示列标题。 对于包含多个字段的报表,请增加行数以确保显示所有字段。 |
| RightMargin | 指定右边距。 如果将此属性设置为 “自动”,将使用存储在 UserInfo 系统表中的默认值。 |
| ResolutionX | 指定网格线之间的距离。 |
| ResolutionY | 指定网格线之间的距离。 |
| 标尺 | 为编辑设计时显示的标尺指定单位。 若要编辑设计,请右键单击 “AutoDesignSpecs ”或 “生成的 设计”,然后选择“ 编辑”。 |
| Table | 指定节的数据源。 |
| 厚度 | 指定节边框的粗细。 |
| Top | 更改报表顶部的位置。 |
| TopMargin | 指定上边距。 如果将此属性设置为 “自动”,将使用存储在 UserInfo 系统表中的默认值。 |
| 下划线 | 指定文本格式。 Font 和 FontSize 属性的设置将覆盖可以通过单击>”菜单上的“选项字体”设置的值。 |
报表查询属性
下表描述了报表查询属性。 有关其他报表属性的信息,请参阅“报表属性”和“系统和通用属性”部分。
| 资产 | Description |
|---|---|
| AllowCheck | 获取或设置“允许”检查标志。 |
| AllowCrossCompany | 获取或设置“允许跨公司”标志。 此标志指示查询执行是否跨公司。 |
| Description | 查询的文本说明。 此可选属性通常用于 Office 加载项方案。 |
| 表格 | 指定用于用户交互的窗体。 |
| 交互 | 指定用户是否可以通过分隔查询、设置打印机选项等来与报表交互。 |
| Literals | 指定如何在 SQL 语句中表示文本。 |
| 型号 | 指定报表查询位于的模型。 模型是层中元素的逻辑分组。 元素的示例包括表或类。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于另一层的模型中的自定义版本中。 |
| QueryType | 指定查询的类型。 可用选项如下: -加入 -联盟 默认值为 Join。 |
| 可搜索 | 指定查询是否可以是可用于搜索 SharePoint 业务目录的一组查询的一部分。 使用企业搜索功能时,此属性非常有用。 默认值为 No。 |
| Title | 指定查询的标题。 |
| UserUpdate | 指定用户是否可以更新查询。 |
| 版本 | 这是一个只读的内部属性。 |
安全代码权限属性
代码权限是一组与菜单项或服务作关联的权限。 当安全角色有权访问菜单项时,它还有权访问该菜单项的代码权限的其他应用程序资源管理器项。 在代码权限节点下定义的特定权限控制访问程度。
安全对象
使用代码权限授予对安全对象的访问权限。 以下列表显示了应用程序资源管理器中代码权限节点的层次结构:
- 安全
- 代码权限
- YourCodePermission
- Tables
- 服务器方法
- 关联的对象
- 表单
- Web 控件
- 报表
- YourCodePermission
- 代码权限
代码权限还可以替代访问级别,以在 “关联对象” 节点下的安全对象。
代码权限属性
下表介绍了应用程序资源管理器中 安全>代码权限>YourCodePermission 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 代码权限的名称。 代码权限允许用户运行在 Method 属性中指定的类方法。 |
| Class | 可选 | 与此代码权限关联的类。 |
| 方法 | 可选 | 与此代码权限关联的方法。 |
表属性
下表描述了应用程序资源管理器中 “安全>代码权限>YourCodePermission>表>YourTable ”中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Table | 是的 | 表的名称。 |
| EffectiveAccess | 是的 | 权限值。 可用选项如下: - 阅读 -更新 - 创建 -正确 - 删除 - NoAccess EffectiveAccess 属性的权限值表示层次结构。 读取是最弱的权限,Delete 是最强的权限。 删除权限包括所有其他权限。 创建权限包括更新和读取。 将权限值设置为 NoAccess ,以防止对表的所有访问。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
服务器方法属性
下表描述了应用程序资源管理器中 安全>代码权限>YourCodePermission>服务器方法>YourServerMethod 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Class | 是的 | 服务器类的名称。 |
| 方法 | 是的 | 使用 SysEntryPointAttribute 属性标记的安全服务器方法。 |
| EffectiveAccess | 是的 | 权限值。 可用选项如下: - 调用 - 可以调用服务器方法。 - NoAccess - 无法调用服务器方法。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
窗体属性
下表描述了应用程序资源管理器中“安全>代码权限>YourCodePermission>关联对象>”窗体>中的节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| 表格 | 是的 | 窗体的名称。 |
| AccessLevel | 是的 | 权限值。 可用选项如下: - 阅读 -更新 - 创建 -正确 - 删除 - NoAccess EffectiveAccess 属性的权限值表示层次结构。 读取是最弱的权限,Delete 是最强的权限。 删除权限包括所有其他权限。 创建权限包括更新和读取。 将权限值设置为 NoAccess ,以防止对表单的所有访问。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
Web 控件属性
下表描述了应用程序资源管理器中 安全>代码权限>YourCodePermission>关联对象>Web 控件>YourWebControl 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| WebControl | 是的 | Web 控件的名称。 |
| AccessLevel | 是的 | 权限值。 可用选项如下: - 阅读 -更新 - 创建 -正确 - 删除 - NoAccess EffectiveAccess 属性的权限值表示层次结构。 读取是最弱的权限,Delete 是最强的权限。 删除权限包括所有其他权限。 创建权限包括更新和读取。 将权限值设置为 NoAccess ,以防止对 Web 控件的所有访问。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
报表属性
下表描述了应用程序资源管理器中 “安全>代码权限>YourCodePermission>关联对象>报告>YourReport ”中的节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 报表设计的名称。 |
| 报表 | 是的 | 报表的全名。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
安全职责属性
安全权限合并为特权,权限合并为职责。 将职责定义为相关权限组,以便用户能够访问特定业务功能。 在应用程序资源管理器中,将这些特权组织到职责的节点中。
最佳做法
遵循以下有关职责的最佳做法规则:
- 向角色分配所有职责。
- 将所有职责包含在进程周期中。
- 由于职责表示特定的业务功能,因此很少或永远不会更改职责的名称。 例如,你的公司支付账单。 虽然支付帐单的详细信息可能会改变,但支付账单的基本功能不会改变。 更改职责的特权子节点,而不是创建新的职责。
- 很少或永远不会更改进程周期的名称。
应用程序资源管理器中的职责层次结构
以下列表显示了应用程序资源管理器中职责节点的层次结构:
- 安全
- 事
- YourDuty
- 特权
- YourDuty
- 事
Duty 属性
下表介绍了应用程序资源管理器中 安全>职责>YourDuty 处节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 职责的名称。 |
| 标签 | 是的 | 用户界面针对职责显示的文本。 |
| Description | 是的 | 职责说明。 |
| 已启用 | 是的 | 一个值,该值指示是否启用职责。 可用选项如下: - 是 - 启用职责。 - 否 - 禁用职责。 |
特权属性
下表介绍了应用程序资源管理器中 安全>职责>YourDuty>Privileges>YourPrivilege 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 权限的名称。 |
| 已启用 | 是的 | 一个值,该值指示是否启用特权。 可用选项如下: - 是 - 启用特权。 - 否 - 禁用特权。 |
安全特权属性
权限是一组权限。 每个特权节点下方的节点标识用户可以访问的安全对象,并设置每个对象的访问级别。
最佳做法
本部分介绍特权的最佳做法规则。
- 使用特权指定执行作业所需的访问权限。
- 使用权限对相关安全对象的权限进行分组。 例如,菜单项及其控件密切相关。
- 将特权直接分配给安全角色。 但是,如果分配职责或处理周期而不是特权,则维护安全设置会更容易。
安全对象
使用特权授予对安全对象的访问权限。 以下列表显示应用程序资源管理器中 “安全>特权 ”节点下的层次结构:
- 安全
- 特权
- YourPrivilege
- 入口点
- 权限
- Tables
- 服务器方法
- 表单
- YourPrivilege
- 特权
权限还可以替代访问级别,使其在应用程序资源管理器中的其他位置定义安全对象。 例如,权限可以替代 EffectiveAccess 属性在 Application Explorer 中的 Forms>YourForm>权限>更新>表>YourTable 下定义的权限。
特权属性
下表介绍了应用程序资源管理器中 Security>Privileges>YourPrivilege 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 权限的名称。 |
| 标签 | 是的 | 用户界面中为特权显示的文本。 |
| Description | 是的 | 权限的说明。 |
| 已启用 | 是的 | 一个值,该值指示是否启用特权。 可用选项如下: - 是 - 启用特权。 - 否 - 禁用特权。 |
入口点属性
下表描述了应用程序资源管理器中 Security>Privileges>YourPrivilege>EntryPoints>YourEntryPoint 处节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 入口点的名称。 |
| 对象类型 | 是的 | 入口点的对象类型。 可用选项如下: - MenuItemDisplay - MenuItemOutput - MenuItemAction - ServiceOperation - WebActionItem - WebURLItem - WebManagedContent |
| 对象名称 | 是的 | 入口点的对象名称。 |
| ObjectChildName | 可选 | 一个表示服务方法名称的值。 注意: 仅当 ObjectType 属性设置为 ServiceOperation 时,才为此属性指定值。 |
| AccessLevel | 是的 | 权限值。 对于 除 ServiceOperation 之外的所有对象类型,可以使用以下选项: - 阅读 -更新 - 创建 -正确 - 删除 - NoAccess AccessLevel 属性的权限值表示层次结构。 读取是最弱的权限,Delete 是最强的权限。 删除权限包括所有其他权限。 创建权限包括更新和读取。 可以将权限值设置为 NoAccess ,以防止对入口点的所有访问。 仅当涉及时间状态表时,“正确”权限才适用。 此权限授权你颁发时间状态表中的更新记录。 对于 ServiceOperation 对象类型,可以使用以下选项: - 调用 - 可以调用服务器方法。 - NoAccess - 无法调用服务器方法。 |
表属性
下表描述了应用程序资源管理器中“ 安全>特权>YourPrivilege>权限>表>YourTable ”中的节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Table | 是的 | 表的名称。 |
| EffectiveAccess | 是的 | 权限值。 可用选项如下: - 阅读 -更新 - 创建 -正确 - 删除 - NoAccess EffectiveAccess 属性的权限值表示层次结构。 读取是最弱的权限,Delete 是最强的权限。 删除权限包括所有其他权限。 创建权限包括更新和读取。 仅当涉及时间状态表时,“正确”权限才适用。 此权限授权你更新时间状态表中的记录。 将权限值设置为 NoAccess ,以防止对表的所有访问。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
服务器方法属性
下表描述了应用程序资源管理器中 “安全>特权>YourPrivilege>权限>服务器方法>YourServerMethod ”中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Class | 是的 | 服务器类的名称。 |
| 方法 | 是的 | 使用 SysEntryPointAttribute 属性标记的安全服务器方法的名称。 |
| EffectiveAccess | 是的 | 权限值。 可用选项如下: - 调用 - 可以调用服务器方法。 - NoAccess - 无法调用服务器方法。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
窗体属性
下表介绍了应用程序资源管理器中 “安全>特权>YourPrivilege>权限>窗体>” 中的节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| 表格 | 是的 | 窗体的名称。 |
安全进程周期属性
进程周期是一组职责。 进程周期表示高级作业函数。 尽管给定的作业函数运行方式的详细信息可能会随时间而变化,但该作业函数的概念和名称可能不会更改。
最佳做法
本部分介绍流程周期的最佳做法规则。
- 每个职责都应是进程周期的一部分。
- 使用进程周期来组织作业函数的一组职责。
应用程序资源管理器中的进程周期层次结构
以下列表显示了应用程序资源管理器中进程周期节点的层次结构:
- 安全
- 进程周期
- YourProcessCycle
- 责任
- YourProcessCycle
- 进程周期
进程周期属性
下表描述了应用程序资源管理器中 安全>进程周期>YourProcessCycle 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 进程周期的名称。 |
| 标签 | 是的 | 用户界面中进程周期显示的文本。 |
| Description | 是的 | 进程周期的说明。 |
| 已启用 | 是的 | 一个值,该值指示是否启用职责。 可用选项如下: - 是 - 启用进程周期。 - 否 - 禁用进程周期。 |
Duty 属性
下表描述了应用程序资源管理器中 安全>进程周期>YourProcessCycle>Duties>YourDuty 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 职责的名称。 |
| 已启用 | 是的 | 一个值,该值指示是否启用职责。 可用选项如下: - 是 - 启用职责。 - 否 - 禁用职责。 |
安全策略属性
开发人员和系统管理员可以创建安全策略来拒绝访问表中的一部分数据记录。
策略的约束表
在应用程序资源管理器中,在安全策略的 “约束表 ”节点下,可以添加表和视图。 这些表和视图与在策略的 Query 属性中命名的查询的数据源表相关。 以下列表显示了应用程序资源管理器中安全策略节点的层次结构:
- 安全
- 政策
- YourPolicy
- 受约束表
- YourConstrainedTable
- YourConstrainedSubTable
- YourConstrainedView
- YourConstrainedTable
- 受约束表
- YourPolicy
- 政策
每个 约束表 节点可以包含任意数量的受约束表和视图。 此外,每个受约束表可以包含任意数量的受约束子表。
安全策略属性
下表描述了应用程序资源管理器中 安全>策略>YourPolicy 节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 安全策略的名称。 |
| 标签 | 是的 | 用户界面中为安全策略显示的文本。 |
| PrimaryTable | 是的 | 在数据源中为安全策略查询指定的表。 |
| Query | 是的 | 策略用于筛选策略所指定的受约束表中的数据的查询。 |
| UseNotExistJoin | 是的 | 一个值,该值指示安全查询是必须应用为 不存在 联接还是 存在 联接。 |
| PolicyGroup | 否 | 管理员和开发人员可以使用此属性快速识别相关安全策略组。 可用选项是系统管理员或开发人员创建的安全策略组的名称。 系统在运行时不使用此属性。 |
| ConstrainedTable | 是的 | 一个值,用于控制安全策略是否限制从主表返回的记录中的数据值。 可用选项如下: - 是 - 在主表上强制实施安全策略。 - 否 - 不会对主表强制实施安全策略。 |
| 已启用 | 是的 | 一个值,用于控制系统是否在运行时强制执行策略。 可用选项如下: - 是 - 启用安全策略。 - 否 - 禁用安全策略。 |
| 操作 | 是的 | 一个值,用于控制强制执行策略的数据作。 可用选项如下: -选择 -插入 -更新 - 删除 - 插入、更新和删除 - 所有操作 |
| ContextType | 是的 | 控制安全策略的上下文类型的值。 可用选项如下: - ContextString - 必须为 ContextString 属性指定值。 安全策略使用策略的特定应用程序上下文。 - RoleName - 安全策略仅适用于分配给 RoleName 值的应用程序用户。 - RoleProperty - 此值与 ContextString 属性结合使用以指定多个角色上下文。 |
| ContextString | 是的 | 此属性与 ContextType 属性结合使用。 它可用于指定应用程序或多个角色上下文。 |
安全角色属性
角色表示可向用户授予的权限集合。 每个角色节点下面嵌套的节点标识用户可以访问的各种安全对象,并指定访问级别。
应用程序资源管理器中的角色节点
使用角色授予对安全对象的访问权限。 以下列表显示了应用程序资源管理器中角色节点的层次结构:
- 安全
- 角色
- YourRole
- 责任
- 特权
- 权限
- Tables
- 表单
- 服务器方法
- 子角色
- YourRole
- 角色
通常,将角色与安全职责相关联,有时还与安全特权相关联。 角色中安全对象的访问级别来自职责、特权或两者兼有。 角色还可以将访问级别重写为 “权限” 节点下的安全对象。
角色属性
下表描述了应用程序资源管理器中 “安全>角色>YourRole ”中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 角色的名称。 |
| 标签 | 是的 | 用户界面为角色显示的文本。 |
| Description | 是的 | 角色的说明。 |
| 已启用 | 是的 | 一个值,该值指示是否启用角色。 可用选项如下: - 是 - 启用角色。 - 否 - 禁用角色。 |
| PastDataAccess | 是的 | 具有有效日期字段的表的过去数据访问。 可用选项如下: - 阅读 -更新 - 创建 -正确 - 删除 - NoAccess PastDataAccess 属性的权限值表示层次结构。 读取是最弱的权限,Delete 是最强的权限。 删除权限包括所有其他权限。 创建权限包括更新和读取。 将权限值设置为 NoAccess ,以防止对表的所有访问。 |
| CurrentDataAccess | 是的 | 具有有效日期字段的表的当前数据访问。 |
| FutureDataAccess | 是的 | 具有有效日期字段的表的未来数据访问。 |
| ContextString | 可选 | 安全策略可以使用的用户定义字符串。 |
Duty 属性
下表介绍了应用程序资源管理器中 安全>角色>职责>YourDuty 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 职责的名称。 |
| 已启用 | 是的 | 一个值,该值指示是否启用职责。 可用选项如下: - 是 - 启用职责。 - 否 - 禁用职责。 |
特权属性
下表描述了应用程序资源管理器中 安全>角色>Privileges>YourPrivilege 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 权限的名称。 |
| 已启用 | 是的 | 一个值,该值指示是否启用特权。 可用选项如下: - 是 - 启用特权。 - 否 - 禁用特权。 |
表属性
下表描述了应用程序资源管理器中 “安全>角色>权限>表>YourTable ”中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Table | 是的 | 表的名称。 |
| EffectiveAccess | 是的 | 权限值。 可用选项如下: - 阅读 -更新 - 创建 -正确 - 删除 - NoAccess EffectiveAccess 属性的权限值表示层次结构。 读取是最弱的权限,Delete 是最强的权限。 删除权限包括所有其他权限。 创建权限包括更新和读取。 将权限值设置为 NoAccess ,以防止对表的所有访问。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
窗体属性
下表描述了应用程序资源管理器中“ 安全>角色>权限>窗体>YourForm ”中的节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| 表格 | 是的 | 窗体的名称。 |
服务器方法属性
下表描述了应用程序资源管理器中 安全>角色>权限>服务器方法>YourServerMethod 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Class | 是的 | 服务器类的名称。 |
| 方法 | 是的 | 使用 SysEntryPointAttribute 属性标记的安全服务器方法的名称。 |
| EffectiveAccess | 是的 | 权限值。 可用选项如下: - 调用 - 可以调用服务器方法。 - NoAccess - 无法调用服务器方法。 |
| ManagedBy | 可选 | 自动化工具使用此属性。 |
子角色属性
下表描述了应用程序资源管理器中 安全>角色>子角色>YourSubRole 中节点的属性。
| 资产 | 必选 | Description |
|---|---|---|
| Name | 是的 | 子角色的名称。 |
| 已启用 | 是的 | 一个值,该值指示是否启用职责。 可用选项如下: - 是 - 启用子角色 - 否 - 禁用子角色。 |
Web 菜单属性
下表描述了特定于 Web 菜单和子菜单的属性。
| 资产 | Description |
|---|---|
| ConfigurationKey | 指定控制此菜单显示的配置键。 如果用户无权访问配置键,则菜单不可见。 |
| HighlightSelected | 不支持此属性。 |
| 标签 | 指定为 Web 菜单或子菜单的顶级节点显示的文本。 该值不能超过 250 个字符。 |
| MenuItemName | 指定在单击菜单或子菜单的顶级节点时要访问的菜单项。 可用选项取决于 MenuItemType 属性的设置。 |
| MenuItemType | 指定菜单或子菜单的顶级节点访问的菜单项的类型。 可用选项为 “作 ”和 “URL”。 |
| 型号 | 指定模型。 模型是层中元素的逻辑分组。 元素的示例包括表或类。 元素可以恰好存在于层中的一个模型中。 同一元素可以存在于位于较高层的模型中的自定义版本中。 |
| SetCompany | 当窗体收到焦点时,此属性会导致系统更改公司。 如果表上的 SaveDataPerCompany 属性设置为 “是”,则使用表作为数据源的窗体设计上的 SetCompany 属性也必须设置为 “是”。 |
| ShowParentModule | 根据菜单项的父模块指定是否更新 QuickLaunch。 可用选项如下: - 是 - 始终基于菜单项的父模块更新 QuickLaunch。 - 否 - 使 QuickLaunch 保持不变,即使菜单项的父模块与当前模块不同。 默认值为是。 |
Web 菜单项属性
下表描述了特定于 Web 菜单项的属性。
| 资产 | Description |
|---|---|
| 大 | 指定在作窗格上使用按钮的大小。 可用选项如下: - 是 - 按钮以完整大小显示,位于组的开头。 - 否 - 按钮以较小的大小显示,位于组的右侧。 |
| CloseDialogBehavior | 指定对话框关闭时对父窗口执行的作。 可用选项如下: - 自动 - 根据对话框的使用方式,关闭对话框时将执行相应的更新操作。 - RefreshDataSource - 更新父窗体上的只读数据源。 此选项保留当前所选内容,对数据源执行 Research() 作。 - RefreshPage - 刷新页面。 - 提交 - 刷新父页。 - 无 - 未执行任何操作。 默认值为 “自动”。 |
| HideActionPane | 指定正在打开的页面上是否显示操作窗格。 |
| HomePage | 指定页面是否为角色中心页面,并将其部署到主企业门户网站。 |
| NeedsRecord | 将此属性设置为 “是”时,当数据集中没有记录时,将显示菜单项。 |
| PageDefinition | Web 菜单项指向的页面。 |
| 参数 | 指定传递给正在打开的页面的参数。 每个参数必须采用以下形式: 名称=值 如果必须传递多个参数,则必须用安和(>)分隔它们,如以下示例所示:mode=2&category=1 |
| URL | 指定要导航到的 URL。 |
| WebConfigurationKey | 选择启用 Web 菜单项所需的配置键。 使用对象所属的模块的密钥。 |
| WindowMode | 指定要用于正在打开的页面的窗口类型。 可用选项如下: - 内联 - 正在打开的页面将替换浏览器中的现有内容。 如果从对话框中访问 Web 菜单项,则打开的页面将在新的浏览器窗口中打开。 - 模式 - 如果未打开任何对话框,则会创建新对话框。 如果从对话框中访问 Web 菜单项,则打开的页面将替换当前对话框的内容。 - NewModal - 正在打开的页面始终在新对话框中打开。 - NewWindow - 正在打开的页面将在新的浏览器窗口中打开。 |
| WindowParameters | 指定其他参数来控制 SharePoint 对话框的外观。 参数必须用大括号({})括起来,用逗号分隔。 以下示例演示如何设置 WindowParameters 属性,使对话框的大小为 400 × 300 像素,使其没有 “关闭 ”或“ 最大化 ”按钮:{width:400,height:300,showClose:false,allowMaximize:false} |
| 窗口大小 | 指定要用于正在打开的页面的窗口的大小。 可用选项如下: - 最小 - 330 × 200 像素 - 小 - 550 × 450 像素 - 中 - 800 × 630 像素 - 大 - 930 × 630 像素 - 最大值 - 适合主浏览器窗口边界的最大大小 |