流程平台：表单页面（三）- 列表选人控件(SheetUserList)

在表单页面上选择人员的方式有2种，一种是通过下拉列表控件，选择其中的一位或多人；另一种是通过组织架构树的形式选择一位或多位。

组织架构树形选人控件 SheetUserSelector、下拉列表选人控件 SheetUserList

树形选人控件 SheetUserSelector 

下拉列表选人控件 SheetUserList

下拉列表式选人控件一般适用于选择部门人员或者选择角色成员，也可以通过自定义JS脚本方式通过ajax方式获取显示的数据源。

该选人控件有诸多属性，其中常用的几个属性有：

DataField="[AcceptApprover]"   //[必须]绑定的参与者数据项
CompanySelectable="False" 　//是否可以选择公司
GroupSelectable="False" 　　 //是否可以选择角色(组)
OrgUnitSelectable="False" 　  //是否可以选择部门
SegmentSelectable="False" 　//是否可以选择群
UserSelectable="True"　　　  //是否可以选择用户
SelectMode="Multi" 　　　　　//Multi=多选,Single=单选
UnitId=""　　　　　　　　　　 //指定范围的ID，多个ID用分号分隔

如果需要使用自定义数据源，比如通过js的ajax方式获取人员列表作为该控件的数据源，则需要修改几个属性的设置，

BaseUnitsSource="Script"

OnClientClick="SelectAcceptApprover();" //自定义的脚本方法

添加一个js文件或在表单页面加入js代码实现SelectAcceptApprover方法

//下拉列表选择人员
function SelectAcceptApprover() {
    //选人控件在表单页面上的ID
    var controlID = "SheetUserList2";
    //0=单选(Single),1=多选(Multi)
    var selectType = 0; 
    //json格式的数据源(可以通过ajax等方式获取，此处省略.)
    var selectUsers = {
        Users:[{ID:"14641f7a-e1f7-417d-bcb9-21e192d95d1c",Value:"张三"},
              {ID:"2fd48bc2-34da-437e-9be8-f73e1cb0a2c2",Value:"李四"}
             ]}; //json
    //选人控件绑定数据源(最后两个参数基本是固定的)
    $.setUserListDefault(controlID + "_UserNames", controlID + "_UserIDs", selectType, selectUsers, 0, 8);
}

最终自定义数据源(js)方式呈现的效果如