of 265 /265
Informatica PowerExchange for SAP NetWeaver (Version 9.1.0 HorFix 1) User Guide for PowerCenter

(Version 9.1.0 HorFix 1) Informatica PowerExchange for SAP ... · Informatica PowerExchange for SAP NetWeaver (Version 9.1.0 HorFix 1) User Guide for PowerCenter

  • Author
    others

  • View
    16

  • Download
    0

Embed Size (px)

Text of (Version 9.1.0 HorFix 1) Informatica PowerExchange for SAP ... · Informatica PowerExchange for SAP...

  • Informatica PowerExchange for SAP NetWeaver(Version 9.1.0 HorFix 1)

    User Guide for PowerCenter

  • Informatica PowerExchange for SAP NetWeaver User Guide for PowerCenter

    Version 9.1.0 HorFix 1June 2011

    Copyright (c) 1998-2011 Informatica. All rights reserved.

    This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing restrictions on use anddisclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in any form,by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. This Software may be protected by U.S. and/or internationalPatents and other Patents Pending.

    Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as provided inDFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013 © (1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT III), asapplicable.

    The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to us inwriting.

    Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange,PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica OnDemand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging and InformaticaMaster Data Management are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other companyand product names may be trade names or trademarks of their respective owners.

    Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies. All rightsreserved. Copyright © Sun Microsystems. All rights reserved. Copyright © RSA Security Inc. All Rights Reserved. Copyright © Ordinal Technology Corp. All rightsreserved.Copyright © Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright © MetaIntegration Technology, Inc. All rights reserved. Copyright © Intalio. All rights reserved. Copyright © Oracle. All rights reserved. Copyright © Adobe Systems Incorporated. Allrights reserved. Copyright © DataArt, Inc. All rights reserved. Copyright © ComponentSource. All rights reserved. Copyright © Microsoft Corporation. All rights reserved.Copyright © Rogue Wave Software, Inc. All rights reserved. Copyright © Teradata Corporation. All rights reserved. Copyright © Yahoo! Inc. All rights reserved. Copyright ©Glyph & Cog, LLC. All rights reserved. Copyright © Thinkmap, Inc. All rights reserved. Copyright © Clearpace Software Limited. All rights reserved. Copyright © InformationBuilders, Inc. All rights reserved. Copyright © OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved. Copyright Cleo Communications, Inc. All rightsreserved. Copyright © International Organization for Standardization 1986. All rights reserved. Copyright © ej-technologies GmbH . All rights reserved. Copyright © JaspersoftCorporation. All rights reserved.

    This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and other software which is licensed under the Apache License,Version 2.0 (the "License"). You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing,software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See theLicense for the specific language governing permissions and limitations under the License.

    This product includes software which was developed by Mozilla (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved; software copyright ©1999-2006 by Bruno Lowagie and Paulo Soares and other software which is licensed under the GNU Lesser General Public License Agreement, which may be found at http://www.gnu.org/licenses/lgpl.html. The materials are provided free of charge by Informatica, "as-is", without warranty of any kind, either express or implied, including but notlimited to the implied warranties of merchantability and fitness for a particular purpose.

    The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California, Irvine,and Vanderbilt University, Copyright ( © ) 1993-2006, all rights reserved.

    This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and redistribution ofthis software is subject to terms available at http://www.openssl.org and http://www.openssl.org/source/license.html.

    This product includes Curl software which is Copyright 1996-2007, Daniel Stenberg, . All Rights Reserved. Permissions and limitations regarding thissoftware are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for any purpose with or withoutfee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

    The product includes software copyright 2001-2005 ( © ) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms availableat http://www.dom4j.org/ license.html.

    The product includes software copyright © 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to termsavailable at http://dojotoolkit.org/license.

    This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations regarding thissoftware are subject to terms available at http://source.icu-project.org/repos/icu/icu/trunk/license.html .

    This product includes software copyright © 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at http://www.gnu.org/software/ kawa/Software-License.html.

    This product includes OSSP UUID software which is Copyright © 2002 Ralf S. Engelschall, Copyright © 2002 The OSSP Project Copyright © 2002 Cable & WirelessDeutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php .

    This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software are subjectto terms available at http:/ /www.boost.org/LICENSE_1_0.txt. This product includes software copyright © 1997-2007 University of Cambridge. Permissions and limitationsregarding this software are subject to terms available at http://www.pcre.org/license.txt.

    This product includes software copyright © 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to termsavailable at http://www.eclipse.org/org/documents/epl-v10.php.

    This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?License, http://www.stlport.org/doc/ license.html, http://www.asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://httpunit.sourceforge.net/doc/license.html, http://jung.sourceforge.net/license.txt, http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/release/license.html, http://www.libssh2.org,http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, http://fusesource.com/downloads/license-agreements/fuse-message-broker-v-5-3- license-agreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/licence.html; http://www.jgraph.com/jgraphdownload.html; http://www.jcraft.com/jsch/LICENSE.txt. http://jotm.objectweb.org/bsd_license.html; http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231; http://www.slf4j.org/license.html; http://developer.apple.com/library/mac/#samplecode/HelpHook/Listings/HelpHook_java.html; http://www.jcraft.com/jsch/LICENSE.txt;http://nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/license.html; and http://forge.ow2.org/projects/javaservice/.

    This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), the Common Development and DistributionLicense (http://www.opensource.org/licenses/cddl1.php) the Common Public License (http://www.opensource.org/licenses/cpl1.0.php), the Sun Binary Code LicenseAgreement Supplemental License Terms, the BSD License (http://www.opensource.org/licenses/bsd-license.php) and the MIT License (http://www.opensource.org/licenses/mit-license.php).

  • This product includes software copyright © 2003-2006 Joe WaInes, 2006-2007 XStream Committers. All rights reserved. Permissions and limitations regarding this softwareare subject to terms available at http://xstream.codehaus.org/license.html. This product includes software developed by the Indiana University Extreme! Lab. For furtherinformation please visit http://www.extreme.indiana.edu/.

    This Software is protected by U.S. Patent Numbers 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775;6,640,226; 6,789,096; 6,820,077; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,254,590; 7,281,001; 7,421,458; 7,496,588; 7,523,121; 7,584,422, 7,720,842;7,721,270; and 7,774,791 , international Patents and other Patents Pending.

    DISCLAIMER: Informatica Corporation provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the impliedwarranties of oninfringement, merchantability, or use for a particular purpose. Informatica Corporation does not warrant that this software or documentation is error free. Theinformation provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation issubject to change at any time without notice.

    NOTICES

    This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies, an operating company of Progress SoftwareCorporation ("DataDirect") which are subject to the following terms and conditions:

    1.THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOTLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.

    2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT INFORMED OFTHE POSSIBILITIES OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT LIMITATION, BREACHOF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS.

    Part Number: PWX-SPU-91000-HF1-0001

  • Table of Contents

    Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiiInformatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

    Informatica Customer Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

    Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

    Informatica Web Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

    Informatica How-To Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

    Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

    Informatica Multimedia Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

    Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

    Part I: Getting Started with PowerExchange for SAP NetWeaver. . . . . . . . . . . . . . . . . . . . . 1

    Chapter 1: Understanding PowerExchange for SAP NetWeaver. . . . . . . . . . . . . . . . . . 2Understanding PowerExchange for SAP NetWeaver Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

    PowerCenter and SAP NetWeaver Integration Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

    Data Integration Using the ABAP Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

    IDoc Integration Using ALE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

    Data Integration Using BAPI/RFC Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

    Data Migration Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

    Business Content Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

    PowerCenter and SAP NetWeaver BI Integration Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

    Communication Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

    Common Program Interface-Communications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

    Remote Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

    Transport System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

    Operating System Profiles for SAP Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

    Chapter 2: Installing and Configuring PowerExchange for SAP NetWeaver. . . . . . . . . 7Installing and Configuring PowerExchange for SAP NetWeaver Overview. . . . . . . . . . . . . . . . . . . . . . 7

    Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

    Installing PowerExchange for SAP NetWeaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

    Upgrading PowerExchange for SAP NetWeaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

    Upgrading to PowerExchange for SAP NetWeaver in Unicode Mode. . . . . . . . . . . . . . . . . . . 8

    Registering the Plug-in. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

    Configuration Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

    Configuration Tasks and Integration Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

    Integrating with SAP Using ABAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

    Integrating with SAP Using ALE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

    Table of Contents i

  • Integrating with SAP Using BAPI/RFC Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

    Migrating Data to SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

    Integrating with SAP Business Content. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

    Installing the SAP RFC SDK Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

    Registering the PowerExchange for SAP NetWeaver Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

    Installing and Configuring Transports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

    Step 1. Delete Transport Programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

    Step 2. Install Transport Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

    Step 3. Run Transport Programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

    Step 4. Create Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

    Step 5. Create Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

    Step 6. Create a Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

    Defining PowerCenter as a Logical System in SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

    Creating a Logical System for IDoc ALE Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

    Creating a Logical System for Business Content Integration. . . . . . . . . . . . . . . . . . . . . . . . 23

    Configuring saprfc.ini. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

    saprfc.ini Entry Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

    Sample saprfc.ini File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

    Configuring an Entry in saprfc.ini. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

    Creating Entries in the Services File for Stream Mode Sessions. . . . . . . . . . . . . . . . . . . . . 27

    Uninstalling PowerExchange for SAP NetWeaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

    Cleaning Up the SAP System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

    Chapter 3: Installing and Configuring PowerExchange for SAP NetWeaver BI. . . . . . 29Installing and Configuring PowerExchange for SAP NetWeaver BI Overview. . . . . . . . . . . . . . . . . . . 29

    Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

    Installing and Configuring PowerExchange for SAP NetWeaver BI. . . . . . . . . . . . . . . . . . . 30

    Upgrading PowerExchange for SAP NetWeaver BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

    Installing the SAP RFC SDK Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

    Registering the PowerExchange for SAP NetWeaver Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

    Creating Profiles for Production and Development Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

    Profiles for Extracting Data from SAP BW 3.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

    Profiles for Extracting Data from SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

    Profiles for Loading data to SAP NetWeaver BI or SAP BW 3.5. . . . . . . . . . . . . . . . . . . . . 34

    Defining PowerCenter as a Logical System in SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

    Configuring saprfc.ini. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

    saprfc.ini Entry Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

    Sample saprfc.ini File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

    Configuring an Entry in saprfc.ini. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

    Creating the SAP BW Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

    Load Balancing for the SAP BI System and the SAP BW Service. . . . . . . . . . . . . . . . . . . . 39

    Steps to Create the SAP BW Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

    Importing the ABAP Program into SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

    ii Table of Contents

  • Troubleshooting a PowerExchange for SAP NetWeaver BI Installation. . . . . . . . . . . . . . . . . . . . . . . 41

    Part II: Data Integration Using ABAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

    Chapter 4: Importing SAP R/3 Source Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Importing SAP R/3 Source Definitions Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

    Editing a Source Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

    Table and View Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

    Importing Key Relationships. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

    Hierarchy Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

    Uniform Hierarchies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

    Non-Uniform Hierarchies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

    Importing Hierarchy Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

    Establishing Hierarchy Relationships. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

    IDoc Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

    Importing IDoc Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

    Viewing IDoc Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

    Importing a Source Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

    Filtering Definitions in the Import Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

    Steps to Import an SAP R/3 Source Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

    Organizing Definitions in the Navigator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

    Working with Business Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

    Troubleshooting SAP R/3 Source Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

    Chapter 5: SAP R/3 Target Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51SAP R/3 Target Definitions Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

    Target Table Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

    Editing a Target Table Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

    Target Update Override. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

    Target Table Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

    Keys and Key Relationships. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

    Importing an SAP R/3 Target Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

    Filtering Definitions in the Import Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

    Chapter 6: Working with ABAP Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Working with ABAP Mappings Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

    Setting the Select Option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

    Select Single. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

    Select Distinct. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

    Setting Order By Ports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

    Transparent Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

    Pool and Cluster Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

    Viewing the Hierarchy Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

    Table of Contents iii

  • Viewing IDoc Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

    Working with the ABAP/4 Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

    Selecting the Program Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

    Naming the ABAP Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    Adding Authority Checks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    Working with ABAP Programs and Versioned Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . 60

    Generating and Installing the ABAP Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

    Deploying ABAP Mappings with ABAP Programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

    Viewing Program Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

    Uninstalling the ABAP Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    Cleaning ABAP Program Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    Copying Program Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    Troubleshooting ABAP Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

    Chapter 7: Working with SAP Functions in ABAP Mappings. . . . . . . . . . . . . . . . . . . . 66Working with SAP Functions in ABAP Mappings Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

    Using SAP Functions in the ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

    SAP Function Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

    Using SAP Functions in the ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

    Importing SAP Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

    Viewing SAP Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

    Inserting SAP Functions in the ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

    Configuring SAP Function Parameters in the ABAP Program Flow. . . . . . . . . . . . . . . . . . . 69

    Steps for Inserting an SAP Function in the ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . 70

    Validating SAP Functions in the ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

    Chapter 8: Application Source Qualifier for SAP R/3 Sources. . . . . . . . . . . . . . . . . . . 72Application Source Qualifier for SAP R/3 Sources Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

    Generating an ABAP Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

    Available ABAP Generation Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

    Generating Open SQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

    Generating Exec SQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

    Generating ABAP Join Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

    Working with ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

    Validating the ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

    Joining Source Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

    Joining Sources Using Open SQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

    Joining Sources Using Exec SQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

    Joining Sources Using ABAP Join Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

    Selecting a Join Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

    Using Multiple Outer Joins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

    Joining Tables and Hierarchies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

    Joining Tables and IDoc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

    iv Table of Contents

  • Specifying Join Conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

    Creating an ABAP Code Block. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

    Rules for Inserting the ABAP Code Block. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

    Creating ABAP Program Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

    Naming Convention. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

    Creating Structure and Structure Field Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

    Creating a Structure Variable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

    Creating a Structure Field Variable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

    Creating ABAP Type Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

    Viewing ABAP Program Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

    Using SAP System Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

    Entering a Source Filter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

    Using Dynamic Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

    Using Static Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

    Using Mapping Variables and Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

    Using Mapping Variables in the ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

    Working with SAP Date Formats. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

    Working with IDoc Sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

    Working with IDoc Sources in the ABAP Program Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . 87

    Entering an IDoc Filter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

    Validating the IDoc Filter Condition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

    Configuring an Application Source Qualifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

    Configuring an Application Source Qualifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

    Troubleshooting an Application Source Qualifier for SAP R/3 Sources. . . . . . . . . . . . . . . . . . . . . . . 90

    Chapter 9: Configuring Sessions with SAP R/3 Sources and Targets. . . . . . . . . . . . . 91Configuring Sessions with SAP R/3 Sources and Targets Overview. . . . . . . . . . . . . . . . . . . . . . . . . 91

    Running Stream Mode Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

    Running File Mode Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

    Reusing Staging Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

    Overriding Filter Conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

    Accessing Staging Files for ABAP Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

    Modes of Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

    Enabling Access to Staging Files on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

    Configuring File Mode Session Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

    Pipeline Partitioning for SAP R/3 Sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

    Session Properties for SAP R/3 Targets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

    Reject Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

    Session Load Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

    Configuring an SAP R/3 Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

    Troubleshooting Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

    Table of Contents v

  • Part III: IDoc Integration Using ALE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

    Chapter 10: Creating Outbound IDoc Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Creating Outbound IDoc Mappings Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

    Defining PowerCenter as a Logical System for Outbound IDocs. . . . . . . . . . . . . . . . . . . . 102

    Creating an Outbound IDoc Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

    Processing Invalid Outbound IDocs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

    Creating an SAPALEIDoc Source Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

    Using SAPALEIDoc Source Definitions in an Outbound IDoc Mapping. . . . . . . . . . . . . . . . 104

    Working with the SAP/ALE IDoc Interpreter Transformation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

    Segments and Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

    Creating an SAP/ALE IDoc Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

    Editing an SAP/ALE IDoc Interpreter Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . 110

    Processing Invalid Outbound IDocs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

    Chapter 11: Creating Inbound IDoc Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Creating Inbound IDoc Mappings Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

    Defining PowerCenter as a Logical System for Inbound IDocs. . . . . . . . . . . . . . . . . . . . . 112

    Creating an Inbound IDoc Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

    Validating 6.x Inbound IDoc mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

    Processing Invalid Inbound IDocs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

    Working with the SAP/ALE IDoc Prepare Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

    IDoc Primary and Foreign Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

    Creating an SAP/ALE IDoc Prepare Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

    Editing an SAP/ALE IDoc Prepare Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

    Creating an SAPALEIDoc Target Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

    Configuring Inbound IDoc Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

    Passing the Document Number to SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

    Passing the Sender Partner Number to SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

    Processing Invalid Inbound IDocs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

    Chapter 12: Configuring IDoc Workflows Using ALE. . . . . . . . . . . . . . . . . . . . . . . . . 119Configuring Sessions for Outbound IDoc Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

    Terminating Conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

    Real-time Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

    Message Recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

    Pipeline Partitioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

    Outbound IDoc Validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

    Row-Level Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

    Continuous Workflows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

    Configuring Sessions for Inbound IDoc Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

    Pipeline Partitioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

    vi Table of Contents

  • Sending IDocs to SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

    Inbound IDoc Validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

    Caching Inbound IDoc and DMI Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

    Steps to Configure Sessions for IDoc Mappings Using ALE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

    Error Handling for IDoc Sessions Using ALE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

    Running IDoc Workflows Using ALE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

    Troubleshooting IDoc Workflows Using ALE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

    Part IV: Data Integration Using BAPI/RFC Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

    Chapter 13: BAPI/RFC Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128BAPI/RFC Transformation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

    BAPIs with Nested Structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

    BAPI/RFC Transformation Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

    Configuring BAPI/RFC Transformation Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

    Customizing BAPI/RFC Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

    Creating a BAPI/RFC Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

    Using a BAPI/RFC Transformation in Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

    Adding XML Transformations for Table Type Parameters. . . . . . . . . . . . . . . . . . . . . . . . 135

    Working with Function Input Data for BAPI/RFC Functions. . . . . . . . . . . . . . . . . . . . . . . . 135

    Configuring a Target Definition for BAPI/RFC Error Output. . . . . . . . . . . . . . . . . . . . . . . . 135

    System Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

    Real-time BAPI/RFC Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

    Troubleshooting a BAPI/RFC Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

    Chapter 14: BAPI/RFC Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138BAPI/RFC Sessions Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

    Configuring a Session with a BAPI/RFC Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

    Committing Data to SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

    Caching BAPI Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

    Configuring Error Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

    Configuring a Session for BAPIs with Table Type Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

    Configuring a Real-time BAPI/RFC Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

    Part V: Data Migration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

    Chapter 15: Creating Data Migration Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Creating Data Migration Mappings Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

    Creating a DMI Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

    Working with the SAP DMI Prepare Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

    DMI Primary and Foreign Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

    Creating an SAP DMI Prepare Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

    Editing an SAP DMI Prepare Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

    Table of Contents vii

  • Error Handling with DMI Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

    Creating a Flat File Target for DMI Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

    Configuring Sessions for DMI Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

    Chapter 16: Migrating Legacy Data into SAP IS-U/CCS. . . . . . . . . . . . . . . . . . . . . . . 149Migrating Legacy Data into SAP ISU/CCS Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

    Migration Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

    Configuring Migration Objects in SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

    SAP IS-U/CCS Transformation Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

    SAP IS-U Transformation Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

    Auto Structures and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

    Creating an SAP IS-U/CCS Transformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

    SAP IS-U/CCS Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

    Caching SAP IS-U/CCS Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

    SAP IS-U/CCS Migration Data to Import File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

    Error Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

    Part VI: Business Content Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

    Chapter 17: Business Content Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Business Content Integration Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

    DataSources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

    Logical System in SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

    Mappings for Business Content Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

    Workflows for Business Content Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

    PowerCenter Integration Service Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

    Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

    Steps to Integrate with SAP Business Content. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

    Step 1. Prepare DataSources in SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

    Activating a DataSource in SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

    Customizing Fields in a DataSource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

    Step 2. Import and Configure PowerCenter Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

    Importing PowerCenter Objects from BCI_Mappings.xml. . . . . . . . . . . . . . . . . . . . . . . . . 163

    Creating Database Tables for PowerCenter Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

    Configuring an LMAPITarget Application Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . 164

    Identifying and Verifying the Basic IDoc Type in the Listener Mapping. . . . . . . . . . . . . . . . 165

    Step 3. Configure and Start the Listener Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

    Step 4. Create the Processing Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

    Update Modes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

    Request Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

    Non-Hierarchy and Hierarchy DataSource Processing Mappings. . . . . . . . . . . . . . . . . . . . 168

    Steps to Create a Processing Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

    Generating and Executing SQL for the Relational Targets. . . . . . . . . . . . . . . . . . . . . . . . 174

    viii Table of Contents

  • Step 5. Deploy the Request Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

    Step 6. Create the Send Request Workflows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

    Step 7. Create the Processing Workflows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

    Creating a Processing Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

    Creating a Cleanup Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

    Configuring the Processing Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

    Step 8. Schedule the Processing and Send Request Workflows. . . . . . . . . . . . . . . . . . . . . . . . . . 176

    Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

    Steps to Schedule the Processing and Send Request Workflows. . . . . . . . . . . . . . . . . . . . 178

    Troubleshooting Business Content Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

    Part VII: SAP BI Data Extraction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

    Chapter 18: SAP BI Extraction Through Open Hub Destination. . . . . . . . . . . . . . . . 181SAP BI Extraction Through Open Hub Destination Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

    Extracting Data from SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

    Step 1. Create an Open Hub Destination. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

    Create a Data Transfer Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

    Step 2. Create an SAP BW OHS Source Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

    Step 3. Start the SAP BW Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

    Step 4. Configure and Start a PowerCenter Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

    Step 5. Configure and Start a Process Chain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

    Configuring and Starting a Process Chain from SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . 186

    Inserting an InfoSpoke Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

    Configuring and Starting the Process Chain from PowerCenter. . . . . . . . . . . . . . . . . . . . . 188

    Changing the Data Extraction Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

    Viewing Data Extraction Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

    Viewing Data Extraction Status from PowerCenter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

    Viewing Data Extraction Status from SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

    Troubleshooting Data Extraction from SAP BI through OHD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

    Part VIII: Loading Data into SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

    Chapter 19: Building Components to Load Data into SAP BI. . . . . . . . . . . . . . . . . . 194Building Components to Load Data into SAP BI Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

    InfoSources for Loading Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

    SAP BI Hierarchy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

    Transfer Methods for Writing Data to SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

    Steps to Build Components to Load Data into SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . 197

    Step 1. Create an InfoSource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

    Creating an InfoSource in SAP BI 7.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

    Creating an InfoSource in SAP BW 3.5 or Earlier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

    Configuring Hierarchy Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

    Table of Contents ix

  • Step 2. Assign an External Logical System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

    Step 3. Activate the InfoSource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

    Chapter 20: Building PowerCenter Objects to Load Data into SAP BI. . . . . . . . . . . . 201Building PowerCenter Objects to Load Data into SAP BI Overview. . . . . . . . . . . . . . . . . . . . . . . . 201

    Step 1. Import an InfoSource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

    Step 2. Create a Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

    Filtering Data to Load into SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

    Filtering Data from a Relational Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

    Filtering Data from a Flat File Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

    Filtering Data from an SAP R/3 Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

    Configuring Mapping Parameters for Data Selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

    Chapter 21: Loading Data into SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Loading Data into SAP BI Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

    Step 1. Configure a Workflow to Load Data into SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

    Creating an SAP BI Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

    Creating a PowerCenter Workflow for an SAP BI Session. . . . . . . . . . . . . . . . . . . . . . . . 210

    Step 2. Configure an InfoPackage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

    Creating and Scheduling an InfoPackage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

    Setting a Data Selection Entry to Filter Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

    Step 3. Configure a Process Chain to Load Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

    Creating the Process Chain and Inserting the Start Process. . . . . . . . . . . . . . . . . . . . . . . 212

    Inserting an InfoPackage Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

    Inserting the ZPMSENDSTATUS ABAP Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

    Viewing Log Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

    Viewing SAP BW Service Log Events in the SAP BI Monitor. . . . . . . . . . . . . . . . . . . . . . . 215

    Viewing InfoPackage Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

    Recovering a PowerCenter Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

    Troubleshooting Data Loading into SAP BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

    Appendix A: Datatype Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218SAP Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

    PowerExchange for SAP NetWeaver and SAP Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

    RAWSTRING, SSTRING, and STRG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

    Overriding Datatypes in the Application Source Qualifier. . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

    Binary Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

    CHAR, CUKY, and UNIT Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

    PowerExchange for SAP BI and SAP Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

    Date/Time Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

    Binary Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

    Numeric Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

    Writing to SAP BI Date Columns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

    x Table of Contents

  • Appendix B: Code Pages and Unicode Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227Language Code Selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

    Code Page Selection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

    Supported Code Pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

    Processing Unicode Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

    Processing Unicode Data with a Single Session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

    Processing Unicode Data with Multiple Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

    Processing Unicode Data in ABAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

    Processing Unicode Data with Different Code Pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

    Appendix C: Glossary of Terms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

    Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

    Table of Contents xi

  • PrefaceThe PowerExchange for SAP NetWeaver User Guide for PowerCenter provides information to build mappings andrun sessions to extract data from SAP NetWeaver into a data warehouse and write data into SAP NetWeaver. It iswritten for the data warehouse developers and software engineers who are responsible for extracting data fromSAP NetWeaver into a data warehouse or loading data into SAP NetWeaver.

    This guide assumes you have knowledge of relational database concepts and the database engines,PowerCenter, and SAP NetWeaver. You should also be familiar with the interface requirements for othersupporting applications.

    Informatica Resources

    Informatica Customer PortalAs an Informatica customer, you can access the Informatica Customer Portal site at http://mysupport.informatica.com. The site contains product information, user group information, newsletters,access to the Informatica customer support case management system (ATLAS), the Informatica How-To Library,the Informatica Knowledge Base, the Informatica Multimedia Knowledge Base, Informatica ProductDocumentation, and access to the Informatica user community.

    Informatica DocumentationThe Informatica Documentation team takes every effort to create accurate, usable documentation. If you havequestions, comments, or ideas about this documentation, contact the Informatica Documentation team throughemail at [email protected] We will use your feedback to improve our documentation. Let usknow if we can contact you regarding your comments.

    The Documentation team updates documentation as needed. To get the latest documentation for your product,navigate to Product Documentation from http://mysupport.informatica.com.

    Informatica Web SiteYou can access the Informatica corporate web site at http://www.informatica.com. The site contains informationabout Informatica, its background, upcoming events, and sales offices. You will also find product and partnerinformation. The services area of the site includes important information about technical support, training andeducation, and implementation services.

    xii

    http://mysupport.informatica.commailto:[email protected]://mysupport.informatica.comhttp://www.informatica.com

  • Informatica How-To LibraryAs an Informatica customer, you can access the Informatica How-To Library at http://mysupport.informatica.com.The How-To Library is a collection of resources to help you learn more about Informatica products and features. Itincludes articles and interactive demonstrations that provide solutions to common problems, compare features andbehaviors, and guide you through performing specific real-world tasks.

    Informatica Knowledge BaseAs an Informatica customer, you can access the Informatica Knowledge Base at http://mysupport.informatica.com.Use the Knowledge Base to search for documented solutions to known technical issues about Informaticaproducts. You can also find answers to frequently asked questions, technical white papers, and technical tips. Ifyou have questions, comments, or ideas about the Knowledge Base, contact the Informatica Knowledge Baseteam through email at [email protected]

    Informatica Multimedia Knowledge BaseAs an Informatica customer, you can access the Informatica Multimedia Knowledge Base at http://mysupport.informatica.com. The Multimedia Knowledge Base is a collection of instructional multimedia filesthat help you learn about common concepts and guide you through performing specific tasks. If you havequestions, comments, or ideas about the Multimedia Knowledge Base, contact the Informatica Knowledge Baseteam through email at [email protected]

    Informatica Global Customer SupportYou can contact a Customer Support Center by telephone or through the Online Support. Online Support requiresa user name and password. You can request a user name and password at http://mysupport.informatica.com.

    Use the following telephone numbers to contact Informatica Global Customer Support:

    North America / South America Europe / Middle East / Africa Asia / Australia

    Toll FreeBrazil: 0800 891 0202Mexico: 001 888 209 8853North America: +1 877 463 2435 Standard RateNorth America: +1 650 653 6332

    Toll FreeFrance: 00800 4632 4357Germany: 00800 4632 4357Israel: 00800 4632 4357Italy: 800 915 985Netherlands: 00800 4632 4357Portugal: 800 208 360Spain: 900 813 166Switzerland: 00800 4632 4357 or 0800 463200United Kingdom: 00800 4632 4357 or 0800023 4632 Standard RateFrance: 0805 804632Germany: 01805 702702Netherlands: 030 6022 797

    Toll FreeAustralia: 1 800 151 830New Zealand: 1 800 151 830Singapore: 001 800 4632 4357 Standard RateIndia: +91 80 4112 5738

    Preface xiii

    http://mysupport.informatica.comhttp://mysupport.informatica.commailto:[email protected]://mysupport.informatica.commailto:[email protected]://mysupport.informatica.com

  • xiv

  • Part I: Getting Started withPowerExchange for SAPNetWeaver

    This part contains the following chapters:

    ¨ Understanding PowerExchange for SAP NetWeaver, 2

    ¨ Installing and Configuring PowerExchange for SAP NetWeaver, 7

    ¨ Installing and Configuring PowerExchange for SAP NetWeaver BI, 29

    1

  • C H A P T E R 1

    Understanding PowerExchange forSAP NetWeaver

    This chapter includes the following topics:

    ¨ Understanding PowerExchange for SAP NetWeaver Overview, 2

    ¨ PowerCenter and SAP NetWeaver Integration Methods, 3

    ¨ PowerCenter and SAP NetWeaver BI Integration Methods, 5

    ¨ Communication Interfaces, 5

    ¨ Transport System, 6

    ¨ Operating System Profiles for SAP Sessions, 6

    Understanding PowerExchange for SAP NetWeaverOverview

    SAP NetWeaver is an application platform that integrates multiple business applications and solutions, such asCustomer Relationship Management (CRM), Advanced Planner and Optimizer (APO), and Bank Analyzer.Developers can add business logic within SAP NetWeaver using Java 2 Enterprise Edition (J2EE) or AdvancedBusiness Application Programming-Fourth Generation (ABAP/4 or ABAP), a language proprietary to SAP.

    You can use the following integration methods to extract data from or load data into SAP systems:

    ¨ You can use the ABAP, Application Link Enabling (ALE), BAPI/RFC functions, data migration, or businesscontent integration methods.

    ¨ You can also extract data from or load data to the SAP Business Information Warehouse.

    Note: PowerExchange for SAP NetWeaver PowerExchange for SAP NetWeaver BI require separate licenses.

    SAP NetWeaver is the basis for SAP solutions. Because PowerCenter works with the SAP NetWeaver applicationplatform, you can integrate PowerCenter with any SAP industry solution or mySAP application that provides BAPI/RFC or ALE integration methods.

    The following figure shows how PowerCenter integrates with SAP NetWeaver:

    2

  • PowerCenter and SAP NetWeaver Integration MethodsPowerExchange for SAP NetWeaver integrates with mySAP applications in the following ways:

    ¨ Data integration using the ABAP program

    ¨ IDoc integration using ALE

    ¨ Data integration using BAPI/RFC functions

    ¨ Data migration integration

    ¨ Business content integration

    Data Integration Using the ABAP ProgramYou can extract data from mySAP applications using the ABAP program. Create a mapping in the Designer thatuses the ABAP program. Generate and install the ABAP program on the SAP server that extracts the source data.When you configure a session, you can access the source data through streaming or a staged file. ThePowerCenter Integration Service accesses streamed data through CPI-C. It accesses staged files through FTP,SFTP, or standard file I/O, typically using network file sharing, such as NFS.

    Complete the following steps to extract data from mySAP applications using the ABAP program:

    1. Import an SAP R/3 source definition.

    2. Create a mapping.

    3. Generate and install the ABAP program.

    4. Create a session and run a workflow.

    PowerCenter and SAP NetWeaver Integration Methods 3

  • IDoc Integration Using ALEYou can integrate PowerCenter with mySAP applications using Application Link Enabling (ALE) to send andreceive Intermediate Documents (IDocs). IDocs are messages that exchange electronic data between SAPapplications or between SAP applications and external programs.

    The message-based architecture of ALE comprises three layers:

    ¨ Application layer. Provides ALE an interface to R/3 to send or receive messages from external systems.

    ¨ Distribution layer. Filters and converts messages to ensure that they are compatible between differentreleases of R/3 and R/2.

    ¨ Communications layer. Enables ALE to support synchronous and asynchronous communication. You useIDocs for asynchronous communication.

    The architecture of ALE provides a way to send IDocs as text files without connecting to a central database. Thisallows applications to communicate with each other without converting between formats to accommodatehardware or platform differences.

    ALE has the following components:

    ¨ Logical component. Determines how messages flow between the various applications or systems.

    ¨ Physical component. Transport layer that routes IDoc messages using the tRFC (Transactional RFC) protocol.

    ¨ Message types. Application messages that classify categories of data. For example, ORDERS and MATMAS(Material Master).

    ¨ IDoc types. Data structure associated with the message type. For example, MATMAS01, MATMAS02 forMATMAS. IDocs contain the data belonging to the message type.

    IDocs contain three record types:

    ¨ Control record. Identifies the message type.

    ¨ Data records. Contain the IDoc data in segments.

    ¨ Status records. Describe the status of the IDoc. Status record names are the same for each IDoc type.

    Data Integration Using BAPI/RFC FunctionsBusiness Application Programming Interfaces (BAPI) provide a way for third-party applications to integrate datawith SAP. You use BAPIs to create, change, delete, list, and detail objects in SAP.

    The Business Application Programming Interfaces allow object-oriented access to the SAP system throughmethods for the business object types. Together with the business object types, BAPIs define and document theinterface standard at the business level.

    BAPIs also provide an object-oriented view of business components in SAP. You define BAPIs in the SAPBusiness Objects Repository. You implement and store them as Remote Function Call (RFC) enabled functionmodules in the Function Builder of the ABAP Workbench. You can call BAPIs as an ABAP program within SAP.You use RFCs to call BAPIs outside of SAP.

    Use a BAPI/RFC transformation to create, change, or delete data in mySAP applications. When you run a sessionwith a BAPI/RFC transformation, the PowerCenter Integration Service makes the RFC function calls to SAP toprocess SAP data.

    You can use a BAPI/RFC transformation for one of the following reasons:

    ¨ Migrate data to SAP. For example, your organization uses PeopleSoft applications for enterprise purchasingmanagement. You want to migrate to mySAP applications to manage enterprise purchasing. UsePowerExchange for for PeopleSoft to extract data from PeopleSoft and a BAPI/RFC transformation to writepurchase management data to mySAP applications.

    4 Chapter 1: Understanding PowerExchange for SAP NetWeaver

  • ¨ Synchronize data in SAP. For example, a mySAP application contains customer orders. You want to add lineitems to some of the orders. You can use a BAPI/RFC transformation to make a BAPI/RFC call to add the lineitems to the orders in SAP.

    Data Migration IntegrationYou can migrate data from legacy applications, from other ERP systems, or data from any number of othersources and prepare it for input into mySAP applications. The PowerCenter Integration Service extracts the datafrom the data source and prepares the data in an SAP format flat file that you can load into mySAP applications.

    Business Content IntegrationYou can integrate PowerCenter with mySAP applications to provide an efficient, high-volume data warehousingsolution. SAP business content is a collection of metadata objects that can be integrated with other applicationsand used for analysis and reporting. SAP produces the business content data, and PowerCenter consumes it.PowerCenter can consume all or changed business content data from mySAP applications and write it to a targetdata warehouse. You can then use the data warehouse to meet analysis and reporting needs.

    PowerCenter and SAP NetWeaver BI IntegrationMethods

    PowerExchange for SAP NetWeaver BI can perform the following tasks:

    ¨ Extracting data from SAP BI

    ¨ Loading data into SAP BI

    PowerExchange for SAP NetWeaver BI interacts with InfoCubes and InfoSources. An InfoCube is a self-containeddataset created with data from one or more InfoSources. An InfoSource is a collection of data that logicallybelongs together, summarized into a single unit.

    Communication InterfacesTCP/IP is the native communication interface between PowerCenter and SAP NetWeaver. PowerCenter and SAPNetWeaver also use the following interfaces:

    ¨ CPI-C

    ¨ Remote Function Call (RFC)

    Common Program Interface-CommunicationsCPI-C is the communication protocol that enables online data exchange and data conversion between SAP andPowerCenter. PowerExchange for SAP NetWeaver uses CPI-C to communicate with SAP NetWeaver only whenyou run ABAP stream mode sessions.

    To initialize CPI-C communication with PowerCenter, SAP NetWeaver requires information, such as the host nameof the application server and SAP gateway. This information is stored in a configuration file named saprfc.ini on

    PowerCenter and SAP NetWeaver BI Integration Methods 5

  • the node where the PowerCenter Integration Service process runs. The PowerCenter Integration Service usesparameters in the saprfc.ini file to connect to SAP NetWeaver when you run ABAP stream mode sessions.

    Remote Function CallRFC is the remote communications protocol used by SAP NetWeaver. It is based on Remote Procedure Call(RPC). PowerCenter makes remote function calls to communicate with SAP NetWeaver.

    To execute remote calls from PowerCenter, SAP NetWeaver requires information, such as the connection typeand the service name and gateway on the application server. This information is stored in a configuration filenamed saprfc.ini on the node hosting the PowerCenter Client and the node where the PowerCenter IntegrationService and SAP BW Service processes run.

    Transport SystemThe transport system is a set of ABAP programs installed on the SAP system. The ABAP programs import SAPmetadata into the Model repository. The ABAP programs also enable run-time functionalities, such as passingmapping variables and filters.

    You use the transport system in the following situations:

    Configuring PowerExchange for SAP NetWeaver.

    You need to transport some customized objects that were developed by Informatica to the SAP system.These objects include tables, structures, programs, and functions. The PowerCenter calls custom objectswhen you make a request to the SAP system.

    Deploying run-time transports and ABAP programs from development to production.

    To use ABAP to integrate with mySAP applications, deploy the run-time transports provided by Informaticaand the ABAP programs installed by the PowerCenter to extract data when you move from development toproduction.

    The SAP system administrator must install and configure transports on the SAP system.

    Operating System Profiles for SAP SessionsIf the PowerCenter Integration Service uses operating system profiles, the operating system user specified in theoperating system profile must have access to run time files.

    Use the following rules and guidelines if the PowerCenter Integration Service uses operating system profiles for anSAP session:

    ¨ The operating system profile must have permissions to access the \server\bin directory to read saprfc.ini andcreate the RFC trace file.

    ¨ If the session writes to SAP NetWeaver BI and there is a filter condition in the InfoPackage, the operatingsystem profile must have permissions to access the BWParam directory.

    6 Chapter 1: Understanding PowerExchange for SAP NetWeaver

  • C H A P T E R 2

    Installing and ConfiguringPowerExchange for SAPNetWeaver

    This chapter includes the following topics:

    ¨ Installing and Configuring PowerExchange for SAP NetWeaver Overview, 7

    ¨ Configuration Checklist, 9

    ¨ Installing the SAP RFC SDK Libraries, 11

    ¨ Registering the PowerExchange for SAP NetWeaver Client, 13

    ¨ Installing and Configuring Transports, 13

    ¨ Defining PowerCenter as a Logical System in SAP, 19

    ¨ Configuring saprfc.ini, 25

    ¨ Uninstalling PowerExchange for SAP NetWeaver, 28

    Installing and Configuring PowerExchange for SAPNetWeaver Overview

    PowerExchange for SAP NetWeaver requires configuration on both the PowerCenter and SAP systems. Theadministrators for each of these systems must perform the configuration tasks for their respective systems.

    Before You BeginBefore you can install and configure PowerExchange for SAP NetWeaver, install and configure SAP. To usebusiness content integration, verify that you have installed the SAP plug-in version 2003_1 or later.

    Tip: Use separate development, test, and production SAP systems. Complete all development, testing, andtroubleshooting on the development and test systems before deploying to the production systems.

    Installing PowerExchange for SAP NetWeaverTo install PowerExchange for SAP NetWeaver, complete the following steps:

    1. Install PowerCenter.

    7

  • 2. Register the PowerExchange for SAP NetWeaver client.

    3. Install the SAP RFC SDK libraries.

    After you install PowerExchange for SAP NetWeaver, complete the configuration tasks.

    Upgrading PowerExchange for SAP NetWeaverThe PowerCenter installation DVD contains transports for new installations and upgrades.

    If you are upgrading from a previous version of PowerExchange for SAP NetWeaver, complete the following steps:

    1. Delete existing transports.

    2. Install the latest transports.

    3. Make a copy of the saprfc.ini file.

    4. Uninstall PowerExchange for SAP NetWeaver.

    5. Install the current version of PowerCenter. When you install the current version of PowerCenter, you alsoupgrade to the latest version of PowerExchange for SAP NetWeaver.

    6. Install the SAP RFC SDK libraries.

    7. Update the PowerExchange for SAP NetWeaver Client registration.

    Upgrading to PowerExchange for SAP NetWeaver in Unicode ModeTo upgrade to PowerExchange for SAP NetWeaver in Unicode mode, complete the following steps:

    1. Delete existing transports.

    2. Install the current version of the PowerExchange for SAP NetWeaver transports with the following overwriteoptions:

    ¨ Import Transport Request Again

    ¨ Overwrite Originals

    3. Install the SAP RFC SDK libraries.

    4. Update the PowerExchange for SAP NetWeaver Client registration.

    5. Regenerate and reinstall ABAP programs on the SAP system after upgrading the system to Unicode.

    6. Configure the PowerCenter Integration Service to run in Unicode mode.

    7. Set ValidateDataCodePages to No in the Informatica Administrator.

    8. Set the code page to UTF-8 in the SAP NetWeaver application connection object.

    Registering the Plug-inAfter you install PowerExchange for SAP NetWeaver, register the plug-in with the repository. When you upgradefrom any previous PowerCenter version to the PowerCenter 9.1 version or above, you must manually register thePowerExchange for SAP plug-in file in the PowerCenter repository.

    A plug-in is an XML file that defines the functionality of PowerExchange for SAP NetWeaver. To register the plug-in, the repository must be running in exclusive mode. Use the pmrep RegisterPlugin command to register the plug-in.

    The plug-in file for PowerExchange for SAP NetWeaver is pmsapplg.xml. Register the plug-in with the updateoption enabled. The RegisterPlugin command uses the following syntax:

    Registerplugin –i /server/bin/native/pmsapplg.xml –e -N

    8 Chapter 2: Installing and Configuring PowerExchange for SAP NetWeaver

  • When you install the Repository component, the installer copies pmsapplg.xml to the followingdirectory:/server/bin/Plugin

    For more information about the pmrep RegisterPlugin command, see the Informatica Command Reference.

    Note: If you do not have the correct privileges to register the plug-in, contact the user who manages thePowerCenter Repository Service.

    Configuration ChecklistAfter you install and configure SAP and PowerCenter, you must complete additional configuration tasks to use oneor more of the following PowerExchange for SAP NetWeaver integration methods:

    ¨ Data integration using ABAP

    ¨ IDoc integration using ALE

    ¨ Data integration using BAPI/RFC

    ¨ Data migration

    ¨ Business content integration

    Configuration Tasks and Integration MethodsSome configuration tasks apply to multiple integration methods. When you complete a configuration task for oneintegration method, you may be able to skip that task for another integration method. For example, if you haveconfigured a Type A entry in saprfc.ini for ABAP, you can skip that task when you configure ALE integration.

    Other configuration tasks apply to only one integration method.

    If you have multiple SAP systems, you must repeat certain configuration tasks. For example, you must configureone SAP_ALE_IDoc_Reader application connection for each SAP system from which you want to receiveoutbound IDocs.

    The following table lists the configuration tasks and the integration methods that apply to them:

    Configuration Task ABAP ALE RFC/BAPI

    DMI BusinessContent

    Install SAP RFC SDKlibraries.

    Yes Yes Yes Yes Yes

    Define PowerCenter as alogical system in SAP.

    No Yes No No Yes. Use the ZINFABCIABAP program provided byInformatica.

    Configure saprfc.ini. Yes Yes Yes Yes Yes

    Configure anSAP_ALE_IDoc_Readerapplication connection.

    No Yes, if receivingoutbound IDocs

    No No Yes

    Configure anSAP_ALE_IDoc_Writerapplication connection.

    No Yes, if sendinginbound IDocs

    No No Yes

    Configuration Checklist 9

  • Configuration Task ABAP ALE RFC/BAPI

    DMI BusinessContent

    Configure an SAP R/3application connection.

    Yes No No No No

    Configure an FTP or SFTPconnection.

    Yes, if runningfile modesessions

    No No No No

    Configure an SAP BAPI/RFCapplication connection.

    No No Yes No No

    Prepare DataSources in SAP. No No No No Yes

    Integrating with SAP Using ABAPTo integrate with SAP using ABAP programs, complete the following steps:

    1. Verify that the SAP user has the appropriate authorization.

    2. Configure saprfc.ini to run sessions in stream mode through the Common Program Interfaces-Communication(CPI-C) protocol or to run sessions in file mode through RFC communication.

    3. Configure an SAP R/3 application connection or an FTP or SFTP connection.

    Integrating with SAP Using ALETo integrate with SAP using ALE, complete the following steps:

    1. Define PowerCenter as a logical system in SAP.

    2. Configure saprfc.ini for RFC communication with SAP. Configure a Type R entry to listen for outbound IDocs.The PROGID parameter must match the Program ID you configured for the logical system in SAP.

    3. Configure SAP_ALE_IDoc_Reader application connections to receive outbound IDocs from SAP.

    4. Configure an SAP_ALE_IDoc_Writer application connection to send inbound IDocs to SAP.

    Integrating with SAP Using BAPI/RFC FunctionsTo integrate with SAP using BAPI/RFC functions, complete the following steps:

    1. Configure saprfc.ini for RFC communication with SAP.

    2. Configure an SAP R/3 application connection.

    Migrating Data to SAPTo migrate data to SAP, configure an entry in saprfc.ini for RFC communication with SAP.

    Integrating with SAP Business ContentTo integrate with SAP business content, complete the following steps:

    1. Define PowerCenter as a logical system in SAP.

    10 Chapter 2: Installing and Configuring PowerExchange for SAP NetWeaver

  • 2. Configure saprfc.ini for RFC communication with SAP. Configure a Type R entry to consume business contentdata. Set PROGID to INFACONTNT.

    3. Configure SAP_ALE_IDoc_Reader application connections to consume business content data from SAP.

    4. Configure an SAP_ALE_IDoc_Writer application connection to send requests for business content data toSAP.

    5. Activate and configure each DataSource in SAP before you create a processing mapping for the DataSource.

    Installing the SAP RFC SDK LibrariesYou need to download and install the SAP RFC SDK 6.40 libraries for the PowerCenter Client and the operatingsystem that hosts the PowerCenter Integration Service process when you configure PowerExchange for SAPNetWeaver. Contact Informatica Global Customer support if you find any issues in downloading the SAP RFC SDKlibraries.

    To download and install the SAP RFC SDK libraries:

    1. Go to the SAP Service Marketplace: http://service.sap.com

    2. Download SAP RFC SDK 6.40 libraries that are specific to the operating system that hosts the PowerCenterIntegration Service process and the Windows 32-bit SAP RFC SDK libraries.

    Operating System Unicode RFC SDK libraries

    AIX 64-bit - libicudata26.so- libicuuc26.so- librfccm.a- librfcum.a- libsapu16.a- libsapu16.so- libsapu16_mt.a- libsapu16_mt.so- libsapucum.so

    HP/UX Itanium 64-bit - libicudata.so.26- libicui18n.so.26- libicuuc.so.26- librfccm.so- librfcum.sl- libsapu16.sl- libsapu16_mt.so- libsapucum.so

    Linux64-X86 - libicudata.so.26- libicui18n.so.26- libicuuc.so.26- librfccm.so- librfcum.so- libsapu16.so- libsapu16_mt.so- libsapucum.so

    Installing the SAP RFC SDK Libraries 11

    http://service.sap.com

  • Operating System Unicode RFC SDK libraries

    Linux Itanium 64-bit - libicudata.so.26- libicui18n.so.26- libicuuc.so.26- librfccm.so- librfcum.so- libsapu16.so- libsapu16_mt.so- libsapucum.so

    Linux-X86 - libicudata.so.26- libicuuc.so.26- librfccm.so- librfcum.so- libsapu16.so- libsapu16_mt.so- libsapucum.so

    Solaris 64-bit - libicudata.so.26- libicui18n.so.26- libicuuc.so.26- libr