外部数据获取字段可以和您的第三方系统进行交互，进行一些数据获取，在工单提交页面显示，下面将对该字段进行详细描述。
外部数据获取字段有什么用？
例如您的企业运营着一个网上商城系统，您的用户在您的商城里购买东西，在购买东西的时候用户会下订单，这样一来一个用户也许在您的商城系统里面有多个订单。
您希望您的客户在提交工单的时候，能方便的选择这些订单列表，来对某个订单提出工单问题请求
如图：
这些订单编号是从您的商城系统里当前用户的信息中获取的，需要进行一些配置后才能正常使用该功能。
如何使用和配置外部数据获取字段
外部数据获取字段是用来获取外部系统用户的某些额外信息列表，所以这个字段必须与外部系统的用户相关联，如果不能和外部系统的用户相关联，这个字段是没有意义的。
要添加一个外部数据获取字段，将菜单转到 系统设置 > 工单 > 工单自定义字段， 点击添加工单自定义字段，然后选择 外部数据获取字段。
在打开的字段配置页面，您可以设置要显示给哪些用户，最重要的是要配置好 数据获取URL 和 数据获取TOKEN 这两个信息。
数据获取URL
这个是指您的外部系统的一个URL地址，KF5帮助台会通过这个地址来访问您的系统，从而获取到您外部系统中的用户信息来生成该字段的信息列表。它的格式形如： http://sample.com/obtain/?email={{email}} &phone={{phone}}&landline={{landline}}。请不要删除地址中的{{email}} 、{{phone}}、{{landline}}，它代表所要数据的当前用户的邮箱、手机号、座机号，并以此作为用户的匹配方式来获取目标系统该用户的相关信息。
数据获取TOKEN
这个是指您外部系统指定的数据获取通信密钥，设置TOKEN是为了增加数据请求的安全性。具体如何获取我们将在下面具体描述到。
如何配置或二次开发您的外部系统
逸创云客服目前已经让一些开源系统能支持该字段的设置，无需进行二次开发，如果您使用的是以下系统，则可以轻松配置和使用
- ecshop
配置ECSHOP让用户提交工单时能选择在商城系统的订单号
配置好ECSHOP系统和逸创云客服的整合，并在逸创云客服配置好单点登录，让用户必须登录才可以提交工单，同时关闭云客服平台的注册功能。
在 外部数据获取字段 的数据获取URL 处，填入： http://www.yourecshop.com/kf5.php?act=getOrderList&email={{email}}
下面的 外部数据获取字段 的 数据获取TOKEN 留空，系统会使用API密钥作为TOKEN来进行加密。
这样，用户通过单点登录提交工单时，可以显示自己的订单号列表了。
其他外部系统的二次开发指导 （您需要有一定的代码开发基础才能配置好该字段功能）
如果您使用的是您自己开发的外部系统，则需要进行一些简单的二次开发
- 您需要写一个函数来处理用邮箱来查找用户信息，并返回这些指定的信息
- 您需要自行设定一个TOKEN通信密钥，这个密钥只是为了数据获取使用，并填入 数据获取TOKEN 中
下面是一个PHP语言开发示例代码段：
$email = isset($_GET['email']) ? $_GET['email'] : '';
$token = isset($_GET['token']) ? $_GET['token'] : '';
//您设定的数据获取验证token
$secret_key = '********';
$results = array();
//验证token是否正确
if($email && $token && $token == $secret_key）{
/*
* 可查询数据库获取和用户邮箱匹配的数据
* 此处仅为演示，请根据具体情况开发
*/
$data = array('订单1号','订单2号');
foreach($data as $key=>$value){
$results[$value] = $value;
}
}
echo json_encode($results);
注意事项
- 因为该字段是和外部用户系统相关联的，所以最好是做好SSO单点登录整合集成后，再添加该字段，否则单独添加该字段是没有任何意义的。
- 如果没有获取到外部系统用户的任何信息，或者因为配置不当没有获取到用户，该字段是不会显示任何下拉数据的。
- 如果用户没有以任何方式登录系统时，在任何情况下都是不会显示该字段的。