BRF

How to Check or Derive an Attribute Value in MDG using BRFPlusApplies to: SAP Master Data Governance, as of SAP Master Data Governance 6.1 (or lower). Summary With SAP Master Data Governance you can use BRFplus to define rules for checking attribute values or to derive them. This step-by-step guide shows you how to create such a rule. This procedure can be applied to any MDG application or data model. The MDG for Custom Objects Example Scenario is used as an easy to understand basis for this how to document. Author: Andreas Seifried Company: SAP AG Created on: 9 October 2012 Author Bio Andreas is a Product Manager for SAP Master Data Management. He joined SAP in 2001 as a Technical Consultant and has been working with SAP NetWeaver in customer projects since the very first releases. In July 2005 he changed his position to SAP NetWeaver MDM Product Management. Meanwhile Andreas works as a Product Manager for the overall SAP Master Data Management portfolio. Andreas holds a diploma in engineering of Fridericiana University Karlsruhe and has over 15 years of experience in the IT industry. SAP COMMUNITY NETWORK © 2011 SAP AG SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 1 How to Check or Derive an Attribute Value in MDG using BRFPlus Table of Contents Relevant Documentation .................................................................................................................................... 3 Example Scenario ............................................................................................................................................... 3 Objective ............................................................................................................................................................. 3 Step 1 – Identify name of attribute and name of entity type ........................................................................... 4 Step 2 – Create BRFplus objects for check .................................................................................................... 6 Step 3 – See the check function working ...................................................................................................... 15 Step 4 – Create a derivation rule with BRFplus ............................................................................................ 16 Step 5 – Hint for troubleshooting .................................................................................................................. 18 Related Content ................................................................................................................................................ 20 Copyright........................................................................................................................................................... 21 SAP COMMUNITY NETWORK © 2011 SAP AG SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 2 com/docs/DOC-7858 ) Example Scenario I assume that you followed this configuration description and have the scenario up and running in your system: SAP Master Data Governance 6.sap.How to Check or Derive an Attribute Value in MDG using BRFPlus Relevant Documentation SAP Master Data Governance 6.uac.com 3 .com | BOC .sap.sap.com | BPX .sdn.boc.sap.sap. particularly on how to apply rules. see the MDG Extensibility Center (http://scn. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .bpx.1 – SAP Help Portal Page -> Application Help -> Configuration of Master Data Governance -> Configuring Master Data Governance for Custom Objects -> Definition of Validations and Derivations For more comprehensive information. checks and derivation to MDG for Material.1 – SAP Help Portal Page -> Application Help -> Configuration of Master Data Governance -> Configuring Master Data Governance for Custom Objects -> Master Data Governance for Custom Objects: Example Scenario Conf (at bottom of page) Objective As an example the value of the airline local currency should be checked: It must not be DEM (Deutsche Mark) or GRD (Greek Drachma).com | UAC . boc.How to Check or Derive an Attribute Value in MDG using BRFPlus Step 1 – Identify name of attribute and name of entity type Open IMG using transaction MDGIMG. then Visualize Data Model. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .com 4 .com | BOC .bpx.sap.com | UAC . Select the SF example data model. select Edit Data Model.com | BPX .uac.sap.sap.sdn.sap. sap.boc.com | BOC .sap. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .uac.sap.sdn.bpx.com | BPX . you see that the attribute Airline local currency is technically named CURRCODE and belongs to the entity type CARR.com | UAC .com 5 .sap.How to Check or Derive an Attribute Value in MDG using BRFPlus By examining the structure. sdn.com | UAC .sap. SAP COMMUNITY NETWORK © 2011 SAP AG SDN . and then select Define Validation and Derivation Rules.uac.sap. select Continue.bpx.com 6 .boc.com | BPX .sap.com | BOC . Enter SF as the id of the example data model.How to Check or Derive an Attribute Value in MDG using BRFPlus Step 2 – Create BRFplus objects for check Go back to the IMG again.sap. sap. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .sdn.sap.sap.com | UAC . Be aware that the names of the folders do not influence the execution of the BRFplus functions.com | BPX .bpx. as it defines that this function will be called during the check cycle (CHECK) and for the entity type CARR. then from the context menu Create Object Node -> Create Function.com | BOC .com 7 .sap.boc.uac. Name the function CHECK_CARR.How to Check or Derive an Attribute Value in MDG using BRFPlus MDG provides you with a set of folders to organize the BRFplus objects. Only the name of the function is important! Select the folder Check Entity. Select Create and Navigate to Object. It is important to choose this name. sap.com | UAC .How to Check or Derive an Attribute Value in MDG using BRFPlus Confirm the name of the BRFplus catalog node.sap.com | BOC .sap.com 8 . First you need to define the context of the function.uac.sap.sdn.bpx. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .com | BPX .boc. Select Add Existing Data Object. sap.sap. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .com | UAC .sdn. it depends on MDG whether these objects will contain data during runtime or not. please see the online documentation of Definition of Validations and Derivations. MDG will always provide the data of the respective entity type. select the corresponding entry.sap.com | BPX .sap.boc. IMPORTANT: Even if you can add as many different data objects to the signature of the BRFplus function as you want. For a CHECK_<ENTITY_TYPE> function. For further information.uac.bpx.How to Check or Derive an Attribute Value in MDG using BRFPlus Since we want to check entities of type CARR.com 9 .com | BOC . com 10 .bpx.sap.sap.How to Check or Derive an Attribute Value in MDG using BRFPlus Switch to tab Assigned Rulesets.com | BPX .boc.com | BOC .com | UAC .uac.sap. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .sap.sdn. sap.com 11 . SAP COMMUNITY NETWORK © 2011 SAP AG SDN .sap.com | UAC .sap.bpx.sdn.How to Check or Derive an Attribute Value in MDG using BRFPlus Then select Create Ruleset.boc. select Create and Navigate to Object. Choose any name for the ruleset.uac.sap.com | BPX .com | BOC . boc.com | BPX .sdn. create a new rule.sap.How to Check or Derive an Attribute Value in MDG using BRFPlus Confirm save.com | UAC .sap.uac.com 12 . For the new ruleset.com | BOC .sap. then selecting Add -> Perform Action -> Create.sap. SAP COMMUNITY NETWORK © 2011 SAP AG SDN . by selecting Insert Rule -> Create… Start defining the rule using the BRFplus editor by choosing the appropriate condition.bpx. com | BOC .com | BPX .sap.bpx.uac. Confirm save.sap.sap.boc. select Create and Navigate to Object.sdn.How to Check or Derive an Attribute Value in MDG using BRFPlus Select the type Log Action for the new action and choose any name.com | UAC .com 13 . SAP COMMUNITY NETWORK © 2011 SAP AG SDN .sap. com | UAC .How to Check or Derive an Attribute Value in MDG using BRFPlus Enter a message text.sap.boc.sap.com | BOC . Also activate the ruleset. BRFplus will allow you to choose the values for the variables. Please note that you can use variables with the &n notation.com 14 . As soon as you hit enter.uac.sap.com | BPX . SAP COMMUNITY NETWORK © 2011 SAP AG SDN .sdn.bpx. Select Activate.sap. sap.sdn.com | UAC .com | BPX . SAP COMMUNITY NETWORK © 2011 SAP AG SDN .com | BOC .sap.boc.bpx.com 15 .sap.uac.sap. Note that you need to restart the Web Dynpro application.How to Check or Derive an Attribute Value in MDG using BRFPlus Step 3 – See the check function working Then verify the correct execution of the rule. DERIVE indicates that the function will be called by MDG during the derive cycle. you can also define rules for deriving attribute values.com 16 . CARR that it will be called for entities of type CARR. For that.com | BPX .sdn.sap. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .boc. create a new function below the Derive Entity folder. only the name of the derivation function is important. As for the check function.How to Check or Derive an Attribute Value in MDG using BRFPlus Step 4 – Create a derivation rule with BRFplus In a similar way.uac.com | BOC . Let’s define a function to derive the value of attribute URL of entity type CARR by naming the function DERIVE_CARR.com | UAC .sap.sap.bpx. not the folders where you locate the catalog object.sap. sap.boc.sdn. do this as shown on the screenshot.com | UAC . but simple example .bpx. assign the value of CARR-Name to CARR-Url. When you leave the attribute Airline URL empty and press Check.com 17 . the BRFplus function DERIVE_CARR will be triggered and the attribute Airline URL will be filled with the name of the airline.-) ) After having activated ruleset and function.com | BOC . (Stupid. this value will be converted to lower case and be prefixed with http:// .com | BPX . At the point where you define the rule.sap. As the condition use CARR-URL is initial.sap.How to Check or Derive an Attribute Value in MDG using BRFPlus Proceed as in the example for the check function. Because the access class of the example scenario also includes some check and derivation logic.sap. you can check the result by launching Create Airline again. and in the Then part. SAP COMMUNITY NETWORK © 2011 SAP AG SDN .uac. sap.sap.sap.com | BOC . You can easily switch it on or off using the Enabled flag.com 18 .How to Check or Derive an Attribute Value in MDG using BRFPlus Step 5 – Hint for troubleshooting When starting to work with BRFplus rules in MDG.com | BPX . SAP COMMUNITY NETWORK © 2011 SAP AG SDN .boc.sdn. it is a good idea to include a ruleset for debugging purposes in order to see whether the rule is actually triggered and to check values within the BRFplus context.sap.bpx.com | UAC .uac. com | BOC .sap.bpx.com | UAC .sap.com 19 .sap.sap.sdn.How to Check or Derive an Attribute Value in MDG using BRFPlus SAP COMMUNITY NETWORK © 2011 SAP AG SDN .com | BPX .boc.uac. com | BPX .com | BOC .sap.com | UAC .sdn.com 20 .bpx.How to Check or Derive an Attribute Value in MDG using BRFPlus Related Content Extensibility Options for SAP Master Data Governance SAP Master Data Governance Community on SCN How-to guide .boc.sap.sap.sap.Overview of the checks which are used in MDG-M with examples for checks and derivations built in BRFplus SAP COMMUNITY NETWORK © 2011 SAP AG SDN .uac. sap.uac. IBM. z/OS. POWER. Java is a registered trademark of Sun Microsystems. Inc. Parallel Sysplex. BladeCenter. Inc. Crystal Reports. HACMP. GPFS. ICA. System z9. World Wide Web Consortium. PartnerEdge. System i.com 21 . ByDesign.How to Check or Derive an Attribute Value in MDG using BRFPlus Copyright © Copyright 2012 SAP AG.boc. Excel. The information contained herein may be changed without prior notice.bpx. Adobe.sap. DB2. 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. System z.com | UAC . and MultiWin are trademarks or registered trademarks of Citrix Systems. SAP Business ByDesign. Business Objects is an SAP company. PowerVM. without representation or warranty of any kind. R/3. Redbooks. POWER5+. xSeries. Tivoli and Informix are trademarks or registered trademarks of IBM Corporation. the Adobe logo. S/390 Parallel Enterprise Server. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. S/390. Linux is the registered trademark of Linus Torvalds in the U. System p. Acrobat. JavaScript is a registered trademark of Sun Microsystems. System p5.sdn. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. MVS/ESA. Crystal Decisions. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only. SAP. SAP COMMUNITY NETWORK © 2011 SAP AG SDN . BatchPipes. and Motif are registered trademarks of the Open Group. POWER6. System x. zSeries. z/VM. System i5.com | BOC . Outlook. Inc. OS/2. and other countries.A. System Storage. Massachusetts Institute of Technology. z9.. POWER5. System z10. Netfinity. OS/390. X/Open. and SAP Group shall not be liable for errors or omissions with respect to the materials. VideoFrame. Oracle is a registered trademark of Oracle Corporation. Xcelsius. OSF/1. 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. WinFrame. POWER6+. and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects S. AS/400. pSeries. UNIX. Power Architecture. Web Intelligence. in the United States and in other countries. Citrix. Business Objects and the Business Objects logo. Windows. Program Neighborhood. XHTML and W3C are trademarks or registered trademarks of W3C®. Microsoft. PostScript. z10. XML. and PowerPoint are registered trademarks of Microsoft Corporation. i5/OS. All other product and service names mentioned are the trademarks of their respective companies. HTML. All rights reserved. AIX. WebSphere. used under license for technology invented and implemented by Netscape.sap.sap. OS/400. Duet. RETAIN. RACF. Intelligent Miner. iSeries. DB2 Connect. eServer.com | BPX . and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries. DB2 Universal Database. PowerPC. OpenPower.S. if any. SAP NetWeaver. BusinessObjects. These materials are subject to change without notice. MetaFrame. National product specifications may vary. Nothing herein should be construed as constituting an additional warranty. Data contained in this document serves informational purposes only.