易飞与PDM集成手册.docx

易飞事业部易飞与PDM产品集成手册ver.1.0周妍妍2011-05 目录一.集成方式的功能效益概述：3二.PDM与易飞集成流程及信息范围：3（一） 集成流程图：3（二） 集成信息范围：3三.集成方式的先决限制要求：41. 硬件需求：42. 软件需求：4四.易飞通用集成接口安装4五.文件目录与相关配置说明：7（一） 文件目录7（二） 相关配置81 Windows系统环境配置-数据执行保护设置82 易飞通用接口WebService配置103 易飞系统相关设置134 PDM系统相关设置17六易飞与PDM集成的详细范围23（一）PDM->ERP：23（二）ERP->PDM：27（三）PDM相关操作27七主要操作流程介绍：33（一）相关虚拟机33（二）流程操作331、PDM->ERP：332、ERP->PDM：39八资料更新和服务支持与问题反馈39九对应的内部模拟测试环境说明39十该产品线集成常见问题集40附注：40一.集成方式的功能效益概述：PDM是一门用来管理所有与产品相关信息(包括零件信息、配置、文档、CAD文件、结构、权限信息等)和所有与产品相关过程(包括过程定义和管理)的技术。不同产品线之间的集成已经成为发展趋势，PDM与易飞ERP产品的集成增强了企业内部信息的沟通和交流，减少企业人员的大量重复的工作，同时也减少了数据不一致性发生的概率。二.PDM与易飞集成流程及信息范围：（一） 集成流程图：Webservice根据请求，自动判断是写数据还是读数据，然后由企业对象去操作资料库PDM发出请求，是写数据请求，也可能是获取数据的请求易飞ERP(7.0、8.0、9.0) 集成接口(Webservice入口) 数据库返回数据给企业对象ERP资料库 易飞企业对象PDM的资料库其它产品线PDM 接口返回数据给请求端【注意】PDM与易飞集成时，所以的信息交互动作都是由PDM开始，也就是无论是从PDM导入数据到易飞EPR还是PDM发出请求获取易飞PDM数据，一切都是在PDM中开始（二） 集成信息范围：1. PDM->ERP：（指的是从PDM导入数据到易飞EPR）a. Itemb. BOMc. ECNd. 工艺e. 工艺路线f. 取替代料2. ERP->PDM：（指的是PDM发出请求获取易飞PDM数据）a. Item相关的单价、成本、库存等信息 b. 从PDM调用易飞编码规则以生成物料编码 【注】：上述内容将在六、易飞与PDM集成的详细范围做详细讲解三.集成方式的先决限制要求：1. 硬件需求： 一般性能较好的PC机或服务器即可 最低配置为：CPU1.8G、内存512M、硬盘剩余空间300M以上 2. 软件需求： 主流Windows操作系统(如WIN2003，WINXP,WIN2008) 易飞安装盘8.0.7.0及以上版本四.易飞通用集成接口安装安装盘在：172.16.1.201YiFei_Setup80AdditionsIntegration运行安装程序Setup.exe 在弹出的安装界面上勾选PDM集成，勾选PDM集成 单击下一步，出现如下提示，按确认进入安装程序的下一界面蓝色字列明软硬件要求单击下一步进入安装路径设置界面，设置安装路径设置好安装目录后单击下一步，进入安装过程，并可以看到安装进度显示安装进度安装过程完成，单击完成退出安装程序，可以看到桌面及开始-程序中都创建了集成接口管理其与接口数据处理中心桌面也会创建两个快捷图标 五.文件目录与相关配置说明：（一） 文件目录易飞通用集成接口安装完成后可以看到在安装目录下创建了YiFeiGateWay文件夹。 （二） 相关配置1 Windows系统环境配置-数据执行保护设置 如果服务器的操作系统为Windows Server2003(或更高版本)，需要设置操作系统的数据执行保护，具体方法如下图：首先，在我的电脑快捷方式上右击鼠标，选择属性，如下图在桌面快捷方式”我的电脑”上点击鼠标右键，选择属性 其次，在弹出的系统属性中选择高级页签，点击性能设置然后，在性能选项中选择数据执行保护页签，接下来有两种方式的设置 a. 选择第一项职位关键Windows程序和服务启用数据执行保护，然后单击确定，重启服务器，完成设置 b. 选择第二项除所选之外，为所有程序和服务启用数据执行保护，然后单击添加，在弹出的画面中选择集成系统安装目录bin文件夹下的的InterfaceManager.exe和WSDispatcher.exe 注：集成系统安装目录(本例中也就是C:Program FilesYiFeiGateWay)注：数据执行保护设置完成后必须重启服务器。(重启动作一定要做) 具体设置方法如下图所示： a. 选择第一项职位关键Windows程序和服务启用数据执行保护(不推荐使用)完成后点击“确认”按钮，并重启服务器后，即可完成设置 在数据执行保护中选择第一项 b. 选择第二项除所选之外，为所有程序和服务启用数据执行保护，然后单击添加加入exe文件(推荐使用b)完成后点击“确认”按钮，并重启服务器后，即可完成设置 2 易飞通用接口WebService配置a. 启动WebService服务以及代理服务开启WelService服务集成接口安装完成后，系统默认开启WebService服务。可在此进行停止或者开启WebService服务 双击桌面快捷方式，打开易飞通用接口管理器，点击“Webservice服务” 启动完成后，可在此可以查看服务的运行状况 点击”启动WSDispatcher.exe”，程序正常启动会后弹出下面界面 派班中心(WSDispatcher)启动后，最小化至任务栏即可 开启代理服务开启“Webservice服务”后，再点击代理服务，启动”派班中心” b. 连接参数设置点击开窗进行配置配置易飞数据库服务器的地址、数据库用户名密码以及公用资料库等资料 输入易飞服务器地址 单击设置连接，弹出如下画面，进行配置设置数据库服务器登录的用户名密码，输入完成后需要勾选“允许保存密码”；如果密码为空白，则需勾选”空白密码” 选择易飞ERP的公用资料库 点击链接测试，提示成功后，点击确定按钮退出即可 输入易飞服务器IP 然后设置易飞WebService地址易飞WebService地址为系统默认，一般情况下不需要更改。如果需要更改地址或者端口号，需要先停止服务。 测试成功后，点击“应用”与“确定”后，即可完成配置 打表示连接成功测试完成后，点击测试连接 至此Window系统配置和易飞通用集成接口配置的工作已经完成了。3 易飞系统相关设置作业1.设置启用系统系统设置-基本信息子系统-设置启用系统-勾选PDM集成 作业2. 设置PDM集成参数 a. 作业位置： 基本信息子系统-基础设置-设置集成参数-PDM集成参数 b. 主要作用： 设置PDM传输到易飞的品号以及BOM信息在易飞中作何种处理 。 其中主要强调一点：只有当BOM版本升级，易飞同步方式选择人工处理时，才允许PDM系统发送ECN到易飞系统。 注：ECN需要在易飞中手工处理，才可以生成易飞中的BOM变更单 以PDM中的品号作为易飞系统中的品；。如果易飞中该品号已存在，则根据导入策略进行更新 品号版本升级，易飞同步方式选择“直接更新品号”时，才允许勾选”人工处理” 举例说明：PDM品号A001,版本号00；则易飞中品号为：A00100 作业3 易飞通用接口管理器对象管理【注】：作业3可以暂时不看，可以继续往下进行配置，在流程操作中与PDM配置内容参照来看更好如果不输入口令，点击修改对象后，仅可对企业对象中的默认值栏位进行编辑修改完成后点击修改完成这时你会发现，原来的标准企业对象名称S.Item变为个案名称M.Item了只有勾选了发布的字段信息才允许从PDM系统导入易飞系统；也只有勾选了发布的字段才能在PDM系统被查询的到，并且进行字段对应配置M.前缀的企业对象为个案企业对象S. 前缀的企业对象为标准企业对象企业对象中默认设置了一些常用的字段，如果需要在企业对象中增加新的字段，则只需将光标移至最后一行，按小键盘向下的箭头即可。这里需要说明的是增加字段的字段名，类型、长度一定要输入准确；属性标示可以自行定义。其他参数根据实际需求来设置就可以了易飞系统中有部分字段的值是相对固定的，为了简化用户的操作，可以在此设置相应字段的默认值，而不需要从PDM系统中再进行导入。需要注意一点：设置默认值的字段，如果勾选了发布，则默认值会失效。共4种类型，可以根据客户的不同需求来设置。需要注意一点，如果是不可新增、修改。则即使从PDM系统导入此字段，也无法写入到易飞数据库勾选了必输的字段，要求必须在PDM系统中进行配置，并且导入易飞系统，否则系统会报错。选项-管理权限 在弹出的界面上输入口令才可以修改企业对象，否则只能修改默认值按使用者的权限不同，对象管理中可使用的功能也不尽相同：1) 普通用户，只可“修改对象”中的“默认值”。2) 服务顾问用户（口令：dcmsservice），可“修改对象”中的全部属性，增加删除属性等，如果修改标准对象，保存时会自动存为个案对象，标准对象不会被修改到。3) 个案开发（口令：dcmsgean），可新增、修改、删除对象，完成对个案对象的全部操作。4) 研发出货（口令：？），与个案开发有同样的权限。需要注意的是修改完标准对象后，仍然会将对象另存到modi目录下，测试完成出货时需将modi目录下文件拷贝至标准区（这是为了防止修改出错导致标准文档信息丢失）。作业4. 录入BOM变更单_依PDM（ECN）信息处理 PDM系统发送到易飞的ECN信息可以在易飞作业中进行手工处理，生成易飞系统的BOM变更单 作业位置 易飞生产管理-BOM-录入BOM变更单_依PDM（ECN）作业4 PDM系统相关设置开始菜单>Digital China PDM>DCPDM Client Center->DCPDM 2009,如下图所示，进入PDM的登陆界面登陆注：可能出现PDM产品无法打开的问题，请参考【附注】输入PDM的用户ID和密码（super）进入PDM主界面，选择易飞ERP整合配置右键>ERP配置>ERP配置界面进入ERP集成配置，选择易飞ERP（如下图所示），进入配置界面进入易飞ERP配置界面可以看到已经有两个配置好的PDM与易飞ERP集成的配置设置在此进行配置 (1)修改配置文件在PDM按装目录下的conf文件夹里找到yfconf.xml 文件IP指的是PDM的服务器，文件夹要设置为共享记住新增的PDMERP新增红色框中的内容，其中DEMO80_AST是易飞公用资料库的DSCMB.MB001(2)进行配置 a.配置名称及ERP服务器地址的设置这三个填写固定只需要修改其中的ip地址，这是集成接口的ip一定要确保是上述配置文件中新添的内容b.集成对象的配置点选请配置服务器，如下图，其中ERP中的类里有下拉选项中的六个类。双击edit框打开PDM中的类，如下图所示选择需要配置的EPR中的类，如选择ITEM物料信息然后再单击ERP配置3142找到产品类，点选Select，返回到ERP集成配置界面3 下图中字段即为当前配置设置所连接的易飞集成接口中对象管理里S.ITEM.xml已发布的字段。点击ERP配置按钮(4)，展出数据到下面的表格中PDM属性名称为所选则PDM中的类与易飞集成对象中相对应的字段4 如上图，将PDM中的类里的字段与ERP中的类里的字段一一做好对应关系，把不需要做集成的字段信息删除后保存。这样我们就建立了PDM中产品信息与易飞中品号信息的对应关系。 这里需要注意的是，由于PDM中的表结构与易飞表结构差异很大，在集成时，可能在PDM中找不到合适的与易飞集成的字段，这时，我们就需要在PDM对应的类中增加自己所需要的字段，且赋给这些字段适当的值。以ITEM中的品号版本为例：本例中有英文描述字段可以临时地代替版本字段使用，但若没有可以替代使用的字段时，则需在PDM中新增字段。 1、Insert : 新增，如果对应对象（主键）已经存在则报错 2、Update : 更新，如果对应对象（主键）不存在则不执行操作（更新时，不会删除多余明细资料） 3、Sync : 更新，将原对象删除并新增为新对象 4、Adjust : 更新，如果原对象不存在则新增，否则为更新（更新时，不会删除多余明细资料） 如上图可以看到上面配置的相关的类信息，其中PDM导出策略，是集成接口在处理PDM导出的XML的内容时的处理方式，包含如图中的四类，其中的含义，可参见易飞通用集成接口白皮书.pdf 中Setdata.OperateD的说明。这里选择ADJUST,导出策略在这里只是一个默认值，在后面真正做导出时，也可重新选择导出策略。 至此，PDM配置完成六易飞与PDM集成的详细范围 易飞与PDM集成分为两部分，一部分为将数据从PDM导入到易飞，一部分为PDM从易飞获取数据（一）PDM->ERP：1、ITEM(品号信息）：由PDM系统抛转到易飞系统 其中： 1. Item <=> INV.MB001 品号2. ItemVersion <=> 品号版本 3. StockUnit <=> INV.MB004 库存单位4. ItemProperty <=> INV.MB025 品号属性 四个字段为必传字段，也就是说在PDM进行字段对应时，这四个字段必须进行配置,少一个，进行数据传输得时候都会出现错误提示。 注意： a.ItemVersion字段长度固定为2位。强调一点现在易飞与PDM集成应用中， 多数不会用到品好版本这个字段，因此建议在PDM中进行字段配置时，将品号版本设为默认值：00。 b.ItemProperty只能从 M、S、P、C、Y中进行选择； 以上必须要配置的字段有： 品号 属性 库存单位 品号版本2、BOM（产品结构信息）：由PDM系统抛转到易飞系统。 其中： 1. ParentItem <=> BOM.MC001 主件品号2. ParentItemVersion <=> 主件品号版本 3. SubItemVersion <=> 元件品号版本4. SequenceNumber <=> BOM.MD002 元件序号 四个字段为必传字段，也就是说在PDM进行字段对应时，这四个字段必须进行配置。少一个，进行数据传输得时候都会出现错误提示。 注意： ParentItemVersion、 SubItemVersion的字段长度固定为2位。 同样的建议在PDM中进行字段配置时，将版本设为默认值:00。 BOM中必须要配置的字段有：元件品号版本，元件序号，主件品号，主键品号版本3、ECN（BOM变更信息）：由PDM系统抛转到易飞系统。 注意a. 只有易飞设置集成参数中，BOM版本升级方式，易飞同步方式选择人工处理时，才允许PDM传ECN到易飞。 b. PDM抛转至易飞的ECN信息不会自动生成易飞的BOM变更单。需要在 易飞的BOMI16（录入BOM变更单_依PDM）作业进行手工处理后，才会生成易飞的BOM变更单。 ECN中需配置字段： 原组成用量，原元件品号，原BOM序号，组成用量，主件原版本，主键版本，元件品号，主件品号，BOM序号4、Operation(工艺信息)：由PDM系统抛转到易飞系统。 其中： 1. Operation <=> MW001 工艺 2. Character <=> MW004 性质(厂内Or委外）3. WorkCenter/SupplierNo. <=> MW005 工作中心/供应商编号 三个字段为必传字段，也就是说在PDM进行字段对应时，这三个字段必 须进行配置。少一个，进行数据传输得时候都会出现错误提示。 注意：当性质为厂内时，PMD传输过来的工作中心只是一个代码，并不会写入易飞的工作中心维护档。因此需要手工在PDM系统与易飞系统将两步的工作中心信息档维护一致。（实施段注意） PDM必传工艺代号、性质以及工作中心。如果性质为委外：供应商编号传空字段，客户手工维护。5.ItemRouting(工艺路线信息)：由PDM系统抛转到易飞系统。 其中： 1. RoutingItem <=> ME001 工艺路线品号 2. Routing <=> ME002 工艺路线编号3. Sequence <=> MF003 加工顺序 4. Operation <=> MF004 工艺 5. WorkCenter/Supplier <=> MF006 工作中心/供应商编号 6. SubcontractUnit <=> MF017 加工单位 7. PMDOUID <=> MF032 PDM识别码 七个字段为必传字段，也就是说在PDM进行字段对应时，这七个 字段必须进行配置。少一个，进行数据传输得时候都会出现错误提示。 注意：a. PDM工艺路线变更： 易飞根据OUID号更新工艺、加工顺序信息，其他字段赋默认值； 易飞根据OUID作单身数据比对，插入易飞单身中无但更新信息中有的OUID对应的信息；删除易飞单身中有，但更新信息中无的OUID对应的单身信息；在易飞系统中手工新增的单身信息不作任何变更 由于用户可能在易飞中进行工艺路线的维护，因此PDM传输数据到易飞时可能出现KEY值重复，当出现此状况时易飞会返回错误信息，不接受该笔信息，需要在易飞或者PDM中对key值作调整，然后再进行传送 PDM只传工艺路线单头至易飞时，易飞作工艺路线删除动作 b. PDM先传工艺后传工艺路线。 c. 实施段注意：工艺路线建议在PDM系统中维护。 6、AlternativeReplaceItem(取替代料信息)：由PDM系统抛转到易飞 其中： 1. SubItem <=> MA001 元件品号 2. ParentItem <=> MA002 主件品号3. Alternative/ReplaceItem <=> MA003 取替代料（替代OR替换） 4. Item <=> MB004 单身品号 5. Alternative/ReplacePrority <=> MB009 取替代顺序 注意a. 取替代料关系更新：易飞直接覆盖更新。 b. 取替代料关系删除：PDM只传送单头时，易飞作单头单身删除操作。 c. 易飞与PDM集成后。取替代料关系维护只允许在PDM中进行，易飞只被动接受。 d. 易飞中即使手工维护了新的取替代关系，也会被PDM传输的资料覆盖。 取替代料关系中必须要配置的字段: 元件 主件 取替代料 单身品号 取替代顺序（二）ERP->PDM：1、Item相关的单价、成本、库存等信息 PDM发送品号代码至易飞，易飞返回品号以及对应该品号的库存数量、最近进价、标准成本合计、上月库存成本以及本月移动加权成本2、从PDM调用易飞编码规则以生成物料编码 （三）PDM相关操作 （1）PDM中信息的录入(以产品为例)输入编号等信息后,点击注册,一个新的工作版本的产品的基本信息就建好了.注册后可以看到如上图画面,选择产品结构页签,可以在这里录入产品的BOM结构.查询要加入的下阶品号分类(如半成品)，点击查询点击选择在上面窗口中输入顺序 ，数量信息后保存这样产品PDM01的产品结构就建好了。（2）如何升版 (升版主要用与通过ECN变更单的方式更新易飞BOM信息时，生成ENC信息时使用)1. 创建工作版本(同（一）PDM中信息的录入)2. 升版查询所有版本的产品信息，选择1中创建的工作版本双击打开该笔信息，选择 标准审批流程选择审批流程界面，这里简化流程，就不再对每一关设定审批人员，直接选中各个审批模块，然后点击跳过。保存之后点击启动流程如下图这样升版操作就完成了。（3）如何导出到易飞ERP在PDM对象区中选择产品对象，查询出产品信息，选择要导出的产品信息，右键弹出菜单，如图：选择导出到易飞后，出现如下图画面：选择在自己建立的ERP服务器配置,选择后 公司别会同时变为设置中的信息,接下来选择导出的内容，导出的内容包含以下12类:<E3>非物料</E3> <E6>仅导入选中的物料</E6><E1>导入选中物料及其下所有物料</E1> <E2>导入选中物料及其下所有物料,结构及ECN</E2> <E4>导入选中物料及其下所有物料及结构</E4> <E5>仅结构</E5><E12>导入选中物料及其下所有物料,及其取替代关系</E12> <E7>导入选中物料及其下所有物料及BOM,及其取替代关系</E7> <E8>仅传输取替代关系</E8> <E9>导入选中物料及其下所有物料,及其工艺路线</E9> <E10>导入选中物料及其下所有物料及BOM,及其工艺路线</E10> <E11>仅传输工艺路线</E11> 选择需要导出的内容后，选则PDM导出策略，点击确定后，如下图：导出到易飞的操作，除了在产品对象上可以操作外还有 (1) (2) (3) 其中的工艺信息和工艺路线在导出数据时，如果是单独导出各个对象，需注意各个对象之间的顺序：(1) ITEM (2) BOM (3)取替代(4)工艺(5)工艺路线七主要操作流程介绍：（一）相关虚拟机PDM虚拟机：在172.16.1.203 开启PDM虚拟机，可以远程桌面 172.16.1.227 密码：238173集成接口： 在 192.168.11.92 上开启虚拟机，虚拟机地址：172.16.11.55 或者可以在其他客户端上配置，集成接口配置是比较简单的（二）流程操作1、PDM->ERP：1.ITEM/BOM/工艺、工艺路线/取替代料：PDM创建信息->导出到WEB service->检验->写入易飞->返回消息 一定要有这7个易飞字段才可此处可以选择策略，或者后面再选择选择需要的信息 在描述中，显示了集成接口对这笔记录的处理状况，如果是导出完成，则说明该队列要导出的数据已经正确地导入到易飞数据库。如果中间出现了什么异常，也会记录在描述字段中，可以根据这里的信息，查找出错的原因。 成功！返回PDM查看信息可以看到信息：导出完成 2. ECN：PDM变更BOM->比较差异->导出到WEB service->易飞确认->生成易飞ECN2、ERP->PDM： 1.ITEM库存成本信息：PDM发出请求-> WEB service->查询易飞数据库->向PDM返回查询信息 2. 易飞编码规则：PDM发出请求-> WEB service ->编码规则->PDM编码生成->返回信息到易飞 八资料更新和服务支持与问题反馈1）资料路径：ftp:/172.16.1.9/YiFeiPatch/YiFeiPatch80/tools/WebService/PDM更新区（内网）ftp:/ 221.6.15.178/YiFeiPatch/YiFeiPatch80/tools/WebService/PDM更新区（外网）172.16.1.202Standard_80PatchToolsWebServicePDM更新区（研发内部） SOURCE和规格的路径： 172.16.1.202tools上 2）使用易飞8.0.7.0光盘3）易飞服务接口人：周妍妍（025-68522824）4）web型管： http：/221.6.15.178:8018/ 集成单别 B35九对应的内部模拟测试环境说明 PDM虚拟机：在172.16.1.203 开启PDM虚拟机，可以远程桌面 172.16.1.227 密码：238173集成接口： 在 192.168.11.92 上开启虚拟机，虚拟机地址：172.16.11.55 或者可以在其他客户端上配置，集成接口配置是比较简单的十该产品线集成常见问题集 参考【易飞与PDM,电子采购,HR集成常见问题.DOC】附注：1.PDM无法开启时，在DOS命令下依次输入下列命令：sqlplus /nologconn / as sysdbastartupshutdownstartup