Oinone FAQ

第一步：数据可视化创建大屏。 第二步：界面设计器创建页面，在页面设计时，拖一个数据大屏组件，将大屏绑定到页面中，点击右上角显示母版，准备将页面绑定到菜单上。 第三步：在oinone功能展示应用下，创建一个菜单，点击绑定当前页面，将该页面绑定到菜单上，点击发布。 第四步：进入刚才菜单所属的应用（oinone功能展示），可以看到刚刚新增的菜单，数据大屏就成功绑定到页面上了。

以下操作需注意： 手动定义columnDefinition导致重复执行ddl。如pgsql中decimal类型自动转换为numeric类型。 使用Mybatis Plus原生Page对象进行分页查询。 使用distinct/group by/join等查询导致分页报错。 启动创建数据库时未支持驱动参数。 场景 1：URL 缺少关键参数 场景 2：使用了不支持的 JDBC 驱动版本 数据库函数/数据库关键字意外识别为列导致的查询失败。 自定义sql查询时出现字段名称未正确映射为小驼峰字段导致的无法获取数据。

1、执行yum-config-manager –add-repo https://download.docker.com/linux/centos/docker-ce.repo出现问题： 报错： Could not fetch/save url https://download.docker.com/linux/centos/docker-ce.repo to file /etc/yum.repos.d/docker-ce.repo: [Errno 14] curl#35 – "TCP connection reset by peer 解决方案： #安装阿里云的镜像 yum-config-manager –add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo 2、如果重新运行startup.sh失败,可能是docker前面已经启过了还在运行。 解决方案： docker stop designer-allinone docker rm designer-allinone sh startup.sh 3、启动无代码失败 报错： 依赖包版本不匹配 pamirs-business-api已安装版本:[5.1.24],启动中包含的版本:[5.1.12] pamirs-data-audit-api已安装版本:[5.1.24],启动中包含的版本:[5.1.12] pamirs-sys-setting-core已安装版本:[5.1.24],启动中包含的版本:[5.1.12] ······ 解决方案：修改 startup.sh 中的版本修改docker pull 命令中的版本（注意：具体版本号查看https://doc.oinone.top/xin-ren-ru-men/18758.html中） 4、执行vi startup.sh出错，可能是没有修改这个文件的权限，执行chmod 777 startup.sh即可授权

一、协同开发支持 https://doc.oinone.top/backend/4821.html 二、协同开发手册 https://doc.oinone.top/backend/14878.html 三、协同开发常见问题 1、启动报错：公共环境开启了元数据保护模式，本地开发环境需配置https://doc.oinone.top/faq/17045.html 2.协同开发配置一定要注意事项https://doc.oinone.top/faq/18249.html 3.Onione协同开发源码分析https://doc.oinone.top/backend/17209.html 4、Oinone环境保护（v5.2.3以上）https://doc.oinone.top/backend/18451.html 5.协同模式下，本地开发的模型在设计器里找不到https://doc.oinone.top/faq/17110.html

一、工作流引用及触发 1.项目中工作流引入和流程触发https://doc.oinone.top/backend/4361.html 2.【工作流】如何添加工作流运行时依赖https://doc.oinone.top/workflow/13144.html 3.工作流查看、处理流程https://doc.oinone.top/oio4/9388.html 二、 常见工作流功能应用及扩展 1.动态表单https://doc.oinone.top/designer/workflowdesigner/16336.html 2.【工作流】如何自定义支持在加签的同时审批同意https://doc.oinone.top/workflow/13505.html 3.【工作流】如何自定义工作流的待办任务列表https://doc.oinone.top/workflow/6989.html 4.【工作流】如何在业务模型的列表中展示工作流的审批按钮https://doc.oinone.top/workflow/6987.html 5.【工作流】流程扩展自定义函数示例代码汇总https://doc.oinone.top/designer/workflowdesigner/4802.html 6.工作流审核撤回/回退/拒绝钩子使用https://doc.oinone.top/backend/4542.html 三、工作流常见使用问题分析及处理 1.测试环境的流程向正式环境迁移，5.1.x是否还需要部署流程设计器https://doc.oinone.top/faq/17858.html 2.流程设计器里，部门领导审批环节，审批按钮不见了https://doc.oinone.top/faq/17684.html 3.流程设计器，在某个节点审批完后，能否自定义抄送/知会人员(可能多个)https://doc.oinone.top/faq/17516.html 4.流程设计器，填写审批意见，能支持富文本吗？https://doc.oinone.top/faq/17510.html 5.流程设计器，想在同意时加入电子签名https://doc.oinone.top/faq/17503.html 6.加了工作流模块，但是界面设计器模型动作下没有业务流程按钮https://doc.oinone.top/faq/17206.html 7.流程设计器，流程审批人是传哪个类型的IDhttps://doc.oinone.top/faq/17198.html 8.流程设计器里，配置更新数据触发场景，但更新数据时没有触发自动发起流程https://doc.oinone.top/faq/17192.html 9.动态根据业务数据的字段值显示审批同意按钮的文案https://doc.oinone.top/faq/13822.html 10.自定义审批方式、自定义审批节点名称https://doc.oinone.top/backend/4847.html

一、系统权限操作手册配置 https://doc.oinone.top/chan-pin-shi-yong-shou-ce/17797.html 二、常见权限问题分析及解决 1.函数如何跳过权限拦截https://doc.oinone.top/wen-ti-zhen-duan/16299.html 2.工作流工作台无权限排查路径https://doc.oinone.top/wen-ti-zhen-duan/15924.html 3.windows环境npm安装依赖提示无权限https://doc.oinone.top/faq/14590.html 4.权限异常排查路径参考https://doc.oinone.top/faq/14391.html 5.自定义RSQL占位符(placeholder)及在权限中使用https://doc.oinone.top/backend/6393.html 6.自定义数据权限拦截处理https://doc.oinone.top/backend/4737.html 7.如何扩展行为权限https://doc.oinone.top/dai-ma-shi-jian/18976.html 8.跳转动作无权限问题排查https://doc.oinone.top/wen-ti-zhen-duan/18678.html

一、配置问题： 1.证书问题，如过期、路径等。排查文档：https://doc.oinone.top/install/backendinstall/13760.html2.模型中关系字段配置问题。排查文档：https://doc.oinone.top/wen-ti-zhen-duan/15999.html3.跨模块依赖诸多问题。排查文档：https://doc.oinone.top/install/backendinstall/14824.html4.代码问题。如枚举类忘记添加类注解等 二、 环境问题： 1.版本问题。同base库的多个环境版本不一致，从而引发系列问题，如数据表重复新增删除。2.数据表唯一键冲突。 三、场景启动问题分析及解决方案 1.后端启动慢如何排查https://doc.oinone.top/faq/16613.html 2.验证服务是否启动成功https://doc.oinone.top/oinone-faq/17905.html 3.启动时提示未配置SQL记录存储目录，然后启动失败报错https://doc.oinone.top/faq/17048.html 4.启动报错，公共环境开启了元数据保护模式，本地开发环境需配置https://doc.oinone.top/faq/17045.html 5.在docker容器里启动，路径配置正确，仍旧报错https://doc.oinone.top/faq/17040.html 6.容器启动服务，License认证报错https://doc.oinone.top/faq/17039.html 7.系统启动耗时过长，内存耗用过大https://doc.oinone.top/faq/6659.html 8.启动提示：依赖的模块不存在https://doc.oinone.top/faq/6630.html 9.协同模式下，本地开发的模型在设计器里找不到https://doc.oinone.top/faq/17110.html 10.测试服务访问测试服务里docker容器的设计器服务接口，报dubbo接口不存在https://doc.oinone.top/faq/17055.html

验证服务是否启动成功可以调用****/ruok接口，端口是服务器实际运行端口返回imok是启动成功，返回no是启动失败 @Order(Ordered.LOWEST_PRECEDENCE) @RestController public class HealthCheckController implements ApplicationListener<ApplicationStartedEvent> { private static boolean IM_OK = false; private static final String SUCCESS_STRING = "imok"; private static final String FAILURE_STRING = "no"; @GetMapping("/ruok") public String ruok() { if (IM_OK) { return SUCCESS_STRING; } return FAILURE_STRING; } @Override public void onApplicationEvent(ApplicationStartedEvent event) { IM_OK = true; } public static boolean imok() { return IM_OK; } }

场景 启动的时候可能会出现以下错误提示 启动模块中包含jar包或者数据库中不存在的模块 启动模块中包含不存在的模块 启动模块互斥模块中包含已安装模块 排查项 确保启动工程的application.yml中的启动模块pamirs.boot.modules配置项内的模块在pom.xml内依赖了对应模块的jar包 确保出问题的模块的定义文件内的包扫描前缀packagePrefix方法内的路径定义正确，该路径可以是多个，但是一定要包含模块下所有子工程的路径，包括但不限于api子工程、core工程等，另外该路径也不能和其他模块的配置有重复、交集、包含关系（例如：a模块是 aa.bb.cc, b模块是aa.bb，这样b模块的路径就包含了a模块的） 启动类里spring自带的@ComponentScan.basePackages注解项需要包含所有依赖模块的路径 无代码应用创建的时候，配置了依赖模块。但这个依赖没有被本地安装，该模块就会出问题，要么删除该依赖，要么在代码里添加该依赖。

复杂字段类型的导入导出 如果想要导出的字段是该模型关联的对象里的一个字段，则需要在创建模版时使用 “对象.字段” 的方式，并在导出时手动设置该字段 例如PamirsEmployee模型中的company，使用company.name创建值 @Field.many2one @Field.Relation(relationFields = {“companyCode”}, referenceFields = {“code”}) @Field(displayName = “所属公司”) private PamirsCompany company; //定义员工导入导出模版 @Component public class EmployeeTemplate implements ExcelTemplateInit { public static final String TEMPLATE_NAME = "employeeTemplate"; @Override public List<ExcelWorkbookDefinition> generator() { //可以返回多个模版，导出的时候页面上由用户选择导出模版 return Collections.singletonList( ExcelHelper.fixedHeader(PetShop.MODEL_MODEL, TEMPLATE_NAME) .createBlock(TEMPLATE_NAME, PetShop.MODEL_MODEL) .setType(ExcelTemplateTypeEnum.EXPORT) //使用company.name获取PamirsCompany里面的name字段 .addColumn("company.name", "所属公司") .build()); } } //手动设置该字段，如2所示 如果想要导出的字段是非存储字段，由于默认只导出存储在数据库里的字段，非存储的字段需要在导出时手动设置 @Slf4j @Component @Ext(ExcelExportTask.class) public class EmpTemplateExportExtPoint extends DefaultExcelExportFetchDataExtPoint { @Override @ExtPoint.Implement(expression = "context.name==\"" + EmployeeTemplate.TEMPLATE_NAME + "\"") public List<Object> fetchExportData(ExcelExportTask exportTask, ExcelDefinitionContext context) { return super.fetchExportData(exportTask, context); } //重写rawQueryList方法，使用listFieldQuery将非存储字段单独设置 @Override protected List<?> rawQueryList(IWrapper<?> wrapper) { List<PamirsEmployee> pamirsEmployeeProxies = (List<PamirsEmployee>) Models.data().queryListByWrapper(wrapper); if (CollectionUtils.isNotEmpty(pamirsEmployeeProxies)) { new PamirsEmployee().listFieldQuery(pamirsEmployeeProxies, PamirsEmployee::getDepartmentList); } return pamirsEmployeeProxies; } } 如果想要导入的字段存在多个，则可以创建一个代理模型，在代理模型里设置一个字段用来接受该多值字段（在Excel里一个单元格内填写多值字段，每个字段用自定义符号（如：" ; "）进行分割），在创建模版时使用该代理类的模版，在导入导出的时候再根据 “;” 截取 @Model.model(PamirsEmployeeProxy.MODEL_MODEL) @Model(displayName = "员工导出代理") @Model.Advanced(type = ModelTypeEnum.PROXY) public class PamirsEmployeeProxy extends PamirsEmployee { private static final long serialVersionUID = -6582160484690807999L; public static final String MODEL_MODEL = "business.PamirsEmployeeProxy"; @Field.String @Field(displayName = "部门编码列表") private String departmentCodeList; } 创建模版时创建代理模型的字段 .addColumn("departmentCodeList", "部门编码列表") 导入：新建一个类，用来作为导入的扩展点，继承AbstractExcelImportDataExtPointImpl @Component @Ext(ExcelImportTask.class) @Slf4j public class EmpTemplateImportExtPoint extends AbstractExcelImportDataExtPointImpl<PamirsEmployeeProxy> { //必须加这个方法，它使用EmployeeTemplate.TEMPLATE_NAME来指定导入模版 @Override @ExtPoint.Implement(expression = "importContext.definitionContext.name==\"" + EmployeeTemplate.TEMPLATE_NAME + "\"") public Boolean importData(ExcelImportContext importContext, PamirsEmployeeProxy data) { //TODO 根据逻辑校验数据 String departmentCodeList = data.getDepartmentCodeList();…