O2OA(翱途)开发平台[下称O2OA开发平台或者O2OA]拥有门户页面定制与集成的能力,平台通过门户定制,可以根据企业的文化,业务需要设计符合企业需要的统一信息门户,系统首页等UI界面。从本篇讲的是页面设计器元素组件中人员组织选择组件。
1、先决条件
1、O2Server服务器正常运行,系统安装部署请参考文档《如何在服务器上安装部署O2OA》
2、以拥有管理员权限或拥有门户管理员(PortalManager角色)的用户账号登录O2OA(翱途)开发平台,如:xadmin
3、可以进入门户管理平台并且有开发权限,请参考《门户开发-门户设计开发入口和权限说明》
人员组织用于平台中对人员、组织或群组的选择。
人员组织特有的基本属性如下:
属性 | 描述 | 备注 |
显示图标 | 是否显示人员组织图标 | |
是否只读 | 如果选“是“则不允许编辑 | |
允许输入 | 是否允许手工输入 | 一般情况下,为了保证数据准确,人员组织相关数据都是通过选择得到的。此处如果选“是“,则允许手工输入,会从组织中筛选匹配的人员供选择。 |
分隔符 | 多个组织数据的分隔符 | |
Input样式 | 通过css定义input元素的样式 | 人员组织在html的直接dom结构为<div><input /></div>,所以样式属性调整的是div的样式,input样式渲染input对象的样式。 |
默认值 | 可以通过选择用户或组织或编写脚本计算出人员组织的默认值 | 在门户页面中,“创建“、”保存“和”显示“的表现都是一样的,这个选项在流程表单中有区别。 |
校验 | 此字段在门户页面中无效 | 在流程表单中用于提交时的数据校验 |
人员组织特有的选择属性页,定义此字段的选择范围和规则,其属性如下:
属性 | 描述 | 备注 |
选择类型 | 允许选择的数据类型 | 包括:“身份“、”组织“和”群组“;允许多选,每种选择类型在下方tab页中有相应的规则需要配置。 |
身份选择规则 | ||
选择数量 | 允许选择的数量 | 0 表示数量不限 |
返回结果 | 选择的数据的类型 | 平台组织架构有“个人“和”身份“两个概念,一个个人在被分配到一个组织后就产生了一个身份,被分配到多个组织,就有多个身份;一个个人可以有多个身份。 |
只使用自定义项 | 如果选择“是“,只根据属性“自定义选项“和”排除“列示候选项,忽略其他属性 | |
组织范围 | 限定候选项的组织范围 | 指定组织: 此时可以选择一个固定的组织作为候选项范围,也可以通过脚本返回候选项范围,表单数据在页面中不可用。 当前人所在组织: 此时可选择当前人所在的直接所属组织作为候选项范围;当有多级组织时,也可以指定当前人所在的某个层级的组织作为候选项范围;还可以指定当前人所在的某个类型的组织作为候选项范围。 |
展开下级 | 在多级组织时,是否将下级组织也作为候选项范围 | |
职务范围 | 对候选项的职务进行限定 | 所有:不过滤职务,范围内的所有选项都可选择。 指定职务: 此时可以通过“选择职务”,选择固定的职务名称,候选项中就只有拥有此职务的人员;也可以通过脚本返回职务名称作为过滤项;表单数据页面上不可用。 分类和展现层级用于候选项的展现方式。 |
自定义选项 | 通过脚本返回候选项或候选项范围 | 当“只使用自定义项”为“否”时,此选项和上述属性叠加生效;当“只使用自定义项”为“是”时,只有此属性生效 |
排除 | 排除候选项或候选项范围 | 通过脚本返回候选项和候选项范围,返回的这些选项会从上述范围中剔除出去。 |
组织和群组选择规则 | ||
组织和群组的选择规则和身份类似,但属性少一些,可参考身份选择规则 |
区段属性在门户页面中无效,只在流程表单中生效。
除了DOM事件之外,人员组织的系统事件如下:
事件名 | 描述 |
queryLoad | 元素被载入之前执行 |
load postLoad | 元素被载入之后执行 |
人员组织对象可以通过以下脚本获取:
var el = this.page.get(name); //name为人员组织的标识
获取的对象有以下方法可以使用:
方法名(属性) | 用法 | 描述 |
show | el.show() | 显示元素 |
hide | el.hide() | 隐藏元素 |
addEvent | el.addEvent(name, fun) | 给元素绑定系统事件。 name:事件按名称 fun: 执行的方法 |
node | var dom= el.node | 获取html原生Dom对象 |
setData | el.setData(str) | 设置人员组织的值 |
getData | var value = el.getData() | 获取人员组织的值 |
以上是门户设计器中人员组织选择组件的简单说明,希望对您有帮助,关于门户页面开发的更多介绍请参考以下文章: