用友TurboCRM_EAI-U9安装及使用手册
目录
目录 ................................................................................................................................... I 第一部分：重要信息 (1)
第二部分：产品安装 (2)
2.1 CRM系统ERP-U9适配器的安装 (2)
2.1.1 安装步骤 (2)
2.1.2 安装注意事项 (6)
2.2 U9系统接口插件的安装 (6)
第三部分：使用手册 (7)
第一章产品概述 (7)
第二章初始配置 (11)
3.2.1 如何和U9的帐套做对应？ (11)
3.2.1.1 CRM-EAI接口配置 (11)
3.2.1.2 U9系统配置 (12)
3.2.2 在EAI-U9中，有哪些对象可以进行数据交换？ (12)
3.2.3 如何设置对象对应？ (13)
3.2.4 如何设置组织对象的对应？ (14)
3.2.5 如何在CRM中设置派生单位对应U9的辅计量单位？ (15)
3.2.6 如何设置币种汇率的对应？ (15)
3.2.7 如何理解CRM系统中的识别码字段？ (16)
3.2.8如何设置基础数据CRM识别码与U9中ID或CODE的对应。 (16)
3.2.9如何理解CRM系统中同步订单的生效/失效状态？ (17)
3.2.10 如何理解业务数据的审核和弃审？ (17)
3.2.11如何停用导入/导出功能 (17)
3.2.12如何理解CRM-U9的单点登录 (18)
第三章常见应用 (19)
3.3.1 如何把U9的“组织”信息同步到CRM系统？ (19)
3.3.1.1 组织新增/修改/删除的同步操作 (19)
3.3.1.2 组织字段映射表 (22)
3.3.2 如何把U9的“用户”信息同步到CRM系统？ (22)
3.3.2.1 用户新增/修改/删除的同步操作 (22)
3.3.2.2 用户字段映射表 (23)
3.3.3 如何把U9的“业务员”信息同步到CRM系统？ (23)
3.3.3.1 业务员新增/修改/删除的同步操作 (23)
3.3.3.2 业务员字段映射表 (25)
3.3.4 如何进行“客户”信息的传递？ (25)
3.3.4.1 客户新增/修改/删除的同步操作 (25)
3.3.4.2 客户字段映射表 (28)
3.3.5 如何把U9的“币种”信息同步到CRM系统？ (28)
3.3.5.1 币种新增/修改/删除的同步操作 (28)
3.3.5.2 币种字段映射表 (29)
3.3.6 如何把U9的“计量单位”信息同步到CRM系统？ (29)
3.3.6.1 计量单位新增/修改/删除的同步操作 (29)
3.3.6.2 计量单位字段映射表 (31)
3.3.7 如何把U9的“料品”信息同步到CRM系统？ (31)
3.3.7.1 料品新增/修改/删除的同步操作 (31)
3.3.7.2 产品字段映射表 (33)
3.3.8 如何传递“订单”信息？ (33)
3.3.8.1订单新增/修改/删除的同步操作 (33)
3.3.8.2订单字段映射表 (36)
3.3.8.3 CRM中U9订单编辑页面的链接键 (37)
3.3.9如何把U9的出货记录同步到CRM系统？ (37)
3.3.9.1出货单新增/修改/删除的同步操作 (37)
3.3.9.2交付单字段映射表 (38)
3.3.10如何把U9的收款信息同步到CRM系统？ (39)
3.3.10.1应收单审核 (39)
3.3.10.2收款单审核 (39)
3.3.10.3核销单的新增/删除的同步操作 (40)
3.3.10.4收款单字段映射表 (42)
3.3.11如何把U9的发票信息同步到CRM系统？ (43)
3.3.11.1发票的新增/修改/删除的同步操作 (43)
3.3.11.2发票字段映射表 (45)
3.3.12 如何把CRM的报价单信息同步到U9的订单 (46)
3.3.12.1报价单的新增/删除的同步操作 (46)
3.3.12.2报价单字段映射表 (49)
3.3.12.3 CRM报价单列表页面中U9链接键 (49)
3.3.13 如何把CRM的服务工单信息同步到U9的杂发单 (50)
3.3.13.1服务工单的新增的同步操作 (50)
3.3.13.2服务工单字段映射表 (53)
3.3.13.3 CRM服务工单列表页面中U9链接键 (54)
3.3.14 如何查询EAI数据交换的日志？ (54)
附录1：U9数据库及补丁升级方法 (56)
附录2：常见问题 (57)
联系我们................................................................................................ 错误！未定义书签。
用友TurboCRM6.1 EAI-U9安装及使用手册
用友TurboCRM6.1 EAI-U9安装及使用手册
第一部分：重要信息
欢迎购买并使用用友TurboCRM6.1 EAI-U9 接口！以下简称EAI-U9 接口。本接口是基于用友TurboCRM V6.1系统和用友U9 V2.0系统所做的标准接口，以下简称CRM系统和U9系统。
使用产品前请先阅读本手册。如果阅后还需帮助，请咨询本地授权经销商或拨打400 6600 588咨询。当本手册描述与产品操作不符时，请以产品为准。
对于本手册内容的最终解释权归用友公司所有。
Windows, Windows NT, SQL Server是Microsoft Corporation的注册商标。本手册中涉及的其他产品商标为相应公司所有。
用友TurboCRM6.1 EAI-U9安装及使用手册
第二部分：产品安装
2.1 CRM系统ERP-U9适配器的安装
2.1.1 安装步骤
EAI-U9 接口采用了向导式安装，分为两个步骤：
1.确认安装配置，包括确认系统硬件环境和软件运行环境；
2.运行安装程序。
完成以上步骤，成功安装EAI-U9 接口后，请参考《用友TurboCRM6.1 EAI-U9 安装及使用手册》开始应用接口功能。
首先，请您确认安装光盘包含内容：
1.用友TurboCRM6.1 EAI-U9 接口软件安装包
2.用友TurboCRM6.1 EAI-U9 安装及使用手册.chm
第一步确认安装配置
CRM系统和U9系统要求：
CRM系统：用友TurboCRM V6.1系统
U9系统：用友U9 V2.0系统
操作系统要求：
◆服务器要求：
Windows 2000 Server 以上
或者各种Linux（内核版本R2.2.X以上）
◆Web服务器：
用友TurboCRM6.1 EAI-U9安装及使用手册
Apache Server（2.2. 9以上For Win32）
或者Apache Server（2.2. 9以上For Linux）
◆数据库服务器：
Microsoft SQL Server 2000以上
或者Oracle 8i以上
◆客户端要求：Windows 2000、Microsoft Internet Explorer 6.0以上。
当您拿到EAI-U9 接口安装包光盘后，请在安装目录下双击安装文件setup.exe。开始EAI-U9 接口的安装过程。
第二步运行EAI-U9安装程序
双击运行Setup.exe安装程序后，进入用友TurboCRM6.1 EAI-U9 安装界面，如图：
【系统安装界面】
点击[下一步]查阅安装许可协议。
用友TurboCRM6.1 EAI-U9安装及使用手册
【许可证协议】
请详细阅读许可协议，并勾选“我接受许可协议中的条款”点击[下一步]继续安装软件。
【配置数据库】
输入TurboCRM系统数据所在数据库的SQLSERVER身份验证密码。点击[下一步]继续安装。
用友TurboCRM6.1 EAI-U9安装及使用手册
【安装目录信息确认】
系统自动会找到的TurboCRM6.1的安装目录，确认是否正确，不能手工修改，点击[下一步]按钮开始安装。
【安装完毕】
安装完毕后，点击[完成]按钮退出安装程序。
用友TurboCRM6.1 EAI-U9安装及使用手册
2.1.2 安装注意事项
1.必须先安装用友TurboCRM6.1 ，才能安装CRM6.1 EAI-U9接口。
2.安装完毕后，建议重启一下用友TurboCRM6.1的Apache服务。
2.2 U9系统接口插件的安装
1、标准接口安装方法
《U9v2.0上市版安装盘》中有u9-crm插件支持文件夹，根据说明：
A、第一步，直接覆盖U9产品安装的同名目录Portal，即可。
B、第二步，打开U9产品安装Portal\Services\ 下的web.config 文件,在
name="CBO_WCFService.Customer4CRM">
C、第三步，重启U9的服务，重启IIS。
2、美电贝尔接口安装方法
使用U9的补丁升级工具进行升级。升级方法见附录1：U9数据库及补丁升级方法。
用友TurboCRM6.1 EAI-U9安装及使用手册
第三部分：使用手册
第一章产品概述
企业应用集成（Enterprise Application Integration ，简称EAI）：是指对企业中完成不同业务功能的应用系统进行集成，在它们之间建立起可供数据交流和应用沟通的中枢系统。基于内部网络，通过协议转换与数据传输服务，实现企业不同应用间的信息与指令安全而有效地传输。EAI是支撑企业内部不同应用系统间业务流程的关键。EAI追求建立一个灵活、标准的企业应用底层架构，以允许新的基于IT的应用和商业处理更容易和更有效地被连接。这个架构允许企业中的应用能够实时的，无缝的互相数据交换。以保证对客户、合作伙伴做出快速响应，确保在激烈的竞争中立于不败之地。
用友TurboEAI为企业搭建了其核心的集成业务平台，把企业各种应用无缝地整合，对各种业务流程实现管理并实时监控与分析，在不同的企业业务系统间，以及跨越企业边界的合作伙伴形成的商业网络间，安全的对信息流实现智能管理，把相关的外部信息与内部信息有机地联系起来，全方位地满足企业各种业务功能的要求。用友TurboEAI能够真正实现企业大幅度提升管理系统实施和应用的成功率及投入产出比。
用友TurboEAI就是用友CRM事业部针对企业这种实际且迫切的整合应用需求而设计研发的标准数据接口平台，以协助企业实现系统数据对接。用友TurboEAI针对散落在各业务系统中的信息进行全面的整合和记录，实现对客户、合作伙伴的全方位了解和掌握。用友TurboEAI能够实现业务信息的完整应用，强化与客户、合作伙伴的紧密关系。用友TurboEAI 能够实现将CRM（客户关系管理）、ERP（企业资源计划）、财务管理、OA（办公自动化）等业务信息的业务整合及控制。
用友TurboEAI是TurboCRM与第三方系统进行业务数据交换的平台级工具产品，是TurboCRM统一的对外开放接口。
用友TurboEAI产品包括一整套TurboCRM的标准业务数据交换接口，这些接口涵盖TurboCRM所有业务模块，具备统一的入口、一致的业务外观和相对完整的业务功能，能完成基础数据、业务数据的导入导出及增、删、改等操作，是TurboCRM与外部系统进行应用集成和业务整合的基本资源。
为解决数据交换中系统之间数据格式和数据语义差异问题，用友TurboEAI产品提供了可扩展的数据适配器和数据映射机制用来进行内外数据的翻译和转换。
本文我们重点讲解用友TurboEAI的标准接口对用友TurboCRM系统与U9系统接口的具体实现方案。该标准接口通过用友TurboCRM系统和U9系统之间的对外发布接口来实现这种强大的对接功能，使用的是业内的一些比较先进的技术，从而可以使用友TurboCRM系统更好的服务于客户和企业，提高整个工作流程的效率，可以在用友TurboCRM系统中对后台U9
用友TurboCRM6.1 EAI-U9安装及使用手册
系统（ERP系统）中一些重要的信息进行管理和分析，使得企业各部门的信息能够很好的整和到一起，更好的管理客户信息，来为客户提供更好的服务，使客户和企业达到双盈利。
我们将从接口功能、接口原理、系统环境以及交换规则等几个方面做细致的介绍，帮助企业更好的理解用友TurboCRM系统接口的强大功能，也方便企业自行维护、调整系统之间需要交换和处理的数据，更好的利用接口为企业服务，带来更多效益。
用友TurboEAI的一端以用友TurboCRM系统为主，另外一端可以适配多种交换系统，通常支持基于W3C标准的WebService、SOAP等服务。如U9、U9都有提供此功能的外部服务。一方面通过为交换系统提供适配器，保障了系统之间的可访性；另一方面基于用友TurboCRM 系统以及交换系统提供的开放的标准数据接口，通常基于W3C作为业界数据交换的XML标准。按照指定的规则在数据接口之间做映射，将一个系统提供的标准数据映射为另一个系统可接收的标准数据，从而达到数据的交换目的。因此，用友TurboEAI可以说是建立在一个灵活的、开放的、标准化的技术底层架构之上。
用友TurboEAI采用面向对象技术的PHP编写，设计上结构清晰，可扩展性很强。
用友TurboEAI通过不同的方式可以访问不同的交换系统。通过SOAP协议访问基于.Net 的U9的外部数据交换服务。通过Http访问基于Microsoft IIS的U9的外部数据交换服务。
产品特点
CRM系统与U9系统之间同一类对象数据的同步时，通过CRM系统中设置相关的识别码字段，与U9中对象的关键编码字段的值对应，即CRM中识别码字段与U9中的关键编码字段的值相等时，则说明它们是同一个对象。
CRM系统与U9系统中对象的数据转换，通过在数据库中进行字段映射配置实现，可以根据需要增减对象转换的字段映射关系，而不需要修改程序。
由于CRM系统中往U9同步时，采用实时的方式实现。
接口定义
用友TurboEAI接口目前支持对用友TurboCRM系统中所有对象和枚举值的查询、新增、编辑和删除操作。
类TCRMEai提供统一的调用接口Process()
参数： queryXml
返回值：rtnXml
用友TurboCRM6.1 EAI-U9安装及使用手册
外部系统调用
EAI服务封装于标准的Web Service之中，外部系统开发人员可以采用如下方式调用
1、登录系统
使用Web Service标准接口，通过
http://localhost/webservice/service.php?orgcode=crm&class=WS_System&wsdl 调用登录函数login，传入登录名、密码，返回当前登录的Session。
2、使用EAI接口
使用Web Service标准接口，通过
http://localhost/webservice/service.php?orgcode=crm&class=WS_EAI&wsdl
调用EAI接口函数process，传入查询xml，登录的Session，返回结果xml。
业务数据的数据交换规则
主要处理查询、新增、修改、删除。
枚举值的数据交换规则
主要处理查询、新增、修改、删除。
接口原理
用友TurboCRM系统通过用友TurboEAI系统可实现与ERP系统如U9的基础信息（包括组织、用户、业务员、币种、计量单位、客户、料品）以及业务信息（包括订单、出货、收款核销、发票、报价单、服务工单等）的数据无缝集成和整合。实现用友TurboCRM与财务系统或者其他系统的实时数据交换。
U9接口实现原理
订阅U9中相关实体需要送给CRM的变更事件，并将变更后的最新数据异步传递给CRM-U9接口，此版本仅支持1个U9 Site对1套CRM。
用友TurboCRM6.1 EAI-U9系统能够渐进而有效地实现企业的价值与效能提升，主要表现在下列几个方面：
提供对客户、合作伙伴全方位的了解与认识
企业对客户/伙伴信息获得的方式和渠道是来自于各业务系统，用友TurboCRM6.1 EAI-U9针对散落在各业务系统中的信息进行全面的整合和记录，实现对客户、合作伙伴信息的全方位了解和掌握。
与客户、合作伙伴建立更紧密的联系
企业对客户、合作伙伴管理是建立在“全方位接触管理”的基础上的，所谓“全方位接触管理”就是能够基于电话、信函、传真、WEB和移动设备（手机、PDA等）的多渠道的接触。用友TurboCRM6.1 EAI-U9能够实现业务信息的完整应用，强化与客户、合作伙伴的紧密关系。
实现对业务信息的有效控制
用友TurboCRM6.1 EAI-U9安装及使用手册
针对业务管理的核心一定是结果和过程并重的管理，用友TurboCRM6.1 EAI-U9能够实现将CRM（客户关系管理）、ERP（企业资源计划）、财务管理、OA（办公自动化）等业务信息的业务整合及控制。
充分利用并扩展现有的IT投资
企业针对客户、合作伙伴的管理系统通常都是根据业务管理的核心和侧重点不同来部署的，用友TurboCRM6.1 EAI-U9能够充分利用企业已经部署的原有业务系统资源，并极大的提升各业务系统的功效。
实现企业盈利能力的提升
企业盈利能力的提升是通过企业内部管理到外部管理的协同和整合来实现的，用友TurboCRM6.1 EAI-U9能够让企业的盈利能力得到充分的提升，并通过业务的持续发展得到充分地体现。
技术领先
高度的可配置性和伸缩性，先进的技术架构。
主要功能
1、基础档案
实现组织（客户：组织）、用户（员工）、业务员（员工）、币种、计量单位、料品（产品）等的数据交换。
数据流向为从U9实时传送到CRM，包括新增、修改、删除三种操作。
2、客户档案
数据流向为从CRM实时传送到U9，包括新增、修改、删除三种操作。
3、业务数据（U9->CRM）
实现销售订单、出货（交付）、发票、核销（收款）的数据交换。
数据流向为从U9实时传送到CRM，包括新增、修改、删除三种操作。
4、业务数据(CRM->U9)
实现订单(报价单)、杂发单（服务工单）的数据交换。
数据流向为从CRM实时传送到U9，包括新增、修改、删除三种操作。
用友TurboCRM6.1 EAI-U9安装及使用手册
第二章初始配置
3.2.1 如何和U9的帐套做对应？
3.2.1.1 CRM-EAI接口配置
使用U9 系统管理工具的功能，进入企业管理页面新增/查看企业代码和名称，如下图所示：
在CRM系统的EPR-U9适配器：数据交换的页面，新建CRM系统与U9的某个企业同步。
在CRM的客户化平台下，点击“ERP-U9适配器”菜单，进入“ERP-U9适配器：数据交换”页面，点击“设置”按钮，打开ERP-U9适配器设置页面。
用友TurboCRM6.1 EAI-U9安装及使用手册
3.2.1.2 U9系统配置
进入U9系统管理的参数设置，倒数四行需要设置CRM 的服务器及端口（服务器和端
口用冒号隔开）、登录组织及用户密码。
特别说明：CRM 系统登录组织必须是单位代码，而不是单位简称，该单位代码可以在CRM 的系统配置-其他设置-系统设置中查看，用户名及密码为可以登录到CRM 系统中的用户名和密码。
3.2.2 在EAI-U9中，有哪些对象可以进行数据交换？
使用TurboCRM EAI 实现CRM 与U9数据的同步操作，同步的内容分为基础档案和业务对象两大类。具体同步的数据和同步方向见下表：
用友TurboCRM6.1 EAI-U9安装及使用手册
注意：有些对象的某些字段在CRM或在U9中为必需项，从U9系统导入到CRM或从CRM导出到U9时，必须制定该字段的对应字段或默认值!
3.2.3 如何设置对象对应？
上图列出了CRM中所有可以与U9进行数据交换处理的对象。可以点击操作中按钮进
入对象，有两个，第一个表示对象主表的字段对应，第二个表示对象的明细字段对应。
点击可以修改对象的停用状态。
用友TurboCRM6.1 EAI-U9安装及使用手册3.2.4 如何设置组织对象的对应？
U9中的组织对象，以客户自定义属性的形式同步到CRM中。因此需要在安装完EAI接口后进行如下自定义字段设置。首先进入客户的自定义字段页面，新增一个字段名为Company（注意大小写），字段标签[中文]为组织的自定义字段，如下图：
建好“组织”自定义枚举属性后，返回“ERP-U9适配器：数据交换”列表页面，客户对象的组织名称将由原来的“客户：https://www.wendangku.net/doc/184339875.html,pany”自动变更为“客户：组织”。
用友TurboCRM6.1 EAI-U9安装及使用手册
CRM系统自定义的“组织”的识别码对应U9的公司ID，枚举值对应U9的公司编码。如下图：
3.2.5 如何在CRM中设置派生单位对应U9的辅计量单位？
在EAI-U9接口中，不考虑计量单位的辅计量单位和换算率等。可在CRM中手工设置，不与U9同步。
3.2.6 如何设置币种汇率的对应？
用友TurboCRM6.1系统预置了人民币、美元两种货币币种来满足一般用户的需要。如果您的业务涉及其它的币种汇率及本位币设置要求，可点击KEY菜单【产品】 【币种汇率】进入币种的列表页面，设置币种汇率。在适配器的数据交换中，我们通过导入操作只导入U9的币种，汇率可手工设置。
点击操作栏的“编辑”按钮，进入币种的编辑页面，录入相应的信息即可。
用友TurboCRM6.1 EAI-U9安装及使用手册
注意：将U9币种的名称及编码，填写到CRM相应的币种名称及识别码上，汇率填写U9对应的汇率。
3.2.7 如何理解CRM系统中的识别码字段？
CRM系统中的识别码字段：
1）CRM系统中，可以用来同步传递的对象、枚举值，都会有一个识别码字段，用来存储外部系统的数据编码。
2）如从U9中同步员工信息到CRM中，那么在CRM员工的识别码字段上，会存储U9员工的ID。
3）如从CRM中同步客户信息到U9，那么同步成功时,会自动返回U9已同步生成客户的ID到CRM客户的识别码字段上。
注意：一个对象的识别码在系统中必须唯一，否则对象的导入、导出不成功。
3.2.8如何设置基础数据CRM识别码与U9中ID或CODE的对应。
注意：因为U9中的业务员和用户都对应CRM中员工，此时需要在CRM的对象员工中，建立两个字段，如下图。
用友TurboCRM6.1 EAI-U9安装及使用手册
3.2.9如何理解CRM系统中同步订单的生效/失效状态？
1）系统规则：“创建即生效”的订单创建时即为生效状态
2）接口规则：U9订单提交后，CRM同步生成订单，状态为失效；
U9订单审核后，订单状态才更新为生效；
U9订单弃审时，订单状态更新为失效。
因此规定，订单类型中的“创建即生效”不勾选。
注意：当订单类型中的“创建即生效”已勾选，那么以系统规则优先。即，U9中已提交未审核的订单，CRM中同步生成的订单直接生效。
3.2.10 如何理解业务数据的审核和弃审？
3.2.11如何停用导入/导出功能
在ERP-U9适配器中，可以对导入导出状态进行停用，点击适配器列操作中对象的编辑按钮，将对象的导入或导出状态改为停用。
用友TurboCRM6.1 EAI-U9安装及使用手册
修改页面，勾选停用，保存。
3.2.12如何理解CRM-U9的单点登录
在CRM的客户，订单，报价单以及服务工单中，增加相关按钮，点击按钮后，进入到U9中的相关页面中。如在CRM订单中点击“查看U9”按钮，进入到U9中相应的订单的查看页面。
注意：需要单点登录时，需要使用与U9中对应的用户进行登录，并且需要修改登录密码为与登录U9的密码一致。