用友TurboCRM EAIU9安装及使用手册.docx
《用友TurboCRM EAIU9安装及使用手册.docx》由会员分享，可在线阅读，更多相关《用友TurboCRM EAIU9安装及使用手册.docx（55页珍藏版）》请在冰豆网上搜索。
用友TurboCRMEAIU9安装及使用手册
目 录
第一部分：
重要信息1
第二部分：
产品安装2
2.1CRM系统ERP-U9适配器的安装2
2.1.1安装步骤2
2.1.2安装注意事项6
2.2U9系统接口插件的安装6
第三部分：
使用手册7
第一章产品概述7
第二章初始配置11
3.2.1如何和U9的帐套做对应？
11
3.2.1.1CRM-EAI接口配置11
3.2.1.2U9系统配置12
3.2.2在EAI-U9中，有哪些对象可以进行数据交换？
12
3.2.3如何设置对象对应？
13
3.2.4如何设置组织对象的对应？
14
3.2.5如何在CRM中设置派生单位对应U9的辅计量单位？
16
3.2.6如何设置币种汇率的对应？
16
3.2.7如何理解CRM系统中的识别码字段？
17
3.2.8如何理解CRM系统中的名称字段？
17
3.2.9如何理解CRM系统中同步订单的生效/失效状态？
18
3.2.10如何理解业务数据的审核和弃审？
18
第三章常见应用18
3.3.1如何把U9的“组织”信息同步到CRM系统？
18
3.3.1.1组织新增/修改/删除的同步操作18
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客户字段映射表27
3.3.4.3客户导出停用27
3.3.5如何把U9的“币种”信息同步到CRM系统？
29
3.3.5.1币种新增/修改/删除的同步操作29
3.3.5.2业务员字段映射表31
3.3.6如何把U9的“计量单位”信息同步到CRM系统？
31
3.3.6.1计量单位新增/修改/删除的同步操作31
3.3.6.2计量单位字段映射表33
3.3.7如何把U9的“料品”信息同步到CRM系统？
33
3.3.7.1料品新增/修改/删除的同步操作33
3.3.7.2产品字段映射表34
3.3.8如何传递“订单”信息？
34
3.3.8.1订单新增/修改/删除的同步操作35
3.3.8.2订单字段映射表37
3.3.8.3CRM中U9订单编辑页面的链接键38
3.3.9如何把U9的出货记录同步到CRM系统？
38
3.3.9.1出货单新增/修改/删除的同步操作38
3.3.9.2交付单字段映射表39
3.3.10如何把U9的收款信息同步到CRM系统？
40
3.3.10.1应收单审核40
3.3.10.2收款单审核42
3.3.10.3核销单的新增/删除的同步操作44
3.3.10.4收款单字段映射表45
3.3.11如何把U9的发票信息同步到CRM系统？
46
3.3.11.1发票的新增/修改/删除的同步操作46
3.3.11.2发票字段映射表48
3.3.12如何查询EAI数据交换的日志？
49
附录：
常见问题51
联系我们53
用友TurboCRM6.1EAI-U9安装及使用手册
第一部分：
重要信息
欢迎购买并使用用友TurboCRM6.1EAI-U9接口！
以下简称EAI-U9接口。
本接口是基于用友TurboCRMV6.1系统和用友U9V2.0系统所做的标准接口，以下简称CRM系统和U9系统。
使用产品前请先阅读本手册。
如果阅后还需帮助，请咨询本地授权经销商或拨打4006600588咨询。
当本手册描述与产品操作不符时，请以产品为准。
对于本手册内容的最终解释权归用友公司所有。
Windows,WindowsNT,SQLServer是MicrosoftCorporation的注册商标。
本手册中涉及的其他产品商标为相应公司所有。
第二部分：
产品安装
2.1CRM系统ERP-U9适配器的安装
2.1.1安装步骤
EAI-U9接口采用了向导式安装，分为两个步骤：
1. 确认安装配置，包括确认系统硬件环境和软件运行环境；
2. 运行安装程序。
完成以上步骤，成功安装EAI-U9接口后，请参考《用友TurboCRM6.1EAI-U9安装及使用手册》开始应用接口功能。
首先，请您确认安装光盘包含内容：
1. 用友TurboCRM6.1EAI-U9接口软件安装包
2. 用友TurboCRM6.1EAI-U9安装及使用手册.chm
第一步确认安装配置
CRM系统和U9系统要求：
CRM系统：
用友TurboCRMV6.1系统
U9系统：
用友U9V2.0系统
操作系统要求：
◆服务器要求：
Ø Windows2000Server以上
Ø 或者各种Linux（内核版本R2.2.X以上）
◆Web服务器：
Ø ApacheServer（2.2.9以上ForWin32）
Ø 或者ApacheServer（2.2.9以上ForLinux）
◆数据库服务器：
Ø MicrosoftSQLServer2000以上
Ø 或者Oracle8i以上
◆客户端要求：
Windows2000、MicrosoftInternetExplorer6.0以上。
当您拿到EAI-U9接口安装包光盘后，请在安装目录下双击安装文件setup.exe。
开始EAI-U9接口的安装过程。
第二步运行EAI-U9安装程序
双击运行Setup.exe安装程序后，进入用友TurboCRM6.1EAI-U9安装界面，如图：
【系统安装界面】
点击[下一步]查阅安装许可协议。
【许可证协议】
请详细阅读许可协议，并勾选“我接受许可协议中的条款”点击[下一步]继续安装软件。
【配置数据库】
输入TurboCRM系统数据所在数据库的SQLSERVER身份验证密码。
点击[下一步]继续安装。
【安装目录信息确认】
系统自动会找到的TurboCRM6.1的安装目录，确认是否正确，不能手工修改，点击[下一步]按钮开始安装。
【安装完毕】
安装完毕后，点击[完成]按钮退出安装程序。
2.1.2安装注意事项
1. 必须先安装用友TurboCRM6.1，才能安装CRM6.1EAI-U9接口。
2. 安装完毕后，建议重启一下用友TurboCRM6.1的Apache服务。
2.2U9系统接口插件的安装
接口插件RAR解压，将protal文件夹覆盖U9程序。
第三部分：
使用手册
第一章产品概述
企业应用集成（EnterpriseApplicationIntegration，简称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系统（ERP系统）中一些重要的信息进行管理和分析，使得企业各部门的信息能够很好的整和到一起，更好的管理客户信息，来为客户提供更好的服务，使客户和企业达到双盈利。
我们将从接口功能、接口原理、系统环境以及交换规则等几个方面做细致的介绍，帮助企业更好的理解用友TurboCRM系统接口的强大功能，也方便企业自行维护、调整系统之间需要交换和处理的数据，更好的利用接口为企业服务，带来更多效益。
用友TurboEAI的一端以用友TurboCRM系统为主，另外一端可以适配多种交换系统，通常支持基于W3C标准的WebService、SOAP等服务。
如U9、U9都有提供此功能的外部服务。
一方面通过为交换系统提供适配器，保障了系统之间的可访性；另一方面基于用友TurboCRM系统以及交换系统提供的开放的标准数据接口，通常基于W3C作为业界数据交换的XML标准。
按照指定的规则在数据接口之间做映射，将一个系统提供的标准数据映射为另一个系统可接收的标准数据，从而达到数据的交换目的。
因此，用友TurboEAI可以说是建立在一个灵活的、开放的、标准化的技术底层架构之上。
用友TurboEAI采用面向对象技术的PHP编写，设计上结构清晰，可扩展性很强。
用友TurboEAI通过不同的方式可以访问不同的交换系统。
通过SOAP协议访问基于.Net的U9的外部数据交换服务。
通过Http访问基于MicrosoftIIS的U9的外部数据交换服务。
产品特点
CRM系统与U9系统之间同一类对象数据的同步时，通过CRM系统中设置相关的识别码字段，与U9中对象的关键编码字段的值对应，即CRM中识别码字段与U9中的关键编码字段的值相等时，则说明它们是同一个对象。
CRM系统与U9系统中对象的数据转换，通过在数据库中进行字段映射配置实现，可以根据需要增减对象转换的字段映射关系，而不需要修改程序。
由于CRM系统中往U9同步时，采用实时的方式实现。
Ø接口定义
用友TurboEAI接口目前支持对用友TurboCRM系统中所有对象和枚举值的查询、新增、编辑和删除操作。
类TCRMEai提供统一的调用接口Process（）
参数：
queryXml
返回值：
rtnXml
Ø外部系统调用
EAI服务封装于标准的WebService之中，外部系统开发人员可以采用如下方式调用
1、登录系统
使用WebService标准接口，通过
http:
//localhost/webservice/service.php?
orgcode=crm&class=WS_System&wsdl
调用登录函数login，传入登录名、密码，返回当前登录的Session。
2、使用EAI接口
使用WebService标准接口，通过
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个U9Site对1套CRM。
用友TurboCRM6.1EAI-U9系统能够渐进而有效地实现企业的价值与效能提升，主要表现在下列几个方面：
Ø提供对客户、合作伙伴全方位的了解与认识
企业对客户/伙伴信息获得的方式和渠道是来自于各业务系统，用友TurboCRM6.1EAI-U9针对散落在各业务系统中的信息进行全面的整合和记录，实现对客户、合作伙伴信息的全方位了解和掌握。
Ø与客户、合作伙伴建立更紧密的联系
企业对客户、合作伙伴管理是建立在“全方位接触管理”的基础上的，所谓“全方位接触管理”就是能够基于电话、信函、传真、WEB和移动设备（手机、PDA等）的多渠道的接触。
用友TurboCRM6.1EAI-U9能够实现业务信息的完整应用，强化与客户、合作伙伴的紧密关系。
Ø实现对业务信息的有效控制
针对业务管理的核心一定是结果和过程并重的管理，用友TurboCRM6.1EAI-U9能够实现将CRM（客户关系管理）、ERP（企业资源计划）、财务管理、OA（办公自动化）等业务信息的业务整合及控制。
Ø充分利用并扩展现有的IT投资
企业针对客户、合作伙伴的管理系统通常都是根据业务管理的核心和侧重点不同来部署的，用友TurboCRM6.1EAI-U9能够充分利用企业已经部署的原有业务系统资源，并极大的提升各业务系统的功效。
Ø实现企业盈利能力的提升
企业盈利能力的提升是通过企业内部管理到外部管理的协同和整合来实现的，用友TurboCRM6.1EAI-U9能够让企业的盈利能力得到充分的提升，并通过业务的持续发展得到充分地体现。
Ø技术领先
高度的可配置性和伸缩性，先进的技术架构。
主要功能
1、 基础档案
实现组织、用户（员工）、业务员（员工）、币种、计量单位、料品（产品）等的数据交换。
数据流向为从U9实时传送到CRM，包括新增、修改、删除三种操作。
2、 客户档案
数据流向为从CRM实时传送到U9，包括新增、修改三种操作。
3、 业务数据
实现订单、出货（交付）、发票、核销（收款）的数据交换。
数据流向为从U9实时传送到CRM，包括新增、修改、删除三种操作。
4、 新增U9销售订单
在订单的列表页面中，增加“新建U9销售订单”按钮，点击后链接到U9的登录页面。
第二章初始配置
3.2.1如何和U9的帐套做对应？
3.2.1.1CRM-EAI接口配置
使用U9系统管理工具的功能，进入企业管理页面新增查看企业代码和名称，如下图所示：
在CRM系统的EPR-U9适配器：
数据交换的页面，新建CRM系统与U9的某个企业同步。
在CRM的客户化平台下，点击“ERP-U9适配器”菜单，进入“ERP-U9适配器：
数据交换”页面，点击“设置”按钮，打开ERP-U9适配器设置页面。
U9网址：
输入U9系统所在服务器名称
U9企业ID：
公司ID，通过U9的系统管理工具，在企业管理下找到公司名称对应的代码
U9企业名称：
公司名，即U9登录页面的“公司”
U9订单网址：
用于U9订单编辑页面登录，不用改动。
默认值:
/Portal/erp/display.aspx?
lnk=SCM.SD.SD6010_10&SO_Type=SD6010&sId=3015nid&mId=1000910129519800&__curOId=
U9客户WebService：
用于客户数据导出到U9，不用改动。
默认值:
/Portal/services/CBO.Customer4CRM.svc?
wsdl
3.2.1.2U9系统配置
进入U9系统管理的参数设置，倒数四行需要设置CRM的服务器端口、登录组织及用户密码。
3.2.2在EAI-U9中，有哪些对象可以进行数据交换？
使用TurboCRM6.1EAI实现CRM与U9数据的同步操作，同步的内容分为基础档案和业务对象两大类。
数据同步是采用实时同步的方式。
具体同步的数据和同步方向见下表：
CRM
流向
U9
公共基础数据
客户：
组织
组织（营运）
员工
业务员
员工
组织用户
产品
物料主档
币种
币种
计量单位
计量单位
客户
客户
业务数据
销售订单
销售订单
交付单
出货单（客户必须来源于CRM）
发票
税务发票（客户必须来源于CRM）
收款单
核销单（客户必须来源于CRM）
接口图：
注意：
有些对象的某些字段在CRM中为必填项或必需项，从U9系统导入到CRM时，必须制定该字段的对应字段或默认值!
对象
字段
默认值
员工（用户）
可登录
1
计量单位
派生单位
0
单位换算
1
产品
类型ID
产品
订单
类型ID
订单
价格表
标准价格表
发票
发票类型ID
发票
交付
类型
47
状态
3
关联对象
6
收款
类型
48
状态
3
关联对象
6
3.2.3如何设置对象对应？
CRM与U9进行交换的对象固定，不可新增对象，详情如下：
组织：
单向同步到CRM系统
员工（业务员）：
单向同步到CRM系统
员工（用户）：
单向同步到CRM系统
币种：
单向同步到CRM系统
计量单位：
单向同步到CRM系统
产品：
单向同步到CRM系统
客户：
单向同步到U9系统
订单：
单向同步到CRM系统
发票：
单向同步到CRM系统
交付：
单向同步到CRM系统
收款：
单向同步到CRM系统
上图列出了CRM中所有可以与U9进行数据交换处理的对象，包括可以从U9同步的对象，以及可以从CRM中同步到U9中的对象。
同步的字段，用户可以根据实际需要进行配置。
系统会预置一部分字段的匹配。
3.2.4如何设置组织对象的对应？
U9中的组织对象，以客户自定义属性的形式同步到CRM中。
因此需要在安装完EAI接口后进行如下自定义字段设置。
首先进入客户的自定义字段页面，新增一个字段名为Company（注意大小写），字段标签[中文]为组织的自定义字段，如下图：
建好“组织”自定义枚举属性后，返回“ERP-U9适配器：
数据交换”列表页面，客户对象的组织名称将由原来的“客户：
Account.Company”自动变更为“客户：
组织”。
CRM系统自定义的“组织”的识别码对应U9的公司ID，枚举值对应U9的公司编码。
如下图：
3.2.5如何在CRM中设置派生单位对应U9的辅计量单位？
在EAI-U9接口中，不考虑计量单位的辅计量单位和换算率等。
可在CRM中手工设置，不与U9同步。
3.2.6如何设置币种汇率的对应？
用友TurboCRM6.1系统预置了人民币、美元两种货币币种来满足一般用户的需要。
如果您的业务涉及其它的币种汇率及本位币设置要求，可点击KEY菜单【产品】【币种汇率】进入币种的列表页面，设置币种汇率。
在适配器的数据交换中，我们通过导入操作只导入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的名称编码，对应名称则同步失败。
以后版本将进一步调整。
如下列表归纳：
对象
CRM字段
U9字段
客户：
组织
enum_value（enum_value）
公司编码（m_code）
员工（业务员）
姓名（User.Name）
人员编码（m_code）
员工（用户）
姓名（User.Name）
名称（m_name）
币种
名称（Currency.Name）
编码（m_code）
计量单位
名称（Unit.Name）
编码（m_code）
产品
名称（Product.Name）
名称（m_name）
客户
名称（Account.name）
名称（Name）
3.2.9如何理解CRM系统中同步订单的生效/失效状态？
1）系统规则：
“创建即生效”的订单创建时即为生效状态
2）接口规则：
U9订单提交后，CRM同步生成订单，状态为失效；
U9订单审核后，订单状态才更新为生效；
U9订单弃审时，订单状态更新为失效。
3）因此规定，订单类型中的“创建即生效”不勾选。
注意：
当订单类型中的“创建即生效”已勾选，那么以系统规则优先。
即，U9中已提交未审核的订单，CRM中同步生成的订单直接生效。
3.2.10如何理解业务数据的审核和弃审？
U9
CRM
SO提交
SO保存
SO删除
SO删除
SO审核
SO生效
SO弃审
SO取消生效
销售出货单审核
交付单保存
销售出货单弃审
交付单删除
销售税务发票审核
销售发票保存
销售税务发票弃审
销售发票删除
应收核销记录保存
收款单保存
应收核销记录删除
收款单删除
第三章常见应用
3.3.1如何把U9的“组织”信息同步到CRM系统？
3.3.1.1组织新增/修改/删除的同步操作
步骤一：
设置客户组织的自定义对象，如3.2.4中所述。
步骤二：
同步U9新增的组织信息
路径：
U9->系统管理->组织机构
升级会员 