EAI接口開(kāi)發(fā)使用及單點(diǎn)登錄配置說(shuō)明

1、6.1 EAI6.1 EAI接口開(kāi)發(fā)使用接口開(kāi)發(fā)使用及單點(diǎn)登錄配置說(shuō)明及單點(diǎn)登錄配置說(shuō)明1.1.在線文檔：在線文檔：用友TurboCRM6.1 EAI使用標(biāo)準(zhǔn)的Web Service接口。其在線文檔，可以通過(guò)以下方式訪問(wèn)：http:/localhost/webservice/service.php?orgcode=crm其中http:/localhost為當(dāng)前TurboCRM 6.1系統(tǒng)所使用的Apache服務(wù)器地址。參數(shù)orgcode取值“crm”，為當(dāng)前系統(tǒng)所使用的單位簡(jiǎn)稱。在線文檔在線文檔如圖:在線文檔在線文檔2.2.接口介紹接口介紹用友TurboCRM6.1的WebService主要的

2、兩個(gè)接口是：(1)WS_System提供CRM系統(tǒng)用戶登錄登出的WEB服務(wù)驗(yàn)證身份 login( string user, string password, int lang ) type string user 用戶登錄名 type string password 登錄密碼 WS_SystemWS_System接口接口type int lang 登錄后使用的語(yǔ)言，默認(rèn)為中文 returns string 如果驗(yàn)證成功，返回一個(gè)token串，否則返回空字符串，調(diào)用其它的WEB服務(wù)，必須將token變量加到請(qǐng)求頭中 退出登錄 logout( ) returns void(2)WS_EAI提供CR

3、M系統(tǒng)用戶EAI讀取的WEB服務(wù) EAI處理函數(shù) process(string queryXml) type string queryXml 輸入XMLreturns string 輸出XMLWS_EAIWS_EAI接口接口3.3.調(diào)用流程調(diào)用流程(1)登錄系統(tǒng)使用Web Service標(biāo)準(zhǔn)接口，通過(guò)http:/localhost/webservice/service.php?orgcode=crm&class=WS_System&wsdl調(diào)用登錄函數(shù)login，傳入登錄名、密碼，返回當(dāng)前登錄的Session。Web ServiceWeb Service調(diào)用流程調(diào)用流程(2)使

4、用EAI接口使用Web Service標(biāo)準(zhǔn)接口，通過(guò)http:/localhost/webservice/service.php?orgcode=crm&class=WS_EAI&wsdl調(diào)用EAI接口函數(shù)process，傳入查詢xml，登錄的Session，返回結(jié)果xml。Web ServiceWeb Service調(diào)用流程調(diào)用流程4.4.開(kāi)發(fā)實(shí)例開(kāi)發(fā)實(shí)例修改PHP配置文件php.ini，使PHP運(yùn)行環(huán)境持以下兩個(gè)擴(kuò)展庫(kù)：extension=php_soap.dllextension=php_xsl.dll調(diào)用Web Service 使用PHP類：SoapClient代碼示例

5、如下：$client = new SoapClient($wsURL);$result = $client-_soapCall($wsFunc, $params, array(),$header);Web ServiceWeb Service調(diào)用開(kāi)發(fā)示例調(diào)用開(kāi)發(fā)示例參數(shù)說(shuō)明：(1)$wsURL：為TurboCRM6.1 EAI提供的Web Service地址，如登錄登出服務(wù)地址為：http:/localhost/webservice/service.php?orgcode=crm&class=WS_System&wsdlEAI處理地址為：http:/localhost/webs

6、ervice/service.php?orgcode=crm&class=WS_EAI&wsdlWeb ServiceWeb Service調(diào)用開(kāi)發(fā)示例調(diào)用開(kāi)發(fā)示例(2)$wsFunc：為TurboCRM6.1 EAI提供的函數(shù)，如登錄函數(shù)login，EAI處理函數(shù)process。(3)$params參數(shù)數(shù)組，參見(jiàn)函數(shù)說(shuō)明，如登錄函數(shù)login的參數(shù)即可設(shè)置如下：$params = array(“admin”, ”123”);即登錄名為admin，登錄密碼為123。(4)$headerPHP類SoapHeader對(duì)象。Web ServiceWeb Service調(diào)用開(kāi)發(fā)示例調(diào)用

7、開(kāi)發(fā)示例5.5.調(diào)用流程調(diào)用流程(1)登錄系統(tǒng)$wsURL=“http:/localhost/webservice/service.php?orgcode=crm&class=WS_System&wsdl”;$params = array(“admin”, ”123”);$header = null;$client = new SoapClient($wsURL);$wsFunc = “l(fā)ogin”;$session = $client-_soapCall($wsFunc, $params, array(),$header);調(diào)用調(diào)用Web ServiceWeb Service

8、流程：流程：$session返回為登錄函數(shù)返回的session，這個(gè)session在后續(xù)調(diào)用EAI接口時(shí)需要用到。如果不傳遞session，EAI接口將無(wú)法返回正確的值。(2)處理EAI函數(shù)$queryXML = ;$wsURL=“http:/localhost/webservice/service.php?orgcode=crm&class=WS_EAI&wsdl”;$params = array($queryXML);調(diào)用調(diào)用Web ServiceWeb Service流程：流程：$header = new SoapHeader(http:/.$_SERVERHTTP_HO

9、ST,PHPSESSID, $session);$client = new SoapClient($wsURL);$resultXML = $client-_soapCall($wsFunc, $params, array(),$header);$queryXML中xml含義為查詢系統(tǒng)中所有客戶信息。$header為新建一個(gè)SoapHeader對(duì)象，并將登陸調(diào)用返回的session傳入。$resultXML為EAI返回的xml信息。調(diào)用調(diào)用Web ServiceWeb Service流程：流程：6.6.單點(diǎn)登錄單點(diǎn)登錄(1)單登錄的入口及配置說(shuō)明CRM系統(tǒng)提供的單點(diǎn)登錄入口為/login/si

10、ngletlogin.php。針對(duì)不同的登錄機(jī)制，接收不同的參數(shù)。如果需要，可以使用配置文件autologin.ini, 該文件放在/tsvr/autologin.ini (2)登錄名與IP的驗(yàn)證方式需要提供orgcode 和 loginname 參數(shù)，形如： http:/localhost/login/singletlogin.php?orgCode=crm&loginName=admin 單點(diǎn)登錄單點(diǎn)登錄配置文件示例：method=ipmethod=iptype=clientip/referhosttype=clientip/referhostuser:user:* * ip:1=

11、ip:1=ip:2=-ip:2=-ip:3=192.168.0.ip:3=192.168.0.* * host:1=host:1=host:2=“host:2=“ user:admin user:adminip:1=ip:1=ip:2=-ip:2=-ip:3=192.168.0.ip:3=1

12、92.168.0.* * 單點(diǎn)登錄單點(diǎn)登錄配置文件說(shuō)明：method：驗(yàn)證方法。ip表示通過(guò)IP驗(yàn)證。type：驗(yàn)證方式。其中：clientip：以客戶端IP的方式。referhost：來(lái)自頁(yè)面的HOST方式驗(yàn)證。user：每個(gè)用戶可以配置一節(jié)，以“user:”開(kāi)始，可以使用通配符*。單點(diǎn)登錄單點(diǎn)登錄user其包含的參數(shù)：如果為clientip方式，可以設(shè)置多個(gè)用戶IP，支持三種方式。a.具體的IP。例如：””b.IP段地址段。例如：”- ”c.通配符。例如：”192.168.0.*”如果為referhost方式，可以設(shè)置多個(gè)host的地址。單點(diǎn)登錄單點(diǎn)登錄(3)登錄名與密碼驗(yàn)證方式需要提供o