组织属性和组织信息上下文

1. 概述

1.1 功能概述

Wyn系统组织默认仅有一个名称属性，系统管理员可扩展组织自定义属性（即组织信息上下文，下面内容使用组织信息上下文代替），通过为不同组织配置专属属性值，即可实现多租户系统的数据隔离与精细化权限管控。

2. 操作步骤

2.1 前提条件

1. 用户要求： 仅系统管理员可以扩展组织自定义属性。

2.2 操作步骤-添加组织属性

1. 系统管理员登录Wyn后，依次单击「系统管理＞账户管理＞组织管理>组织模型」，进入组织模型界面，即可添加组织信息上下文。

   
   

2. 在组织模型界面，单击添加属性按钮，输入组织信息上下文名称（例如DBName），并设置其他项目。

• 属性值类型： 选择属性值的数据类型，保存后不可更改

• 必填项： 是否设置该属性为添加组织时的必填项

• 允许多值： 是否为多值属性

• 允许隐藏值： 开启后属性值旁边会有一个小眼睛，点击可隐藏或显示属性值

  
  

3. 组织信息上下文配置完成后，系统提供以下管理能力：

• 可视化查看： 单击目标组织可直观展示所有已配置的组织信息上下文

• 灵活配置： 支持为每个组织独立设置/修改上下文属性值

• 权限控制： 可设置为禁止子组织查看或编辑特定属性，使得数据过滤更安全

  
  

2.3 操作步骤-管理组织属性

Wyn系统保留组织默认名称属性且不可删除，组织信息上下文（自定义属性）支持灵活管理（增删改），但需确保至少保留一个有效组织信息上下文（自定义属性），组织名称属性除外。

1. 系统管理员登录Wyn后，依次单击「系统管理＞账户管理＞组织管理>组织模型」，进入组织模型界面，即可管理组织信息上下文。

   
   

2. 在组织模型界面，系统提供以下管理能力：

• 新增组织信息上下文（自定义属性）： 单击按钮即可新增组织信息上下文（自定义属性）

• 修改组织信息上下文（自定义属性）： 单击按钮即可修改组织信息上下文（自定义属性）

• 删除组织信息上下文（自定义属性）： 单击按钮即可删除组织信息上下文（自定义属性）

  
  

3. 组织信息上下文应用

组织信息上下文可应用于数据源连接、数据集过滤及报表展示，实现多租户数据的动态隔离与个性化呈现。

3.1 在数据源连接中使用

在数据源连接配置中，通过嵌入组织属性（格式：#{属性名}，如#{DBName}），系统可实现多租户环境下的动态数据库路由——不同组织的用户访问同一数据源时，将自动连接至其所属组织属性指定的物理数据库。

参考示例：

1. 用户张三（A分公司的组织管理员）登录系统并在系统后台创建DBName组织信息上下文，并为下属研发总部设置属性值CRMDB（用户王五）和营销中心设置属性值CRMDB1（用户李四）分别配置独立数据库标识。

   组织名	DBName属性值	组织成员	系统图示
   研发总部	CRMDB	王五
   营销中心	CRMDB1	李四

2. 用户张三（A分公司的组织管理员）登录系统使用动态连接字符串（含#{DBName}参数）创建数据源。

   
   

3. 用户张三（A分公司的组织管理员）创建完数据源后，设置数据源文档访问权限给研发总部审批人和营销中心审批人。

   
   

4. 用户王五（研发总部）登录系统后，可以查看该数据源，查看数据源时自动连接至CRMDB数据库，确保数据隔离。

   
   

5. 用户李四（营销中心）登录系统后，可以查看该数据源，查看数据源时自动连接至CRMDB1数据库，确保数据隔离。

   
   

3.2 在数据集中进行数据过滤

在数据集参数过滤配置中，将参数类型设置为"组织信息上下文"后，系统会自动将数据表字段与用户所属组织的上下文属性进行匹配，从而实现精准的行级数据权限控制。该功能确保用户仅能访问其组织权限范围内的数据记录，其配置方式与基于用户信息上下文进行行级数据管理方法完全一致。

type=info

提示： 仅当缓存数据集使用组织信息上下文参数后，基于租户生成缓存选项才会出现在设置页面，开启该功能后系统将为每个组织创建独立缓存（使用组织上下文参数过滤数据），建议仅在大数据量且多租户场景下开启该功能以优化性能。

3.3 在报表中使用

在报表参数过滤配置中，通过选择参数类型为用户/组织上下文信息，系统可实现个性化数据展示——不同身份的用户访问同一报表时，将自动应用其所属用户或组织的上下文属性值作为过滤条件，从而实现"千人千面"的数据呈现效果。更多关于用户信息上下文在报表中的应用，请参考用户/组织信息上下文。

在报表中“组织信息上下文”或“用户信息上下文”的使用方法都是使用表达式，只是表达式不一样：

参考示例：

系统管理员admin的用户信息（扩展属性：销售大区）和组织信息（组织属性）如下：

报表的使用表达式分别展示单值组织信息上下文，多值组织信息上下文和单值用户信息上下文、多值用户信息上下文。