工单外部扩展，指的是工单自定义字段中的两种字段类型（文本，资产表）可支持数据源来自于第三方，及绑定帮我吧客户档案的资产表的数据，然后赋值到工单中，使得工单满足多方对接。对接类型有两大类，一类是文本字段，一类是资产表字段。

不希望同步一些数据到帮我吧绑定工单模块的资产表中，但是工单又需要使用这些数据的时候，便可通过外部扩展实现。 比如：备件信息，项目信息等

使工单的自定义文本字段在开启外部扩展（启用外部数据源）后能够操作帮我吧自定义资产表，并将数据中的数据对应工单的自定义字段值中。

配置地址

https://www.bangwo8.com/osp2016/SDK/Tables/ticketAssetTable.php

配置参数

注意：

①filter参数用于筛选资产表所属人的数据时，固定传两个参数：ownerType；owner 非必填，如果owner不为空，则ownerType也不能为空，否则显示所有数据

②ownerType：资产表数据的所属人类型，所属人类型为联系人取值：contacter，所属人类型为公司取值：company

③owner ：资产表数据的所属人，所属人类型为联系人占位符取值为：{ {user.cId} }（联系人id），所属人类型为公司占位符取值为：{ {company.companyId} }（公司id）

④非占位符时直接写联系人id或者公司id值; 该占位符获取的是当前页面数据，非数据库数据;如果配置了这两个参数，但是工单页面数据为空，则这两个参数不生效，显示所有数据； 如果owner不为空，则ownerType也不能为空，否则显示所有数据

⑤没有设置display参数时，第一次配置该外部扩展：默认显示所有字段，可视化选项选择中所有字段。

⑥有传display参数，第一次配置该外部扩展：显示的是该参数列，可视化选中的也是显示的字段。再次添加字段参数，不会再生效。

⑦symbol参数中传的分割多个选项的符号一定要确定所传的数据中不包含此分隔符，否则将出现数据混乱问题。

⑧assignment参数仅在单选时有效，链接中配置了多选参数时，传入此参数无效；配置好后在工单创建时可带入联系人信息或者公司信息（以及公司默认联系人），如果联系人离职则不带入；工单提交后，修改选择资产客户信息不会再随之改变。

配置地址示例

https://www.bangwo8.com/osp2016/SDK/Tables/ticketAssetTable.php?tableId=12&cPara=_id:ticket_price,asset_field_2:ticket_name&filter=asset_field_1:电子,asset_field_2:{{ticket_status}},ownerType:company,owner:{{company.companyId}}&precise_filter=asset_field_1&display=asset_field_1,asset_field_2&assignment=1

操作视图

工单字段与资产表字段可赋值类型对应表

当帮我吧工单和第三方页面互动时，工单页面内使用iframe（PS2）嵌套第三方页面；第三方页面内展现数据，选择数据，当选择完数据，帮我吧会使用选择的数据来回填工单内容

配置

在帮我吧配置文本字段如下：

接口地址是第三方提供的url，帮我吧必传一个参数：cPara 该参数是指第三方字段和帮我吧字段的对应关系，当第三方页面给帮我吧回传数据时使用。格式为field_1:bw8_field_1,field_2:bw8_field_2； field_1,field_2为第三方页面里字段的名称，bw8_field_1, bw8_field_2为帮我吧内字段的名称，参数有多个时，以逗号分隔。

工单内使用

在工单页，双击A这个位置，就会弹出B,B是iframe，内部嵌套的是一里面配置的url。

对接方需要做的

当在第三方界面选择完数据，设置一个按钮，点击此按钮时，首先组装一个数组变量（详见下方注意），如叫param，封装为新对象data，参数msgType为本次对接标志,固定为字符串'textFieldExtend'，组装完成调用函数如下：

window.parent.postMessage(data,'*');

具体示例如下：		
	   //表单数据
        var param = [
            {key:'field_181',value:'value field_181'},
            {key:'field_182',value:'value field_182'},
        ];
        //封装为新数据格式
        var data = {
            msgType: 'textFieldExtend', //添加消息类型
            data: param,                //表单数据
        };
        window.parent.postMessage(data,'*'); //发送消息

此时便可以给工单回填数据。

注意：

1.根据传过来的参数cPara，使用第三方field_1的值给对应的bw8_field_1赋值，组装成如下的数组（数组的元素是json）格式： new Array({'key':’bw8_field_1’,'value':'hello'},{'key':':bw8_field_2','value':'world'})

2.Iframe的宽度是1000px，高度是500px

当帮我吧工单的自定义字段–资产表类型字段的元数据来自于第三方数据时，工单页面内使用第三方系统提供的元数据，由帮我吧接入元数据，展示第三方数据在资产表页面内；选择数据，当选择完数据，帮我吧会使用选择的数据来回填工单本字段内容。 可用于配件库等业务场景。

实现界面如图：

配置

如果开启了启用外部数据源，则请选择表单选项不用选择，在帮我吧配置资产表字段如下： 启用外部数据源后，接口地址是第三方提供的接口url

对接方式

首先创建资产表时，资产表的自定义字段唯一标识要与第三方接口返回的参数名一致

请求方式

psot

请求参数

第三方返回给帮我吧的数据格式

当帮我吧单击资产表字段时请求第三方提供的url的数据，第三方接口按要求返回格式,这两个参数必须回传：

"ownerType":"agent",//资产表数据的所属人类型，取值为：agent-服务商//servicer-客服，contacter-联系人，company-公司
"owner":"测试公司"//服务商认证名称/客服名称/联系人名称/公司名称

返回格式示例

{
    "rows":[
        {   "ownerType":"agent",
            "owner":"测试公司",
            "uId":6941323,
            "companyName":"一个测试公司",
            "area":"0",
            "address":"",
            "date":"2020-01-21",
            "price":0.12
        },
        {
            "ownerType":"agent",
            "owner":"测试公司2",
            "uId":6941356,
            "companyName":"另一个公司",
            "area":"0",
            "address":"",
            "date":"2020-01-21",
            "price":0.12
        }
    ],
    "total":2000,
    "page":25,
    "currentpage":1
 }

返回格式错误处理

如果返回格式错误，则在页面显示：数据有误，请检查接口返回格式是否正确！

如果返回数据为空，则显示：

如果配置错误，如：custominfo多个参数传参没有按分号分隔或者格式错误，则显示：

当帮我吧工单的自定义字段–资产表类型字段的元数据来自于关联模块是客户管理的资产表数据时，工单页面内使用该资产表提供的元数据，由关联模块是工单的资产表接入元数据，展示该资产表数据在工单资产表页面内；选择数据，当选择完数据，帮我吧会使用选择的数据来回填工单本字段内容。

实现界面如图： 选择添加以后的页面：

配置

首先创建一个跟关联模块是客户管理的资产表结构一模一样的关联工单的资产表，然后启用外部数据源，请选择表单选项选择关联模块为工单的资产表，在帮我吧配置资产表字段如下：

启用外部数据源后，接口地址是自己根据下面文档配置的接口url

请求方式

post

配置参数

配置地址示例

https://www.bangwo8.com/osp2016/SDK/Tables/getAssetTableDate.php?tableId=292488&owner={{user.userId}}&ownerType=contacter

第三方返回数据格式

当帮我吧单击资产表字段时请求接口地址的数据，接口按要求返回格式,这两个参数必须回传：

"ownerType":"agent",//资产表数据的所属人类型，取值为：agent-服务商//servicer-客服，contacter-联系人，company-公司
"owner":"武汉华菲工匠工程服务有限责任公司"//服务商认证名称/客服名称/联系人名称/公司名称

返回格式示例：

{
    "rows":[
        {   "ownerType":"agent",
            "owner":"武汉华菲工匠工程服务有限责任公司",
            "uId":6941311,
            "companyName":"贵阳青汇铸造有限公司",
            "area":"0",
            "address":"",
            "date":"2020-01-21",
            "price":0.12
        },
        {
            "ownerType":"agent",
            "owner":"武汉华菲工匠工程服务有限责任公司",
            "uId":6941311,
            "companyName":"贵阳青汇铸造有限公司",
            "area":"0",
            "address":"",
            "date":"2020-01-21",
            "price":0.12
        },
        {
            "ownerType":"agent",
            "owner":"武汉华菲工匠工程服务有限责任公司",
            "uId":6941311,
            "companyName":"贵阳青汇铸造有限公司",
            "area":"0",
            "address":"",
            "date":"2020-01-21",
            "price":0.12
        },
        {
            "ownerType":"agent",
            "owner":"武汉华菲工匠工程服务有限责任公司",
            "uId":6941311,
            "companyName":"贵阳青汇铸造有限公司",
            "area":"0",
            "address":"",
            "date":"2020-01-21",
            "price":0.12
        }
    ],
    "total":2000,
    "page":25,
    "currentpage":1
 }

返回格式错误处理 如果返回格式错误，则在页面显示：数据有误，请检查接口返回格式是否正确！

如果返回数据为空，则显示：

如果配置错误，如：custominfo多个参数传参没有按分号分隔或者格式错误，则显示