模板条件匹配接口文档

## 1 简介 在打印需求中，二开由于某些具体需求，标准操作按钮不满足用户业务场景时，希望通过接口获取到单据匹配的打印模板，进行打印。 ## 2 适用版本 金蝶云苍穹 6.0.1及以上 ## 3 接口工具类 kd.bos.print.matchtpl.TplMatcherUtil ## 4 接口列表 | 方法 | 说明 | | ------------------------------------- | ------------------------------------------------------------ | | runMatcher | 执行模板匹配流程，一个流程匹配到即返回结果
1、模板条件设置匹配模板流程
2、打印个人设置匹配模板流程
3、打印方案匹配模板流程
4、默认模板匹配模板流程 | | buildMatcherResultByNewPrintCondition | 执行模板配置条件设置匹配流程 | | buildMatcherResultByPrintSetting | 执行打印个人设置匹配流程
模板匹配优先级：打印个人设置打印条件>打印个人设置默认模板 | | buildMatcherResultByScheme | 执行打印方案匹配流程
匹配模板优先级：打印方案设置的打印条件>打印方案设置的默认模板 | | buildMatcherResultByDefault | 执行默认模板匹配流程
匹配模板优先级：打印个人设置按钮配置的默认模板>打印方案配置的默认模板>维护打印模板列表设置的默认模板 | ## 5 入参 kd.bos.print.matchtpl.TplMatcherParam | 参数名称 | 类型 | 必填 | 说明 | | -------- | ------------ | ---- | -------------------------------------------- | | entityId | String | 是 | 实体id(页面的标识，扩展页面需要传原单的标识) | | pkIds | List<Object> | 必填 | 单据id集合 | | appId | String | 否 | 应用id | | viewType | ViewType | 是 | 视图类型 | ## 6 结果集 kd.bos.print.matchtpl.MatcherResult | 参数名称 | 类型 | 说明 | | ------------- | ------------------------- | ------------------------------------------------------------ | | endMatchLevel | int | 模板在哪个节点匹配到。1模板匹配条件 2个人设置 3打印方案 4默认模板 0时4种设置均为空，未匹配到 | | pkTplMap | Map<Object,Set<MatchTpl>> | pk-模板集合映射map，数据主键对应模板集合 | | tplPkMap | Map<MatchTpl,Set<Object>> | 模板-pk集合映射map，模板对应数据主键集合 | | unMatchPkSet | Set<Object> | 未匹配到的数据主键集合 | ## 7 案例-单据打印时如何插件获取到匹配的模板 ```java /** * 模板接口使用案例 * */ public class TplMatchTestPlugin extends AbstractListPlugin { @Override public void registerListener(EventObject e) { addItemClickListeners("_toolbar_"); } @Override public void itemClick(ItemClickE