SAP NETWEAVER DECISION SERVICE MANAGEMENT A PARADIGM SHIFT

Size: px

Start display at page:

Download "SAP NETWEAVER DECISION SERVICE MANAGEMENT A PARADIGM SHIFT"

Cory Dalton
6 years ago
Views:

1 SAP NETWEAVER DECISION SERVICE MANAGEMENT A PARADIGM SHIFT CD160 Exercises / Solutions Alexander Held, SAP Deutschland AG & Co. KG Carsten Ziegler, SAP AG

2 2 In these exercises, we want to set up a managed system and assign a sample application to it (Exercise 1). This application derives the price of a product (Exercises 2 and 3), adds shipping costs of 5% but at least $2 if the price is under $100 (Exercise 4) and sends a notification mail if a product is not found in the price list (Exercise 4). Then we want to simulate the application on the managed system (Exercise 5) before we deploy it and call it from the managed system (Exercise 6). Finally, we will make a delta deployment with an activation timestamp in the future (Exercise 7). OGIN INFORMATION Please log on to system TDI, client 001 Your user is CD160_US (TechEd LV) or CD160 (TechEd Amsterdam, Bangalore) The password is welcome The system is an SAP NetWeaver 7.40 system with support package level 03 If the system TDI is not yet available in the SAP Logon, you need to create a connection To do so, choose the New icon Connection Select User Specified System Choose Next Enter the following values o Description: TDI o Message Server: localhost o Instance Number: 00 o System ID: TDI Choose Finish Alternatively, you can access SAP NetWeaver Decision Service Management directly be entering the following URL to your internet browser:

3 EXERCISE 1 Create a Managed System and a BRFplus Application for your

managed system Check further properties of the managed system Create a new

Management Call the transaction DSM in the SAP backend system or enter the

3 3 EXERCISE 1 Create a Managed System and a BRFplus Application for your Business Rules Call SAP NetWeaver Decision Service Management Create a managed system Check further properties of the managed system Create a new BRFplus application Walkthrough Call SAP NetWeaver Decision Service Management Call the transaction DSM in the SAP backend system or enter the link shown above A browser window will appear and Decision Service Manager starts automatically

4 Create a managed system - Choose the New icon - A dialog box in which you can specify the System Name (for example

System (select the RFC_Destination TDI using the F4 Help ) and the Documentation - The System Type field can automatically

Alternatively, you can also enter the system type yourself (for example Development System) - Choose Add to create the

4 4 Create a managed system - Choose the New icon - A dialog box in which you can specify the System Name (for example CD160_MS), Description (for example <YourName> appears: HandsOn lecture CD160 DSM), the RFC-Connection to the Managed System (select the RFC_Destination TDI using the F4 Help ) and the Documentation - The System Type field can automatically be received from the Managed System. Alternatively, you can also enter the system type yourself (for example Development System) - Choose Add to create the Managed System. Now a managed system has been added to Decision Service Manager Choose the Save button. A success message appears. Check further properties of the Managed System Select the Managed System you created before from the list shown in the table Managed Systems Check the properties in the tabs Deployment, Applications and Technical Information. On the different tabs, you can access the information relevant to your managed system. On the Deployment tab, you can

5 see all of the decision services that have been deployed to the managed system.

Currently the tab is empty because we haven't created a BRFplus application yet.

Create a new BRFplus application assigned to the managed system Navigate to the Applications tab Choose New In the Create Application dialog box, enter

5 5 see all of the decision services that have been deployed to the managed system. On the Applications tab, all BRFplus applications assigned to this managed system are displayed. Currently the tab is empty because we haven't created a BRFplus application yet. The Technical Information tab will give you an overview of some technical figures of the managed system. Create a new BRFplus application assigned to the managed system Navigate to the Applications tab Choose New In the Create Application dialog box, enter Name, Short Text, and Text, for example TechEd_<your name> (you can use the same text string for all three fields, if the text is short enough (20 characters). The Name field only allows ASCII characters, numbers, and underscores. Select the Create Local Application checkbox Choose Create. The BRFplus application will automatically be assigned to the managed system Choose Save Change to Display mode

6 EXERCISE 2 Create a Function and a Ruleset Navigate from Decision Server Manager to the BRFplus Workbench Create a decision Service (BRFplus Function) assigned to the application created in

6 6 EXERCISE 2 Create a Function and a Ruleset Navigate from Decision Server Manager to the BRFplus Workbench Create a decision Service (BRFplus Function) assigned to the application created in exercise 1 Define the signature of the function Input parameter is the product name Output parameter is the price Create a ruleset assigned to the function Walkthrough Navigate to the BRFplus Workbench Choose the Open BRFplus Workbench button to start the BRFplus Workbench. You can also use the transaction BRFplus (SAP GUI Transaction). A new browser window will open and the BRFplus Workbench is displayed. Close the DSM browser window

7 Choose the Personalize icon at the upper right of the screen and select Show in Change Mode as Viewing

By doing so, you do not need to change to edit mode in every single screen Create a BRFplus function

the application created in Exercise 1 and choose the Search button The application you ve created will

7 7 Choose the Personalize icon at the upper right of the screen and select Show in Change Mode as Viewing Mode Select the Show Technical Aspects checkbox Then choose Save. By doing so, you do not need to change to edit mode in every single screen Create a BRFplus function assigned to the Application created in Exercise 1 Choose Search on the Repository tab Enter the name of the application created in Exercise 1 and choose the Search button The application you ve created will be displayed on the Repository Tab Click on the application and select Contained Objects tab and choose Create Object (make sure function is selected)

8 Enter Name (max. 30 characters), Short Text (max.

Choose Create And Navigate To Object Define the signature of the function

Element Type Enter Name, Short Text, Text, such as Product For Length, select a

8 8 Enter Name (max. 30 characters), Short Text (max. 20 characters), and Text (max. 80 characters), such as Product Price. Choose Create And Navigate To Object Define the signature of the function Select the Signature tab Choose Add New Data Object Add New Data Object Select Element Type Enter Name, Short Text, Text, such as Product For Length, select a reasonable text length for product names, such as 40 Choose Create And Navigate To Object and choose Yes to save your entries

9 Select the Domain Values tab Choose Create Value Hint: In the Domain Value section we can define domain values/constants

When you bind your input values to a DDIC attribute, the domain values will automatically be derived from the DDIC.

Racket and choose Create Repeat that previous step for additional products, for example Baseball bar, Football, Golf club,

9 9 Select the Domain Values tab Choose Create Value Hint: In the Domain Value section we can define domain values/constants that can later be used in a value help when defining the rules. When you bind your input values to a DDIC attribute, the domain values will automatically be derived from the DDIC. DDIC values will be retrieved from the managed system automatically Enter Name, Short Text, Text, and Value, such as Tennis Racket and choose Create Repeat that previous step for additional products, for example Baseball bar, Football, Golf club, Paddle, Paint Ball Gun... When you are done, you will have a value list of products that can be used in your decision service Choose Back and confirm by choosing Yes to return to the function

.. Select Element Type Enter Name, Short Text and Text, for example, Price Select element

10 10 Make sure you are in the function editor At the Result Data Object choose the icon to the right of the word Actions and select Create... Select Element Type Enter Name, Short Text and Text, for example, Price Select element type Amount Select Positive Values (price determination should always return a positive amount that has to be paid by the customer) Choose Create

11 You have now defined the decision service Product Price.

will be returned. Now you need to define the rules for calculating the product price.

Create a Ruleset assigned to the function Select the Assigned Ruleset tab Choose Create

11 11 You have now defined the decision service Product Price. This service needs a Product and based on that the Price (including shipping costs) will be returned. Now you need to define the rules for calculating the product price. To do so, we first have to create a Ruleset (encapsulates the rules). Create a Ruleset assigned to the function Select the Assigned Ruleset tab Choose Create Ruleset Enter Name, Short Text and Text, for example, Product Price Choose Create And Navigate To Object and then choose Yes to confirm

12 12 Choose Save You have now created the framework for your decision service. What is left is to create the rules themselves and to test them and deploy them into the managed system. This will be part of the following exercises.

consideration If no matching entry is available, an initial value is returned Walkthrough In the ruleset defined in Exercise 2,

13 13 EXERCISE 3 Define a simple Rule In the ruleset defined in Exercise 2, create a rule using a decision table The decision table will return the price for a specific product If there are several entries for the same product, the first one is taken into consideration If no matching entry is available, an initial value is returned Walkthrough In the ruleset defined in Exercise 2, create a rule using a decision table Ensure you are in the ruleset editor for the ruleset you created in the last exercise Select Insert Rule Create...

14 Enter a Description, for example, Look up product price At the Then branch,

.. Select the Decision Table type Enter Name, Short Text, and Text, for example

Exercise 2 as the result data object of the decision service) Click Create And

14 14 Enter a Description, for example, Look up product price At the Then branch, choose Add Process Expression Create... Select the Decision Table type Enter Name, Short Text, and Text, for example Product Prices Select the Data Object Price as Result Data Object (you created it in Exercise 2 as the result data object of the decision service) Click Create And Navigate To the Object and confirm the popup window with Yes Choose the Table Settings button to define the condition columns for the decision table

15 Choose Insert Column under Condition Columns From Context Data Objects.

and choose OK Choose OK Choose Insert New Row Choose.

15 15 Choose Insert Column under Condition Columns From Context Data Objects... Select Product (the name of the data element that you created above in Exercise 2) and choose OK Choose OK Choose Insert New Row Choose... in the first column of the new row Enter a product name in the empty field. You now have two options. Either you can write the values directly into the empty field or you can use the value help. In the value help, you will see the domain values you created earlier in Exercise 2. After entering a value, choose OK

16 16 Choose... in the second column of the same new row Enter a price and a currency, for example, USD for US Dollars (you can select a valid currency by clicking on the icon to the right of the currency field) and choose OK. We are using US Dollars in this example. If you are going for another currency, you need to replace US Dollars with that currency in all later occurrences Repeat the last six steps (from Choose Insert New Row ) for several products. Also include at least one product more than once with different prices Choose Back and confirm by choosing Yes (now select the ruleset you created earlier) Choose OK to close the rule Look up product prices Choose Save You have now created a complete BRFplus application. In the next exercise you will extend that application by adding the shipping costs to a product that costs less than $100.

17 EXERCISE 4 Define more complex Rules Add other rules to the existing ruleset using formulas and actions (such as sending an

email address If the product was found in the decision table, derive the shipping costs (5% but at least $2 if the price is under

existing ruleset using formulas and actions In the ruleset on the right side of the that rule we already created, choose Options

17 17 EXERCISE 4 Define more complex Rules Add other rules to the existing ruleset using formulas and actions (such as sending an ) If the product was not found in the price list (price is set to initial value), trigger a notification to a fixed address If the product was found in the decision table, derive the shipping costs (5% but at least $2 if the price is under $100, $0 if the price is $100 or more) by using a formula and add the costs to the price Walkthrough Add other rules to the existing ruleset using formulas and actions In the ruleset on the right side of the that rule we already created, choose Options Insert Next Rule by... Create... Enter a Description, such as Product not valid Choose Assign Condition... Use Value Range From... Context Price

Name, Short Text, and Text, for example,

18 18 Select condition is intial Under the Then branch choose Add Perform Action Create... Select type Send (Action) Enter Name, Short Text, and Text, for example, Notification Mail Choose Create And Navigate To Object and confirm by choosing Yes

19 In the Recipient(s) field, enter an arbitrary email address (We are not going to actually send a mail.

replace the product name by &1, for example, Hello customer, product &1 does not exist.

19 19 In the Recipient(s) field, enter an arbitrary address (We are not going to actually send a mail. The address still needs to be technically correct, however it does not need to exist) Enter some Subject, for example, Notification: Product not available Enter the body text, where you can replace the product name by &1, for example, Hello customer, product &1 does not exist. Regards, Your Sales Team Choose Refresh Message Placeholders Choose the icon to the right of Placeholder 1 and select Context Parameters Choose Back and confirm by choosing with Yes (the rule should now be selected) Choose OK again In the ruleset on the right side of the rule that you created earlier, choose Options Insert Next Exit Condition Use Value Range from Context Price

20 Select is initial as condition In the ruleset

created before, choose Options Insert Next Rule

.. Enter a Description, for example Add Shipping

20 20 Select is initial as condition In the ruleset on the right side of the exit condition that you created before, choose Options Insert Next Rule Create... Enter a Description, for example Add Shipping Costs Choose Assign Condition... Use Value Range From... Context Price Select is less than as condition and insert 100 USD in the value field In the THEN branch, choose Add Process Expression Create...

21 Select Formula type Enter Name, Short Text, and Text, for example, Add Shipping Costs Select Price as the result data object Choose Create And Navigate To

Price + MAX ( 2_USD, Price * 0,05 ) for TechEd Amsterdam and Bangalore; for TechEd Las Vegas, please use 0.05 instead of 0,05.

21 21 Select Formula type Enter Name, Short Text, and Text, for example, Add Shipping Costs Select Price as the result data object Choose Create And Navigate To Object and confirm by choosing Yes By using the context elements, operators, and formula function offered on the lower part of the screen, enter the formula: Price + MAX ( 2_USD, Price * 0,05 ) for TechEd Amsterdam and Bangalore; for TechEd Las Vegas, please use 0.05 instead of 0,05. Choose the Check button to make sure that the formula is consistent Choose Back and confirm the dialog box by choosing Yes (the rule should now be selected) Choose OK. You should now be back in the ruleset

22 You have now finished modelling your business rules! The next exercise will guide you through activating and testing your rules on the managed system 22

once, and watch the results Check the intermediate results of rules processing Walkthrough Activate all of the created objects

23 23 EXERCISE 5 Simulate the Rules on the Managed System (Remote Simulation) Activate all created objects Run the function in simulation mode on the managed system Enter different products, including products that are not listed or are listed more than once, and watch the results Check the intermediate results of rules processing Walkthrough Activate all of the created objects If the repository tree is collapsed, expand it In the repository tree on the left, select the ruleset you created earlier Choose Activate

24 Make sure that the Include Referenced Objects checkbox is selected Confirm the dialog box by choosing Yes On the upper left of

repository tree, indicating that they are active Run the function in simulation mode on the managed system In the repository tree

Select Remote (Current Version) in the Simulation Mode section.

24 24 Make sure that the Include Referenced Objects checkbox is selected Confirm the dialog box by choosing Yes On the upper left of the screen, you should see the success message Objects activated and all of the objects you created should show a green icon in the repository tree, indicating that they are active Run the function in simulation mode on the managed system In the repository tree on the left, select the function you created earlier Choose Start Simulation. A dialog box appears. Select Remote (Current Version) in the Simulation Mode section. This option will deploy your decision service into the managed system specified in the Managed System section (decision service not active for productive use). Please select the managed system you created in Exercise 1. Choose Continue

Processing Steps Notice the resulting price at the top of the screen When you

25 25 Enter a product (you can select products you created earlier by clicking on the icon to the right of the input field) Choose Execute and Display Processing Steps Notice the resulting price at the top of the screen When you are finished with the simulation of your Decision Service, choose Back to Workbench.

26 EXERCISE 6 Deploy the Decision Service to the Managed System Deploy the decision service into your managed system Select the managed system

Implement an ABAP report that calls the deployed decision service Hint: The second part of the exercise is intended for people who are familiar

Decision Service Manager. Click in the toolbar on Workbench Open Decision Service Manager or enter the transaction DSM in the SAP GUI.

26 26 EXERCISE 6 Deploy the Decision Service to the Managed System Deploy the decision service into your managed system Select the managed system you created in Exercise 1 Make a test deployment and then deploy the decision service Execute your decision service in the managed system Implement an ABAP report that calls the deployed decision service Hint: The second part of the exercise is intended for people who are familiar with ABAP Programming Walkthrough Deploy the decision service into your managed system Navigate from the BRFplus Workbench directly to the Decision Service Manager. Click in the toolbar on Workbench Open Decision Service Manager or enter the transaction DSM in the SAP GUI. The DSM Workbench will now open in a new browser session. Select the managed system you created in Exercise 1 and on the Deployment tab, choose the Deployment Test button

27 Select the BRFplus function you created in Exercise 2. Enter the name of your function, for example, Product* and choose the Search button Mark your function and choose Run Test.

27 27 Select the BRFplus function you created in Exercise 2. Enter the name of your function, for example, Product* and choose the Search button Mark your function and choose Run Test. DSM will now check whether your function can be deployed to the managed system After the test deployment has been performed, the message Deployment test was successful, do you want to deploy now? will appear. Choose Yes to start the deployment In the dialog box, please enter some form of documentation, such as Initial deployment of the Decision Service Product Price Select Intermediate Deployment as the activation time and click on Deploy In the upper part of the screen, two success messages are displayed. On the Deployment tab, you will now see that your function has been deployed to the managed system. Click in the column Documentation and check the entries Congratulations! You have deployed your first decision service into a managed system. In the next step, we will execute your decision service in the managed system.

Executable program as type and Test Program as Status and press Save In the pop up choose Local Object Call the ABAP Editor (transaction SE38) Create a local report with the following name

28 28 Execute your decision service in the managed system Go to the Deployment tab Select the decision service, for example, Product Price. The BRFplus Workbench will open Choose Create Code Template Deselect the Show Comments checkbox Choose Apply Copy the text Switch to the SAP GUI In the popup enter a tile and choose the Executable program as type and Test Program as Status and press Save In the pop up choose Local Object Call the ABAP Editor (transaction SE38) Create a local report with the following name ZZ_CALL_TECHED_EX_CD 160 Paste the copied text into the report Insert the variable lv_price of type if_fdt_types=>element_amou nt to the Data-Statement Replace the text [INSERT CONTEXT VALUE HERE OR DELETE THE LINE]. with one of the products

29 29 At the end of the report, include the following: Save, Activate, and Run the Report LO_PROCESSOR will find the deployed code of the decision service and execute it The result should be the same as in the simulation in Exercise 5

30 EXERCISE 7 Change Rules in the Decision Service and make a Delta Deployment Change the rules in the DSM System Go to the decision table PRODUCT_PRICES and adjust the price Simulate the function

Perform a delta deployment Deploy the decision service to the managed system as a future deployment (current time + 5 minutes) Execute the report created in Exercise 6 Wait 5 minutes and run the

30 30 EXERCISE 7 Change Rules in the Decision Service and make a Delta Deployment Change the rules in the DSM System Go to the decision table PRODUCT_PRICES and adjust the price Simulate the function Execute the report you created in Exercise 6 again. What do think will happen? Perform a delta deployment Deploy the decision service to the managed system as a future deployment (current time + 5 minutes) Execute the report created in Exercise 6 Wait 5 minutes and run the report again Walkthrough Change the rules in the DSM System Select Open BRFplus Workbench in Decision Service Manager The BRFplus Workbench appears in a new browser window. Choose Search and enter the name of the application you created in Exercise 1. Choose Application as the Object Type. Choose Search. On the left-hand side, in the navigation area, the application you created is displayed Expand the repository tree and navigate to Expression Decision Table

Select Remote (Current Version) for the simulation mode. Select the managed system you created in Exercise 1 and choose Continue Enter a product whose price you change.

31 31 Product Price Change the price for all products (click directly on the price and table open. Change the price and choose OK) Activate the decision table In the repository tree, go to your function Choose Simulation and simulate the function as explained in Exercise 5. Select Remote (Current Version) for the simulation mode. Select the managed system you created in Exercise 1 and choose Continue Enter a product whose price you change. The price should now be calculated based on your change Go to the SAP GUI and navigate to the report you created in Exercise 6 and execute it. (Make sure the product is the same as in your simulation). The prices calculated in the simulation and by the report are different. Since we only changed the prices in the DSM system, the managed system will not be affected by those changes. So it would be possible to test all changes in the rules before deploying them to the productive environment In the next step we will perform a delta deployment and distribute the new decision service to the managed system Perform a delta deployment Call transaction DSM from SAP GUI Select the managed system you created in Exercise 1 and click on the Deployment tab, choose Deploy button Select the BRFplus function you created in Exercise 2. Enter the name of your function, for example, Price* and choose Search

32 On the screen, please enter a description, for example, Delta Deployment. Prices Changed for all products. Go Live of new rules will be in 5 minutes.

decision service. (The service deployed previously will be valid in 5 minutes as long as the old decision service is processed). Navigate to the report you created in the previous exercise.

32 32 On the screen, please enter a description, for example, Delta Deployment. Prices Changed for all products. Go Live of new rules will be in 5 minutes... Select As on Date/Time as the activation time, define the current time + 5 minutes as timestamp and Choose Deploy Check the valid from/valid to timestamps on the Deployment tab for your decision service. (The service deployed previously will be valid in 5 minutes as long as the old decision service is processed). Navigate to the report you created in the previous exercise. Execute it. You will get the same result as before. Please write down the result. Wait 5 minutes and then execute your report again. Compare the current result with the result you wrote down. The price should now be different from 5 minutes ago!

33 2013 by SAP AG or an SAP affiliate company. 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. National product specifications may vary. 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. SAP 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 other countries. Please see for additional trademark information and notices.