BCM CRM Integration-7-Configuration Guide

You might also like

Download as pdf or txt
Download as pdf or txt
You are on page 1of 126

Wu

SAP BCM & SAP CRM


Configuration Guide for
Integration Scenarios

January 2014

SAP BCM 7 and


SAP CRM 7.0
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Contents

Connect SAP CRM to SAP BCM ..................................................................................................................... 4


1. Create ICI RFC Connection to SAP BCM ............................................................................................ 4
2. Make Settings for Communication Management Systems................................................................... 5
3. Define Connections for Communication Management Software ......................................................... 6
4. Define Communication Management Software Profiles ....................................................................... 7
5. Assign Communication Management Systems to Profiles ................................................................... 7
6. Define Toolbar Profile ........................................................................................................................... 8
7. CMS Integration Profiles ....................................................................................................................... 9
8. Soft Phone Link Configuration ............................................................................................................ 11
9. Business Role Configuration .............................................................................................................. 11
10. Assign the Business Role to your SAP CRM User ............................................................................. 12
11. Set up Users ....................................................................................................................................... 13
12. Test the Business Role ....................................................................................................................... 13
Communication Management Software for all Business Roles ............................................................... 15
1. Define Toolbar Profile ......................................................................................................................... 15
2. Business Role Configuration .............................................................................................................. 15
IVR to identify Callers from SAP CRM ......................................................................................................... 17
1. Create endpoints for standard CRM Web Services ........................................................................... 17
2. Add the IVR Prompts .......................................................................................................................... 23
3. Import CRM BP Lookup IVR ............................................................................................................... 26
4. Add parameters .................................................................................................................................. 28
5. Link the Prompts ................................................................................................................................. 29
6. Maintain Soap Username and Password ........................................................................................... 34
Configure CAD based Alerts for new calls in SAP CRM ........................................................................... 36
1. Configure CRM to accept the CAD ..................................................................................................... 36
2. Add the CAD Profile to Business Role ............................................................................................... 38
3. Configure Fact Base entries for CAD in CRM .................................................................................... 39
4. Event ContactStarted.......................................................................................................................... 39
5. Configure BCM to send the CAD ........................................................................................................ 40
6. Create Alert ......................................................................................................................................... 41
7. Intent Driven Interaction Rule Policy .................................................................................................. 43
8. Make a call to your IVR ...................................................................................................................... 45
Automatic Categorisation via IVR ................................................................................................................ 46
1. Tables ZOPTION and ZOPTION_ROLES.......................................................................................... 46
2. Methods ZMAPCADTOCAT & DO_PREPARE_OUTPUT ................................................................. 58
3. Add Business Role in Table ZOPTION_ROLES ................................................................................ 63
4. Add the CAD Profile to Business Role ............................................................................................... 64
5. Add the CAD Terms used in your IVR to the table ZOPTION ............................................................ 64
6. Restrictions ......................................................................................................................................... 65
Outbound Campaigns and Automatic Dialing ............................................................................................ 66
1. Create SAPphone connection in BCM ............................................................................................... 66
2. Create SAPphone RFC Connection ................................................................................................... 67
3. Create SAPphone Server ................................................................................................................... 68
4. Maintain Call-Lists .............................................................................................................................. 73

© SAP AG 2014 2
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

SAP BCM E-Mail (ICI E-Mail) ......................................................................................................................... 76


1. E-Mail Profile ...................................................................................................................................... 76
2. Business Role Configuration .............................................................................................................. 76
3. Configure BCM to retrieve e-mails ..................................................................................................... 77
SAP CRM ERMS push E-Mail ....................................................................................................................... 78
1. E-Mail Profile ...................................................................................................................................... 78
2. Business Role Configuration .............................................................................................................. 78
3. Define Receiving E-mail Addresses in SAP CRM .............................................................................. 79
4. Enable SAP Business Object Instance............................................................................................... 79
5. Maintain Recipient Distribution ........................................................................................................... 80
6. Assign Service Management Profile ................................................................................................... 82
7. Maintain Communication Management Software Connections ......................................................... 83
8. Define ERMS Repository .................................................................................................................... 83
9. Set up ERMS rules ............................................................................................................................. 84
10. Configure BCM to route ERMS e-mails .............................................................................................. 92
11. Debugging - Check that e-mails arrive in CRM .................................................................................. 93
12. Debugging - Check the Work Items.................................................................................................... 93
13. Debugging - Check the outstanding e-mails ...................................................................................... 95
14. Debugging - Check the ICI Trace ....................................................................................................... 96
15. Debugging - Check the BCM OII log .................................................................................................. 99
Configure CAD based Alerts for new ERMS push E-mails in SAP CRM ............................................... 101
1. Configure CRM to accept the CAD ................................................................................................... 101
2. Configure Fact Base entries for CAD in CRM .................................................................................. 103
3. Create Alert ....................................................................................................................................... 103
4. Intent Driven Interaction Rule Policy ................................................................................................ 105
5. Send an e-mail.................................................................................................................................. 107
Configure CAD based Alerts for new Chats in SAP CRM ....................................................................... 108
1. Configure CRM to accept the CAD ................................................................................................... 108
2. Configure Fact Base entries for CAD in CRM .................................................................................. 110
3. Create Alert ....................................................................................................................................... 110
4. Intent Driven Interaction Rule Policy ................................................................................................ 111
5. Start a chat session .......................................................................................................................... 113
Enable Presence information in SAP CRM ............................................................................................... 114
1. Define Communication Management Software Profiles ................................................................... 114
2. Add Presence & Collaboration to the Partner Block ......................................................................... 114
Business Process Push for Service Ticket ............................................................................................... 118
1. Add Actions for Order Routing .......................................................................................................... 118
2. Add a Rule Policy for Order Routing ................................................................................................ 119
Business Process Push for Service Request ........................................................................................... 120
1. Add Actions for Service Request ...................................................................................................... 120
2. Add a Rule Policy for Service Request Management ...................................................................... 121
Copyright ...................................................................................................................................................... 123

© SAP AG 2014 3
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Connect SAP CRM to SAP BCM


1. Create ICI RFC Connection to SAP BCM
Transaction SM59
This needs to be done only once per CRM system as this is Client Independent. Add a new HTTP
Connection to External Server (Connection Type G). RFC Destination is a free-text field but it is
recommended to use some name that reflects the BCM System you wish to connect to

Test connection with “Connection Test”

© SAP AG 2014 4
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

2. Make Settings for Communication Management Systems


Transaction CRMM_IC_MCM_CCADM
Create New Entry. System ID is a free-text field. It is recommended to use a name which is BCM version
independent. This means if you upgrade your BCM system in the future, you do not have to change this
entry.

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

3. Define Connections for Communication Management


Software
Transaction CRMM_BCB_ADM
Link the RFC connection to the Communication Management Software
Create a New Entry. The entry in the field Comm. Mgmt Software System ID is the System ID you created in
step 2. If your CRM system is CRM 7.0 Ehp1 SP3 or above and you want to use http to connect your BCM
system, make sure to include your defined RFC connection (here SAPBCM7.0) in the Session Connected
field too.

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

4. Define Communication Management Software Profiles


Transaction CRMC_IC_MCM_CCPRO
Create a New Entry
Make sure to click the Presence Enabled checkbox if you want to be able to use Presence. Com Mgmt
Software Profile is a free-text field. Again, it is recommended to use a name which is BCM version
independent. This means if you upgrade your BCM system in the future, you do not have to change this
entry. Make sure to enable the Multisessioning flag if you want to have multi-session support in the IC Web-
Client (as from CRM 7.0, EhP1)

5. Assign Communication Management Systems to Profiles


Transaction CRMM_IC_MCM_CCLNK
Create a New Entry. You can get a list of available Software Profiles and Software System IDs with F4

© SAP AG 2014 7
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

6. Define Toolbar Profile


Transaction CRMC_IC_TLBPROF
Create a New Entry or copy an existing entry. The Profile that will be added to the Business Role
corresponds to the Toolbar that will be used to show the communication buttons in CRM. Select the
checkboxes for Generic, Telephony, Chat, E-mail and Action Item Layout Buttons. The option Dynamic
Toolbar enables the buttons on the toolbar to be shown based on the current communication channel state
e.g. the Logoff button will be shown only when the user is logged onto BCM and is in either Idle or Busy
state, while it will be not shown when the user is not logged onto BCM.

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

Available buttons (as in CRM 7.0 EhP1) are:

7. CMS Integration Profiles


Transaction CRM_IC_FW_PROF
CMS_ROLE function profile is a function profile used for defining the behavior of the CMS (Communication
Management Software – in this case BCM) functionality. This function profile is required in order to use
functionality such as UI Object transfer, Start-Up Component, etc.
You should enable the Disable Link flag. In order for Absence profiles to work correctly in CRM, the BCM
softphone (CDT) should always be fully started before starting CRM.
Select option for Transfer UI Object. This configuration signifies how the UI should behave when doing
transfer call. Select Current UI Component if you would like to have the recipient to get the “current UI
object” of the caller (e.g. caller working on contact screen and want to transfer this to the recipient)
The Entity Provider Class will be used only when the Transfer UI Object is configured with “Custom Entity”.

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

8. Soft Phone Link Configuration


In order for Absence profiles to work correctly in the IC WebClient, the BCM softphone should always be
started before the IC WebClient. Therefore, it is no longer recommended to create a Soft Phone Link in the
Navigation Bar.

Starting the IC WebClient before the BCM softphone (CDT)

Starting the IC WebClient after the BCM softphone (CDT)

9. Business Role Configuration


Transaction CRMC_UI_PROFILE
Create a New Entry or copy an existing entry.
Click on Assign Function Profiles. Assign the Communications Management Software Profile you have just
created to the Function Profile ID CONTACTCENTER

© 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

10. Assign the Business Role to your SAP CRM User


Assign the Business Role to your CRM User in the normal way. You can specify the Business Role in the
User Profile using parameter CRM_UI_PROFILE or assign the Business Role using Organizational
Management

© SAP AG 2014 12
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

11. Set up Users


The connection between CRM and BCM is made using the UserID. In BCM 7, there is now the ability to map
a different CRM user to a BCM user using the BCM System Configurator. There is no need to maintain the
same passwords.

If you want to map a CRM user to a different BCM user, add the CRM user information to the CRM Logon
Name field.

12. Test the Business Role


Start BCM CDT with your BCM User and once this is completed loaded, then logon to CRM using your CRM
User/ Business Role. The Ready/Not Ready buttons should be visible.

© SAP AG 2014 13
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

© SAP AG 2014 14
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Communication Management Software for all Business


Roles
In CRM 7.0, the Communication Management Software functionality can be enabled for all CRM Business
Roles. This means that the users can use telephony within any CRM business role.

1. Define Toolbar Profile


Transaction CRMC_IC_TLBPROF
Create a New Entry or copy an existing entry. The Profile that will be added to the Business Role
corresponds to the Toolbar that will be used to show the communication buttons in CRM. For more details
see this section in Chapter 1.

2. Business Role Configuration


Transaction CRMC_UI_PROFILE
Some elements of the business role need to updated in order to enable the CMS functionality. There are
some default delivery elements that ready to be used out of the box.
Select the Business Role that will be changed, in this example we are enabling a copy of the SALESPRO
Business Role for the CMS functionality. Change Role Config Key, Layout Profile and Technical Profile to
the default value CMS_Role.

© 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)

Assign function profile CONTACTCENTER

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

IVR to identify Callers from SAP CRM


This IVR uses two standard web-services to identify the caller in the IVR from CRM firstly doing a lookup
using the caller’s telephone number and if not Business Partner is found, the caller is asked to enter a
customer number which is the basis for the second lookup. If a Business Partner is found, the language
returned from CRM (assuming it is a supported BCM Language) will be set as the Caller Language and all
prompts will use that language.

1. Create endpoints for standard CRM Web Services


Transaction SOAMANAGER
Click on Web Service Configuration

Enter the Search Pattern ‘BusinessPartnerCRMElementsByElementsQueryResponse_In’ and click on Go

© SAP AG 2014 17
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Highlight the entry found and click on Apply Selection

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

Enter a Service Name. You can use the same name


(BusinessPartnerCRMElementsByElementsQueryResponse_In) if you want. Click on Apply Settings

© 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

Save your settings

© 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

Repeat these steps for the web-service CustomerCRMByIDQueryResponse_In

© SAP AG 2014 22
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

2. Add the IVR Prompts


Open System Configurator. Go to Queue Management –> Prompt Files and create a New Prompt. Enter the
description, select In Queue Message as the prompt type and add language prompts as required. English
(UK) and English (US) prompts are provided but you are free to record your own prompts too. Make sure
that any prompts you record are saved in the correct format (Wave, 8KHz, 16-bit, Mono). Click on the folder
icon and navigate to the folder which contains the prompts and select the appropriate prompt file

You need to create 6 IVR Prompt Files in Total

IVR: Welcome to ACME IVR: Customer Number Not Found


IVR: Enter Customer ID IVR: Repeat Message
IVR: Customer Number Found IVR: Invalid Option, Try Again

© 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

Select the Action Play File

© 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

Repeat these steps until you have created all 6 prompts

IVR: Welcome to ACME IVR: Customer Number Not Found


IVR: Enter Customer ID IVR: Repeat Message
IVR: Customer Number Found IVR: Invalid Option

© SAP AG 2014 25
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

3. Import CRM BP Lookup IVR


Open System Configurator. Go to IVR Management – Custom-Made IVRs and create a New IVR.

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

Expand Customizers and Click on Add New

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”

Save your IVR

© SAP AG 2014 28
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

5. Link the Prompts


You will now need to link the Prompts you created to the IVR. Re-open the IVR, and double-click the
Custom-Made IVR Version you imported earlier

<?xml version="1.0" encoding="utf-8"?>


<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance">
<SOAP-ENV:Body>
<yq1:BusinessPartnerCRMElementsByElementsQuery_sync
xmlns:yq1="http://sap.com/xi/CRM/Global2">
<BusinessPartnerCRMSelectionByElements>
<BusinessPartnerAddressCountryCode>BE</BusinessPartnerAddressCountryCode>
<NormalisedPhoneNumberDescription>*475334500</NormalisedPhoneNumberDescription>
</BusinessPartnerCRMSelectionByElements>
</yq1:BusinessPartnerCRMElementsByElementsQuery_sync>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

© 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

And finally the audio element under filled, else

© SAP AG 2014 33
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

6. Maintain Soap Username and Password


You now need to maintain the soap username and password you are using in the IVR. Expand the form
Form_Soap_LookupBPviaTelNumber and click on the soap element Soap_LookupBPviaTelNumber.
Maintain the User Name and Password fields. Enter a valid CRM User and password that has rights to run
Web-services in CRM. Don’t forget to click on Apply to save your settings!

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

Do the same for the soap Element Soap_LookupBPviaID2

Save your IVR.

© SAP AG 2014 35
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Configure CAD based Alerts for new calls in SAP CRM


This chapter describes how to set up a Contact Attached Data profile in CRM and how CAD can be used to
display alerts indicating what the caller selected in the IVR.

1. Configure CRM to accept the CAD


Transaction CRMC_IC_CAD
Create a Profile for your BCM system. Highlight the profile and click on Contact Attached Data Groups

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

Highlight your group and click on Attributes

© 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.

2. Add the CAD Profile to Business Role


Transaction CRMC_UI_PROFILE
Select entry from right and click on Assign Function Profiles. Assign the CAD Profile you have just created
to the Function Profile ID CAD

© SAP AG 2014 38
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

3. Configure Fact Base entries for CAD in CRM


Transaction CRMC_ERMS_REPOSITORY
Select the ICRULE context and click on Attributes

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.

XPath Expression /parts/Application_ID/Attribute/text()

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

If the event ContactStarted does not exist, create it as shown below

5. Configure BCM to send the CAD


Configure BCM to send the CAD. Open SAP BCM System Configurator
Open the Parameters tab for the Call Centre application.

Add the Name: ExtraDataWhenAllocated

© SAP AG 2014 40
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Add the Value:


XML,Z_Language,Z_Requested,Z_Option,Z_CustomerType,Z_Extension,Z_AgentLanguage,Z_ID,
Z_CADAlert1,Z_CADAlert2,Z_QueueNumber,Z_AgentGroup,Z_Forward,Z_TermID,Z_BCMLanguage,
Z_NoNumberSeen,Z_Menu1,Z_NextOption1-1,Z_NextOption1-2,Z_NextOption1-3,Z_Menu2,Z_Queue2_0,
Z_Queue2_1,Z_Queue2_2,Z_Queue2_3,Z_Queue2_4,Z_Queue2_5,Z_Queue2_6,Z_Queue2_7,
Z_Queue2_8,Z_Queue2_9,Z_Menu3,Z_Service,Z_OrderID,Priority,
,FirstBName,FirstBNumber,FirstANumber

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.

Create a second alert Z_BCM_CAD2 in exactly the same way.


It is also possible to create your own alerts using 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.

© SAP AG 2014 41
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Caller's language is [FACTBASE$ZCAD_LANGUAGE] and caller selected


[FACTBASE$ZCAD_REQUESTED]
In order that the CAD Alert is displayed when the Agent is using other languages in CRM, create in exactly
the same way variants for other languages. To do this, create a rule with the same name but change the
language.

Here are some examples of CAD Alerts in different languages.

© SAP AG 2014 42
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

7. Intent Driven Interaction Rule Policy


Log into CRM as the IC Manager

Go to Rule Policies. Click on New and select Intent Driven Interaction (IC WebClient)

Click on the highest level of your Rule Policy – here Z_BCM_CAD

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.

ADD SECOND ALERT FIRST!!!!!


NEW SCREENSHOT!!!!!

Once you have created your rule, release it.

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

8. Make a call to your IVR


You should see the alerts when the call is allocated to your agent.

© SAP AG 2014 45
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Automatic Categorisation via IVR


With this enhancement, is possible to automatic categorise CRM objects such as Service Tickets, Incidents
and Complaints using the CAD sent from the IVR.

1. Tables ZOPTION and ZOPTION_ROLES


Transaction SE11
Create a new domain: Z_TERMID

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

Activate the object

Create a new Data Element: Z_TERMID

© SAP AG 2014 48
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Select Data Element

© SAP AG 2014 49
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Select the Domain Z_TERMID

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

Activate the object

Create a new Table: ZOPTION

© 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 short description and allow display and maintenance

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

Activate the table

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

2. Methods ZMAPCADTOCAT & DO_PREPARE_OUTPUT


Transaction SE80
Create Method ZMAPCADTOCAT for class CL_ICCMP_BT_CATDDLB_IMPL.

The complete coding:


method ZMAPCADTOCAT.
*{ INSERT DSZK914353 1

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.

CONSTANTS: cv_prod_link_type TYPE char8 VALUE 'IS_PROD',


"#EC NOTEXT
cv_code_link_type TYPE char8 VALUE 'IS_CODE'.
"#EC NOTEXT

if gr_aspect is not bound.


return.
endif.
* Categorization dependent on the CAD:
lr_subject ?= typed_context->btsubject->collection_wrapper->get_current( ).
IF lr_subject IS NOT BOUND.
lr_current ?= typed_context->btadminh->collection_wrapper->get_current( ).
typed_context->btsubject->on_new_focus( focus_bo = lr_current ).
lr_subject ?= typed_context->btsubject->collection_wrapper->get_current( ).
ELSE.
call method lr_subject->get_property_as_value EXPORTING iv_attr_name = 'CONC_KEY'
IMPORTING ev_result = lv_conc_key.
if lv_conc_key is not initial.
* if a category already exists, no automatic precategorisation according to CAD
return.
endif.
ENDIF.

© SAP AG 2014 58
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

data : lv_zoption(4) type c,


lv_termid type char4,
DATA_ACCESS type ref to CL_IC_CAD_DATA_PROCESS,
lt_cad_list type CRMT_IC_CAD_TAB,
ls_cad_list type CRMT_IC_CAD,
lv_string type string,
lv_code_cat type COMT_CATALOG,
lv_code_grp type QCODEGRP,
lv_code_id type QCODE.

* read CAD attribute Z_Option


IF NOT data_access IS BOUND.
CALL METHOD cl_ic_cad_data_process=>get_instance
RECEIVING
rv_instance = data_access.
ENDIF.

CALL METHOD data_access->get_cms_data


IMPORTING
et_cms_data = lt_cad_list.

loop at lt_cad_list into ls_cad_list


where application_id = 'CRM_IC/BUPA'.

if ls_cad_list-item_name = 'Z_TermID'.
* lv_zoption = ls_cad_list-item_value.
lv_termid = ls_cad_list-item_value.
endif.
endloop.

* map CAD attribute to catalog/code group/code


select single CODE_CAT from ZOPTION into lv_CODE_CAT
where z_termid = lv_termid.

select single CODE_GRP from ZOPTION into lv_CODE_GRP


where z_termid = lv_termid.

select single CODE_ID from ZOPTION into lv_CODE_ID


where z_termid = lv_termid.

if lv_code_cat is initial or lv_code_grp is initial or lv_code_id is initial.


return.
endif.

CONCATENATE lv_code_cat lv_code_grp lv_code_id INTO lv_conc_key SEPARATED BY '#'.

if lr_subject is bound.
lr_subject->set_property( iv_attr_name = 'CONC_KEY'
"#EC NOTEXT
iv_value = lv_conc_key ).
endif.

* find category guid for conc_key


data : lv_conc TYPE crmt_erms_cat_code_trip,
ls_ob TYPE crmt_erms_cat_ob,
lt_cat TYPE crmt_erms_cat_ca_buf_tab,
ls_cat TYPE crmt_erms_cat_ca_buf.

CONSTANTS cv_link_type TYPE char8 VALUE 'IS_CODE'.

SPLIT lv_conc_key AT '#' INTO


lv_conc-code_cat lv_conc-code_grp lv_conc-code_id .

ls_ob-obj_extkey = lv_conc. "#EC ENHOK


ls_ob-obj_ddic = if_crm_erms_catego_const=>gc_ob_ty_subjectcode."#EC NOTEXT

CALL METHOD gr_aspect->get_cat_search


EXPORTING
iv_obj = ls_ob
iv_lnk_type = cv_link_type
IMPORTING
et_cat = lt_cat.

© SAP AG 2014 59
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

READ TABLE lt_cat INTO ls_cat INDEX 1.

lv_guid = ls_cat-cat_guid.

* publish the category to the category controller


if gr_cucocat is bound.
CALL METHOD gr_cucocat->if_bol_bo_property_access~set_property
EXPORTING
iv_attr_name = gv_cat_attr
iv_value = lv_guid .
endif.

* update the inputkey of the ddlb


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 = lv_guid.
ENDIF.

lr_bol_core ?= cl_crm_bol_core=>get_instance( ).
if lr_bol_core is bound.
lr_bol_core->modify( ).
endif.

*
*} INSERT
endmethod.

Modify method DO_PREPARE_OUTPUT in same class CL_ICCMP_BT_CATDDLB_IMPL. This makes


Method ZMAPCADTOCAD to be only called in case the actual Business Role is maintained in table
ZOPTION_ROLES.

The complete coding of method DO_PREPARE_OUTPUT:


method DO_PREPARE_OUTPUT.
data: lr_entity type ref to cl_crm_bol_entity,
lr_current type ref to if_bol_bo_property_access,
lr_btadminH type ref to cl_crm_bol_entity,
lr_case type ref to cl_crm_bol_entity,
lr_inputkeys type ref to crmt_ct_catego_input_keys,
ls_input type crmt_ct_catego_input_keys,

© SAP AG 2014 60
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

lv_timestamp type bcos_tstmp,


lv_order_guid type crmt_object_guid,
lv_case_guid type scmg_case_guid,
lv_cat_guid type crm_erms_cat_guid,
lv_update_input type abap_bool.

* 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( ).

if lr_btadminh is not bound and lr_case is not bound.


* evtl. cancel has been clicked, clear classification

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 the dropdown listbox


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 = lv_cat_guid.
ENDIF.

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.

if lv_order_guid <> gv_last_order_guid.

gv_last_order_guid = lv_order_guid.

init_categories( ).

elseif gv_update_input = abap_true.

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.

IF gv_application <> gc_interaction_record.


if lv_timestamp is initial.
* if order is initial, get assigned category to product
get_bt_cat2prod( ).
*{ INSERT DTZK929225 1
*call ZMAPCADTOCAT only for certain roles!

data : lr_ui_profile type ref to cl_crm_ui_profile,


lv_profile type CRMT_IC_CONFIGPROF,
ls_zoption_role type zoption_roles.
lr_ui_profile ?= cl_crm_ui_profile=>get_instance( ).
lv_profile = lr_ui_profile->if_crm_ui_profile~get_profile( ).

select single * from zoption_roles into ls_zoption_role where business_role = lv_profile.


if sy-subrc = 0.
ZMAPCADTOCAT( ).
endif.

*} 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.

if lv_case_guid <> gv_last_case_guid.

gv_last_case_guid = lv_case_guid.

init_categories( ).

elseif gv_update_input = abap_true.

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.

3. Add Business Role in Table ZOPTION_ROLES


Transaction SE16
Add the Business Role that you want to be able to use the auto-categorisation feature. This screenshot is
from Client 770:

© SAP AG 2014 63
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

4. Add the CAD Profile to Business Role


Transaction CRMC_UI_PROFILE
Select entry from right and click on Assign Function Profiles. Assign the CAD Profile to the Function Profile
ID CAD

5. Add the CAD Terms used in your IVR to the table ZOPTION
Transaction SE16
Enter the following fields:

 CLIENT: is being populated automatically


 Z_TERMID: Code being sent by BCM (contains ‘the users choice in IVR’)
 Z_OPTION: The long text of sent code (optional).
 CODE_CAT
 CODE_GRP
 CODE_ID

The example here is from the Telco4U IVR.

© 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

Outbound Campaigns and Automatic Dialing


With SAP CRM 7.0, EhP1, it is possible to download call-list to SAP BCM and BCM to automatic dial the call
and allocate the call to an available agent.

1. Create SAPphone connection in BCM


In the BCM System Configurator, navigate to System Management -> Modules

Click on Search

Double-click on your Integrations VU, Online Interaction Interface (OII)

Click on the check box to enable the SAPphone Interface

Add a new connection:

© SAP AG 2014 66
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Server Connection: -aBCM7DEMO -gdtztdc00.wdf.sap.corp –xsapgw20


-a: Name of RFC Program
-g: Address of CRM Web Server
-x: Gateway (Instance Number) of CRM system
Server Name: BCMDEM – the name of the SAPphone server you will set up in step 3.

2. Create SAPphone RFC Connection


Transaction SM59
Add a new TCP/IP Connection (Connection Type T)

© SAP AG 2014 67
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Test connection with “Connection Test”

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.

3. Create SAPphone Server


Transaction SPHB
Create New Entry

© SAP AG 2014 68
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Create Telephone server

© SAP AG 2014 69
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Select the RFC destination created in the previous step

Make sure Dialer is selected here

© 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

The call-list will now be available in BCM in the CPM Administrator

© SAP AG 2014 75
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

SAP BCM E-Mail (ICI E-Mail)


E-mail can either be handled directly by BCM or handled in CRM and routed as an object via BCM (ERMS
Push E-Mail). This section describes how e-mail handled directly by BCM can be set up.

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

2. Business Role Configuration


Transaction CRMC_UI_PROFILE
Create a New Entry or copy an existing entry. Select entry from right and click on Assign Function Profiles.
Assign the Communications Management Software Profile you created to the Function Profile ID
CONTACTCENTER

© 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

3. Configure BCM to retrieve e-mails


Configure BCM to retrieve e-mails from an IMAP-enabled mail account. Open SAP BCM System
Configurator and create an E-mail queue.

Address: e-mail address of the IMAP-enabled e-mail account (here


bcm_zure_sales@tdcdemomail.sap-ag.de)
E-Mail Account: account ID of the IMAP-enabled e-mail account (here tdcdemo01-
wdf\bcm_azure_sales)
E-Mail Password Password of your e-mail account on your e-mail server
E-Mail Server: address of the IMAP-enabled e-mail server (here tdcdemomail03)

© SAP AG 2014 77
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

SAP CRM ERMS push E-Mail


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 Agent Inbox

2. Business Role Configuration


Transaction CRMC_UI_PROFILE
Create a New Entry or copy an existing entry. Select entry from right and click on Assign Function Profiles.
Assign the Communications Management Software Profile you created to the Function Profile ID
CONTACTCENTER

© 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

3. Define Receiving E-mail Addresses in SAP CRM


Transaction CRMC_IC_AUIADDR

4. Enable SAP Business Object Instance


Transaction SO16
Check that SAP object instance is available, if not enable it

© SAP AG 2014 79
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

5. Maintain Recipient Distribution


Transaction SO28
Create new entry and on New recipient, choose SAP object instance

Select ERMS support 2.

© SAP AG 2014 80
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Search for Receiver/Address you created in Step 1.

Select the e-mail address you created in Step 1.

© SAP AG 2014 81
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

6. Assign Service Management Profile


Transaction CRMC_ERMS_SM_PDET
Add an entry with ObjectID: 0 and a Service Manager Profile (in this case DEFAULT) – the same entry we
will use later in the Rule Policy.

© SAP AG 2014 82
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

7. Maintain Communication Management Software


Connections
Transaction CRMM_BCB_ADM
Create a Communication Management Software System ID ERMS_ACTION and assign this to the
Connection you are using for BCM for Phone and Chat. ERMS_ACTION is in in-built system name and it
does not have to be created manually in transaction CRMM_IC_MCM_CCADM.

8. Define ERMS Repository


Transaction CRMC_ERMS_REPOSITORY
Select ERMS and click on Atrributes. Click on New Entries

© 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

9. Set up ERMS rules


Log into CRM as the IC Manager

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 folder under Draft Rules

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.

Add the Action Push EMail to IC WebClient Agent.

© 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).

Once you have created your rule, release it.

Then you should have a screen similar to this:

© 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.

In this example, there are also 3 sub-rules:

© 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

10. Configure BCM to route ERMS e-mails


Configure BCM to route ERMS E-Mails to the appropriate queue depending on the E-Mail Original Recipient.
Open SAP BCM System Configurator and create new e-mail queues for each e-mail address you used in the
‘Z_TO_ADDRESS – BCM Queue E-Mail Address’ parameter in your ERMS Rule Policy.

Address: email address used in the ERMS Rule Policy (here bcm_red_sales@bcmdemo.sap)

All other fields should be left blank including E-Mail Password.

© SAP AG 2014 92
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

11. Debugging - Check that e-mails arrive in CRM


Transaction SCOT
Click on Inbound Send Requests

12. Debugging - Check the Work Items


Transaction SWI1
Click on the execute button

© 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.

Change the view to include the Technical Details

Click on ERMS rule execution and select the Container Tab.

© 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.

13. Debugging - Check the outstanding e-mails


Log into CRM as the IC Manager. Go to Monitoring Operations (click on the Menu and not the triangle)

© SAP AG 2014 95
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Click on E-Mail Status: Overview

Here you can see all the outstanding e-mails.

14. Debugging - Check the ICI Trace


Transaction SU01
Enable CRM_ICI_TRACELEVEL as XXX for user WF-BATCH. Do this before you send a test mail.

Transaction CRM_ICI_TRACE for user WF-BATCH

© 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

Highlight the complete line

And now you can see what happened

<?xml version="1.0" encoding="UTF-8" ?>


<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">-
<SOAP-ENV:Header>
<pre:user xmlns:pre="urn:IciActionItemInterface" SOAP-ENV:mustUnderstand="0" xsi:type="xsd:string">WF-BATCH</pre:user>
<pre:language xmlns:pre="urn:IciActionItemInterface" SOAP-ENV:mustUnderstand="0" xsi:type="xsd:string">EN</pre:language>
</SOAP-ENV:Header>
<SOAP-ENV:Body>-
<ns0:route xmlns:ns0="urn:IciActionItemInterface">-
<itemData xmlns="urn:IciActionItemInterface">
<systemId />
<client />
<requestId>000000447682</requestId>
<processId>FOL25000000000004RAW37000000012392</processId>
<attachedData />
<capabilityList />

© 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>

15. Debugging - Check the BCM OII log


13:43:15.230 TRC> --- SOAPAction="http://inqmy.com/soapdispatcher/rpc/bcbici/IciActionItemBean"
Remote=10.22.141.133 URL=/OII/OII.asmx
13:43:15.231 TRC> route: user=WF-BATCH language=EN data=
actionItemId:
requestId: 000000447679
processId: FOL25000000000004RAW37000000012390
processingStatus: /
messageStatus: /
capabilityList (0):
attachedData:
actionItemAttributes (10): SUBJECT=Test from Mark SUBJECT_CHARSET= SEND_DATE=20120430134305
SENSITIVITY= IMPORTANCE= MAIL_ID=AA944E36AE627F4C9099976E5BE4847C07A6CD2368@DEWDFECCR06.wdf.sap.corp
FROM_NAME=mark.tate-smith@sap.com FROM_ADDRESS=mark.tate-smith@sap.com TO_NAME=bcm_red@dez.r3.sap-
ag.de TO_ADDRESS=bcm_red@dez.r3.sap-ag.de
routingAttributes (5): Z_TO_ADDRESS=BCM_RED_SUPPORT@BCMDEMO.SAP.CORP Z_EMAIL_CATEGORY=Other
MAIL_RECIPIENT=BCM_RED@DEZ.R3.SAP-AG.DE MAIL_SUBJECT=Test from Mark
Z_TO_ADDRESS=BCM_RED_SUPPORT@BCMDEMO.SAP.CORP
13:43:15.231 INF> [ActionItem:C8CA116FCA92E111A6C80017A43C040C;-/action] Created
13:43:15.231 TRC> [ActionItem:C8CA116FCA92E111A6C80017A43C040C;-/action] TO_ADDRESS:
bcm_red@dez.r3.sap-ag.de
13:43:15.231 TRC> [ActionItem:C8CA116FCA92E111A6C80017A43C040C;-/action] Z_TO_ADDRESS:
BCM_RED_SUPPORT@BCMDEMO.SAP.CORP
13:43:15.231 TRC> [ActionItem:C8CA116FCA92E111A6C80017A43C040C;-/action]
Address=BCM_RED_SUPPORT@BCMDEMO.SAP.CORP mapped to queue=Queue:Red - Support (E-Mail)
address=bcm_red_support@bcmdemo.sap.corp
...
The previous 2 lines were repeated 2 times
13:43:15.232 TRC> [ActionItem:C8CA116FCA92E111A6C80017A43C040C;-/action] CAD:
<ItemAttachedData><Application
id="SAP_BCM/OII"><Z_TO_ADDRESS>BCM_RED_SUPPORT@BCMDEMO.SAP.CORP</Z_TO_ADDRESS><Z_EMAIL_CATEGORY>Othe
r</Z_EMAIL_CATEGORY><MAIL_RECIPIENT>BCM_RED@DEZ.R3.SAP-AG.DE</MAIL_RECIPIENT><MAIL_SUBJECT>Test from
Mark</MAIL_SUBJECT></Application></ItemAttachedData>
13:43:15.232 TRC> [ActionItem:C8CA116FCA92E111A6C80017A43C040C;-/action] Queue: a46e2bf6-1aa8-4928-
bb16-41718d898247 Channel: bcm_red_support@bcmdemo.sap.corp

© SAP AG 2014 99
SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

13:43:15.232 TRC> [ActionItem:C8CA116FCA92E111A6C80017A43C040C;-/action] ActionItemData:


<ici.ActionItem><systemId /><client
/><requestId>000000447679</requestId><processId>FOL25000000000004RAW37000000012390</processId><actio
nItemId p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" /><actionItemInboxId
p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" /><attachedData /><capabilityList
/><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>20120430134305
</description></item><item><id>SENSITIVITY</id><description
/></item><item><id>IMPORTANCE</id><description
/></item><item><id>MAIL_ID</id><description>AA944E36AE627F4C9099976E5BE4847C07A6CD2368@DEWDFECCR06.w
df.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></ici.ActionItem>
13:43:15.232 TRC> [ActionItem:C8CA116FCA92E111A6C80017A43C040C;-/action] RoutingAttributes:
<ArrayOfIciNameValue><ici.NameValue><name>Z_TO_ADDRESS</name><value>BCM_RED_SUPPORT@BCMDEMO.SAP.CORP
</value></ici.NameValue><ici.NameValue><name>Z_EMAIL_CATEGORY</name><value>Other</value></ici.NameVa
lue><ici.NameValue><name>MAIL_RECIPIENT</name><value>BCM_RED@DEZ.R3.SAP-
AG.DE</value></ici.NameValue><ici.NameValue><name>MAIL_SUBJECT</name><value>Test from
Mark</value></ici.NameValue><ici.NameValue><name>Z_TO_ADDRESS</name><value>BCM_RED_SUPPORT@BCMDEMO.S
AP.CORP</value></ici.NameValue></ArrayOfIciNameValue>

© SAP AG 2014 100


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Configure CAD based Alerts for new ERMS push


E-mails in SAP CRM
This chapter describes how to extend the Contact Attached Data profile in CRM to display alerts giving the
agent additional information about an incoming e-mail in the IC WebClient

1. Configure CRM to accept the CAD


Transaction CRMC_IC_CAD
Edit the Contact Attached Data Profile your created earlier. Highlight the profile and click on Contact
Attached Data Groups

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

© SAP AG 2014 101


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

The description is used in the Contact Attached Data workcenter in the IC WebClient

© SAP AG 2014 102


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

2. Configure Fact Base entries for CAD in CRM


Transaction CRMC_ERMS_REPOSITORY
Select the ICRULE context and click on Attributes

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()

XPath Expression /parts/Application_ID/Attribute/text()

3. Create Alert
Log into CRM as the IC Manager

© SAP AG 2014 103


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Go to Alerts and click on New

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.

Caller's language is [FACTBASE$ZCAD_LANGUAGE] and caller selected


[FACTBASE$ZCAD_REQUESTED]

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

© SAP AG 2014 104


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

4. Intent Driven Interaction Rule Policy


Log into CRM as the IC Manager

Go to Rule Policies. Click on New and select Intent Driven Interaction (IC WebClient)

Click on the highest level of your Rule Policy – here Z_BCM_CAD

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)

© SAP AG 2014 105


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.

Once you have created your rule, release it.

Then you should see a screen similar to this. Save the Rule Policy

© SAP AG 2014 106


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

5. Send an e-mail
You should see the alerts when the call is allocated to your agent.

© SAP AG 2014 107


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Configure CAD based Alerts for new Chats in SAP CRM


This chapter describes how to extend the Contact Attached Data profile in CRM to display alerts giving the
agent additional information about an incoming chat in the IC WebClient

1. Configure CRM to accept the CAD


Transaction CRMC_IC_CAD
Edit the Contact Attached Data Profile your created earlier. Highlight the profile and click on Contact
Attached Data Groups

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

© SAP AG 2014 108


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

The description is used in the Contact Attached Data workcenter in the IC WebClient

© SAP AG 2014 109


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

2. Configure Fact Base entries for CAD in CRM


Transaction CRMC_ERMS_REPOSITORY
Select the ICRULE context and click on Attributes

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()

XPath Expression /parts/Application_ID/Attribute/text()

3. Create Alert
Log into CRM as the IC Manager

© SAP AG 2014 110


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Go to Alerts and click on New

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.

Caller's language is [FACTBASE$ZCAD_LANGUAGE] and caller selected


[FACTBASE$ZCAD_REQUESTED]

4. Intent Driven Interaction Rule Policy


Log into CRM as the IC Manager

Go to Rule Policies. Click on New and select Intent Driven Interaction (IC WebClient)

Click on the highest level of your Rule Policy – here Z_BCM_CAD

© SAP AG 2014 111


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

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.

© SAP AG 2014 112


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Once you have created your rule, release it.

Then you should see a screen similar to this. Save the Rule Policy

5. Start a chat session


You should see the alerts when the call is allocated to your agent.

© SAP AG 2014 113


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Enable Presence information in SAP CRM


1. Define Communication Management Software Profiles
Transaction CRMC_IC_MCM_CCPRO

Make sure the Presence Enabled flag is set

2. Add Presence & Collaboration to the Partner Block


Transaction: BSP_WD_CMPWB

Component: BTPARTNER and click on Display

© SAP AG 2014 114


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Click on Component Structure Browser

© SAP AG 2014 115


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Expand Views and double-click on BTPARTNER/Partner. Click on Configuration.

Click on Choose Configuration

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

© SAP AG 2014 116


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

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

Check that it has been saved correctly.

Now you should have presence available in Partner Functions

Add screenshot for different options…

© SAP AG 2014 117


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Business Process Push for Service Ticket


1. Add Actions for Order Routing
Transaction CRMC_ERMS_REPOSITORY
Select the ORDER context and click on Actions

Add the Send Parameter Action

Add the Set Parameter Action. You need to add 3 Action Parameters for this

Add the 3 Action Parameters: ITEM_TYPE, PARAMETER and VALUE

© SAP AG 2014 118


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

2. Add a Rule Policy for Order Routing


Log into CRM as the IC Manager

Go to Rule Policies. Click on New and select the Context ‘Order Routing’.

Or use an existing Rule Policy

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

© SAP AG 2014 119


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

Business Process Push for Service Request


Since for the Service Request a different context in Rule Modeler is being used, some customizing settings
need to be adapted so the Business Process Push is working in context ‘Service Request’.

1. Add Actions for Service Request


Transaction CRMC_ERMS_REPOSITORY
Select the SERVICEREQUEST context and click on Actions

Add the Send Parameter Action

Add the Set Parameter Action. You need to add 3 Action Parameters for this

Add the 3 Action Parameters: ITEM_TYPE, PARAMETER and VALUE

© SAP AG 2014 120


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

2. Add a Rule Policy for Service Request Management


Log into CRM as the IC Manager

Go to Rule Policies. Click on New and select the Context ‘Service Request Management’.

Or use an existing Rule Policy

This rule example uses the ITSM_ROUTING Rule Policy

Service Teams were created in Organisational Management. This is to ensure the Service Request goes to
the right Agent Group.

© SAP AG 2014 121


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

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

© SAP AG 2014 122


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

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.

MaxDB is a trademark of MySQL AB, Sweden.

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.

WinFax® is a U.S. registered Trademark from Symantec Corporation.

Sybase and SYBASE (logo) are trademarks of Sybase, Inc.

Intel and Intel JPEG Library are trademarks of Intel, Inc.

© SAP AG 2014 123


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

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.

THE APACHE SOFTWARE LICENSE, VERSION 1.1


Copyright (c) 1999 The Apache Software Foundation. All rights reserved. Redistribution and use in source
and binary forms, with or without modification, are permitted provided that the following conditions are met:
 Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
 Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
the following disclaimer in the documentation and/or other materials provided with the distribution.
 The end-user documentation included with the redistribution, if any, must include the following
acknowledgment: "This product includes software developed by the Apache Software Foundation
(http://www.apache.org/)." Alternately, this acknowledgment may appear in the software itself, if and
wherever such third-party acknowledgments normally appear.
 The names "Xerces" and "Apache Software Foundation" must not be used to endorse or promote
products derived from this software without prior written permission. For written permission, please
contact apache@apache.org.
 Products derived from this software may not be called "Apache", nor may "Apache" appear in their
name, without prior written permission of the Apache Software Foundation.

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:

© SAP AG 2014 124


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

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.

Copyright and Licensing Information for ACE(TM) and TAO(TM)


ACE(TM) and TAO(TM) are copyrighted by Douglas C. Schmidt and his research group at Washington
University, University of California, Irvine, and Vanderbilt University Copyright (c) 1993-2003, all rights
reserved. Since ACE+TAO are open-source, free software, you are free to use, modify, copy, and distribute--
perpetually and irrevocably--the ACE+TAO source code and object code produced from the source, as well
as copy and distribute modified versions of this software. You must, however, include this copyright
statement along with code built using ACE+TAO.
You can use ACE+TAO in proprietary software and are under no obligation to redistribute any of your source
code that is built using ACE+TAO. Note, however, that you may not do anything to the ACE+TAO code, such
as copyrighting it yourself or claiming authorship of the ACE+TAO code that will prevent ACE+ TAO from
being distributed freely using an open-source development model. You needn't inform anyone that you're
using ACE+TAO in your software, though we encourage you to let us know so we can promote your project
in the ACE+TAO success stories..
ACE+TAO are provided as is with no warranties of any kind, including the warranties of design,
merchantability, and fitness for a particular purpose, noninfringement, or arising from a course of dealing,
usage or trade practice. Moreover, ACE+TAO are provided with no support and without any obligation on the
part of Washington University, UC Irvine, Vanderbilt University, their employees, or students to assist in its
use, correction, modification, or enhancement. However, commercial support for ACE is available from
Riverace and commercial support for TAO is available from OCI and PrismTech. Both ACE and TAO are
Y2K-compliant, as long as the underlying OS platform is Y2K-compliant.
Washington University, UC Irvine, Vanderbilt University, their employees, and students shall have no liability
with respect to the infringement of copyrights, trade secrets or any patents by ACE+TAO or any part thereof.
Moreover, in no event will Washington University, UC Irvine, or Vanderbilt University, their employees, or
students be liable for any lost revenue or profits or other special, indirect and consequential damages.
The ACE and TAO web sites are maintained by the Center for Distributed Object Computing of Washington
University for the development of open-source software as part of the open-source software community. By
submitting comments, suggestions, code, code snippets, techniques (including that of usage), and
algorithms, submitters acknowledge that they have the right to do so, that any such submissions are given
freely and unreservedly, and that they waive any claims to copyright or ownership. In addition, submitters
acknowledge that any such submission might become part of the copyright maintained on the overall body of
code, which comprises the ACE and TAO software. By making a submission, submitter agrees to these
terms. Furthermore, submitters acknowledge that the incorporation or modification of such submissions is
entirely at the discretion of the moderators of the open-source ACE+TAO projects or their designees.
The names ACE(TM), TAO(TM), Washington University, UC Irvine, and Vanderbilt University, may not be
used to endorse or promote products or services derived from this source without express written permission
from Washington University, UC Irvine, or Vanderbilt University. Further, products or services derived from

© SAP AG 2014 125


SAP BCM & SAP CRM Configuration Guide - Integration Scenarios

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.

SAP Library document classification: PUBLIC

© SAP AG 2014 126

You might also like