Emailfunktionalitsd v05 e

  • Upload
    kluser

  • View
    33

  • Download
    0

Embed Size (px)

DESCRIPTION

Emailfunktionalitsd v05 e

Citation preview

  • Service Desk E-Mail Functionality

    Feb 2010

  • Page 2 of 33

    Contents1 Technical Background................................................................................................................. 3

    1.1 Actions ............................................................................................................................... 3

    1.2 Conditions (Scheduling/Execution) ..................................................................................... 4

    2 Basic Settings ............................................................................................................................. 6

    2.1 Implementing SAP Note 1275036 ....................................................................................... 6

    3 Example Implementations .......................................................................................................... 7

    3.1 Automatic Notification of Reporter ..................................................................................... 7

    3.1.1 Step 1: Define Notification Action ............................................................................... 7

    3.1.2 Step 2: Schedule Notification Action ..........................................................................10

    3.2 Manual Reporter Notification ............................................................................................17

    3.3 Notifying a Team ...............................................................................................................18

    3.3.1 Step 1: Create a Message Processor Distribution Group .............................................18

    3.3.2 Step 2: Create the Distribution Group in the IBase .....................................................19

    3.3.3 Step 3: Determine the Support Team .........................................................................22

    3.3.4 Step 4: Define Notification Action ..............................................................................25

    3.3.5 Step 5: Scheduling Notification ..................................................................................26

    3.4 Adjusting the Mail Template (Header, Body), Adding Fields ...............................................27

    3.5 Notification as Text or as Attachment ................................................................................29

    3.6 Change Standard Smart Form Settings ...............................................................................32

    4 Links and Further Information ...................................................................................................33

    4.1 Literature ..........................................................................................................................33

    4.2 Links ..................................................................................................................................33

    4.3 Selected Notes...................................................................................................................33

    New in this version

    Editors note: some screen shots in wrong language.

  • Page 3 of 33

    1 Technical BackgroundThis section describes the set-up of automatic E-mail notification.

    1.1 ActionsYou can, among other things, specify and add functions to the message-handling process, underActions. Actions are collected in an action profile, which is assigned to a transaction type (e.g. SLFN,SIVA, SISV), in customizing. For example: Call the transaction type settings customizing, incustomizing, in the IMG (transaction SPRO) , as shown in Figure 1.1.

    Figure 1.1: IMG in Transaction SPRO

    Display the transaction type details, as shown in Figure 1.2.

    Figure 1.2: Transaction Type Definition

  • Page 4 of 33

    The action profile used is under Profile. The next graphic shows the details of the transaction typeSIVA. The action profile AI_SDK_STANDARD is assigned to this transaction type (Standard ServiceDesk Messages Service Provider).

    Figure 1.3: Customizing for Transaction Type SIVA

    Actions in the SAP Solution Manager use the Post-Processing Framework (PPF), a basis componentwhich creates actions (e.g. method call or workflow) according to an action definition, from the dataof an application. The actions are processed at a specified time. The post-processing frameworkprovides tools to schedule, run and monitor actions.

    The transactionSAP Solution Manager SPPFCADM goes to customizing. The customizing for ServiceDesk actions is under the applications CRM_ORDER and DNO_NOTIF. You can, for example, specifyan action in the action profile with the following attributes:

    ? Executable in dialog or in the background? Display the action in a toolbar (GUI)? Action processing time (when saving, or in selection report)? Action depends on a partner? Action scheduling rules (workflow conditions or BAdI implementations)? Execution frequency

    The example implementations in section 3 provide further descriptions of these customizing settings.

    1.2 Conditions (Scheduling/Execution)The availability of actions in a Service Desk message depends upon the action profile customizing ofthe transaction type. Actions are specified in the action profile, and then scheduled. You can specifyif an action is to run in dialog or in the background (scheduling condition), or at a specified time(execution condition). See figure 1.4.

  • Page 5 of 33

    Figure 1.4: Actions in CRM

    Figure 1.5 defines the two terms, and gives an example of the descriptions.

    Figure 1.5: Difference between scheduling and execution conditions

  • Page 6 of 33

    2 Basic SettingsThis section describes how you can use a BAdI implementation to specify the action scheduling logic.SAP delivers a standard implementation, which you can use to schedule actions.

    2.1 Implementing SAP Note 1275036You should implement SAP note 1275036 with transaction SNOTE, to use the E-Mail functionality(until SPS19). If you do not yet have Solution Manager SPS19, perform the manual post-processingdescribed in the note. If you implemented the BAdI manually, before SPS19, as described in the note,you should see the following screen:

    Figure 2.1: BAdI Implementation for Scheduling Conditions

    Figure 2.2: BAdI Implementation Interface

  • Page 7 of 33

    3 Example ImplementationsThis section describes examples of customizing actions to notify various parties by E-Mail.

    3.1 Automatic Notification of ReporterThis example describes the customizing for an action to automatically send an E-Mail when the statusof a Service Desk message changes to Author Action. Perform the following steps:

    3.1.1 Step 1: Define Notification ActionSpecify a new action to send an E-Mail automatically. Call the transaction SPPFCADM. Choosethe application CRM_ORDER, and click on the button Define Action Profile and Actions, asshown in Figure 3.1.

    Figure 3.1: Customizing for PPF Actions

    Select an action profile which is assigned to the active transaction type for Service Deskmessages. If, for example, the transaction type SLFN is active, the action profileAI_SDK_STANDARD is used for the service provider (VAR) functionality, in the SAP standard.Doubleclick on Action Definition as shown in Figure 3.2.

    Figure 3.2: Action Definitions for Action Profile

    Go to change mode and make a New Entries, as shown in Figures 3.3 and 3.4.

  • Page 8 of 33

    Figure 3.3: Define New Action in Action Profile

    Assign a technical name and description to the action, and make the following settings:

    ? Sort Order for Display? Schedule Automatically? Partner-Dependent | SLFN0002 (partner function for Reporter)? Rule Type: Conditions Using Business Add-In (BAdI)

    Figure 3.4: Action Settings

    You can also maintain the Action Description (click on the Action Description tab). Thendoubleclick on Processing Types, as shown in Figure 3.5, and make a New Entries.

  • Page 9 of 33

    Figure 3.5: Set-Up Action Processing Types

    Click on the right-hand table field and choose the F4 search help.

    Figure 3.6: Set-Up Processing Types

    Choose Smart Forms Mail.

    Figure 3.7: Smart Forms Mail Processing TypesSelect the row just created, and choose Set Processing Type.

  • Page 10 of 33

    Figure 3.8: Set-Up Smart Forms Processing Type

    Maintain the following settings:

    ? Form Name: CRM_REMINDER_MAIL_01? Processing Class: CL_DOC_PROCESSING_CRM_ORDER? Processing Method: CRM_SRVORDER_EXEC_SMART_FORM

    Figure 3.9: Smart Forms Mail Settings

    Save the customizing.

    3.1.2 Step 2: Schedule Notification ActionWhen you have specified the E-Mail notification action in customizing, as described, specifywhen it is to be performed. This example tells you how you can have the reporter E-Mailnotification action performed automatically, depending on the user status of the Service Deskmessage (here: Author Action, in the CRM actions condition configuration.Call the transaction SPPFCADM. Select the application CRM_ORDER, as shown in Figure 3.10, andclick on the button Condition Configuration

  • Page 11 of 33

    Figure 3.10: Action Condition Configuration

    Display the technical names.

    Figure 3.11: Display Action Conditions

    Double-click on the action profile which is assigned to the transaction type for Service Deskmessages (e. g. the action profile AI_SDK_STANDARD is assigned to the transaction type SLFN orSIVA), as shown in Figure 3.12.

  • Page 12 of 33

    Figure 3.12: Action Profile Selection in the Condition Configuration

    Change to edit mode and choose the not-yet-scheduled action (Create button) as shown inFigure 3.13.

    Figure 3.13: Add an Action to the Condition Configuration

    Double-click on the action newly inserted, as shown in Figure 3.14, choose the ScheduleConditions tab, and the F4 help.

  • Page 13 of 33

    Figure 3.14: Specify Scheduling Conditions for an Action

    Choose the BAdI implementation for checking the status change, as shown in Figure 3.15 (seesection 1.2).

    Figure 3.15: Scheduling Condition Filter Values

  • Page 14 of 33

    Assign the following condition parameters to the condition (with the Define Parameters"pushbutton), as shown in Figure 3.16:

    ? Element: USER_STATUS? Name: User Status? Short Description: User status for which the action is performed (when status changes)? Data type: ABAP Dictionary reference Structure: TJ30, Field: ESTAT? Attributes: Select the checkbox in several rows? Initial value: Enter the status values for which the action is to be performed: E0003 (the

    action is then performed when the status changes to this value)

    Figure 3.16: Set-Up Container Values

    Figure 3.17: Define Filter Values

    (The technical keys of the status values are in the table TJ30. Select the transaction type for theService Desk messages via the status schema)

    Save the changes. Test the settings by giving a test message the status in which the message is tobe sent.

  • Page 15 of 33

    Figure 3.18: Test E-Mail Notification when Status Changes

    You can check whether the action is performed after saving, in the Action Log tab.

    Figure 3.19: Monitoring the Performance of an Action

    You can notify the reporter at all necessary times. Either define a new action and schedule it forthe status at which the E-Mail is to be sent, or schedule the existing message for severaldifferent statuses.

    Example: The message is sent in the statuses Author Action and Proposed Solution(underlying status profile: SLFC0001).

  • Page 16 of 33

    Figure 3.20: Container Values

    USER_STATUS[1] is the status Proposed Solution (E0005) and USER_STATUS[2] AuthorAction.

    You can get the technical status values by displaying the status profile of the transaction typeused. Call transaction SE16 and display the contents of table TJ30.

    Figure 3.21: Contents of Table TJ30 (Status Profile)

    Select the status profile used (e.g. SLFC0001) from the F4 help

    Figure 3.22: Status of Status Profile SLFC0001

    The technical values for the status of a message are in the column ESTAT, as shown in Figure3.23.

  • Page 17 of 33

    Figure 3.23: Technical Values for the Status of Status Profile SLFC0001

    3.2 Manual Reporter NotificationThe previous section described customizing for automatic notification of the reporter, but you canalternatively set up customizing so that an action to notify the reporter can be triggered manually.

    You specify a new action to notify the reporter, as described in section 3.1.1. and change the settingsfor the action, as shown in Figure 3.24:

    ? Sort for display? Executable in dialog? Display in toolbar? Partner-Specific | SLFN0002 (Partner function for Reporter)? Rule type: Conditions from Business Add-In (BAdI)

    Figure 3.24: Setting for Manual Actions

  • Page 18 of 33

    If a scheduling condition for a status is assigned for this action, as described in section 3.1.2, it can beperformed manually in the list of actions in the work center. The action is performed after themessage is saved.

    Figure 3.25: Action E-Mail to Reporter

    3.3 Notifying a TeamThe standard Service Desk cannot send E-Mail messages to more than one recipient with the samepartner function. The following example implementation creates a distribution group for messageprocessors, which is automatically notified by an E-Mail action when a new Service Desk message iscreated.

    3.3.1 Step 1: Create a Message Processor Distribution GroupCreate a new business partner for the distribution group, in the transaction BP, as shown in Figure3.26.

    Figure 3.26: Create a Business Partner for a Support Team

    Enter the E-Mail address under which you later want to automatically notify the message processorsin the distribution list, as shown in Figure 3.27.

  • Page 19 of 33

    Figure 3.27: Specifying the E-Mail Address of the Support TeamSave the business partner.

    3.3.2 Step 2: Create the Distribution Group in the IBaseBefore you create the business partner for the distribution group in the IBase, adjust the IBasepartner schema customizing slightly. Call the customizing view in the IMG (transaction SPRO), asshown in Figure 3.28:

    Figure 3.28: Define Partner Schema (Call in IMG)

    Change the Allowed Functions setting to All Specified Partners, as shown in Figure 3.29

  • Page 20 of 33

    Figure 3.29: Change Partner Schema for IBase

    Set-up partner inheritance, so that the business partner in the IBase hierarchy only has to bemaintained once. The information is passed on to subcomponents (SAP products and installations).Call the customizing view in the IMG, as shown in Figure 3.30.

    Figure 3.30: Partner and Address Inheritance (IMG Call)

    Select the field Partner Inheritance and enter the depth, as shown in Figure 3.31.

  • Page 21 of 33

    Figure 3.31: Partner and Address Inheritance Setting

    Save the changes.

    You can now put the business partner in the IBase. Call the transaction IB52 to change the Ibase, asshown in Figure 3.32. To identify the active Ibase, search for, for example, the external IDSOL_MAN_DATA_REP. Usually, installation 1 is used for all SAP installations.

    Figure 3.32: Transaction IB52 Initial screen

    Confirm with ENTER. Select the node to which you want to assign the business partner for thedistribution group, in the IBase structure (in this example, the business partner is assigned to theentire IBase SOL_MAN_DATA_REP, and passed on to all its subcomponents).

    Go to the Partner setting, as shown in Figure 3.33.

    Figure 3.33: Putting a Partner in the IBase

  • Page 22 of 33

    In the following dialog box, assign the business partner to SLFN0003, with the partner function.

    Figure 3.34: Entering the Partner Function Support Team

    Confirm the setting, and save the entire IBase.

    3.3.3 Step 3: Determine the Support TeamDetermine the support team by creating a Service Desk message. This example implementation tellsyou how to do so, based on the previously-described settings (sections 3.2.1 and 3.2.2).

    Partner determination can be more flexible if, for example, the support team is determined by adetermination rule, in which support teams are defined in an organization schema and identifiedautomatically by a rule (e.g. 13200137 CRM_DNO_1) when you create a Service Desk message.

    If you want to determine the partner by rules, using organization data management, implementit using the following note:SAP note 812385: Partner Determination by BADI COM_PARTNER_BADI and Access Sequence

    Implement note 1041455 as well, if you determine the support team by action. und

    The IMG contains detailed information about finding organization data, as shown in Figure 3.35:

    Figure 3.35: Determine Organization Data (IMG Settings)

  • Page 23 of 33

    The SAP Developer Network also contains a guideline for determining the support team inorganization data management. The link to the guideline is in section 4.2.

    The SAP Press publication: SAP Solution Manager Service Desk Functionality andImplementation contains further help and examples of alternative ways of determiningorganization and partner

    You put the partner function for the support team in the Service Desk message partner schema (ifstandard VAR functionality customizing is active, the standard partner schema does not contain thesupport team partner function the ISV partner schema already contains it).

    Call partner schema customizing in the IMG, as shown in Figure 3.36.

    Figure 3.36: Define Partner Schema (IMG Call)

    Select the partner schema which is assigned to the Service Desk messages transaction type (here:SLFC0001 > Standard Service Desk VAR Partner)

    Figure 3.37: Change Partner Schema Customizing Corporate MessageDouble-click on Partner Functions in Schema, in the dialog structure, and make a new entry.

  • Page 24 of 33

    Figure 3.38: Change Partner Functions in Schema

    Choose the standard partner function SLFN0003 Support Team (CRM), and maintain the generaldata as follows:

    Figure 3.39: Add Partner Function

    Set-up partner determination with the access sequence SAP Service: Determine via Ibase/Ind.

    Figure 3.40: Set-Up Partner Determination Function

    Save the customizing. The partner function for the support team is now in the partner schema.

  • Page 25 of 33

    Figure 3.41: Overview of Partner Functions in Schema

    3.3.4 Step 4: Define Notification ActionDefine a new action, to notify the support team, in the Service Desk message action profile. Make thesettings as described in section 3.1.1 except that you specify the partner function for the supportteam first:

    Figure 3.42: Specify Partner Function in the Action (transaction SPPFCADM)

    Set a different rule type for finding actions, and set the action compression, as follows.

    Figure 3.43: Set-Up Action Rule Type

    Set the Number of Actions Processed, as follows, in the Action Compression tab, so that the actionto notify by E-Mail is only performed once, when the Service Desk message is created.

  • Page 26 of 33

    Figure 3.44: Set-Up Action Compression for Actions

    Save your settings. (You can save another Smart Form for the notification > see section 3.4 forfurther information about adjusting a Smart Form)

    3.3.5 Step 5: Scheduling NotificationSpecify the action scheduling conditions, as described in section 3.1.2 except that the status isdifferent. You can schedule actions in transaction SPPFCADM or transaction SPPFDETCRM. You canspecify directly, for which action profile the conditions for actions are to be maintained.

    Figure 3.45: Scheduling Actions (transaction SPPFDETCRM)

    In this example, a notification is sent when a new message is created with the status Sent toSupport. A scheduling condition with the initial value E0010 is specified. The scheduling condition isnot checked by a BAdI.

    You can reuse an existing condition. Choose the condition AI_SDK_1STLEVEL from the F4 search help,as shown in Figure 3.46. The action is then scheduled for performance for status E0010 (Sent toSupport) of standard status schema SLFC0001 (Service Desk message VAR).

  • Page 27 of 33

    Figure 3.46: Schedule Actions

    Save the customizing and leave the transaction. Test the notification by creating a new message inthe work center.

    3.4 Adjusting the Mail Template (Header, Body), Adding FieldsThis section tells you how to create a new Smart Form for a notification text, containing a link to themessage with which the recipient can go directly to the Service Desk message in the work center.

    Call the transaction SMARTFORMS. You go to the Smart Form Builder. Copy an existing Smart Form(e.g. CRM_REMINDER_MAIL_01) into customer namespace. (Create a development package first, ifthis has not yet been done.)

    Figure 3.47: Smart Forms Transaction SMARTFORMS

    Open the newly-created Smart Form. Go to the main text with Pages and Windows FIRST MAIN MAIL CONTENT. You can change the text. In the following example Smart Form (Figure3.48) the link to the message and the current status have been added.

    You add the link to the message as follows:

  • Page 28 of 33

    ? Using the message GUID:

    http:///sap/bc/webdynpro/sap/ags_incident_trans?sap-wd-configId=AGS_INCIDENT_TRANS&GUID=

    ? Using the message number:

    http:///sap/bc/webdynpro/sap/ags_incident_trans?sap-wd-configId=AGS_INCIDENT_TRANS&MSNR=&MSTYP=

    Figure 3.48: Definition of Smart Form Text

    The message number is passed to the Smart Form at runtime, in this example. The field&orderadm_h-guid& was added to the message text.

    You can determine form interfaces for the fields provided. You can select all fields defined asimport or export parameters in the form interface, global definitions in the Smart Form, andsystem information.

    Save the Smart Form. You can now put it in the user notification action (see section 3.1.1).

    The SAP Press publication: SAP Solution Manager Service Desk Functionality andImplementation contains further information and examples of ways of configuring E-Mailactions and Smart Forms

  • Page 29 of 33

    3.5 Notification as Text or as AttachmentWhen you have set-up the actions and Smart Forms for the notification, you can specify whether thetext generated is sent directly as E-Mail text, or as an attachment to an E-Mail. Call the transactionSCOT, and double-click on the node SMTP, as shown in Figure 3.49.

    Prerequisite: You have set-up the SAPconnect interface. The SAP IMG contains further set-upinformation. Call the transaction SPRO and go to the IMG activity SOLMAN_EWA_SCOT:SAP Solution Manager: IMG -> SAP Solution Manager -> Cross-Scenario Settings -> AutomaticE-Mail -> Set-Up SAPconnect

    Figure 3.49: SAPconnect Administration (transaction SCOT)

    Go to the setting for the address type Internet.

  • Page 30 of 33

    Figure 3.50: E-Mail Settings

    You can specify whether the notification text is sent as E-Mail text (format TXT) or as an attachmentto an E-Mail (format PDF).

    Figure 3.51: SMTP Node Settings

  • Page 31 of 33

    Test mail delivery:

  • Page 32 of 33

    3.6 Change Standard Smart Form Settings

    If you want to change some of the standard attributes of a Smart Form document like changing

    ? Document title? Sender email address

    please see note 788626 PPF: adjusting the Smart Form documents for the instructions.

  • Page 33 of 33

    4 Links and Further Information

    4.1 Literature

    ? Matthias Friedrich; Torsten Sternberg: SAP Solution Manager Service Desk Functionality andImplementation. SAP PRESS 2008

    http://www.sap-hefte.de/katalog/hefte/titel/gp/titelID-1584?GalileoSession=07901481A3.V6-dwI8Y

    4.2 Links

    ? SAP Developer Network (SDN):- Support Team Determination in Organization Data Management:

    https://www.sdn.sap.com/irj/scn/weblogs?blog=/pub/wlg/7485

    4.3 Selected Notes

    ? 691303 Send E-Mail from Message after Status Change? 812385 Partner Determination via BADI COM_PARTNER_BADI and Access Sequence? 1041455 Partner-Dependent Actions are Not Performed (2)? 1034624 Relationships between Actions and Side-Effects? 1088980 SAP Solution Manager 4.0 Documentation? 949292 SAP Solution Manager: SAP Service Desk Notes? 662441 Solution Manager: SAP Support Package Notes