金蝶云星空 产品用户操作手册（协同OA集成平台V4.0）.pdf

协同OA集成平台用户操作手册厦门鼎云泽软件科技有限公司2022年04月12日厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第2页共45页修订记录：版本号修订人修订日期修订描述V3.0钟伟2022-04-12V4.0钟伟2023-06-14新增：许可引入、反写规则配置及审批配置内容厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第3页共45页目录第一章概述..................................................................................................................6第二章安装说明..........................................................................................................7获取技术支持.......................................................................................................................7软件安装与卸载...................................................................................................................7第三章快速使用指南..................................................................................................9许可引入...............................................................................................................................9权限分配.............................................................................................................................10用户同步.............................................................................................................................10参数设置.............................................................................................................................11BOS配置............................................................................................................................12流程字段映射配置.............................................................................................................14第四章使用说明........................................................................................................16参数配置.............................................................................................................................16集成参数设置.................................................................................................................16用户同步.............................................................................................................................17用户同步配置.................................................................................................................17OA用户清单..................................................................................................................18反写规则配置.....................................................................................................................19厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第4页共45页反写OA数据规则.........................................................................................................19审批配置.............................................................................................................................21OA审批配置..................................................................................................................21映射配置.............................................................................................................................25流程字段映射配置.........................................................................................................25同步计划.............................................................................................................................33协同OA同步计划.........................................................................................................33集成监控.............................................................................................................................34同步任务列表.................................................................................................................34同步日志明细.................................................................................................................35OA审批记录..................................................................................................................35集成监控平台.................................................................................................................36第五章功能列表........................................................................................................38第六章参考资料........................................................................................................39第七章附录................................................................................................................40术语表.................................................................................................................................40常见问题.............................................................................................................................40常见错误信息对照表.........................................................................................................44索引.....................................................................................................................................44厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第5页共45页表索引.............................................................................................................................44图索引.............................................................................................................................44厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第6页共45页第一章概述软件全称:《协同OA集成平台》英文名称：《CollaborativeOAIntegrationPlatform》主要特点：一款基于金蝶云星空协同开发平台构建的和泛微OA系统工作流集成的可配置平台，通过简单配置即可实现金蝶云星空任意标准单据、基础资料及二开业务对象与泛微OA系统审批流程单据的集成，即时配置即时生效，快速灵活稳定的OA工作流表单集成工具。适用人员：实施人员、企业IT人员软件的价值和意义：系统整合:专业领域业务需要交给更加专业的执行系统进行管理，打通信息孤岛成为企业信息化建设必要的工作降低成本:需求有变动需要双方系统各自开发，造成建设成本增加,一套灵活可配置的方案可大大降低建设成本提高效率:避免双方系统因一方开发人员的质量与效率存在问题，从而直接影响对接结果与上线计划可靠性强:统一的对接标准与开发规范，完善的监控机制，保证数据的完整性厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第7页共45页第二章安装说明获取技术支持获取方式：钟伟手机号（18750909812）微信同号技术支持内容：产品补丁、许可文件、使用教程与培训、维护、软件错误反馈等注意事项：私有买断或私有订阅提供金蝶云星空特征码、公有订阅提供租户ID及使用客户全称软件安装与卸载软件安装：1.将补丁包放到金蝶云星空管理中心服务器，双击执行（补丁包执行时系统不能使用，请于用户非使用时间段执行）图1安装界面厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第8页共45页2.输入管理中心密码，选择数据中心，点击确认，等待执行完成图2安装界面软件卸载：协同OA集成平台补丁基于金蝶云星空协同开发平台构建，与金蝶云星空标准产品补丁一致，一经安装禁止卸载，协同OA集成平台产品属于独立模块，不会影响标准产品使用。厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第9页共45页第三章快速使用指南许可引入以administrator登录金蝶云星空业务站点，打开【系统管理】/【系统管理】/【行业产品许可引入】，上传许可文件厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第10页共45页权限分配以administrator登录金蝶云星空业务站点，进行权限分配，建议新建角色【OA集成配置】，将协同OA集成平台相关功能权限分配给该角色，再将角色分配给实施配置人员图3权限分配界面用户同步1.使用有配置权限人员打开【系统集成管理】/【协同OA系统集成】/【用户同步配置】，维护相关配置信息，勾选启用用户同步，点击保存按钮厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第11页共45页图4用户同步配置界面2.使用有配置权限人员打开【系统集成管理】/【协同OA系统集成】/【OA用户清单】，点击【同步OA用户】按钮，即可完成OA用户初始化同步及与金蝶云星空用户映射图5OA用户清单界面3.可登陆金蝶云星空BOS平台，在【用户】列表菜单增加【同步OA用户】按钮同时注册【同步OA用户】操作，后续金蝶云星空新增用户后点击【同步OA用户】按钮即可实现新用户的映射匹配图6同步OA用户注册界面参数设置以administrator登录金蝶云星空业务站点，打开【基础管理】/[参数设置]，选择子系统【协厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第12页共45页同OA系统集成】，选择相应OA产品类别，填写接口地址信息，勾选启用集成，如需通过执行计划获取OA审批结果及记录，则回调模式需选择【更新单据状态同时获取审批记录】图7参数设置界面BOS配置1.登录金蝶云星空BOS平台，右击扩展需集成的单据，添加基础资料属性字段【OA用户】（关联单据创建人，该字段做为调用OA创建流程表单需要传入的信息）和文本字段【OA流程ID】（用于保存接口成功后返回的OA流程实例ID）图8字段扩展界面厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第13页共45页图9字段扩展界面2.单据操作列表中编辑【提交】操作，在该操作注册【创建提交OA流程】的服务端服务图10服务注册界面3.单据操作列表中编辑【删除】操作，在该操作注册【删除OA流程】的服务端服务厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第14页共45页图11服务注册界面4.表单菜单增加【查看OA审批记录】按钮，同时注册【查看OA审批记录】表单操作图12服务注册界面流程字段映射配置1.使用有配置权限人员打开【系统集成管理】/【协同OA系统集成】/【流程字段映射配置】，配置金蝶云星空单据与OA系统的流程与字段的映射，做完配置后保存并审核后，即可实现相应单据点击提交后推送至OA审批厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第15页共45页图13映射配置界面图14映射配置界面厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第16页共45页第四章使用说明参数配置集成参数设置功能描述用于配置OA工作流接口地址及相关控制参数接口地址：OA的工作流接口地址OA产品类别：泛微、蓝凌、致远同步方式：实时（单据提交后立即调用接口）、异步（参数保存会自动创建协同OA执行计划【创建提交OA流程】，单据提交后不会立即调用接口，由执行计划后台调度执行）回调模式：不启用回调服务（则不会创建协同OA执行计划【获取OA审批数据】，否则会自动创建该计划）仅更新单据状态（由执行计划调用OA接口获取审批数据，自动调用单据的撤销和审核操作）仅获取审批记录（由执行计划调用OA接口获取审批数据写入云星空OA审批记录表）更新单据状态同时获取审批记录（由执行计划调用OA接口获取审批数据写入云星空OA审批记录表，同时根据审批节点进度自动调用单据的撤销与审核操作）启用集成：控制是否将单据数据按流程字段映射配置推送至OA审核记录同步日志：协同OA同步计划【创建提交OA流程】执行日志记录回调日志：协同OA同步计划【获取OA审批数据】执行日志操作说明以administrator登录系统，在菜单【基础管理】/[参数设置]，选择子系统【协同OA系统集成】，维护完相关参数信息后，点击保存厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第17页共45页图15参数设置界面用户同步用户同步配置功能描述用于配置同步OA用户的接口地址及相关参数，同时设置OA用户与金蝶用户的匹配字段及根据匹配字段更新金蝶用户信息的其他字段映射关系（需提前在BOS中将金蝶用户扩展一个OA用户ID的文本字段，作为金蝶用户与OA用户映射使用）接口地址：获取OA组织架构接口地址IP地址：当集成产品为泛微时，需填写金蝶云应用服务器地址，同时泛微需将HrmWebserviceIP.properties配置文件中配置调用接口客户端的IP启用用户同步：同步OA用户的开关参数用户字段映射：金蝶用户字段标识：可选择金蝶【用户】单据头文本类型字段OA用户字段标识：可选择自定义业务对象【OA用户】所有字段匹配字段：将根据该字段匹配更新金蝶云星空用户信息，如根据手机号码匹配操作说明使用有配置权限人员打开【系统集成管理】/【协同OA系统集成】/【用户同步配置】维护相关配置信息，勾选启用用户同步，点击保存按钮厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第18页共45页图16用户同步配置界面OA用户清单功能描述用于保存同步下来的OA用户信息，同时作为匹配更新金蝶用户的数据源基础操作：过滤、新增、删除、引入、引出等系统标准功能同步OA用户：自定义封装操作，调用OA获取用户的接口，将OA用户数据同步至OA用户清单，同时根据【字段映射配置】信息关联更新金蝶用户相关信息操作说明使用有配置权限人员打开【系统集成管理】/【协同OA系统集成】/【OA用户清单】，点击【同步OA用户】按钮，即可完成OA用户初始化同步及与金蝶云星空用户映射厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第19页共45页图17OA用户清单界面反写规则配置反写OA数据规则功能描述用于配置ERP单据反写OA表单字段内容，配合OA审批配置功能使用，支持四种反写模式：累加：仅支持单据头数值字段，累加反写OA主表数值字段扣减：仅支持单据头数值字段，扣减反写OA主表数值字段覆盖：仅支持单据头文本及数值字段，覆盖反写OA主表字段新增：支持自定义sql数据，反写新增OA明细表的行数据操作说明1.使用有权限的用户登录系统，打开菜单【系统集成管理】/【协同OA系统集成】/【反写OA数据规则】，选择执行单据厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第20页共45页2.选择反写模式，当反写模式为新增时反写数据源SQL为必填项，否则需填写星空的单据体和反写字段以及OA的表名与字段名厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第21页共45页审批配置OA审批配置功能描述当执行单据对应操作注册了【提交OA流程】的服务端服务，则系统将按照审批配置内容调用OA系统的提交流程接口，当满足操作执行条件及OA审批执行条件时，将按照反写规则清单中的配置更新当前流程实例表单的内容，同时将当前流程实例提交至下一流程节点，当仅满足操作执行条件时，则仅根据反写规则更新OA表单内容不会将流程提交至下一节点，如果不满足操作执行条件，则系统不允许执行对应操作。当执行单据对应操作注册【回滚OA数据】（该服务需要与提交OA流程配对使用）的服务端服务，则系统将按照审批配置中的反写规则清单，回滚OA表单数据。典型应用场景为：由OA付款申请单生成ERP应付单，在ERP分多次付款，需要将付款记录反写更新至OA当前流程表单中，当付款完成后将流程表单提交至下一节点审批。参考业务流程图：厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第22页共45页操作说明1.使用有权限的用户登录系统，打开菜单【系统集成管理】/【协同OA系统集成】/【OA审批配置】，选择执行单据厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第23页共45页2.选择审批人字段，该字段需要为OA用户ID，后续将使用该用户调用OA接口3.选择OA流程实例字段，该字段需要为OA流程实例ID，后续反写单据及提交流程都是在该实例上执行4.当业务场景需要进行调用接口前的逻辑控制时，需维护执行操作审批条件，不维护则系统不进行校验控制，该条件书写语法参考SQL语法中的WHERE条件，参考语句：(t0.F_PFJV_Amount>=(SELECTSUM(FREALPAYAMOUNTFOR)ASFTotalAmountFROMT_AP_PAYBILLWHEREt0.F_PFJV_RequestId=F_PFJV_RequestIdGROUPBYF_PFJV_RequestId))语句释义：当OA的申请金额大于等于当前付款单上按流程实例ID汇总的付款金额时5.不符合条件提示信息：当不满足操作执行条件时，用户执行操作时系统抛出的异常提示信息6.当业务场景需要在满足一定的条件后提交至下一个流程节点时，需要维护OA审批执行厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第24页共45页条件，不维护代表操作执行即提交下一节点审批，该条件书写语法参考SQL语法中的WHERE条件，参考语句：(t0.F_PFJV_Amount=(SELECTSUM(FREALPAYAMOUNTFOR)ASFTotalAmountFROMT_AP_PAYBILLWHEREt0.F_PFJV_RequestId=F_PFJV_RequestIdGROUPBYF_PFJV_RequestId))语句释义：当OA的申请金额等于当前付款单上按流程实例ID汇总的付款金额时7.OA审批意见格式：当满足OA审批执行条件时触发OA提交流程接口时用户在OA的审批意见内容，该内容支持四则运算，可选择单据上字段内容，作为提交OA流程意见内容，以“{”书写时，系统会自动跳出单据字段清单8.反写规则清单：可选择执行单据为当前OA审批配置一致的反写规则，单据在执行操作时会根据反写规则清单更新OA流程表单内容，如勾选“满足OA审批条件时执行”，则只有当满足该条件时才会执行该反写规则厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第25页共45页映射配置流程字段映射配置功能描述用于配置金蝶云星空单据与OA系统流程和字段的映射关系，云星空制单后推送OA时将按照配置的映射关系解析为OA流程表单创建和提交接口需要的数据结构，是协同OA集成平台的核心功能。基础操作：过滤、新增、保存、提交、撤销、审核、反审核、删除、引入、引出等系统标准功能操作说明1.使用有权限的用户登录系统，打开菜单【系统集成管理】/【协同OA系统集成】/【流程字段映射配置】，选择单据图18映射配置界面2.选择流程发起人字段，用于创建OA流程表单的发起人取值来源，是接口调用时必要参数，支持单据头文本及基础资料属性字段厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第26页共45页图19映射配置界面3.选择反写流程实例ID字段，用于保存创建OA流程接口调用成功后返回的流程实例ID信息，支持单据头文本字段（如不需要重新提交和回调服务，可不选）图20映射配置界面4.填写OA流程/模板ID，该信息是用于金蝶单据和OA流程的映射匹配，是接口调用时必要参数厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第27页共45页图21映射配置界面5.如需将星空单据的附件管理中的附件信息推送至OA，需维护OA流程表单中用于接收的附件字段标识（使用该功能则金蝶云星空需启用文件服务器）图22映射配置界面6.如果启用回调服务则需要填写发起人节点和归档节点ID，该信息是用于判断流程是否撤回和审核通过的依据厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第28页共45页图23映射配置界面7.如需通过接口创建流程后自动提交至OA下一节点审批，则需勾选创建流程自动提交图24映射配置界面8.字段映射明细：是用来配置金蝶单据和OA表单字段映射，接口调用时会根据K3字段标识做数据取值解析，同时根据OA字段标识做推送数据组装，文本、数值等原生数据类型可直接映射匹配，枚举值需通过枚举值转换列表做转换，如果是基础资料、辅助资料等复杂数据类型需配置属性值与OA字段映射复杂数据类型映射场景一：两边系统各有一套数据主档，则需在星空基础资料扩展OAID，将OA对应的基础资料主档ID维护至星空对应的主档上，字段映射配置选择扩展的厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第29页共45页OAID属性映射至OA字段复杂数据类型映射场景二：只有星空有基础数据主档，则OA流程表单的字段使用文本类型，将星空的基础资料属性映射至OA的文本字段（推荐模式）图25映射界面图26映射配置界面厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第30页共45页图27映射配置界面图28映射配置界面9.唯一性字段与汇总字段为组合使用，应用场景为星空单据明细多行，需根据明细的字段做分组汇总后推送至OA单据厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第31页共45页图29映射配置界面10.过滤条件可根据客户需求选择配置，支持将星空的一种单据根据自定义条件推送至OA，过滤条件只支持选择单据头字段配置图30映射配置界面11.OA模板字段映射：支持接口调用推送时获取OA流程表单默认值，有维护OA模板字段标识，则接口数据组装时会先使用流程发起人获取流程表单默认值厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第32页共45页图31映射配置界面12.表映射明细：星空单据和OA表单存在多个明细表，并且字段映射明细配置了多个单据体映射时，需要在此页签维护金蝶单据体标识与OA明细表名的映射关系图32映射配置界面13.单据头附件字段如推送OA时，需配置附件映射，K3附件字段支持选择单据头附件字段，OA附件字段填写OA附件字段标识厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第33页共45页图33映射配置界面同步计划协同OA同步计划功能描述用于异步执行星空单据推送OA与获取OA审批结果信息的执行计划，基于金蝶云星空标准的执行计划开发的执行计划插件，和标准系统执行计划一样由金蝶云星空系统调度执行【创建提交OA流程】：当参数同步方式设置为异步时，系统自动创建该同步计划，参数设置为同步时，将同步删除该计划任务【获取OA审批数据】：当参数启用回调服务时，系统自动创建该同步计划，参数调整为不启用回调服务时，将同步删除该计划任务操作说明上述参数启用时自动创建同步计划任务，默认执行周期为1H，计划任务由系统调度执行，用户可根据需求自定义调整执行周期，也可点击测试手工执行用户可自定义消息配置，将执行情况发送给负责人员，如任务状态异常时需执行设置任务状态为准备厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第34页共45页图34同步计划界面集成监控同步任务列表功能描述用于保存同步的指令，当参数【同步方式】设置为【异步】并启用集成时，单据提交后会自动写入，【创建提交OA流程】和【获取OA审批数据】的计划任务执行时，将获取未完成的数据去执行操作说明该业务对象为系统同步使用的后台表单，非异常情况用户无需操作，如出现数据异常时，可手工删除数据，将星空单据重新提交，则会生成新的同步任务图35同步任务界面厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第35页共45页同步日志明细功能描述当参数启用了日志记录时，系统在执行接口调用时生成的日志信息会写入，用于排查接口调用异常时使用操作说明该业务对象为系统接口调用日志记录的后台表单，用户正常情况下无需操作，当出现异常时可查看接口异常详细信息图36同步日志界面OA审批记录功能描述用于记录OA审批结果数据，当参数【回调模式】设置为【更新单据状态同时获取审批记录】时，通过执行计划【获取OA审批数据】调用OA接口获取审批记录数据，同时写入云星空OA审批记录，用户可在表单增加按钮注册【查看OA审批记录】的表单服务，实现联查OA审批数据功能操作说明该业务对象为后台数据记录表单，用户无需操作，可通过表单新增按钮注册【查看OA审批厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第36页共45页记录】的表单服务，实现联查OA审批数据功能（流程字段映射配置需配置反写OA流程实例ID字段，在接口调用成功后会将流程实例写入，联查是根据流程实例ID关联）图37OA审批记录界面图38集成监控平台界面集成监控平台功能描述用于查询单据同步状态及同步日志，根据不同单据将同步任务和同步日志数据关联展示，用户可使用该功能实现单据同步状态的统一监控管理同步状态：未完成(尚未调用创建提交OA流程接口)有错误(调用创建提交OA流程接口有异常)已完成(调用创建提交OA流程接口成功)流程状态：未启动(数据尚未推送至OA)审批中(数据已推送OA)厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第37页共45页已归档(OA审批已完成)已退回(OA审批已驳回申请人)回调状态：未完成(尚未调用获取OA审批记录接口)有错误(调用获取OA审批记录接口出现异常)已完成(调用获取OA审批记录已成功)操作说明使用有权限的用户登录系统，打开菜单【系统集成管理】/【协同OA系统集成】/【集成监控平台】，用于查询单据同步状态及日志，也可联查单据图39集成监控平台界面厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第38页共45页第五章功能列表表1功能列表清单功能模块功能点描述备注参数设置集成参数设置用于配置OA工作流接口地址及相关控制参数用户同步用户同步配置用于配置同步OA用户的接口地址及相关参数，同时设置OA用户与金蝶用户的匹配字段及根据匹配字段更新金蝶用户信息的其他字段映射关系OA用户清单用于保存同步下来的OA用户信息，同时作为匹配更新金蝶用户的数据源映射配置流程字段映射配置用于配置金蝶云星空单据与OA系统流程和字段的映射关系，云星空制单后推送OA时将按照配置的映射关系解析为OA流程表单创建和提交接口需要的数据结构，是协同OA集成平台的核心功能同步计划协同OA同步计划用于异步执行星空单据推送OA与获取OA审批结果信息的执行计划，基于金蝶云星空标准的执行计划开发的执行计划插件集成监控同步任务列表用于保存同步的指令，当参数【同步方式】设置为【异步】并启用集成时，单据提交后会自动写入同步日志明细当参数启用了日志记录时，系统在执行接口调用时生成的日志信息会写入，用于排查接口调用异常时使用OA审批记录用于记录OA审批结果数据，当参数【回调模式】设置为【更新单据状态同时获取审批记录】时，通过执行计划【获取OA审批数据】调用OA接口获取审批记录数据，同时写入云星空OA审批记录集成监控平台用于查询单据同步状态及同步日志，根据不同单据将同步任务和同步日志数据关联展示，用户可使用该功能实现单据同步状态的统一监控管理厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第39页共45页第六章参考资料无。厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第40页共45页第七章附录术语表表1术语列表序号术语、概念、略缩语定义或解释1.BOS金蝶云星空集成开发平台2.OA泛微ecology7/8/9常见问题1.单据提交时提示：单据符合多个流程映射配置，请修改流程映射配置的过滤条件同一种单据在流程字段映射配置中存在多条记录，当前单据根据映射配置的过滤条件满足多条映射配置，需修改过滤条件，使过滤条件范围不重复2.单据提交时提示：没有终结点在侦听可以接受消息的http://[ip]/services/WorkflowService。这通常是由于不正确的地址或者SOAP操作导致的。……….检查配置的OA接口地址是否正确在金蝶云星空服务器使用浏览器访问地址：http://【OAIP地址或域名】:【端口号】/services/WorkflowService?wsdl，如出现404错误表示与OA通讯异常，检查以下问题：网络问题：星空应用服务器与OA服务通信是否正常OA白名单：OA启用了白名单设置，需要把星空应用服务器IP添加进白名单厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第41页共45页3.单据提交时提示：节点附加操作失败找不到下一节点的处理人，检查OA流程下一节点处理人是否存在4.单据提交提示：OA流程模板ID或用户ID不合法映射配置维护的流程ID信息不正确或OA用户ID不正确，OA用户ID为OA数据库表HrmResource中的id字段值OA流程模板ID在新建流程时可查看，参考下图5.单据提交提示：获取K3数据字段出现异常，无法将类型为“System.Int64”的对象强制转换为“System.String”字段标识xxxx字段映射配置将复杂数据类型直接映射到OA字段，参考本文档中【映射配置】中对复杂数据类型的处理方式厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第42页共45页6.OA表单字段使用浏览框类型，在字段映射配置该如何配置？BOS对应基础资料扩展OAID字段，维护好值之后，在BOS单据添加引用属性，通过映射配置这边选择OAID字段如果是在OA启动流程时自动携带出来的默认信息，可以通过OA模板配置的页签，把OA的字段维护进去（通常用于申请人的组织、部门这些信息）如果是其他的如物料、供应商这些，建议OA直接建成文本字段，用于展示即可，如果一定需要使用浏览按钮，也可以通过配置明细行关联的值转换列表，做一下ERP与OA的值转换（如：ERP物料编码为CH44001,OA值为100001）7.单据提交时提示：提交OA流程失败，接口返回信息【failed】出现该提示代表单据上有记录了流程实例ID字段存在数据，可能会有以下两种情况单据第一次提交就有实例ID值，是由于单据扩展字段时未将字段设置为不可复制，当前单据是通过复制其他推送成功的单据而来，需进BOS将单据扩展的流程实例ID字段设置为不允许复制单据不是第一次提交，是由于当前OA流程不在申请人发起的节点，需在OA将流程驳回发起人，方可再次提交厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第43页共45页8.映射配置选择单据提示：运行时不允许加载“xxxxxxxxxxx”的业务对象单据不能选择扩展层9.单据提交时提示：保存表单主表信息失败检查映射配置中的金蝶字段类型与长度和OA的字段在数据库中的类型与长度是否匹配或超出10.金蝶云星空附件无法推送到OA表单的附件字段在OA服务器上访问金蝶文件服务器地址，确认是否可以正常访问金蝶云星空是否启用了https协议，如启用则OA需升级最新版本才支持https的附件地址厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第44页共45页常见错误信息对照表表2常见错误信息对照表序号信息提示含义及建议处理方法1.创建OA流程成功，流程ID【15025】表示调用OA创建流程的接口成功，并返回流程实例ID为【15025】2.提交OA流程【15025】成功表示调用OA提交流程的接口成功，OA流程实例【15025】将提交至下一节点审批3.调用OA工作流接口失败，异常信息：……表示执行接口调用时出现了异常，先按照常见问题排查，如无法解决，请联系技术支持4.删除OA流程实例ID【15025】成功表示调用OA删除流程接口成功,流程实例ID【15025】的流程在OA系统被删除5.删除OA流程实例ID【15025】失败表示调用OA删除流程接口失败，请排查用户是否具有删除权限，该流程实例【15025】在OA系统中当前是否在申请人节点，如无法解决请联系技术支持索引表索引表1功能列表清单..........................................................................................................38表2术语列表...................................................................................................................40表3常见错误信息对照表..............................................................................................44图索引图1安装界面..........................................................................................................................7图2安装界面..........................................................................................................................8图3权限分配界面................................................................................................................10图4用户同步配置界面........................................................................................................11图5OA用户清单界面.........................................................................................................11图6同步OA用户注册界面................................................................................................11图7参数设置界面................................................................................................................12厦门鼎云泽软件科技有限公司协同OA集成平台配置手册第45页共45页图8字段扩展界面................................................................................................................12图9字段扩展界面................................................................................................................13图10服务注册界面..............................................................................................................13图11服务注册界面..............................................................................................................14图12服务注册界面..............................................................................................................14图13映射配置界面..............................................................................................................15图14映射配置界面..............................................................................................................15图15参数设置界面..............................................................................................................17图16用户同步配置界面......................................................................................................18图17OA用户清单界面........................................................................................................19图18映射配置界面..............................................................................................................25图19映射配置界面..............................................................................................................26图20映射配置界面..............................................................................................................26图21映射配置界面..............................................................................................................27图22映射配置界面..............................................................................................................27图23映射配置界面..............................................................................................................28图24映射配置界面..............................................................................................................28图25映射界面......................................................................................................................29图26映射配置界面..............................................................................................................29图27映射配置界面..............................................................................................................30图28映射配置界面..............................................................................................................30图29映射配置界面..............................................................................................................31图30映射配置界面..............................................................................................................31图31映射配置界面..............................................................................................................32图32映射配置界面..............................................................................................................32图33映射配置界面..............................................................................................................33图34同步计划界面..............................................................................................................34图35同步任务界面..............................................................................................................34图36同步日志界面..............................................................................................................35图37OA审批记录界面........................................................................................................36图38集成监控平台界面......................................................................................................36图39集成监控平台界面......................................................................................................37