BPM集成接口配置——【Team Center 精品培训资料】

BPM集成接口配置
1.首选项配置及说明
1.1.BYD_AWC_PROCESS_ADDRESS
名称BYD_AWC_PROCESS_ADDRESS
范围站点
类别BYD.DocumentManger
多值单个
描述用于BPM集成。

TC端发起流程时，自动将首选项值和流程puid值拼接后输出给BPM 值:10.9.41.23:8008/awc/com.siemens.splm.clientfx.tcui.xrt.Objectuid
1.2.BYD_BPMFORM_KEYWORD
名称BYD_ BPMFORM_KEYWORD
范围站点
类别BYD.DocumentManger
多值多个
描述用于BPM集成。

TC端发起流程时，自动根据选择的流程模版匹配可输出的报文参数，匹配【BYD_BPM_KEYWORD】首选项使用。

格式为：
流程模版名称=流程输出参数，如果参数有多个用&连接，如：
BPM_A状态数据发布流程=applyObject&project&processSubject 值BPM_A状态数据发布流程=applyObject&project&processSubject BPM_B状态数据发布流程=applyObject&project&processSubject
BPM_C状态数据发布流程=applyObject&project&processSubject
BPM_N状态数据发布流程=applyObject&project&processSubject 1.3.BYD_BPM_KEYWORD
名称BYD_BPM_KEYWORD
范围站点
类别BYD.DocumentManger
多值多个
描述用于BPM集成。

TC端发起流程时，从【BYD_ BPMFORM_KEYWORD】首选项匹配到需要输出的参数后，到本首选项匹配需要输出参数如何取值：
1、process代表流程对象，如：process.puid表示输出流程id
2、target代表流程目标中第一个版本对象，如target.object_string表
1
示将流程目标中第一个版本的object_string输出
3、relation代表target的指定关系对象，如
relation.Z9_rel_Related_technical.object_string表示将target
的技术文档关系中第一个对象的object_string属性输出
值project=target.project_ids
buyattribute=target.z9_buyAttribute
referenceData=relation.Z9_rel_Related_technical.object_string 1.4.BYD_BPM_OUTFILES_PROCESS
名称BYD_BPM_OUTFILES_PROCESS
范围站点
类别BYD.DocumentManger
多值多个
描述用于BPM集成。

外来文件归档时，根据返回对象类型自动匹配TC端的流程及返回的字段，格式为：
对象类型=流程模版名称=参数，如果有多参数用&拼接
参数赋值按照首选项【BYD_ BPM_OUTFILES_KEYWORDS】
值Z9_Document=TCM Release Process=DOCUMENTTYPE&PROJECT
1
Z9_Drawing=TCM Release Process=DOCUMENTTYPE&PROJECT
Z9_DCN=TCM Release Process=DOCUMENTTYPE&PROJECT 1.5.BYD_BPM_OUTFILES_KEYWORDS
名称BYD_BPM_OUTFILES_KEYWORDS
范围站点
类别BYD.DocumentManger
多值多个
描述用于BPM集成。

外来文件归档时，从首选项【BYD_ BPM_OUTFILES_PROCESS】自动
匹配TC端的流程及返回的字段，再根据本首选项确定值写到那个属性
中，如：
PROJECT=target.project_ids
值PROJECT=target.project_ids
DOCUMENTTYPE=target.z9_Doc_Type
1.6.BYD_BPM_PROPSBACK
名称BYD_BPM_PROPSBACK
1
范围站点
类别BYD.DocumentManger
多值多个
描述用于BPM集成。

TC端发起流程在BPM中完成审核后，有部分属性需要返回到TC端来，
输出的参数按照本首选项匹配，格式；参数=参数值，其中参数值：
1、process表示属性将修改流程的属性
2、target表示修改流程目标的属性
值status=process.z9_status
chargeDate=target.z9_chargeDate
1.7.BYD_BPM_DatasetType
名称BYD_ BPM_DatasetType
范围站点
类别BYD.DocumentManger
多值多个
描述用于BPM集成。

外来文件归档时，从本首选项获取归档文件对应的数据集类型及使用的
工具集，格式：文件后缀：数据集类型：引用类型
值txt:Text:Text
1
doc:MSWord:word
docx:MSWordX:word
1.8.BYD_BPM_FTP
名称BYD_ BPM_FTP
范围站点
类别BYD.DocumentManger
多值多个
描述用于BPM集成。

外来文件归档时，使用本首选项的配置去连接FTP服务器
值FTPIP：10.9.33.223
port=21
username=TCTEST
password=123456byd
localPath=c:\\PLMtoBPM
1.9.BYD_BPM_Oracle
名称BYD_ BPM_Oracle
范围站点
1
类别BYD.DocumentManger
多值多个
描述用于BPM集成过程中访问数据库，三个值依次为用户名、密码和数据库连接（含IP、端口和实例名）
值Infodba
aW5mb2RiYQBlAA==
10.9.41.24.1521/PRODTC
2.流程配置
以原有的流程【2D图纸发布流程】为例
经过配置修改为如下图格式：
1
1其中，开始节点增加handler：Z9_Props_export
2编制节点增加handler：start_again_bpm_process
3BPM节点的选择签审用户handler【EPM-adhoc-signoffs】修改参数：-assignee为gcyadmin，用于保证流程发起后签审节点执
行人为gcyadmin用户，避免流程被所有者删除
3.数据库配置
3.1.数据库表列表
3.1.1.Z9_CREATE_RULES
列名类型及长度备注
OBJECTTYPE VARCHAR2（32）对象类型，这里有Z9_Document、
1
Z9_Drawing、Z9_DCN PROJECTID VARCHAR2（32）项目ID
KEYWORD VARCHAR2（32）关键字
IPD VARCHAR2（32）IPS节点ID DOCUMENTTYPE VARCHAR2（64）文档类型
使用说明：用于BPM外来文件归档已经选择了项目和文档类型，甚至名称都已经有了，在下一节点选择归档路径时，根据该表呈现的规则定位根节点。

1、在选择IPS节点之前，BPM程序根据需要输出的对象类型、项目ID、文档类型及关键字信息到数据库中查询IPS节点；
2、使用IPS根节点ID在Z9_BVPS视图中找是否有子节点，自动把节点信息填入IPS归档路径输入框，且设置输入框不可选；如果有子节点，用户在选择的时候就是以该节点为根的小树供选择，最终将选择的结果填入IPS归档路径输入框。

数据来源：
管理员在【知识管理】创建知识结构后，在右键菜单执行官【输出规则】将指定项目的规则输出到本表中
1
3.1.2.Z9_DOCTYPE
列名类型及长度备注
TYPECODE VARCHAR2（20）文档类型简码
TYPENAME VARCHAR2（64）文档类型
使用说明：用于BPM外来文件归档选择归档的文档类型
数据来源：
管理员在【BPM集成】菜单执行【文档类型集成】将首选项中维护的首选项输出到本表中
3.1.3.Z9_PROJECTMASTER
列名类型及长度备注
PROJECTID VARCHAR2（64）项目ID
PROJECTNAME VARCHAR2（64）项目名称
使用说明：用于BPM中审核人员选择的时候确定某项目中主要负责人
数据来源：
管理员在【BPM集成】菜单执行【指定项目主管】功能，维护所选
1
项目每个部门的主管人员
3.2.数据库视图列表
3.2.1.Z9_BVPS
列名类型及长度备注
节点ID
BVPSID VARCHAR2
（128）
节点名称
BVPSNAME VARCHAR2
（128）
REVISION_ID VARCHAR2（32）节点版本
BVPSTYPE VARCHAR2（32）节点类型
父节点ID
P_BVPSID VARCHAR2
（128）
根据BVPSID和其父节点ID可以完整的构建知识结构树
1
3.2.2.Z9_GROUP
列名类型及长度备注
PUID
PUID VARCHAR2
（128）
GNAME VARCHAR2
中文组织
（128）
PARENTU VARCHAR2（32）父节点PUID PNAME VARCHAR2（32）父节点中文组织
3.2.3.Z9_PUSER_GROUP
列名类型及长度备注PMPUID VARCHAR2（15）
PGPUID VARCHAR2（15）组织的PUID
英文组织PGNAME VARCHAR2
（128）
PGROUPNAME VARCHAR2
中文组织
（256）
RPARENTU VARCHAR2（15）组织父节点PUID
PUSER_ID VARCHAR2（32）用户ID
PUSER_NAME VARCHAR2
用户名称
（128）
PROLE_NAME VARCHAR2（32）英文角色
PROLENAME VARCHAR2（64）中文角色
PGMSTATUS VARCHAR2（38）当前组中用户是否活动。

0是活动，
1是非活动
PUSTATUS VARCHAR2（38）当前用户状态是否活动。

0是活动，
1是非活动
3.2.
4.Z9_URPG
列名类型及长度备注
PPROJECTID VARCHAR2（64）项目ID
PPROJECTNAME VARCHAR2（32）项目名称
中文组织名称PGROUPNAME VARCHAR2
（256）
PROLENAME VARCHAR2（64）中文角色名称
PUSERID VARCHAR2（32）用户ID
PUSERNAME VARCHAR2
用户名称
（128）
1
使用说明：
1、BPM创建用户时会在Z9_PUSER_GROUP中查询PUSER_ID是否存在，
PUSTATUS是否为0来决定是新建或是修改；
2、BPM中构建组织结构树通过Z9_GROUP视图中PUID的父子关系搭建
3、选择节点后，Z9_PUSER_GROUP中过滤查询符合组PUID的角色列
4、BPM选择审核用户时，根据Z9_URPG进行筛选符合的用户
4.T omcat服务配置
4.1.Tomcat服务器部署
1、Tomcat目录下webapps\PLM_BPM_Webservice.war已存在，用
正式的文件替换它，并删除PLM_BPM_Webservice目录
2、Tomcat目录下部署webapps\PLM_BPM_Webservice.war；
3、删除Tomcat目录下
work\Catalina\localhost\PLM_BPM_Webservice目录
4、修改C:\ PLMtoBPM \loginMessage.properties文件地址为当前
服务器地址和参数
1
4.2.Tomcat服务器启动
Tomcat服务器中运行bin\startup.bat，或者运行startup.bat的快捷方式启动服务
5.服务端文件配置
1、在操作系统C盘根目录创建【PLMtoBPM】文件夹，目录中应包含以下文件：
●loginMessage.properties 用于配置接口访问地址
●CreateUser\createUser.bat 用于用户接口创建用户
●CreateUser\make_user.exe 用于用户接口创建用户
●CreateUser\updatePassword.bat 用于用户接口更新密码
●CreateUser\updateGroupRole.bat 用于用户接口禁用/启用用
户
●Process\fotonRobert.exe 用于流程状态控制，驳回、继续
●Process\ReStartSign.bat 用于流程状态控制，驳回、继续
2、确保%TC_DATA%\z9_libBYDSystemIntegration.dll 用于发流程时输出流程、流程目标及相关关系属性到BPM，通过首选项配置
3、注意批处理文件中可能会涉及到账号密码，需要验证为正确的值
1
6.客户端文件配置
1、在操作系统C盘根目录创建【PLMtoBPM】文件夹，目录中应包含以下文件：
●sendMessage.bat
●send_message_to_bpm.jar
●setProcessID.bat
●setProcessID.exe
●start_again_bpm_process.bat
●start _bpm_process_again.jar
2、两层客户端需要配置%TC_ROOT%\bin\z9_libBYDSystemIntegration.dll
3、四层客户端需要保证%TC_DATA%\z9_libBYDSystemIntegration.dll 7.当前服务部署及后续建议
当前在10.9.44.137和10.9.41.23服务器都配置了完全相同的服务，分别负责不同的内容，其中：
●10.9.44.137负责用户接口部分
●10.9.41.23负责流程控制、外来文件归档部分内容
或许后期随着业务增长，23服务器压力会变得非常大，可以通过增加
1
tomcat服务器方式来进行分压，这里有两种方案可以结合使用：➢增加服务器将接口内容分出去，例如一个服务器专职接口，一个专职外来文件，一个专职流程控制
➢增加服务器，对于不同流程表单使用频率不同，需要服务器响应时间也不同。

比如流程控制再单独一个服务器，外来文件单独一个服务器，再
有外来文件归档按照不同类型，调用不同服务器的接口。

1。