以下部分描述了为开发人员实例安装ServiceNow连接器的步骤。

ServiceNow上的代码更改

1. 转至过滤导航并搜索脚本包含。

   在系统用户界面 下选择脚本包含。

2. 筛选名称 并搜索propUtils。

3. 在脚本 中更改UserGetSysId方法。

   curent：

   UserGetSysId：函数() { var opened_for； var user = new GlideRecord("sys_user")； user.addQuery(this.getParameter('field')，this.getParameter('value'))； user.query()； if (user.next()) opened_for=user.sys_id； var grInt = new GlideRecord('interaction')； grInt.initialize()； grInt.assigned_to= gs.getUserID()； grInt.type= 'phone'； grInt.opened_for= opened_for； var sysid=grInt.insert()； return sysid； }，

   事件的新示例代码：

   UserGetSysId：函数() { varopened_for； //与事件相关的更改var sysidlist ={}； var user = new GlideRecordSecure("sys_user")； user.addQuery(this.getParameter('field')，this.getParameter('value'))； user.query()； if(user.next()) {opened_for=用户。sys_id；//返回用户。sys_id； var inc = new GlideRecordSecure('incident')； inc.addQuery('caller_id'，opened_for)； inc.addQuery('state'，'IN'，'1，2')； inc.orderByDesc('sys_created_on')； inc.query()； if (inc.next()) { sysidlist.incsysid=inc.getUniqueValue()； else{ inc.initialize()； inc.caller_id=opened_for；公司。contact_type=“电话”； inc.short_description='从'+ this.getParameter('value')； sysidlist.incsysid=inc.insert()； } } var grInt = new GlideRecordSecure('interaction')； grInt.initialize()； grInt。assigned_to= gs.getUserID()； grInt.type= 'phone'； grInt。opened_for=opened_for； var sysid=grInt.insert()； sysidlist.sysid=sysid；返回JSON.stringify(sysidlist)； }，

1. 转至过滤导航并搜索UI页面。

   在系统用户界面 下选择UI页面。

2. 筛选名称 并搜索代理桌面。

3. 在客户端脚本 中更改屏幕弹出功能。

   当前功能：

   // screen pop功能screenpop(callerani，callSessionInfo) { if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani)； } var gaout = new GlideAjax('propUtils')； gaout.addParam('sysparm_name'， 'UserGetSysId')； gaout.addParam('field'， 'phone')； gaout.addParam('value'， callerani)； gaout.getXMLWait()； var sysid = gaout.getAnswer()； openFrameAPI.openServiceNowForm({ entity：“交互”，查询：'sys_id='+sysid })；

   事件示例代码：

   // screen pop功能screenpop(callerani，callSessionInfo) { if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani)； } var gaout = new GlideAjax('propUtils')； gaout.addParam('sysparm_name'， 'UserGetSysId')； gaout.addParam('field'， 'phone')； gaout.addParam('value'， callerani)； gaout.getXMLWait()； //对于与事件相关的更改var sysObj = JSON.parse(gaout.getAnswer())； if(sysObj.incsysid){ openFrameAPI.openServiceNowForm({ entity：“事件”，查询：'sys_id='+sysObj.incsysid，'interaction_sys_id'：sysObj.sysid })； else{ openFrameAPI.openServiceNowForm({ entity：“事件”，查询：'sys_id=-1', 'interaction_sys_id': sysObj.sysid //'a2ba0ba62fd121106446cc96f699b6b8' })； }

如果CRM中存在呼叫者信息，并且此联系人已打开新事件，应用程序将打开未进展事件

如果CRM中不存在呼叫者信息，应用程序将打开一个新事件

如果呼叫者信息在CRM中存在，应用程序将打开一个包含预填充详细信息的新事件

概览

此用例详细介绍了在安装ServiceNow CRM连接器的Webex CC后，向ServiceNow表中添加额外列和创建webexcc_imp_activitysn_openframe_phone_log 的流程。

默认情况下，该表包含框系统字段和值。

您可以在WebexCC Flow设计器中创建更多业务特定变量（CAD变量），并在ServiceNow后呼叫活动日志中添加CAD变量，并将此持续到呼叫后活动表数据。

向WebexCC IMP活动添加列

1. 在ServiceNow开发者版本中编辑表格。

   

2. 转至过滤器导航器并搜索工作室。

   

   选择 Webex联系中心

   

   或

   

   

   

3. 选择 WebexCC IMP活动 表

   

4. 添加新列，例如，CustomerName

   

   

将列添加到电话日志

1. 编辑电话日志表。

   

   

2. 添加新列，例如 CustomerName。

   

   

WebexCC活动转换地图

添加新列，例如，CustomerName 字段映射。

自定义列表列

根据Service Now的建议，将选择操作从“创建”更改为忽略。

配置电话日志列表

转至“包含脚本”

查看此行：webexcc.u_customername=actInfo.CustomerName； 附有支持注释。

var propUtils = Class.create()； propUtils.prototype = Object.extendsObject(global.AbstractAjaxProcessor，{ getWebexccProp ：function () { var webexccprop = {}； webexccprop.instanceurl= 'https：//'+gs.getProperty('instance_name')+'。service-now.com/'； webexccprop.url=gs.getProperty('x_caci_webexcc。agentdesktop_url')； // webexccprop.popupurl=gs.getProperty('x_caci_webexcc。screenpop_url')；返回JSON.stringify(webexccprop)； }， UserGetSysId：函数() { var opened_for； var user = new GlideRecord("sys_user")； user.addQuery(this.getParameter('field')，this.getParameter('value'))； user.query()； if (user.next()) opened_for=user.sys_id；//return user.sys_id； // else // return null； var grInt = new GlideRecord('interaction')； grInt.initialize()； grInt.assigned_to= gs.getUserID()； grInt.type= 'phone'； grInt.opened_for= opened_for； var sysid=grInt.insert()； return sysid； }， setWebexcctable ：函数() { varsys_id=0； var actInfo = JSON.parse(this.getParameter('actInfo'))； var webexcc = new GlideRecordSecure(gs.getProperty(')x_caci_webexcc.webexccactivitytable'))； webexcc.addQuery("callobject"， actInfo.CallObject)； webexcc.query()； if(！webexcc.next()) { webexcc.ani = actInfo.ani； webexcc.dnis =actInfo.queuename； webexcc.wrapuptime =actInfo.CallDurationInSeconds； webexcc.ringingtime =actInfo.ActivityDate； webexcc.callobject =actInfo.CallObject； webexcc.calltype =actInfo.CallType； webexcc.calldisposition=actInfo.CallDisposition； //此行已添加-以在webexcc活动日志中捕获它。u_customername=actInfo.CustomerName；sys_id=webexcc.insert()； //事件记录上的活动； var actInfoString =this.getParameter('actInfo')； var suser = new GlideRecordSecure("sys_user")； suser.addQuery("phone"， this.getParameter('ani'))； suser.query()； if(suser.next()) { var inc = new GlideRecordSecure('incident')； inc.addQuery('caller_id”””苏塞。sys_id)； inc.orderByDesc('sys_created_on')； inc.query()； if (inc.next()) { var jsonPretty = JSON.stringify(JSON.parse(actInfoString)，null，2)； inc.comments =jsonPretty； inc.update()； } } }返回sys_id； }，类型：'propUtils' })；

在Flow设计器中创建CAD变量

将CAD变量添加到桌面布局

示例

"CadName1：SnowField1，CadName2：SnowField2" CadName1是CustomerName SnowField1也可用作CustomerName，这是在"actInfo.CustomerName"上方的样本剪切的一部分。

演示屏幕截图

查看WebexCC活动表中新添加的CAD变量。

为Flow Designer创建CAD变量

事件影响

Service Now脚本更新

脚本的更新包括

1. 转至过滤器导航器并搜索脚本包括

   在系统用户界面 下选择脚本包含选项。

   

2. 使用propUtils 筛选名称。

   

3. 更改脚本 字段中的UserGetSysId 方法。

   

   当前脚本：

   UserGetSysId：函数() { var opened_for； var user = new GlideRecord("sys_user")； user.addQuery(this.getParameter('field')，this.getParameter('value'))； user.query()； if (user.next()) opened_for=user.sys_id； var grInt = new GlideRecord('interaction')； grInt.initialize()； grInt.assigned_to= gs.getUserID()； grInt.type= 'phone'； grInt.opened_for= opened_for； var sysid=grInt.insert()； return sysid； }，

   事件的新示例代码：

   UserGetSysId：函数() { varopened_for； var sysidlist ={}； var user = new GlideRecordSecure("sys_user")； user.addQuery(this.getParameter('field')，this.getParameter('value'))； user.query()； if(user.next()) {opened_for=用户。sys_id；//返回用户。sys_id； var inc = new GlideRecordSecure('incident')； inc.addQuery('caller_id'，opened_for)； inc.addQuery('state'，'IN'，'1，2')； inc.orderByDesc('sys_created_on')； inc.query()； if (inc.next()) { sysidlist.incsysid=inc.getUniqueValue()； else{ inc.initialize()； inc.caller_id=opened_for；公司。contact_type='phone'； inc.urgency=this.getParameter('IncUrgency')； inc.impact=this.getParameter('Impact')； inc.short_description='从'+ this.getParameter('value')； sysidlist.incsysid=inc.insert()； } } var grInt = new GlideRecordSecure('interaction')； grInt.initialize()； grInt。assigned_to= gs.getUserID()； grInt.type= 'phone'； grInt。opened_for=opened_for； var sysid=grInt.insert()； sysidlist.sysid=sysid；返回JSON.stringify(sysidlist)；//sysid； }，

1. 转至过滤器导航器并搜索UI页面。

   在系统用户界面 下选择UI页面选项。

   

2. 使用名称 筛选用户界面页面，并搜索代理桌面 。

   

3. 更改脚本字段中的屏幕弹出 功能。

   

   当前功能：

   // screen pop功能screenpop(callerani，callSessionInfo) { if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani)； } var gaout = new GlideAjax('propUtils')； gaout.addParam('sysparm_name'， 'UserGetSysId')； gaout.addParam('field'， 'phone')； gaout.addParam('value'， callerani)； gaout.getXMLWait()； var sysid = gaout.getAnswer()； openFrameAPI.openServiceNowForm({ entity：“交互”，查询：'sys_id='+sysid })； 

   事件示例代码：

   //屏幕弹出功能screenpop(callerani，callSessionInfo) { var Impact=3； if(callSessionInfo.callAssociatedData.Impact ！= null && callSessionInfo.callAssociatedData.Impact ！= undefined) { var IncUrgency=3； if(callSessionInfo.callAssociatedData.Urgency ！= undefined) { IncUrgency=callSessionInfo.callAssociatedData.Urgency.value； } if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani)； } var gaout = new GlideAjax('propUtils')； gaout.addParam(''sysparm_name'，'UserGetSysId')； gaout.addParam('field'， 'phone')； gaout.addParam('value'， callerani)； gaout.addParam('IncUrgency'， IncUrgency)； gaout.addParam('Impact'， Impact)； gaout.getXMLWait()； // var sysid = gaout.getAnswer()； var sysObj = JSON.parse(gaout.getAnswer())； if(sysObj.incsysid){ openFrameAPI.openServiceNowForm({ entity：“事件”，查询：'sys_id='+sysObj.incsysid，'interaction_sys_id'：sysObj.sysid })； else{ openFrameAPI.openServiceNowForm({ entity：“事件”，查询：'sys_id=-1', 'interaction_sys_id': sysObj.sysid })； } window.localStorage.setItem("screenpopinteraction"，JSON.stringify(sysObj))； }

如果呼叫者信息在CRM中存在，并且没有新事件或未进展事件，则应用程序将打开新事件

更改ServiceNow上的代码

向 WebexCC IMP活动 表添加新列

单击更新。

向电话日志 表添加新列

打开电话日志 表

WebexCC活动转换地图

从过滤器导航器打开转换地图

单击 WebexCC Activity TransformMap

单击更新。

脚本的更改包括

1. 转至filter navigator并搜索“脚本包含”。

   在系统用户界面 下选择脚本包含。

   

2. 使用propUtils 筛选名称。

   

3. 更改方法setWebexcctable。

   

   事件的新示例代码：

   setWebexcctable：函数() { varsys_id=0； var actInfo = JSON.parse(this.getParameter('actInfo'))； var webexcc = new GlideRecordSecure(gs.getProperty('webexccactivitytable'))； webexcc.addQuery(")u_callobject"， actInfo.CallObject)； webexcc.query()； if(！webexcc.next()) { //Activities on Incident Record； //var actInfoString =this.getParameter('actInfo')； var incsysid=actInfo。incident_sys_id； var interactionsysid=actInfo。interaction_sys_id； var incnum=""； var intenum=""；删除actInfo['interaction_sys_id']；删除actInfo['incident_sys_id']； if( interactionsysid！= null && interactionsysid ！= undefined){ var inte = new GlideRecordSecure('interaction')； //inte.get('sys_id'， interactionsysid )； int.addQuery('sys_id'， interactionsysid )； int.query()； if (int.next()) { intenum=int.number； // inte.setValue('state'， 'Closed Complete')； int.work_notes='将状态更新为关闭。'； inte.update()； } } if( incsysid！= null && incsysid ！= undefined){ var inci = new GlideRecordSecure('incident')； inci.addQuery('sys_id'， incsysid )； inci.query()； if (inci.next()) { incnum=inci.number； var jsonPretty = JSON.stringify(actInfo，null，2)； //JSON.stringify(JSON.parse(actInfoString)，null，2)； inci.comments =jsonPretty； inci.update()； } else{ var suser = new GlideRecordSecure("sys_user")； suser.addQuery("phone"， this.getParameter('ani'))； suser.query()； if(suser.next()) { var inc = new GlideRecordSecure('incident')； inc.addQuery('caller_id”””苏塞。sys_id)； inc.addQuery('state'，'IN'，'1，2')； inc.orderByDesc('sys_created_on')； inc.query()； if (inc.next()) { var jsonPretty = JSON.stringify(actInfo，null，2)； inc.comments =jsonPretty； inc.update()； } } } webexcc。u_ani = actInfo.ani； webexcc。u_dnis =actInfo.dnis； webexcc。u_queuename =actInfo.queuename； webexcc。u_wrapuptime =actInfo.wrapuptime； webexcc。u_callduration =actInfo。CallDurationInSeconds； webexcc。u_ringingtime =actInfo.ringingtime； webexcc。u_activitydate =actInfo。ActivityDate； webexcc。u_callobject =actInfo。CallObject； webexcc。u_calltype =actInfo。CallType； webexcc。u_calldisposition=actInfo.CallDisposition； webexcc。u_incidentnumber= incnum； webexcc。u_interactionsnumber= intenum；sys_id=webexcc.insert()； }返回sys_id； }，

UI页面上的方法更改

1. 转至过滤导航并搜索UI页面

   在系统用户界面 下选择UI页面选项。

   

2. 使用名称 筛选用户界面页面，并搜索代理桌面。

   

3. 更改脚本中的nowActivities and screenpop 功能。

   

   当前功能：

   function nowActivities(actInfo， ani) { var gaout = new GlideAjax('propUtils')； gaout.addParam('sysparm_name'， 'setWebexcctable')； gaout.addParam('actInfo'， JSON.stringify(actInfo))； gaout.addParam('ani'， stripPrefixes(ani))； gaout.getXML(SetCCsysId)； 

   事件示例代码：

   function nowActivities(actInfo， ani) { var sysObjstr = window.localStorage.getItem("screenpopinteraction")； if(sysObjstr ！= null && sysObjstr ！= undefined) { var sysObjjson=JSON.parse(sysObjstr)； actInfo。interaction_sys_id=sysObjjson.sysid； actInfo。incident_sys_id=sysObjjson.incsysid； } var gaout = new GlideAjax('propUtils')； gaout.addParam('sysparm_name'，'setWebexcctable')； gaout.addParam('actInfo'， JSON.stringify(actInfo))； gaout.addParam('ani'， stripPrefixes(ani))； gaout.getXML(SetCCsysId)； } function screenpop(callerani，callSessionInfo) { if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani)； } var gaout = new GlideAjax('propUtils')； gaout.addParam('sysparm_name'，'UserGetSysId')； gaout.addParam('field'， 'phone')； gaout.addParam('value'， callerani)； gaout.getXMLWait()； // var sysid = gaout.getAnswer()； var sysObj = JSON.parse(gaout.getAnswer())； if(sysObj.incsysid){ openFrameAPI.openServiceNowForm({ entity：“事件”，查询：'sys_id='+sysObj.incsysid，'interaction_sys_id'：sysObj.sysid })； else{ openFrameAPI.openServiceNowForm({ entity：“事件”，查询：'sys_id=-1', 'interaction_sys_id': sysObj.sysid })； } window.localStorage.setItem("screenpopinteraction"，JSON.stringify(sysObj))； } 

更新后的结果

自定义# 1 -为呼叫流用例添加自定义业务规则

对于ServiceNow中的WebexCC CRM连接器中的每次新呼叫，请创建新的事件记录。

1. 在Filter导航器上搜索业务规则

   

2. 单击“新建”。

   

   供参考的示例代码：

   函数customcti() { var url = null； var name =sysparm_caller_name； eid =sysparm_caller_id； var phone =sysparm_caller_phone； var taskID =sysparm_task_id； var fQuery =sysparm_query；如果(fQuery == null) fQuery = ''； var view =sysparm_view，如果（视图==零）|| view =='') view = "itil"； var userID = null； if (eid ！= null && eid ！='') { userID = UserGetSysId("employee_number"，eid)； }如果(userID == null && name ！= null && name ！='') { userID = UserGetSysId("name"， name)； }如果(userID == null && phone ！= null && phone ！='') { userID = UserGetSysId("phone"， phone)； }如果(userID ！= null) { if (fQuery.length > 0) fQuery += "^"； fQuery += ""caller_id=" + userID； }如果(url == null) { url = "incident.do？sys_id=-1"；如果(fQuery ！= null) url += "&sysparm_query=" + fQuery； }答案= url；返回url； }函数UserGetSysId(field， value) { var user = new GlideRecord("sys_user")； user.addQuery(field， value)； user.query()；如果(user.next())返回用户。sys_id； else return null； }

   业务规则的示例配置

   

3. 启用客户端可呼叫

   

   事件计算机电话集成(CTI)处理 标记为正确。

   

4. 使用自定义CTI规则更新屏幕弹出网址" cti.do？sysparm_cti_rule=createIncident&sysparm_caller_phone="

   

sysparm_cti_rule=name ，其中“name”是函数 的名称将被调用CTI处理 ，而不是使用默认脚本。

在sys_script 标记为客户端可呼叫的条目中定义功能。

如果您必须在函数中插入、更新或删除任何GlideRecord，请呼叫单独的非客户端可呼叫功能以执行更新。

• https://docs.servicenow.com/en-US/bundle/tokyo-application-development/page/script/business-rules/concept/c_BusinessRules.html

• https://docs.servicenow.com/bundle/tokyo-platform-administration/page/integrate/incident/reference/r_ComputerTelephonyIntegration.html

自定义# 2 -在Webex Contact Center活动表中添加CAD变量

本文详细介绍了向ServiceNow表添加额外列的过程，webexcc_activity 该列表是在安装ServiceNow CRM Connector的Webex CC时创建的。

默认情况下，该表包含出箱式系统字段和值。

您可以在WebexCC Flow设计器中创建更多业务特定变量（CAD变量），并在ServiceNow 呼叫后活动日志中添加这些CAD变量，并将其持续到呼叫后活动表 数据中。

1. 在ServiceNow开发者版本中编辑表格。

   

2. 转至 Studio > Webex联系中心。

   

   

   

3. 选择 WebexCC活动 表。

   

4. 例如，CustomerName。

   

   

5. 选择 WebexCC活动的列表布局。

   

示例脚本

查看带有以下内容的线条：webexcc.u_customername=actInfo.CustomerName； 附有支持注释。

var propUtils2 = Class.create()； propUtils2.prototype = Object.extendsObject(global.AbstractAjaxProcessor，{ getWebexccProp ：function () { var webexccprop = {}； webexccprop.instanceurl= 'https：//'+gs.getProperty('instance_name')+'。service-now.com/'； webexccprop.url=gs.getProperty('x_caci_webexcc。agentdesktop_url')； webexccprop.popupurl=gs.getProperty('x_caci_webexcc。screenpop_url')；返回JSON.stringify(webexccprop)； }， setWebexcctable：函数() { varsys_id=0； var actInfo = JSON.parse(this.getParameter('actInfo'))； var webexcc = new GlideRecordSecure(gs.getProperty(')x_caci_webexcc.webexccactivitytable'))； webexcc.addQuery("callobject"， actInfo.CallObject)； webexcc.query()； if(！webexcc.next()) { webexcc.ani = actInfo.ani； webexcc.dnis =actInfo.queuename； webexcc.wrapuptime =actInfo.CallDurationInSeconds； webexcc.ringingtime =actInfo.ActivityDate； webexcc.callobject =actInfo.CallObject； webexcc.calltype =actInfo.CallType； webexcc.calldisposition=actInfo.CallDisposition； //此行已添加-以在webexcc活动日志中捕获它。u_customername=actInfo.CustomerName；sys_id=webexcc.insert()； //事件记录上的活动； var actInfoString =this.getParameter('actInfo')； var suser = new GlideRecordSecure("sys_user")； suser.addQuery("phone"， this.getParameter('ani'))； suser.query()； if(suser.next()) { var inc = new GlideRecordSecure('incident')； inc.addQuery('caller_id”””苏塞。sys_id)； inc.orderByDesc('sys_created_on')； inc.query()； if (inc.next()) { var jsonPretty = JSON.stringify(JSON.parse(acting string)，null，2)； inc.comments =jsonPretty； inc.update()； } } }返回sys_id； }，类型：'propUtils2' })；

在Flow设计器中创建CAD变量

将CAD变量添加到桌面布局

演示屏幕截图

查看WebexCC活动表中新添加的CAD变量。