sap em- event 0essage 3rofiles for 6ending parameters

SAP EM - Event Message Profiles for SendingParametersHow to set up event message profiles to send eventmessages with parameters via the EM Web UI

Author: Daniel HärderDocument Date: 17.01.2013

SAP EM - Event message profiles for sending parameters

2

TABLE OF CONTENTS

SUMMARY .................................................................................................................................................. 3EVENT MESSAGE PROFILE CUSTOMIZING ............................................................................................. 3Event Reporting Items ............................................................................................................................... 3Event Reporting Details ............................................................................................................................... 4Configured Field LATITUDE_ACT ................................................................................................................ 4Configured Field LATITUDE_NAME ............................................................................................................. 5Configured Field LATITUDE_TYPE .............................................................................................................. 6Configured Field LATITUDE_VAL ................................................................................................................ 6Event Confirmation Details........................................................................................................................ 7Configured Field ODT30_EVM_LATITUDE .................................................................................................. 8Display Profile ODT30_SHIPPER_BO ......................................................................................................... 8

SENDING EVENT MESSAGES ................................................................................................................... 8Send Event Message ................................................................................................................................. 8Report All Expected Events....................................................................................................................... 9TECHNICAL DETAILS ................................................................................................................................ 9


3

SUMMARYThis document gives an overview of the necessary customizing settings to send an event message withparameters form the EM Web UI.

EVENT MESSAGE PROFILE CUSTOMIZING

You can either report an expected event or send an event message from the EM Web UI. For both options itis possible to add parameters to the event message. In the following the customizing is shown that is neededto achieve this. The example can be found in the user profile ODT30_SHIPPER_BO, which is part of thecontent of SAP EM 9.0 and which is used to track ocean bookings that have been extracted from SAP TM. Inthe two shown cases an event message parameter for the latitude (geo coordinate) is send with the eventmessage.

Event Reporting Items

For each parameter that shall be sent with an event message four configured fields are needed, that have tohave a common row number. They have to refer to the following EM attribute IDs:

PARAMETER ACTION PARAMETER NAME PARAMETER TYPE PARAMETER VALUE

Technically it is also possible to add a configured field for the EM attribute ID PARAMETER_INDEX. By thisthe user would be able to provide the index of a control or info parameter.

In the event message profile ODT30_SHIPPER_BO there is the example of the event message parameterLATITUDE which is send with event reporting item “DELAYED”. For this the following four configured fieldshave been created and assigned to the event reporting item with row number 1:

LATITUDE_ACT LATITUDE_NAME LATITUDE_TYPE LATITUDE_VAL

The details of the event message profile and these configured fields can be found in the following screenshots. Configured field LATITUDE_VAL is the only one that is visible (display mode “Write”) on the screen,all others are hidden and have fixed values.


4

Event Reporting Details

Configured Field LATITUDE_ACT

For event message parameters the type can be left empty. So this configured field is not mandatory in thiscase. If you want to send control or info parameters and use e.g. rule set activity PARAMETER_CHANGEthe parameter action should be set in the defined value of this configured field.


5

Configured Field LATITUDE_NAME

The defined value of the configured field that is based on EM attribute ID PARAMETER_NAME has to be theexternal parameter name. In this case this is “LATITUDE”, which is then mapped to the internal parametername “ODT30_EVM_LATITUDE” in the event message parameter mapping.


6

Configured Field LATITUDE_TYPE

For event message parameters the type can be left empty. So this configured field is not mandatory in thiscase. If you want to send control or info parameters and use e.g. rule set activity PARAMETER_CHANGEthe parameter type should be set in the defined value of this configured field.

Configured Field LATITUDE_VAL

This is the field which is used for the user input of the parameter value on the Web UI.


7

Event Confirmation Details

The customizing to set up the event confirmation details for sending parameters is almost the same as forthe event reporting items. For the parameter action, the parameter name and the parameter type the sameconfigured fields can be used. For the parameter value the configured field should have the same name asused in the event display details to display the parameter. By this it can be achieved that an possibly existingvalue is already displayed in the event confirmation screen.


8

Configured Field ODT30_EVM_LATITUDE

Display Profile ODT30_SHIPPER_BO

SENDING EVENT MESSAGES

The following two screenshots show how the above described customizing settings are displayed on the EMWeb UI.

Send Event Message


9

Report All Expected Events

TECHNICAL DETAILS

When such an event message is sent from the EM Web UI technically the following happens. All theconfigured fields that refer to a parameter and have the same row number are used to create one entry intable TRACKPARAMETERS as input for BAPI /SAPTRX/BAPI_EH_ADDEVENTMSG_02. The mapping isas follows:

PARAMETER TYPE -> PARTYP PARAMETER NAME -> PARAM_NAME PARAMETER VALUE -> PARAM_VALUE PARAMETER ACTION -> ACTION

© 2012 SAP AG. All rights reserved.

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAPBusinessObjects Explorer, StreamWork, SAP HANA, and other SAPproducts and services mentioned herein as well as their respectivelogos are trademarks or registered trademarks of SAP AG in Germanyand other countries.

Business Objects and the Business Objects logo, BusinessObjects,Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, andother Business Objects products and services mentioned herein aswell as their respective logos are trademarks or registered trademarksof Business Objects Software Ltd. Business Objects is an SAPcompany.

Sybase and Adaptive Server, iAnywhere, Sybase 365, SQLAnywhere, and other Sybase products and services mentioned hereinas well as their respective logos are trademarks or registeredtrademarks of Sybase Inc. Sybase is an SAP company.

Crossgate, m@gic EDDY, B2B 360°, and B2B 360° Services areregistered trademarks of Crossgate AG in Germany and othercountries. Crossgate is an SAP company.

All other product and service names mentioned are the trademarks oftheir respective companies. Data contained in this document servesinformational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materialsare provided by SAP AG and its affiliated companies ("SAP Group")for informational purposes only, without representation or warranty ofany kind, and SAP Group shall not be liable for errors or omissionswith respect to the materials. The only warranties for SAP Groupproducts and services are those that are set forth in the expresswarranty statements accompanying such products and services, ifany. Nothing herein should be construed as constituting an additionalwarranty.

www.sap.com

sap em- event 0essage 3rofiles for 6ending parameters

Documents