teld-approval-component/CHANGELOG.md

build a npm package for teld-approval-component~ 审批组件抽包

# Changelog of teld-approval-component

## 0.5.1 (2025.7.14)

增加函数导出`ensureDataCenter`，审批详情项目中复用

## 0.5.0 (2025.6.17)

- 增加一个数据中心强识别的逻辑
- 增加对数据中心别名的支持
- 新增 `fasDevAppId` 配置项和 `targetIdc` 配置项，兼容不传的情况（组件使用方不改的情况）从 url 获取
- 完整规则见 `ensureDataCenter` 函数

## 0.4.9 (2024.12.23)

- 商机项目中审批组件有被业务方的`v-show`控制显示时机导致`mounted`后计算动态按钮布局获取不到宽度
  - 因此需要检查审批组件是否可见，可见后再计算动态按钮布局
  - 如果先变为可见后加载完审批流数据，并不影响

## 0.4.8 (2024.12.21)

- 完善审批失败时的处理（关闭loading、弹窗，刷新数据）

## 0.4.7 (2024.12.20)

- ToC框架对具名插槽渲染有问题，需要变通处理

## 0.4.6 (2024.12.19)

- 点击popover的按钮后关闭弹出

## 0.4.5 (2024.12.19)

- 动态按钮类名标识

## 0.4.4 (2024.12.19)

- 更新退回按钮图标
- 重新计算动态按钮时关闭弹出更多

## 0.4.3 (2024.12.19)

- 运营合同项目需求-审批退回前的校验走业务方自有逻辑`beforeApprovalRevert(callback)`
- 通过`watch`响应异步化的自定义按钮

## ~~0.4.2~~ (2024.12.19)

- 运营合同项目需求-审批退回前的校验走业务方自有逻辑`beforeApprovalRevert`

## 0.4.1 (2024.12.19)

- 回退按钮处理修复

## ~~0.4.0~~ (2024.12.18)

- 底部按钮布局动态化
- 支持自定义按钮在底部按钮区域显示在指定位置（`sortNo`）

## 0.3.2 (2024.12.3)

- 审批历史支持效能平台中单据vs审批一对多的使用场景，解决列表查询数据的过滤问题
  (后端接口`GetHistoricProcesses`加参数`ProcessDefinitionKey`)

## 0.3.1 (2024.12.2)

- 修复评论框提交时contentEditable问题
- 修复评论回复时的非空判断根据（trimmedContent 或 data-pasted-image 或 撤回重新编辑）
- 修复评论回复重新编辑时初始化焦点位置
- 修复审批回退评论框的非空判断根据（trimmedContent）
- 修复重新编辑时，编辑框同步最新内容到弹窗（回复框、评论框）

## 0.3.0 (2024.11.26)

- 解决粘贴富文本带样式导致的显示问题（仅粘贴纯文本，可单独粘贴一张图片）
- 优化提交评论内容的空校验等
- 提及人员的姓名块在提交时将富文本处理为不可编辑

## 0.2.17-beta.1 (2024.10.25)

- 由于后端人员查询接口性能问题，搜索人员的交互改为点击按钮搜索

## 0.2.16 (2024.10.16)

- 更新依赖`teld-approval-flow-mobile@0.0.15`
  - 流程图支持单一分支折叠功能

## 0.2.16-beta.3 (2024.10.09)

PC 端使用时不会因为`focus`后拉起虚拟键盘触发`window resize`事件因此需要手动触发一下`onWindowResize`函数

## 0.2.16-beta.2 (2024.10.09)

- 消除控制台警告（回退选节点弹窗props）

## 0.2.16-beta.1 (2024.10.09)

- 增加审批退回功能，通过`enableApprovalRevert:Boolean`控制开启
- 更新流程图组件依赖版本（`teld-approval-flow-mobile@0.0.14`）

## 0.2.15 (2024.10.09)

- fix(Edge): 评论框监听`window resize`事件时机挪到`onMounted`

## 0.2.14 (2024.10.08)

- 修复移动端`Edge`浏览器在底部弹出评论框时的兼容问题

## 0.2.13 (2024.09.23)

- 增加`审批意见模板`自动显示条件：仅审批同意时

## 0.2.12 (2024.09.20)

- 修复`审批意见模板`按钮显示条件：审批同意且模板有内容时

## 0.2.11 (2024.09.14)

> 业务需求：
> 加载结束后的nodeList能啥状态都返回吗，我昨天重构的时候看了下，有根据这个信息来显示某一模块的，如果没有返回没办法判断
> 当前时审批人返回审批节点和全节点，非当前审批人只返回全节点

## 0.2.10 (2024.08.16)

- 当隐藏底部按钮时（视为不可操作），同时隐藏评论回复中的回复按钮

## 0.2.10-alpha.3 (2024.07.26)

- 更新`preflight.css`预设样式，避免重置插槽内样式

## 0.2.10-alpha.2 (2024.07.20)

- 更新`preflight.css`预设样式，对于`box-sizing`的设置排除内容插槽部分

## 0.2.10-alpha.1 (2024.07.11)

- 商机项目需求开发-审批意见必填、最少字数限制、模板提示
- 修复`SYS_CommonHelper_GetUserList`返回`rows`为`null`的场景

## 0.2.9-beta.20 (2024.06.17)

- 修改选人框样式
- 给底部按钮增加可用选择器以满足业务方个性化控制的需求

## 0.2.9-beta.19 (2024.04.29)

- 修复常量导出`SUPPORT_PREVIEW_FILE_TYPES`

## 0.2.9-beta.18 (2024.04.29)

- 加签-备注样式问题修复

## 0.2.9-beta.17 (2024.04.29)

- 评论框容器指定为 body

## 0.2.9-beta.16 (2024.04.29)

- 评论Popup、加签Popup：解决编辑后点击叉号不弹提示的问题

## 0.2.9-beta.15 (2024.04.29)

- 编辑框特殊文字识别相关的重构
  - [重构详情文档](https://alidocs.dingtalk.com/document/edit?chInfo=im&utm_medium=im_card&utm_source=im&docKey=3BMqYaw82pZGqwZL&dentryKey=oeJBxB2Zf0r8ZzAB&type=d)
  - 编辑框输入 / 考虑禁用快捷指令的情况
  - ESC 支持关闭的优化，解决重复弹窗确认的问题（Dialog finally 中增加延时）
  - 回复、加签：更新提示文案

## 0.2.9-beta.14 (2024.04.28)

- 去除包管理器限定

## 0.2.9-beta.13 (2024.04.28)

- 弹窗关闭优化
  - 评论/审批 Popup 已编辑时增加关闭确认
  - 选人 Popup 中已选列表 Popup 增加支持 ESC 关闭
  - 回复 Popup 增加支持 ESC 关闭
  - 加签 Popup 增加支持 ESC 关闭
  - 优化相关关闭确认，避免 ESC 时一直弹确认
- 附件图片预览中增加支持 ESC 关闭
- 优化选人弹窗点击勾选的响应

## 0.2.9-beta.12 (2024.04.26)

- 重构:[审批组件关于各类弹窗样式的重构](https://alidocs.dingtalk.com/document/edit?docKey=a2QnVJN3kzZDn4XB&dentryKey=Mq1B4NKPc051GYQE&type=d)
  - 只有回复 Popup 接收`custom-style`，其它弹窗 Dialog 使用通用默认样式：PC 端居中，移动端全屏
  - 增加配置项`popupStyle`用于大弹窗的宽高自定义（评论、审批、转交、加签、选人弹窗这些）
  - 同时因重构间接修复了审批详情项目中回复内选人弹窗位置问题


## 0.2.9-beta.11 (2024.04.25)

- 回复的提及人员的通知需要链接地址，增加传参`FormUrl`

## 0.2.9-beta.10 (2024.04.25)

- 评论、回复的撤回确认`z-index`调整，高于`approval-head-info`
- 回复支持`@`提及人员（接口增加传参`NotifyUserIdList`）
- 回复支持`/`快捷操作（包括@流程发起人、全部清空、立即发送）
- 加签中选择加签类型时的交互优化
- CommentEditor 功能优化
  - Backspace删除时，阻止浏览器在删光内容后自动添加`<br>`的行为
  - 增加是否使用快捷指令的开关
- 加签支持`@`提及人员（接口增加传参`NotifyUserIdList`）

## 0.2.9-beta.9 (2024.04.24)

- 编辑时支持附件预览 `xlsx`

## 0.2.9-beta.8 (2024.04.23)

- 提及人员类名重命名`teld-approval--mentioned-user`
- 获取提及人员 id 数组时的查询修改

## 0.2.9-beta.7 (2024.04.22)

- fix:评论弹窗-编辑框需要v-if控制

## 0.2.9-beta.6 (2024.04.22)

- 编辑时支持附件预览
  - 图片（.png .jpg .jpeg .gif），.docx，.pdf 文件
- 编辑时附件列表支持PC端鼠标滚动轮滚动
- 编辑时图片附件的样式问题修复

## 0.2.9-beta.5 (2024.04.19)

~~# 0.2.9-beta.4 (2024.04.19)~~
~~# 0.2.9-beta.3 (2024.04.19)~~

- 修复`isAllDone`赋值逻辑

~~# 0.2.9-beta.2 (2024.04.18)~~

- 修改 `next.isAllDone` 赋值逻辑，只看是否开启自动下一条的配置，不看是否勾选（避免最后一条时没有复选框导致无法通知）
- 开启自动下一条配置项即会获取下一条数据用于判断是否全部完成，修改了获取数据的逻辑；当没显示复选框或者不勾选的时候，并不给`autoNext`赋值

~~# 0.2.9-beta.1 (2024.04.18)~~

- 在开启自动下一条后，没有下一条则视为已完成全部审批，`next.isAllDone`

## 0.2.8 (2024.04.18)

- 经多处问题修复及增加新功能特性，`0.2.8`发布为稳定版

## 0.2.8-beta.12 (2024.04.17)

- 审批历史移动端提示问题变更（当前->进行中）

## 0.2.8-beta.11 (2024.04.10)

- 审批历史列表样式微调

## 0.2.8-beta.10 (2024.04.09)

- Features
  - 审批历史功能完善修改组件实例级控制
    - `enableHistory`由全局配置改为组件实例级别参数，默认`false`禁用，设为`true`后启用
    - 废弃原组件级`disableHistory`参数

## 0.2.8-beta.9 (2024.04.09)

- Features
  - 审批历史功能完善增加组件实例级控制
    - 全局用`enableHistory`控制，默认`false`禁用，设为`true`后启用
    - 组件级可以单独控制，使用`disableHistory`参数，默认`false`，设为`true`后组件级禁用

## 0.2.8-beta.8 (2024.04.04)

- Features
  - 审批历史功能（应业务方要求添加功能-合同项目为了方便查看历史拒绝原因）
    - 增加了配置项`enableHistory`，默认`false`不开启
    - 开启后可查看该单据的历史审批，可在历史审批间切换
    - 注：新增使用基础组件`tm-tag`
    - 可切换单据的历史审批，可一键回到该单据进行中的审批（如果有）

## 0.2.8-beta.7 (2024.03.28)

- Features
  - 下载全部附件时从Url取出资源文件名作为文件名

## 0.2.8-beta.6 (2024.03.27)

- Features
  - 查询人员列表接口传参，使用特来电组织ID

## 0.2.8-beta.5 (2024.03.14)

- Features
  - 审批自动通过提示文字增加支持的场景（并行审批，多个审批中，且有自动通过的场景）

## 0.2.8-beta.4 (2024.03.12)

- Features
  - 增加支持审批自动通过，显示“已自动通过”或“将自动通过”

## 0.2.8-beta.4 (2024.03.06)

chore(ApprovalDetail): 去除多余的 van 样式覆盖（van-picker、van-overlay）

## 0.2.8-beta.3 (2024.02.29)

- Fixes
  - 选人功能中流程内人员列表滚动问题
- Improvements
  - 审批标题最多展示三行

## 0.2.8-beta.2 (2024.02.27)

- Fixes
  - 附件多个时图片宽度问题
  - 商机项目某页面样式受影响，去掉 tailwind 的 container 核心类

## 0.2.8-beta.1 (2024.02.20)

- Features
  - 增加分享链接图标，点击复制到粘贴板
- Improvement
  - 优化评论内容展示样式（超长内容情况的显示问题）

## 0.2.8-alpha.19 (2024.01.17)

- 更新依赖
  - teld-approval-flow-mobile@0.0.13-beta.11(流程实例-流程图-审批信息过滤)

## 0.2.8-alpha.18 (2024.01.16)

- 更新依赖
  - teld-approval-flow-mobile@0.0.13-beta.10(流程实例-流程图-主要业务节点非执行时，截断处理)

## 0.2.8-alpha.17 (2024.01.16)

- 更新依赖
  - teld-approval-flow-mobile@0.0.13-beta.9(支持仅显示审批路径，修复复杂流程图场景节点简化)

## 0.2.8-alpha.16 (2024.01.15)

- 更新依赖
  - teld-approval-flow-mobile@0.0.13-beta.8(支持仅显示审批路径)

## 0.2.8-alpha.15 (2024.01.11)

- 更新依赖
  - teld-approval-flow-mobile@0.0.13-beta.7(支持`initScale`及调整样式)
    - 更新依赖`vue-grabbing-box@1.0.0-alpha.4`

## 0.2.8-alpha.14 (2024.01.06)

- 更新依赖
  - teld-approval-flow-mobile@0.0.13-beta.6(默认分支功能)

- 流程图查看-关闭网关全部折叠功能
  useButtonToggleAll: false

- PC端样式适配优化 CommentReplyPopup

## 0.2.8-alpha.13 (2024.01.04)

更新依赖

- teld-approval-flow-mobile@0.0.13-beta.4(NPM问题，无文件，需重发)
- teld-approval-flow-mobile@0.0.13-beta.5

## 0.2.8-alpha.12 (2024.01.03)

- Features
  - 将检查下一条审批地址（ApprovalUrl）的逻辑下沉到审批组件，
    ApprovalDetail 项目中的检查&提示依然保留，
    这里用于无法打开下一条时控制开关的隐藏
    因此需要增加一个配置参数`isFasApproval`，默认 false，只在低代码审批详情项目中打开

## 0.2.8-alpha.11 (2024.01.02)

- Features
  - 增加入参`showBack`用于在 iframe 嵌套时显示返回箭头图标
- Improvement
  - 更换加签图标`IconAddSign`并导出该图标组件

## 0.2.8-alpha.10 (2023.12.27)

- Improvement
  - 操作事件增加传参`processInstanceId`，审批详情移动端页面需要使用

- Fixes
  - 选人搜索加载更多（下一页问题）

## 0.2.8-alpha.9 (2023.12.25)

- Refactor
  - 关于关闭自动下一条的实现方式，将`disableAutoNext`控制逻辑由组件提升至页面，简化组件内逻辑
  - 在审批详情页面通过覆盖`tacOptions`中的`enableAutoNext`，组件中仍只判断`enableAutoNext`即可

## 0.2.8-alpha.8 (2023.12.23)

- 任务中心特殊需求
  - 审批详情页默认开启了自动下一条审批功能，`tacOptions.enableAutoNext: true`
  - 但是当审批详情嵌入在任务中心PC端页面drawer中时，不需要开启自动下一条功能
  - 因此，在`enableAutoNext`开启的前提下，再增加一个判断参数：`disableAutoNext`
  - disableAutoNext 可以是 true 或 false
  - 审批详情作为drawer中iframe页面，强制使用移动端版式(`noRedirect=1`)

## 0.2.8-alpha.7 (2023.12.21)

- Fixes
  - iOS 中输入最后文字提交为拼音的问题

- Improvement
  - FasApproval 移动端时，显示等待下一步处理人，仅控制 PC 端时隐藏

## 0.2.8-alpha.6 (2023.12.20)

- Fixes
  - 同一审批类型的判断
  - 审批后获取最新下一条审批时增加逻辑条件 autoNextVisible

## 0.2.8-alpha.5 (2023.12.18)

更新依赖`teld-approval-flow-mobile@0.0.13-beta.3`，移动端查看流程图实例结束节点样式优化及图标问题修复

## 0.2.8-alpha.4 (2023.12.16)

更新依赖`teld-approval-flow-mobile@0.0.12`，移动端查看流程图实例结束节点样式优化

## 0.2.8-alpha.3 (2023.12.13)

- Improvement
  - 审批后自动转到下一条，当同一审批人员连续审批时无需open新页面，只需刷新数据

## 0.2.8-alpha.2 (2023.12.11)

- Fixes
  - 评论的回复提交后报错未关闭loading无法刷新审批信息的问题

- Improvement
  - 调整文案：审批后自动转到下一条

## 0.2.8-alpha.1 (2023.12.05)

- Features
  - 支持审批（同意、拒绝）后自动进入下一条
    - 1. 本组件增加配置项 enableAutoNext，默认 false 不开启，低代码审批先开启，商机项目默认不开启（因需要项目对接）
    - 2. 本组件增加`@refresh`事件传参，`{ autoNext: {"ProcessInstanceId": "", "BusinessKey": "", "ActivityInstanceId": "", "TaskId": "", ApprovalUrl : ""} }`
    - 3. 项目中对接时，根据`e.autoNext`是否有值，判断是否自动进入下一条
    - 4. 自动进入下一条需要弹出提示：【即将进入下一条审批..】，并用新地址刷新页面

## 0.2.7-beta.2 (2023.12.04)

- 完善搜索人员的防抖处理

## 0.2.7-beta.1 (2023.11.18)

- 更新依赖`teld-approval-flow-mobile`-`vue-grabbing-box`

## 0.2.7-alpha.5 (2023.11.10)

- fixes
  - 根据不同环境为PC端新标签打开流程图获取域名
- optimization
  - 伪元素中的主题色问题

## 0.2.7-alpha.4 (2023.11.07)

- optimization
  - 评论框编辑器延时设焦点（200ms）

## 0.2.7-alpha.3 (2023.11.06)

- optimization
  - 增加版本标识`__TAC_VERSION__`

## 0.2.7-alpha.2 (2023.11.02)

- optimization
  - 解决 Field 组件 PC端时清空无效的问题

## 0.2.7-alpha.1 (2023.11.01)

- optimization
  - 选人确认框移除按钮优化(mini->small)
  - 优化各突出显示使用主题色

## 0.2.6 (2023.11.01)

- fixes
  - fix: 移动端时-审批拒绝-提交前内容赋值时点
- features
  - 撤回的接口增加了返回值，可用于判断是否撤回成功（已流转的不能撤回）
- refactor
  - 部分接口调用处理重构，优化提交后的提示展示（默认都是1200ms）

## 0.2.5 (2023.10.31)

- features
  - PC端样式兼容`close-icon-position`支持调整 Popup 关闭按钮位置为右上角
- fixes
  - CommentEditor交互优化
- others
  - 增加导出转交图标组件
  - 主题色问题对应

## 0.2.4 (2023.10.28)

- features
  - 评论框增加`/`按钮及提示
  - 快捷指令增加`@流程发起人`

## 0.2.3 (2023.10.27)

- features
  - 增加快捷指令功能，输入`/`上下移动选中`Enter`执行快捷指令
  - 增加支持选人框的单独`Esc`关闭
  - improvement: 优化customButtons样式及交互

## 0.2.2 (2023.10.26)

- fixes
  - 修复简易选人上下移动选中循环

## 0.2.1 (2023.10.25)

- fixes
  - 简易选人弹窗内样式优化
  - 修复再次打开选人窗时按组织选人的面包屑问题
- features
  - 变更：移动端打开取消简易选人直接使用原完整版选人
  - PC端的移动版样式（如商机等项目）时支持流程图的新Tab页打开

## 0.2.0 (2023.10.22)

- features
  - 简易选人（`@选人`优化）

## 0.1.16 (2023.10.13)

- fixes
  - 审批意见回显支持换行

## 0.1.15 (2023.10.05)

- features
  - 加签生成系统评论的展示功能
    系统评论默认收折，点击可切换展开状态；
    系统评论不可撤回，也无需回复（这两个按钮直接隐藏）

## 0.1.14 (2023.09.28)

- improvement
  - 商机项目需求：顶部信息 z-index 调整为100（高于插槽内容中的99）

## 0.1.13 (2023.09.27)

- improvement

  - 移动端展示流程图关闭图标跳整（cross）
  - 移动端展示审批详情顶部信息固定（sticky）
- chore

  - 更新依赖库 `teld-approval-flow-mobile`(0.0.10)

## 0.1.12 (2023.09.23)

- features

  - 外部调用审批同意拒绝加params入参
- improvement

  - 针对cfe2项目调整优化

## 0.1.11 (2023.09.20)

- features

  - 是否显示顶部的处理中信息（当前审批人、等待时间）`options.showCurrentProcessing`
  - 按钮使用主题色（读取 `cookie`中的 `Frame_ThemeColor`转对象）
  - 增加对框架切换主题的响应
  -----
- improvement

  - PC端-顶部审批状态印章位置
  - 顶部信息样式优化（减小间距）

## 0.1.10 (2023.09.18)

- features
  - 修改审批同意时的审批意见为非必填
  -----
- improvement

  - PC端-附件列表组件样式优化
  - PC端-时间线组件-内容样式优化
  - 选人框Tabs样式优化
  - 更新依赖 `teld-approval-flow-mobile`

## 0.1.9 (2023.09.15)

- features

  - 评论框Escape关闭
- fixes

  - 审批拒绝外部控制时的回调后刷新
- improvement

  - 移动端时展现流程图优化、收展按钮优化
  - 选人框内全选交互优化
  - 选人框 loading 优化
  - 时间线连线优化、icon优化
  - README 更新（`options`更新）

## 0.1.8 (2023.09.14)

- features

  - 增加对是否显示顶部信息的控制 `show-head-info`
  - 增加对是否显示底部按钮的控制 `show-buttons`
  - 增加加签功能的外部控制 `beforeAddSign`
  - 移动端展示流程图支持配置是否默认打开图例(`flowDesigner.legend.open`)
- fixes

  - 审批组件入参 `show-process`问题
- improvement

  - 弹窗相关适配修改（选人框、催办框、加签框）
  - README 文档内容微调
  - 选人搜索框自动焦点
  - 基础样式reset中，将影响业务项目方的，限定在审批组件内（持续更新）
  - 底部按钮、Confirm弹窗按钮样式优化
  - 更新流程图依赖包

## 0.1.7 (2023.09.12)

- improvement
  - 优化移动端Popup选人框时页面滚动问题（去除body上的transform后选人弹窗动态container修复）
  - 移动端底部按钮组样式
  - 评论、回复时自动焦点等
  - 评论回复在PC端限宽时居中等（底部弹出类统一修改）

## 0.1.6 (2023.09.11)

- improvement
  - 评论框选人后焦点
- fixes
  - 评论框选人再次打开选人时的初始化数据问题

## 0.1.5 (2023.09.09)

- fixes

  - 修改流程图存在判断逻辑，接口增加字段 `IsNewDesigner`
- chore

  - README 更新

## 0.1.4 (2023.09.08)

- fixes

  - 撤销回复时，确保变量 `回复`有值且 `评论`无值
- feature

  - WF接口调用传参，废弃 `FasDevAppId`，改会 `TargetSetID`
- chore

  - 审批状态印章样式调整
  - 审批按钮样式调整

## 0.1.3 (2023.09.07)

- fixes

  - 审批状态印章的 z-index 修改
- chore

  - SearchResult的样式微调
  - README更新

## 0.1.2 (2023.09.06)

- refactor
  - refresh事件，回调参数 `operation: APPROVAL_OPERATIONS`
  - 其它清理
  - 审批前处理函数传入时的接口调用

## 0.1.1 (2023.09.05)

- fixes

  - 修复vant上传 cursor 问题
  - 修复查看流程图样式
  - 修改审批名称文字样式(break-all)
- features

  - 增加子组件导出
  - options.pcPolyfill 审批详情 PC 端 Polyfill
- others

  - 打包优化，减少体积（在被消费的项目里需单独安装 `teld-approval-flow-mobile` 依赖包）

## 0.1.0 (2023.08.31)

重构完成版，已用于低代码审批页面。

TODO

- 文档待完善
- 其它项目中的验证&支持

## 0.0.2 (2023.07.17)

初版更新

- features
  - 增加 `ProcessTimeline`组件导出

## 0.0.1 (2023.07.15)

初版发布