Professional Documents
Culture Documents
BCM CRM Integration-7-Configuration Guide
BCM CRM Integration-7-Configuration Guide
BCM CRM Integration-7-Configuration Guide
January 2014
Contents
© SAP AG 2014 2
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 3
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 4
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
CAD Handling should bet set to "C" (Inherited / Copied Back) (empty means Not Inherited / Not Copied
Back). This setting affects the interaction record handling when a contact is transferred from agent to
another, ideally the Interaction Record transfers while call transfers. If it is set to "C" then the CAD is set for
the original call. When the transfer is completed, then the CAD is set for the consultation call.
Add Channels for the created entry. Highlight the entry on the right and click on Channels
Select Telephony. Do the same for E-Mail and Chat (if necessary)
© SAP AG 2014 5
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
If you want to use ERMS E-mail Push, then add a second entry ERMS_ACTION. This is in in-built system
name and it does not have to be created manually in transaction CRMM_IC_MCM_CCADM. You can get a
list of available connections with F4
If you want to use web-services to create transactions, then add a third entry FAX_LETTER. Again, this is in
in-built system name and it does not have to be created manually in transaction CRMM_IC_MCM_CCADM.
You can get a list of available connections with F4
© SAP AG 2014 6
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 7
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Configure the options for different Layout Buttons. Generic Layout Buttons are not tied to a particular
communication channel. If a button is configured under the Generic Layout Button section, this button will
always be displayed irrespective of the call state.
Here you can indicate which buttons should be shown for all the channels. More buttons can be added here
if required. ButtonPos indicates the sequence of the particular button in the toolbar. Display provides 3
choices:
Text – The button is rendered with the text label corresponding to the ButtonID
Icon – The button is rendered with the icon corresponding to the ButtonID
Text and Icon – The button is rendered with both text and icon corresponding to the ButtonID
The above buttons can be individually chosen to be displayed in the following 3 states:
Logged Off – The current user is not Logged In to the Communication Management System
Idle – The current user is not participating in a call
Busy – The current user is participating in a call
© SAP AG 2014 8
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Start-Up component are the entries for starting up the service components of the business role. The start-up
components are the list of classes defined for a business role. These classes get instantiated and initialized
when the application with the particular business role is started. The start-up components could be defined
either for the worker session or for the agent session and get initialized accordingly. The classes for the
worker session get initialized first and then for the agent session.
© SAP AG 2014 9
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
By default the CMS_ROLE function profile will be delivered with several entries. Generally, you will not need
to change the default delivery entries unless you want to disable some functionality. For example, if the
business partner determination should not be performed, select “Inactive” flag for the component
“BUSINESS PARTNER IDENTIFICATION” and no BP search will be performed when an incoming call
arrives.
For the BUSINESS PARTNER IDENTIFICATION component the class
CL_CRM_IC_FW_BP_SEARCH_SRV does a business partner search for the incoming channel address. If
the search has to be done on employees rather than business partners then the class needs to be replaced
with CL_CRM_IC_FW_EMP_SEARCH_SRV which does an employee search based on the incoming
channel address.
UI Navigation Mapping - this configuration allows the UI to react to the communication channel events. For
example, with the configuration above, once a contact (e.g. phone call) is ended, it should navigate to and
create the Interaction Log.
The user needs to provide the MCM Event, Channel, UI Object Type, UI Object Action and Entity Provider
class.
The MCM event is the event on the occurrence of which the navigation is triggered.
The Channel specifies the Communication channel for which the navigation takes place.
The UI Object Type and UI Object Action are required for the successful navigation to the required object.
The Entity Provider Class is provided by the customer which implements the interface
IF_CRM_IC_FW_COMM_EVENT_NAV. This interface has a method GET_NAVIGATION_TARGET which
the customer can implement and return the desired navigation parameters. In the absence of such a class
the UI Object Type and UI Object Action specified above are used for navigation.
© SAP AG 2014 10
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 11
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Assign the Toolbar Profile you have just created to the Function Profile ID WBAR
© SAP AG 2014 12
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
If you want to map a CRM user to a different BCM user, add the CRM user information to the CRM Logon
Name field.
© SAP AG 2014 13
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 14
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 15
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Open the folder Assign Function Profiles for this Business Role.
Assign function profile CMS_ROLE
Assign function profile CONTEXTAREA
Assign function profile CRMUI_MPLAYOUT (Main Page Layout)
Assign function profile WBAR
Optional: Assign function profile EMAIL (only to remove the error message if you are using email component)
The CRM business role should now start with communication toolbar and linked to BCM.
© SAP AG 2014 16
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 17
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Click on Configurations. Note there is no Binding or Endpoint set up for this service – the field Select Binding
is empty
© SAP AG 2014 18
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Click on Create
© SAP AG 2014 19
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Scroll down to Provider Security and enable the User ID/Password field under Transport Channel
Authentication
In this sample implementation, User ID/Password is being used as the authentication method. Certificate-
based authentication can also be use but it is not described in this document.
© SAP AG 2014 20
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 21
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Click on Overview again. Now the field Select Binding is filled. Click on Open WSDL document for selected
binding or service.
A new browser window opens. Copy the url and save this. This is the url that will be entered as the
parameter Z_Soap_LookupBPviaTelNumber_wsdl in step 2
© SAP AG 2014 22
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 23
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Go to Queue Management –> Prompt and create a new Prompt. Select In Queue Message as the Prompt
Type
Enter the Name and select the Loop Type All Steps
© SAP AG 2014 24
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
And then select the Prompt file. Enter the Description string IVR* and select the appropriate Prompt File
© SAP AG 2014 25
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Add a Number for your IVR, make it Active against a CEM Instance and Click on Import under Custom-Made
IVR Versions
Navigate to the folder with the CRM BP Lookup IVR file, highlight the CRM BP Lookup IVR XML file and
Click on Open
© SAP AG 2014 26
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Navigate to the folder with the CRM BP Lookup IVR file, highlight the IVR_Customize.py file and Click on
Open
© SAP AG 2014 27
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
4. Add parameters
Expand Parameters and add 6 parameters
AvailableLanguages ("CS","DA","DE","EN","enUK","ES","FI","FR","HU","IT","JA","NL","NO","PL","PT","RU","SK","SV","TR","ZH")
BP_Confirmed Yes or No
DefaultLanguage One of the available Language keys as your Default Language
Z_QueueNumber Number of the Queue you want calls to go to
Z_Soap_LookupBPviaID_wsdl Url for the Soap service endpoint “CustomerCRMByIDQueryResponse_In”
Z_Soap_LookupBPviaTelNumber_wsdl Url for the Soap service endpoint “BusinessPartnerCRMElementsByElementsQueryResponse_In”
© SAP AG 2014 28
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 29
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Expand the form Form_Welcome_Prompt and block Play_Start_Prompt and click on the audio element.
Remove the text in the Audio File Expression field and select the correct value from the drop-down in the
Prompt field. Don’t forget to click on Apply to save your settings!
Do the same audio element under the form Form_Get_Customer_ID, field Get_Customer_ID
© SAP AG 2014 30
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
And the same for the audio element under the form Form_Soap_LookupBPviaID, block
AssignValues_Soap_LookupBPviaID, if, else
And the same for the audio elements under the form Form_Get_Customer_ID_Input_Error, field
Get_Customer_ID_Input_Error
© SAP AG 2014 31
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 32
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 33
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Expand the form Form_Soap_LookupBPviaID and click on the soap element Soap_LookupBPviaID. Again
maintain the User Name and Password fields
© SAP AG 2014 34
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 35
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Create a group for the CAD Application ID used by your BCM system (normally SAP_BCM/OII). The profile
can be found in the BCM System Configurator but is set using BCM Infrastructure Administrator
© SAP AG 2014 36
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Create all the attributes for your CAD. You are free to create your own attributes that you are using in your
own IVR. Check Fact Gathering flag for any attribute that you wish to use for your alert(s).
© SAP AG 2014 37
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
The description is used in the Contact Attached Data workcenter in the IC WebClient
Create a second group for the Application ID used by CRM for Business Partner Identification
(CRM_IC/BUPA) if you are identifying the caller in the your IVR.
© SAP AG 2014 38
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Add the attributes for your CAD entries you highlighted to be used for Fact Gathering. If you don’t want to
restrict the operators that can be used when testing for a value of this attribute in a rule policy to EQUALS,
NEQUALS, GREATERTHAN, NGREATERTHAN, LESSTHAN and NLESSTHAN, then leave the Attribute
Extension Class field blank. Otherwise enter CL_CRM_ERMS_ATTR_EXT_EQUALS in the Attribute
Extension Class field.
4. Event ContactStarted
Transaction CRMC_IC_EVENT_REP
Select CRM_IC Event and click on Events
© SAP AG 2014 39
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 40
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
6. Create Alert
Log into CRM as the IC Manager
Go to Alerts and click on New. Enter the Name Z_BCM_CAD1 and select Fact Base in the dropdown
You will see the Attributes you created in the Fact Base in the second dropdown:
You may wish to build the alert completely in your IVR using a custom state. In this example, we are using
the AttributesCAD: Alert line 1 and CAD: Alert line 2 as the text for two different alerts.
© SAP AG 2014 41
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 42
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Go to Rule Policies. Click on New and select Intent Driven Interaction (IC WebClient)
Add any Business Role that will use this Rule Policy and the IC Event that will trigger this Rule Policy
(ContactStarted)
Create a folder under Draft Rules and rule in this new folder (here CAD rule folder and BCM CAD)
© SAP AG 2014 43
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Enter the conditions for the Rule using the Attribute Current Event and value Contact arrives and the action
Trigger Alert with the value of Alert Name the alert you configured in the previous step.
Then you should see a screen similar to this. Save the Rule Policy
© SAP AG 2014 44
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 45
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Data Type is CHAR with maximum 4 characters. Save the Domain – you will need to assign this to a
package and make a customising request
© SAP AG 2014 46
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 47
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 48
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 49
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Add the Field Labels and Save the Data Element – you will need to assign this to a package and make a
customising request
© SAP AG 2014 50
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 51
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 52
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 53
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Add the fields. Now you can see where the new Domain and Data Type Z_TERMID is used. Save the table
– you will need to assign this to a package and make a customising request
© SAP AG 2014 54
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 55
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Create table ZOPTION_ROLES in similar way. This table is used to determine which Business Roles can
use this auto-classification feature.
© SAP AG 2014 56
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 57
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
DATA:
lr_coll TYPE REF TO if_bol_bo_col,
lr_entity TYPE REF TO CL_CRM_BOL_ENTITY,
lr_subject TYPE REF TO CL_CRM_BOL_ENTITY,
lr_current TYPE REF TO if_bol_bo_property_access,
lr_bol_core TYPE REF TO cl_crm_bol_core,
ls_object TYPE crmt_erms_cat_ob,
lv_product_guid TYPE comt_product_guid,
lt_ob_ln TYPE CRMT_ERMS_CAT_OB_LN_TAB,
ls_ob_ln TYPE CRMT_ERMS_CAT_OB_LN,
lv_guid TYPE CRM_ERMS_CAT_GUID,
lv_conc_key TYPE char20.
© SAP AG 2014 58
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
if ls_cad_list-item_name = 'Z_TermID'.
* lv_zoption = ls_cad_list-item_value.
lv_termid = ls_cad_list-item_value.
endif.
endloop.
if lr_subject is bound.
lr_subject->set_property( iv_attr_name = 'CONC_KEY'
"#EC NOTEXT
iv_value = lv_conc_key ).
endif.
© SAP AG 2014 59
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
lv_guid = ls_cat-cat_guid.
lr_bol_core ?= cl_crm_bol_core=>get_instance( ).
if lr_bol_core is bound.
lr_bol_core->modify( ).
endif.
*
*} INSERT
endmethod.
© SAP AG 2014 60
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
* if order has changed, publish the new subject code to the category controller
lr_btadminh ?= typed_context->BTAdminH->collection_wrapper->get_current( ).
lr_case ?= typed_context->CmgCase->collection_wrapper->get_current( ).
lr_current ?= typed_context->inputkeys->collection_wrapper->get_current( ).
IF lr_current IS BOUND.
CALL METHOD lr_current->set_property
EXPORTING
iv_attr_name = 'DISPLAY_MODE'
iv_value = abap_true.
CALL METHOD lr_current->set_property
EXPORTING
iv_attr_name = 'PERS_GUID'
iv_value = ls_input-pers_guid.
ENDIF.
* publish the deletion to the category controller
CALL METHOD gr_cucocat->if_bol_bo_property_access~set_property
EXPORTING
iv_attr_name = gv_cat_attr
iv_value = lv_cat_guid.
gr_cucocat->initialize( ).
clear gv_last_cat_guid.
endif.
IF lr_btadminH is bound.
* binding to order
CALL METHOD lr_btadminh->GET_PROPERTY_AS_VALUE
EXPORTING
IV_ATTR_NAME = 'GUID'
"#EC NOTEXT
IMPORTING
EV_RESULT = lv_order_guid.
gv_last_order_guid = lv_order_guid.
init_categories( ).
lv_update_input = abap_true.
endif.
if gr_aspect is bound.
CALL METHOD lr_btadminh->get_property_as_value
EXPORTING
iv_attr_name = 'CREATED_AT'
"#EC NOTEXT
IMPORTING
© SAP AG 2014 61
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
ev_result = lv_timestamp.
*} INSERT
endif.
endif.
endif.
lr_entity ?= lr_btadminH.
ELSE.
if lr_case is bound.
* binding to case
CALL METHOD lr_case->GET_PROPERTY_AS_VALUE
EXPORTING
IV_ATTR_NAME = 'CASE_GUID'
"#EC NOTEXT
IMPORTING
EV_RESULT = lv_case_guid.
gv_last_case_guid = lv_case_guid.
init_categories( ).
lv_update_input = abap_false.
endif.
lr_entity ?= lr_case.
endif.
ENDIF.
if lr_entity is bound.
lr_current ?= typed_context->inputkeys->collection_wrapper->get_current( ).
if lr_entity->is_changeable( ) = abap_true.
if lr_current is bound.
call method lr_current->set_property EXPORTING iv_attr_name = 'DISPLAY_MODE'
iv_value = abap_false.
endif.
else.
if lr_current is bound.
call method lr_current->set_property EXPORTING iv_attr_name = 'DISPLAY_MODE'
iv_value = abap_true.
endif.
© SAP AG 2014 62
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
endif.
endif.
IF lv_update_input = abap_true.
* this is performed if the page has been entered and the order or case did not change
gv_update_input = abap_false.
lr_current ?= typed_context->inputkeys->collection_wrapper->get_current( ).
IF lr_current IS BOUND.
CALL METHOD lr_current->set_property
EXPORTING
iv_attr_name = 'PERS_GUID'
iv_value = gv_last_cat_guid.
ENDIF.
ENDIF.
endmethod.
© SAP AG 2014 63
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
5. Add the CAD Terms used in your IVR to the table ZOPTION
Transaction SE16
Enter the following fields:
© SAP AG 2014 64
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
The auto-classification feature can use an existing categorization schema. Here is the example from Client
770. Note the entries in table ZOPTION for:
CODE_CAT: Catalog
CODE_GRP: Code Group
CODE_ID: Code
6. Restrictions
For the moment, auto-categorisation only works for older CRM objects such as Service Ticket which use the
categorization component, ICCMP_BT_CAT. We are working on an implementation for BTCATEGORIES,
the component used in newer CRM objects such as Service Request, Incident and the newest Complaint.
© SAP AG 2014 65
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Click on Search
© SAP AG 2014 66
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 67
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
If this fails, check that the port 3300 + the instance of the SAP system is open for communication from your
BCM server. So in the above example, port 3320 should be opened.
© SAP AG 2014 68
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 69
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 70
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Click on Continue
Check the Server is ready for use checkbox and carry out the connection test
© SAP AG 2014 71
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Click on Continue
© SAP AG 2014 72
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
4. Maintain Call-Lists
Transaction CRMD_TM_CLDIST
You can now create call-lists and send them to BCM. You just need to set the Execution mode to Automated
and select the Server name you have configured in this step in the Dialer field.
© SAP AG 2014 73
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
After saving your changes, activate the Call-List by right-clicking on the Call-List name and selecting Activate
Click on Continue
© SAP AG 2014 74
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 75
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
1. E-Mail Profile
Transaction CRMC_IC_EMAILX
Create or edit an existing E-Mail Profile. Make sure that the E-Mail Provider is set to ICI
© SAP AG 2014 76
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Assign the E-Mail Profile you created to the Function Profile ID EMAIL
© SAP AG 2014 77
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 78
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Assign the E-Mail Profile you created to the Function Profile ID EMAIL
© SAP AG 2014 79
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 80
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 81
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 82
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 83
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Add a new Attribute Z_TO_ADDRESS. Make sure you use this exact name add the values FG_EMAIL in
the Fact Gathering Service field. Enter CL_CRM_ERMS_ATTR_EXT_EQUALS in the Attribute Extension
Class field. Make sure the Allow Set Value box is checked.
Add any other Attributes you would like to use in the Rule Policy Editor. These attributes can be used a
Contact Attached Data. For example, here we have created an e-mail category:
You could also set up Attributes to collect the e-mail subject, original e-mail recipient (i.e. the e-mail address
the mail was sent to) or the e-mail sender. See the chapter: Configure CAD based Alerts for new ERMS
Push E-mails in CRM
Go to Rule Policies and click on New or choose an existing policy. Use the context E-Mail Response
Management System.
© SAP AG 2014 84
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
The policy should be the same as the Service Manager Profile entered earlier in Step 3 – in this case
DEFAULT
Create a rule in this new folder (here ERMS_ACTION_BCM and ERMS_BCM_RED). Enter the conditions
for the Rule using the Attribute E-Mail Original Recipient and setting the Value to the e-mail address you set
up in step 1.
© SAP AG 2014 85
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Add the Action Set Attribute Value, select the Attribute BCM Queue E-Mail Address and add the e-mail
address of the BCM Queue you want to use (here BCM_RED_SUPPORT@BCMDEMO.SAP.CORP). The
e-mail address does not have to be a valid e-mail address that can receive and send mail from outside, it is
purely used for routing purposes.
Add the Action Add Routing Attribute for Push E-Mail and select the Fact Base Attribute BCM Queue E-Mail
Address.
© SAP AG 2014 86
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
If you want to also put the e-mail in an Inbox, then add the entry Route Email using the Organization Object
to which your IC Agents belong (here BestRun BCM Call Center).
© SAP AG 2014 87
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
You can add more rules and conditions to add other options. In this example, an auto-acknowledgement is
being sent and the Fact Base Attributes E-Mail Original Recipient and E-Mail Subject are being added to the
Routing Attributes so that they can be included in the Contact Attached Data when the mail is pushed to an
agent.
© SAP AG 2014 88
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
The first sub-rule checks for the key word Complaint (Beschwerde in German) in both the e-mail subject line
and the e-mail body and categorises the e-mail as Complaint and sets the BCM Queue to a second-level
queue. Note the Action Stop Further Rule Processing at the end.
© SAP AG 2014 89
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
The second sub-rule checks for some “sales language” and categorises the e-mail as Sales and set the BCM
Queue to the Sales Queue.
© SAP AG 2014 90
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
The third sub-rule is the default rule categorising the e-mail as Other and setting the BCM Queue to the
Support Queue.
© SAP AG 2014 91
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Address: email address used in the ERMS Rule Policy (here bcm_red_sales@bcmdemo.sap)
© SAP AG 2014 92
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 93
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
First check that the settings entered in step 5 are correct. The e-mail address for the Receiver/Address
should be shown here:
Next you can see that the ERMS rule execution was performed. Double-click on the line ERMS1.
© SAP AG 2014 94
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Click on Actions and you should see that the rule has been executed.
© SAP AG 2014 95
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
© SAP AG 2014 96
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
After sending a test mail, enter the user WF-BATCH and select the Time Period: The last two hours
© SAP AG 2014 97
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
<processingStatus>
<id />
<description />
</processingStatus>
<actionItemStatus>
<id />
<description />
</actionItemStatus>
<actionItemAttributes>-
<item>
<id>SUBJECT</id>
<description>Test from Mark</description>
</item>
<item>
<id>SUBJECT_CHARSET</id>
<description />
</item>
<item>
<id>SEND_DATE</id>
<description>20120430134418</description>
</item>
<item>
<id>SENSITIVITY</id>
<description />
</item>
<item>
<id>IMPORTANCE</id>
<description />
</item>
<item>
<id>MAIL_ID</id>
<description>AA944E36AE627F4C9099976E5BE4847C07A6CD2369@DEWDFECCR06.wdf.sap.corp</description>
</item>
<item>
<id>FROM_NAME</id>
<description>mark.tate-smith@sap.com</description>
</item>
<item>
<id>FROM_ADDRESS</id>
<description>mark.tate-smith@sap.com</description>
</item>
<item>
<id>TO_NAME</id>
<description>bcm_red@dez.r3.sap-ag.de</description>
</item>
<item>
<id>TO_ADDRESS</id>
<description>bcm_red@dez.r3.sap-ag.de</description>
</item>
</actionItemAttributes>
</itemData>
© SAP AG 2014 98
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
<routingAttributes xmlns="urn:IciActionItemInterface">-
<item>
<name>Z_TO_ADDRESS</name>
<value>BCM_RED_SUPPORT@BCMDEMO.SAP.CORP</value>
</item>
<item>
<name>Z_EMAIL_CATEGORY</name>
<value>Other</value>
</item>
<item>
<name>MAIL_RECIPIENT</name>
<value>BCM_RED@DEZ.R3.SAP-AG.DE</value>
</item>
<item>
<name>MAIL_SUBJECT</name>
<value>Test from Mark</value>
</item>
<item>
<name>Z_TO_ADDRESS</name>
<value>BCM_RED_SUPPORT@BCMDEMO.SAP.CORP</value>
</item>
</routingAttributes>
<scenarioId xmlns="urn:IciActionItemInterface" />
</ns0:route>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
© SAP AG 2014 99
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios
Select the group for the CAD Application ID used by your BCM system (normally SAP_BCM/OII). Highlight
your group and click on Attributes. Create your e-mail attributes, enabling the Fact Gathering flag for any you
wish to be included in your alert(s).
CA_LANG E-Mail Language
MAIL_RECIPIENT E-Mail Original Recipient
MAIL_SUBJECT E-Mail Subject
Z_TO_ADDRESS BCM Queue E-Mail Address for routing
Z_EMAIL_CATEGORY E-Mail Category determined by ERMS
The description is used in the Contact Attached Data workcenter in the IC WebClient
Add the attributes for your CAD entries you highlighted to be used for Fact Gathering. If you don’t want to
restrict the operators that can be used when testing for a value of this attribute in a rule policy to EQUALS,
NEQUALS, GREATERTHAN, NGREATERTHAN, LESSTHAN and NLESSTHAN, then leave the Attribute
Extension Class field blank. Otherwise enter CL_CRM_ERMS_ATTR_EXT_EQUALS in the Attribute
Extension Class field.
ZCAD_CA_LANG CAD: E-Mail Language /parts/SAP_BCM/OII/CA_LANG/text()
ZCAD_MAIL_RECIPI CAD: E-Mail Original Recipient /parts/SAP_BCM/OII/MAIL_RECIPI/text()
ZCAD_MAIL_SUBJEC CAD: E-Mail Subject /parts/SAP_BCM/OII/MAIL_SUBJEC/text()
ZCAD_MAIL_CATEGO CAD: E-Mail Category /parts/SAP_BCM/OII/Z_MAIL_CATEGORY/text()
3. Create Alert
Log into CRM as the IC Manager
Enter a new and description and select Fact Base in the dropdown
You will see the Attributes you created in the Fact Base in the second dropdown:
It is also possible to create your own alerts using the other Attributes if required using a mixture of text and
the dropdowns. Click on Insert Attribute to add the selected attribute where you need it.
If
E-Mail Original Recipient Contains "BCM_FUSHIA@DTZ.R3.SAP-AG.DE"
Then
Send Auto Acknowledgement ( Mail Form = Auto Acknowledge; Outgoing E-Mail Address = bcm_fushia@dtz.r3.sap-ag.de; Create
Interaction Record = No; Create Service Order = No ) and
Route EMail ( Organizational Object = BestRun BCM Call Center ) and
Add Routing Attribute for Push E-Mail ( Fact Base Attribute = E-Mail Original Recipient ) and
Add Routing Attribute for Push E-Mail ( Fact Base Attribute = Content Analysis: Language ) and
Add Routing Attribute for Push E-Mail ( Fact Base Attribute = E-Mail Subject )
If
E-Mail Original Recipient Contains "BCM_FUSHIA@DTZ.R3.SAP-AG.DE"
Then
Set Attribute Value ( Attribute = BCM Queue E-Mail Address for routing; Value = "bcm_fushia_support@bcmdemo.sap.corp" ) and
Set Attribute Value ( Attribute = E-Mail Category determined by ERMS; Value = "Support" ) and
Add Routing Attribute for Push E-Mail ( Fact Base Attribute = BCM Queue E-Mail Address for routing ) and
Add Routing Attribute for Push E-Mail ( Fact Base Attribute = E-Mail Category determined by ERMS ) and
Push EMail to IC WebClient Agent and
Stop Further Rule Processing
Go to Rule Policies. Click on New and select Intent Driven Interaction (IC WebClient)
Add any Business Roles that will use this Rule Policy and the IC Event that will trigger this Rule Policy
(ContactStarted)
Create a folder under Draft Rules and rule in this new folder (here CAD rule folder and BCM CAD)
Enter the conditions for the Rule using the Attribute Current Event and value Contact arrives and the action
Trigger Alert with the value of Alert Name the alert you configured in the previous step.
Then you should see a screen similar to this. Save the Rule Policy
5. Send an e-mail
You should see the alerts when the call is allocated to your agent.
As of BCM 7 SP4, the sample Internet Chat Client application supports the processing of the ChatSourceUrl
parameter sent as an argument to the Chat client.
http://bcmchat.myapp.corp/ChatAS/Chatform.aspx?ChatSourceUrl=”http://mywebpage.corp”
Create a new Contact Attached Data Group called Customer. Highlight your group and click on Attributes.
Create your chat attributes, enabling the Fact Gathering flag for any you wish to be included in your alert(s).
Customer Contact Attached Data Group
ChatSourceUrl URL from where caller started the chat
The description is used in the Contact Attached Data workcenter in the IC WebClient
Add the attributes for your CAD entries you highlighted to be used for Fact Gathering. If you don’t want to
restrict the operators that can be used when testing for a value of this attribute in a rule policy to EQUALS,
NEQUALS, GREATERTHAN, NGREATERTHAN, LESSTHAN and NLESSTHAN, then leave the Attribute
Extension Class field blank. Otherwise enter CL_CRM_ERMS_ATTR_EXT_EQUALS in the Attribute
Extension Class field.
ZCAD_CHATSRCEURL CAD: Chat Source url /parts/Customer/ChatSourceUrl/text()
3. Create Alert
Log into CRM as the IC Manager
Enter a new and description and select Fact Base in the dropdown
You will see the Attributes you created in the Fact Base in the second dropdown:
It is also possible to create your own alerts using the other Attributes if required using a mixture of text and
the dropdowns. Click on Insert Attribute to add the selected attribute where you need it.
Go to Rule Policies. Click on New and select Intent Driven Interaction (IC WebClient)
Add any Business Roles that will use this Rule Policy and the IC Event that will trigger this Rule Policy
(ContactStarted)
Create a folder under Draft Rules and rule in this new folder (here CAD rule folder and BCM CAD)
Enter the conditions for the Rule using the Attribute Current Event and value Contact arrives and the action
Trigger Alert with the value of Alert Name the alert you configured in the previous step.
Then you should see a screen similar to this. Save the Rule Policy
If an entry with Config Key CMS_ROLE exists, select that entry, otherwise click on Copy Configuration and
copy the <Default> entry to CMS_ROLE
Select Collaboration and Presence from Available Fields and transfer them to Displayed Fields. You can
move the fields up in order by simply dragging and dropping them
Click on Save
Add the Set Parameter Action. You need to add 3 Action Parameters for this
Go to Rule Policies. Click on New and select the Context ‘Order Routing’.
Add entries as in the example below. Save and release the rules
Business Process Push will now be available when the agent clicks Escalate in the Service Ticket
Add the Set Parameter Action. You need to add 3 Action Parameters for this
Go to Rule Policies. Click on New and select the Context ‘Service Request Management’.
Service Teams were created in Organisational Management. This is to ensure the Service Request goes to
the right Agent Group.
Add entries as in the example below. Save and release the rules
Business Process Push will now be available when the agent clicks Dispatch in the Service Request or
Incident
Copyright
© Copyright 2013 SAP AG. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or for any purpose without the
express permission of SAP AG. The information contained herein may be changed without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietary software components
of other software vendors.
Microsoft, Windows, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390,
OS/400, iSeries, pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, and
Informix are trademarks or registered trademarks of IBM Corporation in the United States and/or other
countries.
®
ORACLE is a registered trademark of ORACLE Corporation.
® ® ® ®
UNIX , X/Open , OSF/1 , and Motif are registered trademarks of the Open Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or
registered trademarks of Citrix Systems, Inc.
®
HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C , World Wide Web
Consortium, Massachusetts Institute of Technology.
®
JAVA is a registered trademark of Sun Microsystems, Inc.
®
JAVASCRIPT is a registered trademark of Sun Microsystems, Inc., used under license for technology
invented and implemented by Netscape.
SAP, R/3, mySAP, mySAP.com, xApps, xApp, and other SAP products and services mentioned herein as
well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several
other countries all over the world. All other product and service names mentioned are the trademarks of their
respective companies. Data contained in this document serves informational purposes only. National product
specifications may vary.
These materials are subject to change without notice. These materials are provided by SAP AG and
its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of
any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only
warranties for SAP Group products and services are those that are set forth in the express warranty
statements accompanying such products and services, if any. Nothing herein should be construed as
constituting an additional warranty.
®
SQL Server is a registered trademark of Microsoft Corporation.
SEE4C (SMTP/POP3 Email Engine Library for C/C++) is the copyright of - MarshallSoft Computing, Inc.
Victor Image Processing Library and VIC32 are trademarks of Catenary Systems. The Victor Image Processing Library is
copyright material. This includes the source code, object code, dlls, examples, and documentation. This material is
protected by United States copyright law as well as international copyright treaty provisions.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/) and
Info-Zip (http://www.info-zip.org/pub/INFO-ZIP/).
This software consists of voluntary contributions made by many individuals on behalf of the Apache Software
Foundation and was originally based on software copyright (c) 1999, International Business Machines, Inc.,
http://www.ibm.com. For more information on the Apache Software Foundation, please see
<http://www.apache.org/>.
SAP and/or its distributors may offer, and charge a fee for, warranty, support, indemnity or liability obligations
to one or more recipients of the software. However, SAP and/or its distributors may do so only on its/their
own behalf, and not on behalf of the Apache Software Foundation or its contributors.
UNZIP. This is version 2003-May-08 of the Info-ZIP copyright and license. The definitive version of this
document should be available at ftp://ftp.info-zip.org/pub/infozip/license.html indefinitely.
Copyright (c) 1990-2003 Info-ZIP. All rights reserved.
For the purposes of this copyright and license, "Info-ZIP" is defined as the following set of individuals:
Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-Michel Dubois, Jean-loup Gailly, Hunter Goatley,
Ian Gorman, Chris Herborth, Dirk Haase, Greg Hartwig, Robert Heath, Jonathan Hudson, Paul Kienitz, David
Kirschbaum, Johnny Lee, Onno van der Linden, Igor Mandrichenko, Steve P. Miller, Sergio Monesi, Keith
Owens, George Petrov, Greg Roelofs, Kai Uwe Rommel, Steve Salisbury, Dave Smith, Christian Spieler,
Antoine Verheijen, Paul von Behren, Rich Wales, Mike White
This software is provided "as is," without warranty of any kind, express or implied. In no event shall Info-ZIP
or its contributors be held liable for any direct, indirect, incidental, special or consequential damages arising
out of the use of or inability to use this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and
to alter it and redistribute it freely, subject to the following restrictions:
Redistributions of source code must retain the above copyright notice, definition, disclaimer, and this list of
conditions.
Redistributions in binary form (compiled executables) must reproduce the above copyright notice, definition,
disclaimer, and this list of conditions in documentation and/or other materials provided with the distribution.
The sole exception to this condition is redistribution of a standard UnZipSFX binary (including SFXWiz) as
part of a self-extracting archive; that is permitted without inclusion of this license, as long as the normal SFX
banner has not been removed from the binary or disabled.
Altered versions--including, but not limited to, ports to new operating systems, existing ports with new
graphical interfaces, and dynamic, shared, or static library versions--must be plainly marked as such and
must not be misrepresented as being the original source. Such altered versions also must not be
misrepresented as being Info-ZIP releases--including, but not limited to, labeling of the altered versions with
the names "Info-ZIP" (or any variation thereof, including, but not limited to, different capitalizations), "Pocket
UnZip," "WiZ" or "MacZip" without the explicit permission of Info-ZIP. Such altered versions are further
prohibited from misrepresentative use of the Zip-Bugs or Info-ZIP e-mail addresses or of the Info-ZIP URL(s).
Info-ZIP retains the right to use the names "Info-ZIP," "Zip," "UnZip," "UnZipSFX," "WiZ," "Pocket UnZip,"
"Pocket Zip," and "MacZip" for its own source and binary releases.
MarketSet and Enterprise Buyer are jointly owned trademarks of SAP AG and Commerce One.
SAP, SAP Logo, R/2, R/3, mySAP, mySAP.com, and other SAP products and services mentioned herein as
well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several
other countries all over the world. All other product and service names mentioned are the trademarks of their
respective companies.
this source may not be called ACE(TM) or TAO(TM), nor may the name Washington University, UC Irvine, or
Vanderbilt University appear in their names, without express written permission from Washington University,
UC Irvine, and Vanderbilt University.