Skip to Content

Purpose:

In CRM IC Agent business role, when creating/changing a service request, knowledge articles can be suggested according to the categories and then displayed as an alert in context area.

For example, there is a categorization schema which can be used for a service request. A knowledge  article is assigned to category DESKTOPS->MAC:

3. schema KA for MAC.PNG

there is no knowledge article assigned to category DESKTOPS->WINDOWS:

4. schema KA for Windows.PNG

For a service request, when change category to DESKTOPS->MAC, alert ‘1 Suggested Knowledge Articles’ is displayed:1. ka alert on.PNG

If change category to ‘DESKTOPS’->’WINDOWS’,  the previous alert will disappear and no alert is displayed:

2. ka alert remove.PNG

Additionally, there is hyperlink for the alert. When click the hyperlink, it will navigate to knowledge article search screen:

2-1 alert navigate.PNG

This blog will explain the logics regarding how the alert is triggered, how the rule policy and alert for knowledge article are configured, how we can make our own rule policy and alerts, etc.

Test Environment:

Auto suggest knowledge article alert in IC is newly introduced since CRM7.0 EHP1 with business function CRM_IC_CEBP. This blog is written with test data in EHP2 and EHP3 system.

Component/view for service request creation screen: SRQM_INCIDENT_H/INCIDENTOV

Component/view for category fields: BTCATEGORIES/Categories

Logics:

  1. Define categorization schema and assign knowledge articles to categories as business required.
  2. An alert should be defined which will be displayed in IC context area(In this blog, the alert is AUTOSUGGEST_KAS).
  3. At least one rule policy should be defined for events AutoSuggestKAEnd and AutoSuggestKAStart (In this blog, the rule policy is AUTOKAS).
  4. Add the alert into the rule policy.
  5. After above preparation, when create/edit a service request in IC web and select/change a category, system will check if there is a knowledge article assigned to it.
  6. Set and raise event AutoSuggestKAEnd to remove existing alerts from context area.
  7. If there is at least one knowledge article assigned to the new category, event AutoSuggestKAStart will be raised to display alert in context area.
    (from the steps 5 ~ 7, please refer to codes in method CL_BTCATEGO_CATEGORIES_IMPL->AUTO_SUGGEST_KA):
    5. source code trigger alert.PNG

How to find out the rule policy triggered by event ‘AutoSuggestKAEnd’ and ‘AutoSuggestKAStart’:

  1. Logon business role IC_MANAGER.
  2. Go to ‘processing Modeling’->search ‘Rule Policies’.
  3. Search with event ID ‘AutoSuggestKAEnd’ or ‘AutoSuggestKAStart'(here, same rule policy AUTOKAS is used for both of the two events):
    6-1. rule policy for AutoSuggestKAEnd.PNG

    6-2. rule policy for AutoSuggestKAStart.PNG

How is the rule policy AUTOKAS defined:

  1. Rule policy AUTOKAS definition( there are two alerts contained in the rule policy):
    6-3 rule policy overview.PNG
  2. Event AutoSuggestKAStart will trigger alert AUTOSUGGEST_KAS:
    7-1. show ka alert.PNG
  3. Event AutoSuggestKAEnd will terminate alert AUTOSUGGEST_KAS:
    7-2. remove ka alert.PNG

How is the alert AUTOSUGGEST_KAS defined:

  1. Logon business role IC_MANAGER.
  2. Go to ‘Processing Modeling’->search ‘Alerts’.
  3. Search alert AUTOSUGGEST_KAS and click the hyperlink to display.
    8-1 alert search.PNG
  4. Alert definition.
    8-2.PNG

Some key steps when creating our own alert for knowledge article:

  1. When create alert, select navigation object/action ‘IC_KNOWS:B’ if you want the alert to navigate to knowledge search screen when click alert hyperlink.
    9-1 create alert object navigate.PNG
  2. In order to add dynamic attributes, we can select ‘Event’->’AutoSuggestKAStart:NumberOfKA’ and then click ‘Insert Attributes’ button:
    9-2 create alert inset attributes.PNG

Some key steps when create our own rule policy for knowledge article:

  1. Should select context ‘Intent Driven Interaction(IC WebClient)’ when creating rule policy.
    9-3 create rule policy.PNG
  2. Remember to add ‘business roles’ and ‘IC Events’.
    9-4 add business role and events.PNG
  3. In order to trigger alert, set condition event equals to ‘AutoSuggestKAStart’ and set the alert name which was created previously.
    9-5 trigger alert.PNG
  4. To remove the alert, set condition event equals to ‘AutoSuggestKAEnd’ and set the alert name which was created previously.
    9-6 remove alert.PNG
  5. Release the rule policy before using it.
    9-7 release the rule policy.PNG

Key words:
CL_CRM_IC_AH_TRIG_ALERT_ABSTR, GET_ALERT_ATTRIBUTES, CL_CRM_SMF_SERVICE->EXECUTE, CL_CRM_SMF_ACTION_MANAGER->ADD_ACTION_TO_BUFFER, CL_CRM_SMF_POLICY, EVALUATE, CRMD_ERMS_PROF

To report this post you need to login first.

2 Comments

You must be Logged on to comment or reply to a post.

Leave a Reply