yiyun-components v2.0.30

公共选择组件的接口

基于库体积的考虑，请自行引入公共css文件（如项目中已有elementui的css文件可忽略）

<link rel="stylesheet" href="https://unpkg.com/element-ui@2.15.9/lib/theme-chalk/index.css">

或者使用本项目提供的css，路径为cdn路径/yiyun-components/theme/index.css

通过script方式引入（使用lib文件夹下的browser.js）

<script src="yiyun-components/lib/browser.js"></script>
// 全局变量为yiyun

npm安装

npm install yiyun-components

在项目中引入

// 全部引入
import yiyun from 'yiyun-components'

// 按需引入
import 组件名 from 'yiyun-components/lib/组件名'

使用

选择设备：yiyun.selectEquipment()

单选：
    var data = await yiyun.selectEquipment(true,'你的token',[不可选id列表],[已选择id列表])
    ....
    或者：
    yiyun.selectEquipment(true,'你的token',[不可选id列表],[已选择id列表]).then((data){
        .....
    })

    data: {
        id: '',             // 设备id
        code: '',           // 设备标识
        name: '',           // 设备名称
        modelId: ''         // 设备型号id
        modelName: ''       // 设备型号名称
        status: 0           // 设备状态：0.停用 1.启用
    }
多选：
    var data = await yiyun.selectEquipment(false,'你的token',[不可选id列表],[已选择id列表])
    ....
    或者：
    yiyun.selectEquipment(false,'你的token',[不可选id列表],[已选择id列表]).then((data){
        .....
    })

    data: [{
        id: '',             // 设备id
        code: '',           // 设备标识
        name: '',           // 设备名称
        modelId: ''         // 设备型号id
        modelName: ''       // 设备型号名称
        status: 0           // 设备状态：0.停用 1.启用
    },{
        id: '',
        ...
    },...]

接口参数

返回结果

多选

参数类型	说明	其他
ArrayObject	选择的设备对象数组

单选

参数类型	说明	其他
Object	设备对象

设备对象的内容

参数名	参数类型	说明	其他
id	String	设备id
code	String	设备标识
name	String	设备名称
modelId	String	设备型号id
modelName	String	设备型号名
status	int	设备状态：0.停用 1.启用

调用地图： yiyun.initMap()

var yiyunMap
try {
    var res = await yiyun.initMap({
        id: '4YcVwbubaA3', //地图的id
        container: document.getElementById('map-container'), // 用于加载地图的dom节点
        Authorization: '', // 平台token
        onload: function (map) {   // 地图加载的回调，返回YiyunMap实例
          yiyunMap = map
        }
        beforeDraw: (cover) => {
          if (cover.type === 'area') {
            cover.setConfig({
              strokeColor: '#000C25',
              strokeWeight: 3,
              fillColor: '#000C25',
              fillOpacity: 0.3
            })
          } else if (cover.type === 'line') {
            cover.setConfig({
              strokeColor: '#000C25',
              strokeWeight: 6,
              strokeOpacity: 1,
              showDir: true
            })
          } else if (cover.type === 'label') {
            cover.setConfig({
              fontSize: 14,
              fontColor: '#000C25',
              content: '标签内容',
              fontAngle: 30
            })
          } else if (cover.type === 'icon') {
            cover.setConfig({
              icon: 'https://aaa.bbb.ccc/ddd.png'
            })
          } else if (cover.type === 'comp') {
            cover.setConfig({
               icon: 'https://aaa.bbb.ccc/ddd.png'
            })
          }
        },
    })
} catch (e) {

}
let line
yiyunMap.updateCover(
    yiyunMap.covers.areas[0],
    {
        strokeColor: '#000C25',
        strokeWeight: 3,
        fillColor: '#000C25',
        fillOpacity: 0.3
    }
)

line = yiyunMap.drawPolyline({
    path: [[121.622797,29.866232],[121.612501,29.883464],[121.653685,29.876544]],
    strokeColor: '#3389FF',
    strokeWeight: 6,
    strokeOpacity: 1,
    showDir: true
})

yiyunMap.clearMapItem(line)

接口参数

异常说明

YiyunMap实例说明

covers对象的说明

各类型cover的说明:

area:

line:

point:

label:

component:

覆盖物的渲染配置（Config）的说明

绑定的对象实例(obj)的说明

组件实例(comp)的说明

工厂模型公共选择： yiyun.nodeSelect()

    树结构调用方式：
    try {
        let res = await yiyun.nodeSelect(
            {
                nodeId: "指定节点id",
                Authorization: "token",
                isOnly: false,
                selectedNode: ["选中节点id", ...]
            }
        )
    } catch (err) {
        // 取消
    }
    ....
    或者：
    yiyun.nodeSelect({
        nodeId: "指定节点id",
        Authorization: "token",
        isOnly: false,
        selectedNode: ["选中节点id", ...]
    }).then((res) => {
        // 确定
    }).catch((err) => {
        // 取消
    })

    列表结构调用方式：
    try {
        let res = await yiyun.nodeSelect(
            {
                type: "对应层级"
                nodeId: "指定节点id",
                Authorization: "token",
                isOnly: false,
                selectedNode: ["选中节点id", ...]
            }
        )
    } catch (err) {
        // 取消
    }
    ....
    或者：
    yiyun.nodeSelect({
        type: "对应层级"
        nodeId: "指定节点id",
        Authorization: "token",
        isOnly: false,
        selectedNode: ["选中节点id", ...]
    }).then((res) => {
        // 确定
    }).catch((err) => {
        // 取消
    })

    单选 res {}
    多选 res [{},...]

    {
        id: '节点id',
        name: '节点名称',
        level: '节点等级',
        pid: '父节点id',
        isError: '节点数据是否无效',
        createTime: '创建时间',
        children: '子节点集合'
    }

接口参数

返回结果

多选

参数类型	说明	其他
ArrayObject	选择的节点对象数组

单选

参数类型	说明	其他
Object	节点对象

组织架构公共选择： yiyun.organizationSelect()

    组织架构单选：
    yiyun.organizationSelect(
        {
            isOnly: true,
            mode: '选择模式', // 包括人、岗位、部门
            needMember: true,
            isActiveMember: false,
            needPost: true,
            orgId: '',
            authorization: '你的token',
            disabled: ["禁用id",...],
            selected: { id: "已选id", name: "已选名称" },
            close: function () {
            },
            confirm: function (data) {
            }
        }
    )
    ....
    组织架构多选：
    yiyun.organizationSelect(
        {
            isOnly: false,
            mode: '选择模式', // 包括人、岗位、部门、人_岗位、人_部门
            needMember: true,
            isActiveMember: false,
            needPost: true,
            orgId: '',
            authorization: '你的token',
            disabled: ["禁用id",...],
            selected: [{ id: "已选id", name: "已选名称" },...],
            close: function () {
            },
            confirm: function (data) {
            }
        }
    )
    ....
    组织架构部门对应成员多选：
    yiyun.organizationSelect({
        isOnly: false,
        mode: 'member',
        orgId: '',
        authorization: '你的token',
        disabled: ["禁用id",...],
        selected: [{ id: "已选id", name: "已选名称" },...],
        deptId: '部门id', // 必须传对应部门id
        state: 1,
        close: function () {
        },
        confirm: function (data) {
        }
    })
    ....
    组织架构部门对应成员单选：
    yiyun.organizationSelect({
        isOnly: true,
        mode: 'member',
        orgId: '',
        authorization: '你的token',
        disabled: ["禁用id",...],
        selected: { id: "已选id", name: "已选名称" },
        deptId: '部门id', // 必须传对应部门id
        state: 1,
        close: function () {
        },
        confirm: function (data) {
        }
    })

    单选 res {}
    多选 res [{},...]
    人 {
           id: '成员Id',
           name: '成员名称',
           headPortrait: '头像',
           userId: '用户Id'  
        }
    岗位 {
            id: '岗位Id'
            name: '岗位名称',
            level: '岗位层级',
        }
    部门 {
            id: '部门Id',
            name: '部门名称',
            code: '部门码',
            parentId: '父部门Id',
        }

接口参数

返回结果

多选

参数类型	说明	其他
ArrayObject	选择的节点对象数组

单选

参数类型	说明	其他
Object	节点对象

当选择模式为member&dept时

参数类型	说明	其他
Object	对象结构为{ members: [], depts: [] }

---

组织架构Api接口：

    let res = await yiyun.getOrganizationOfMember(
        token, // token
        orgId, // 需要查询的组织Id,空表示查询当前用户的企业
        isActiveMember // 是否只显示已经激活的成员，true表示只显示已激活（已绑定），false表示显示全部
    )
    res = [
        {
            id: '部门id',
            parentId: '父部门Id',
            code: '部门码',
            name: '部门名称',
            createTime: '创建时间戳',
            memberCount: '当前部门下的成员数量（包括下下级）',
            type: '类型：member表示人，dept表示部门',
            children: [...] // 包含子部门和部门下的人，以此类推
        },
        ...
        ,   
        {
            id: '成员Id',
            name: '成员名称',
            headPortrait: '头像',
            userId: '用户Id',
            type: '类型：member表示人，dept表示部门',
        }
    ]

    let res = await yiyun.getOrganizationOfPosition(
        token, // token
        orgId // 需要查询的组织Id,空表示查询当前用户的企业
    )
    res = [
         {
            id: '岗位Id',
            name: '岗位名称',
            level: '岗位层级',
            createTime: '创建时间戳',
            memberCount: '岗位上的人数',
            depts: [ // 相关的岗位（根据成员的部门-岗位得到的）
                { id: '岗位Id', name: '岗位名称' },
                ...
            ]
         },
         ...
    ]

    let res = await yiyun.getOrganizationOfDept(
        token, // token
        orgId // 需要查询的组织Id,空表示查询当前用户的企业
    )
    res = [
        {
            id: '部门id',
            parentId: '父部门Id',
            code: '部门码',
            name: '部门名称',
            createTime: '创建时间戳',
            memberCount: '当前部门下的成员数量（包括下下级）',
            children: [...] // 包含子部门列表，子部门可能存在子部门，以此类推
        },
        ...
    ]

    let res = await yiyun.getOrganizationOfMemberPosition(
        token, // token
        orgId, // 需要查询的组织Id,空表示查询当前用户的企业
        isActiveMember // 是否只显示已经激活的成员，true表示只显示已激活（已绑定），false表示显示全部
    )

    res = [
        {
            id: '部门id',
            parentId: '父部门Id',
            code: '部门码',
            name: '部门名称',
            createTime: '创建时间戳',
            memberCount: '当前部门下的成员数量（包括下下级）',
            type: 'dept',
            children: [
                ...,
                {
                    id: '岗位Id',
                    name: '岗位名称',
                    level: '岗位层级',
                    type: 'position'
                }
                ...,
            ] // 包含子部门、部门下的人及部门下的岗位，以此类推
        },
        ...
        ,   
        {
            id: '成员Id',
            name: '成员名称',
            headPortrait: '头像',
            userId: '用户Id',
            type: 'member',
        }
    ]

    let res = await yiyun.getOrganizationOfMemberByDept(
        token, // token
        orgId, // 需要查询的组织Id,空表示查询当前用户的企业
        deptId // 部门Id
    )
    res = [  
        {
            id: '成员Id',
            name: '成员名称',
            headPortrait: '头像',
            userId: '用户Id'
        },
        ...
    ]

审批流程设置组件 const { save } = yiyun.approvalFlowConfig(config)

1.10.0 新增

config插件调用参数

{
    "authorization": 平台用户登入的Authorization

    "appId": String appId,必填 应用id

    "isAllowAll": Boolean 允许审批人员为全企业成员，false时，只有app权限人员出现在审批步骤中,默认false

    "allowStepApvlType": Int32[] 允许的审批步骤中审批人类型 0 按人员 1按岗位 2 按部门岗位 8.直属上级 9.部门主管 10.连续多级主管,未设置默认[0,1,2,8,9,10]

    "isAllowAddCC": Boolean 允许添加抄送人,默认false

    "isAllowAddTransactor": Boolean 允许添加办理人,默认false

    "isAllowSetIsAuto2": Boolean 是否允许设置自动跳过2（类型为1.按岗位、2.部门岗位 9.部门主管时：成员空自动跳过）,默认false,

    "defaultIsAuto2": Boolean 自动跳过2的默认值,默认false,

    "isAllowSetIsAuto3": Boolean 是否允许设置自动跳过3，审批人与发起人为同一人时的处理（类型 9.部门主管 10.连续多级部门主管）,默认false,

    "defaultIsAuto3": Boolean 自动跳过3的默认值,默认false,

    "isAllowSetMemberSignType": Boolean 是否允许设置会签、或签（类型0.按人员,1按岗位, 2 按部门岗位, 4.发起人自选, 5.审批人自选, 9.部门主管, 10.连续多级部门主管）,默认false,

    "defaultMemberSignType": Int32 设置会签、或签的默认值 0.或签 1.会签,默认0,

    "flowId":String 流程id（有值时，表示修改）,
    "containerId": String 组件容器id,
    "onSuccess": Function, 成功时回调, (flowId) => {}
}

返回值

{
    save: (beforeSave:Function,可选,方法参数为步骤列表,返回false或Promise.reject()可阻止保存) => {},保存流程，成功则调用配置中的onSuccess
}

插件内部逻辑与审批一样，根据插件调用参数显示/隐藏部分设置功能和设置默认值