@qse/approve-h5

approve-h5

如果需要自定义 请看@qse/approve-core部分

分成 npm 与 iframe 链接 使用

iframe 引用

通过 iframe 直接访问通用的审批详情页面，无需引入组件，适用于无自定义需求的项目

模版

/edu-approve/index.html?sheet_id={sheet_id}&corpId={corpId}&appsysid={appsysid}

例子

http://www.zhidianbao.cn:8088/qsxxwapdev/edu-approve/index.html?sheet_id=1367225789891739648&corpId=ding6f34e443f18c3ecc&appsysid=59

<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 - 创建群聊

仅钉钉环境才会显示创建群聊，按下面的步骤接入

1. 先找后端配置钉钉群模版ID(template_id)，需要 form_code 参数
2. dd.config 需要授权下面的两个 API

dd.config({
  jsApiList: ['biz.chat.toConversationByOpenConversationId', 'biz.chat.toConversation'],
})

3. 将钉钉对象传入组件 <Approve dd={window.dd} />