3.10.0 • Published 11 months ago
@qse/approve-h5 v3.10.0
approve-h5
如果需要自定义 请看@qse/approve-core部分
分成 npm 与 iframe 链接 使用
iframe 引用
通过 iframe 直接访问通用的审批详情页面，无需引入组件，适用于无自定义需求的项目
模版
/edu-approve/index.html?sheet_id={sheet_id}&corpId={corpId}&appsysid={appsysid}
例子
<iframe
src="http://www.zhidianbao.cn:8088/qsxxwapdev/edu-approve/index.html?sheet_id=1367225789891739648&corpId=ding6f34e443f18c3ecc&appsysid=59"
></iframe>安装
# 安装 更新
npm i @qse/approve-h5@latest使用
ApproveH5 组件有 3 个子组件 ApproveH5.Info ApproveH5.Process ApproveH5.Controls，参数与ApproveH5一样
// 以下两种导入都可以，选一种即可
import { ApproveH5 } from '@qse/approve-h5'
import ApproveH5 from '@qse/approve-h5'
// 完整审批页面
function App() {
return <ApproveH5 sheet_id="1266521377981071360" userId="01632267266265" campusid="选填，影响编辑时List类型的数据" />
}
// 审批信息组件 参数与 ApproveH5 一样
function App() {
return (
<ApproveH5.Info sheet_id="1266521377981071360" userId="01632267266265" campusid="选填，影响编辑时List类型的数据" />
)
}
// 审批流程组件 参数与 ApproveH5 一样
function App() {
return <ApproveH5.Process sheet_id="1266521377981071360" userId="01632267266265" />
}
// 审批按钮组件 参数与 ApproveH5 一样
function App() {
return <ApproveH5.Controls sheet_id="1266521377981071360" userId="01632267266265" />
}API
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| sheet_id | 表单 id | string | |
| userId | 当前登录人 id | string | |
| campusid | 校区 id | string | |
| disabled | 禁用审批操作 | boolean | |
| onResolve | 审批成功时的回调 | () => Promise<void> | |
| onReject | 审批拒绝时的回调 | () => Promise<void> | |
| onRejectAfterComplete | 审批拒绝(审批完成后)时的回调 | () => Promise<void> | |
| onRevoke | 审批撤回时的回调 | () => Promise<void> | |
| onUrge | 审批催办时的回调 | () => Promise<void> | |
| onCreated | 当 init 调用后，会执行这个方法返回详情数据 | (approveState: ApproveState) => void | |
| onPreview | 当点击查看附件的时候返回file信息。如果不填预览不了文件，并在控制台提示警告 | (file: Attachment) => void | |
| allowNextSheet | 允许审批完成后自动跳转下一条单据 | boolean | false |
| onDeliver | 转交按钮触发事件，传递的 callback 参数需要返回人员列表，用于转交给其他人 | (callback: (empList:Emp[], comment?:string) => Promise<void> approveState: ApproveState) => void | |
| dd | 钉钉 JS SDK，用于创建群聊 | - |
dd - 创建群聊
仅钉钉环境才会显示创建群聊，按下面的步骤接入
- 先找后端配置
钉钉群模版ID(template_id)，需要form_code参数 - dd.config 需要授权下面的两个 API
dd.config({
jsApiList: ['biz.chat.toConversationByOpenConversationId', 'biz.chat.toConversation'],
})- 将钉钉对象传入组件
<Approve dd={window.dd} />