内置程序

功能说明

天舟云支持垂直产品开发团队，开发内置程序，然后通过页面配置注册到天舟云系统中，被事件订阅使用。

maven 依赖

            <dependency>
                <groupId>com.cvte.lcp</groupId>
                <artifactId>lcp-internal-client</artifactId>
                <version>2.3.1-SNAPSHOT</version>
            </dependency>
            可以跟随天舟云部署版本选择对应版本

1、在代码工程添加上述依赖，实现AbstractInternalEventAction或者其子类即可。

抽象类说明

建议根据实际场景选择继承相应的抽象类，不区分场景使用AbstractInternalEventAction，会出现一些字段为 null 的情况。

举例

如下图，根据实际情况实现相应的抽象类，并添加@InternalPxEvent注解，实现业务逻辑即可

常见问题

1、事件调试技巧

方式一：

启动宿主程序，访问${base_url}: /v1/internal/event/client/px/dispatch
入参可在 https://lcpsit.gz.cvte.cn/portal/hqjapc10/8fvlv4bu_9vdqfnww_bzkddesb_apilog/lcp_zmycm 查询后，点击链路 ID后获取；

方式二：

配置后事件执行程序后，手动改 obj_event_def 的 service_name 字段

2、快速实现主表单、子表单数据与DTO实体类映射

引入客户端依赖后，利用FormDataMapField注解和InternalEntityUtils帮助类，可以快速实现表单字段、子表单字段与宿主程序的 DTO 实体类快速正向与反向映射

3、多选字段

多选字段，以数组形式进行传递交互；

4、表单更新前，在PX事件中更新字段值，系统会以更新后的值保存到数据库中

5、新服务接入

1、对于私有化部署的产品线，可以直接修改阿波罗配置：
lcp.event.product.services = saasplm-pdm,rest-data （其中 saasplm-pdm 为 服务名，多个服务以英文逗号隔开），然后重启 app 服务
2、对于公有部署的产品线，请联系@柯立明 添加