BIT300 Integration Technology ALE en Col54

BIT300 Partner

Use

Date Training Center Instructors

SAP

Education Website

Partner

Participant Handbook Course Version: 2005 Q4 Course Duration: 3 Day(s) Material Number: 50078127

An SAP course - use it to learn, reference it for work

Only

Internal

Use

SAP

SAP NetWeaver

Internal

Only

Integration Technology ALE

Copyright Copyright © 2006 SAP AG. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. Additionally this publication and its contents are provided solely for your use, this publication and its contents may not be rented, transferred or sold without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.

Partner SAP Use

•

ORACLE® is a registered trademark of ORACLE Corporation.

•

INFORMIX®-OnLine for SAP and INFORMIX® Dynamic ServerTM are registered trademarks of Informix Software Incorporated.

•

UNIX®, X/Open®, OSF/1®, and Motif® are registered trademarks of the Open Group.

•

Citrix®, the Citrix logo, ICA®, Program Neighborhood®, MetaFrame®, WinFrame®, VideoFrame®, MultiWin® and other Citrix product names referenced herein are trademarks of Citrix Systems, Inc.

•

HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.

•

JAVA® is a registered trademark of Sun Microsystems, Inc.

•

JAVASCRIPT® is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape.

•

SAP, SAP Logo, R/2, RIVA, R/3, SAP ArchiveLink, SAP Business Workflow, WebFlow, SAP EarlyWatch, BAPI, SAPPHIRE, Management Cockpit, mySAP.com Logo and mySAP.com are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other products mentioned are trademarks or registered trademarks of their respective companies.

Disclaimer THESE MATERIALS ARE PROVIDED BY SAP ON AN "AS IS" BASIS, AND SAP EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES, EXPRESS OR APPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THESE MATERIALS AND THE SERVICE, INFORMATION, TEXT, GRAPHICS, LINKS, OR ANY OTHER MATERIALS AND PRODUCTS CONTAINED HEREIN. IN NO EVENT SHALL SAP BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES OF ANY KIND WHATSOEVER, INCLUDING WITHOUT LIMITATION LOST REVENUES OR LOST PROFITS, WHICH MAY RESULT FROM THE USE OF THESE MATERIALS OR INCLUDED SOFTWARE COMPONENTS.

g200672943835

Only

Internal

IBM®, DB2®, OS/2®, DB2/6000®, Parallel Sysplex®, MVS/ESA®, RS/6000®, AIX®, S/390®, AS/400®, OS/390®, and OS/400® are registered trademarks of IBM Corporation.

Partner

•

SAP

Microsoft®, WINDOWS®, NT®, EXCEL®, Word®, PowerPoint® and SQL Server® are registered trademarks of Microsoft Corporation.

Use

•

Internal

Only

Trademarks

About This Handbook This handbook is intended to complement the instructor-led presentation of this course, and serve as a source of reference. It is not suitable for self-study.

American English is the standard used in this handbook. The following typographic conventions are also used.

Partner

Words or characters that appear on the screen. These include field names, screen titles, pushbuttons as well as menu names, paths, and options.

Example text

SAP

Description

Example text

Emphasized words or phrases in body text, titles of graphics, and tables

EXAMPLE TEXT

Names of elements in the system. These include report names, program names, transaction codes, table names, and individual key words of a programming language, when surrounded by body text, for example SELECT and INCLUDE.

Example text

Screen output. This includes file and directory names and their paths, messages, names of variables and parameters, and passages of the source text of a program.

Example text

Exact user entry. These are words and characters that you enter in the system exactly as they appear in the documentation.

Variable user entry. Pointed brackets indicate that you replace these words and characters with appropriate entries.

iii

Internal

Only

© 2006 SAP AG. All rights reserved.

Partner

2005/Q4

SAP

Use

Also used for cross-references to other documentation both internal (in this documentation) and external (in other locations, such as SAPNet).

Use

Type Style

Internal

Only

Typographic Conventions

About This Handbook

BIT300

Icons in Body Text The following icons are used in this handbook. Icon

Meaning

Only

Exception or caution

Indicates that the item is displayed in the instructor’s presentation.

Use

Procedures

Internal

Note or further explanation of previous point

Partner

For more information, tips, or background

SAP

SAP Only

Internal

Use

Partner

iv


2005/Q4

Contents Course Overview ............................................................................. vii

Partner SAP

Unit 2: Master Data Distribution .......................................................... 59 Example: Material Master ................................................................. 60 Using Change Pointers .................................................................... 79 Data Filtering and Reducing the Scope of Data ........................................ 84

Unit 3: Distributing Transaction Data: Message Control.. .........................107

Unit 4: Distributing Transaction Data: BAPIs.........................................143

Unit 5: Monitoring Data Distribution, Error-Handling and Archiving ............185 IDoc Status Management................................................................. 187 Error Analysis and Handling.............................................................. 198 SAP Workflow in ALE Environment ..................................................... 222 Archiving IDocs ............................................................................ 238

Unit 6: Appendix .............................................................................247 Renaming Logical Systems .............................................................. 248 IDoc Recovery Following Database Error .............................................. 254

2005/Q4


v

Only

Business Object Types and BAPIs ...................................................... 144 The Usage of BAPIs in ALE .............................................................. 152 Example: Travel Expenses ............................................................... 162

Partner

Message Control and IDoc Generation ................................................. 108 Example: Purchase Order Processing.................................................. 123

SAP

Use

Cross-System Business Processes ........................................................ 3 The Distribution Model ....................................................................... 9 Basic ALE Customizing .................................................................... 15 Intermediate Documents................................................................... 30 Synchronizing Customizing ............................................................... 46 ALE and the SAP NetWeaver Exchange Infrastructure ............................... 53

Use

Internal

Unit 1: ALE Fundamentals ...................................................................1

Internal

Only

Course Goals.................................................................................vii Course Objectives ...........................................................................vii

Contents

BIT300

Index ............................................................................................261

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

vi


2005/Q4

Course Overview This course explains how to use Application Link Enabling (ALE) using predefined example scenarios. You will learn how to configure ALE scenarios and how to control data exchange between systems.

Only

Internal

Target Audience This course is intended for the following audiences:

Partner

• •

Consultants Project team members

Course Prerequisites

Use

Required Knowledge •

SAPTEC (Fundamentals of SAP Web AS)

SAP

•

SAP

Recommended Knowledge BIT100 (SAP NetWeaver Process Integration)

Use

This course will prepare you to:

• •

Create a system landscape for using different ALE scenarios (distributing master data and transaction data) Control data exchange between systems in a distributed system landscape Correctly assess the capabilities and limitations of ALE

Only

Internal

•

Course Objectives After completing this course, you will be able to: • • •

2005/Q4

Set up a distribution model for exchanging master and transaction data between systems Create partner profiles for data exchange in enterprises and for electronic communication with business partners Determine the scope of data to be distributed, depending on its type and recipient


Partner

Course Goals

vii

Course Overview

•

BIT300

Monitor data exchange between systems

SAP Software Component Information The information in this course pertains to the following SAP Software Components and releases:

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

viii


2005/Q4

Unit 1 Unit Overview

Unit Objectives After completing this unit, you will be able to:

SAP Use Internal

• • • •

2005/Q4


1

Only

• • • • •

Partner

• •

List examples of business processes in distributed system landscapes Differentiate ALE from EDI Explain the terms “logical system” or “logical system name”, “message type” and “distribution model” Explain the function of the distribution model Define logical system names and assign them to clients in SAP systems, where applicable Explain the terms “IDoc” and “basic type” Determine the assignment of message types to basic types Complete a view in a distribution model Explain the function of RFC destinations, ports and partner profiles Explain and differentiate between the terms “basic type”, “master IDoc” and “communications IDoc” Determine the details of basic types Describe the process from the creation of an IDoc in the sender system through to processing in the target system Describe methods for adjusting Customizing settings in SAP system landscapes Explain how ALE scenarios are integrated into SAP XI

SAP

• • •

Use

Partner

In this unit, you will first learn about the possible applications of ALE in enterprises. You will then find out which basic settings you need to make in Customizing and applications to use ALE.

Internal

Only

ALE Fundamentals

Unit 1: ALE Fundamentals

BIT300

Unit Contents

Only

Use

Partner

Internal

Lesson: Cross-System Business Processes ....................................... 3 Lesson: The Distribution Model ...................................................... 9 Lesson: Basic ALE Customizing ................................................... 15 Exercise 1: Basic ALE Customizing .......................................... 25 Lesson: Intermediate Documents ................................................. 30 Exercise 2: Documentation for Basic Types ................................. 43 Lesson: Synchronizing Customizing .............................................. 46 Lesson: ALE and the SAP NetWeaver Exchange Infrastructure .............. 53

SAP

SAP Only

Internal

Use

Partner

2


2005/Q4

BIT300

Lesson: Cross-System Business Processes

Lesson: Cross-System Business Processes Lesson Overview This lesson introduces examples of the application and use of ALE.

Lesson Objectives • •

List examples of business processes in distributed system landscapes Differentiate ALE from EDI

Globally-active enterprises usually structure their business using multiple clients in an SAP system, often also using multiple SAP systems. Frequently, these are joined by systems for specific applications from other providers. You need to clarify how the parties involved in this kind of system group exchange data with each other.

SAP Use

Only

Internal

Partner

An enterprise's head office, subsidiaries and sales and distribution branches are often technically separate systems. Each subsystem communicates not only with the other members of the system group but also with business partners, such as customers, vendors, banks and public authorities.

SAP

Enterprise Structure and Business Processes

Use

Partner

Business Example

Internal

Only

After completing this lesson, you will be able to:

Figure 1: The Enterprise as a Whole and External Parties

2005/Q4


3


BIT300

In the example illustrated above, the master data for the overall enterprise network is created and changed in the head office only. New master data and changes to existing data are regularly sent to the downstream systems of the sales and distribution branch and production. The central purchasing department orders from vendors, the sales and distribution branch receives orders from customers and sends these to production to be manufactured. Communication is to be electronic throughout all the processes.

Use

Partner

Only

Internal

Figure 2: Example: Sales Order Processing

SAP Use Internal

• • • •

4

Analysis of the enterprise's organizational structure and the mapping of its technical systems: which SAP systems or clients make up the enterprise's system landscape? Are there any non-SAP systems involved? Listing the software products installed in each participating system Describing the business processes that need to be mapped in the system landscape Breaking these processes down into individual steps Distributing the individual steps of the overall process to the participating systems or business partners


2005/Q4

Only

•

Partner

Preparatory Steps for Mapping Cross-System Business Processes

SAP

The customer sends a purchase order to the sales and distribution branch. The SD branch's system creates an order from the data in this purchase order and then an (internal) purchase order, which it sends to production's system. In the production system, an order is generated from this data. Depending on the agreements between the two enterprise areas, the production system confirms the order from the SD branch and announces delivery of the ordered material amounts. The SD branch can now confirm the customer's order in turn and notify the customer of a consignment of goods. After the goods have been delivered, production invoices sales and distribution for them. SD then, in turn, presents the customer with an invoice for the delivered goods.

BIT300


Internal Communication: Distributing Master Data with ALE ALE can be used within an enterprise for central master data administration (among other uses): master data is created and changed in only one of the systems in the enterprise network. The master data is distributed from this maintenance system to the downstream systems; the data records are forwarded in electronic form to each of the recipients. A typical example of this is centralized master data administration.

Use Internal

• • • •

2005/Q4

Which master data is maintained in which system? To which systems must the master data then be distributed? How often is the data distributed, and when? Do all the recipients receive all the data in its entirety?


5

Only

Basic Questions when Planning Centralized Master Data Distribution

Partner

In the scenario illustrated above, all the material masters are created in the head office and distributed from there to the downstream systems of sales and distribution and production. However, sales and distribution should only receive the master records for finished products, whereas production should receive material master data for both finished products and raw materials. When configuring the ALE scenario, it is therefore important to pay attention to the distribution hierarchy and also to take into account the fact that not every recipient receives all the data. In a different scenario, the departments in the receiving system are responsible for the maintenance of certain portions of a master record. In this case, the master record should not be transferred in its entirety, or there needs to be a guarantee that values changed locally cannot be overwritten if the data records are transferred again.

SAP

SAP

Use

Partner

Only

Internal

Figure 3: Example: Centralized Material Master Administration


BIT300

Communication with External Parties: Purchase Order Handling with EDI You want to communicate electronically not only within the enterprise, but also with your business partners. In this way, the data from an order created in your own system can be electronically transferred to a vendor, who, in turn, sends an order confirmation, shipping confirmation and finally an invoice.

Use

Partner

Only

Internal

SAP

SAP

Use Internal

Separating Systems for Legal Reasons: Human Resources Often, to comply with data protection legislation, a separate system is set up for human resources (HR). In this system, HR master data is managed, payroll accounting is processed and other sensitive data is retained. Unauthorized access to this data is

6


2005/Q4

Only

Generally, data exchange with external parties (that is, business partners, banks, or government agencies) is carried out using Electronic Data Interchange (EDI), not ALE. An electronic document is sent in an SAP-specific format from an SAP system to an EDI subsystem, called a converter. The subsystem converts this document to an EDI document, and sends it to the supplier. The unit on “Distributing Transaction Data: Message Control” contains more information about the differences between ALE and EDI.

Partner

Figure 4: Example: Purchase Order Processing

BIT300


supposed to be prevented (or at least made difficult) by technically separating the HR system from the other systems in the enterprise network. Other possible reasons for separating human resources are: • • •

Independence during technical upgrades Independence when installing Support Packages that effect (human resource-related) legal changes (known as Legal Change Patches) Better performance

Use

Only

Internal

Partner

Since Accounting is one of the systems included in the head office system, this latter also requires HR master data for paying salaries and wages or reimbursing travel costs. Cost centers and other account assignment objects are also required in both systems. Thus even in the case of a separate Human Resources system, master data distribution is useful. The results from the payroll or travel expenses are transferred to head office from the HR system for posting in Accounting.

SAP

SAP

Use

Partner

Only

Internal

Figure 5: Separate System for Human Resources

2005/Q4


7


BIT300

Lesson Summary You should now be able to: • List examples of business processes in distributed system landscapes • Differentiate ALE from EDI

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

8


2005/Q4

BIT300

Lesson: The Distribution Model

Lesson: The Distribution Model Lesson Overview

Internal

Only

The distribution model is the core component of ALE, as it determines which sender transfers which data to which recipients. It is made up of assignments of logical system names and message types. This lesson explains all three terms and the function each one plays in ALE scenarios.

Lesson Objectives After completing this lesson, you will be able to:

•

Explain the terms “logical system” or “logical system name”, “message type” and “distribution model” Explain the function of the distribution model

Use

Partner

•

Business Example

SAP

SAP

You have analyzed your business processes and the existing system landscape. You want to familiarize yourself with the configuration of an ALE scenario, using the example of centralized master data administration as a basis.

Logical System Name

Use

Only

Internal

Partner

Once you have determined which parts of the enterprise should use ALE to exchange data with each other, define logical system names for every client involved in the system group and, if applicable, for all external systems (if this has not already been done).

Figure 6: Example of a Scenario to be Mapped

2005/Q4


9


BIT300

The logical system name uniquely identifies the client of an SAP system or a non-SAP system in the system landscape. If the name refers to a client, assign the name to the client in the next step. To guarantee that the logical system name is unique and to simplify the assignment, SAP recommends using the naming convention CLNT. In the example illustrated below, the SAP system has the key G23. Clients 800, 810 and 811 are used. Thus, for example, client 800 receives the logical system name G23CLNT800.

Only

Use

Partner

Internal

Note: The terms “logical system name” and “logical system” are used interchangeably.

Internal

Caution: Changing the logical system name is a serious intervention, as this name is included in numerous application tables (see lesson on “Basic ALE Customizing” and appendix “Renaming Logical Systems”).

10


2005/Q4

Only

In certain cases, it could be useful not to use SAP's recommended convention for logical system names. The training clients for this course have “descriptive” names: the logical system name for head office is CORE, sales and distribution is called SALES and production is PRODUCTION. Naming the systems in this way is an alternative to the SAP convention if the assignment of clients to logical system names is frequently changed.

Partner

Use

SAP

SAP

Figure 7: Logical System Names

BIT300


Message Type When configuring an ALE scenario, in addition to assigning logical system names, you also need to indicate the types of data that are to be exchanged: if, for example, you want to distribute material masters with ALE in the future, you need to name the type of data (material masters) with what is known as a message type (MATMAS). Message types are therefore essentially keys, comparable to logical system names, which indicate data that can be exchanged between systems in ALE or EDI scenarios.

Use

Partner

Only

Internal

Internal

Note: In some ALE scenarios, “Business Application Programming Interfaces” (BAPIs) are used instead of message types. You will learn about how to use BAPIs in ALE in the unit: “Distributing Transaction Data: BAPIs”.

Distribution Model and Model Views If you want data to be sent from one logical system to another, you specify in the distribution model which message type is to be sent from which logical system to which logical system(s). The distribution model bundles all the assignments of

2005/Q4


11

Only

Both elements – the logical system name and message type – are linked to each other in the distribution model, in order to determine which sender sends which data to which recipient. In the example illustrated above, the head office (CORE logical system) distributes material masters (MATMAS message type) to sales and distribution (SALES logical system) and production (PRODUCTION logical system).

Partner

Use

SAP

SAP

Figure 8: Logical Systems and Message Types


BIT300

senders, recipients and data to be sent. If you set up a new ALE scenario, you normally create a new model view for this scenario in the distribution model of one of systems involved. In this model view, you name the sender and recipient using their logical system names and then add the message type describing the type of data that is to be sent.

SAP Use

Partner Only

Internal

SAP

You then need to distribute the newly created model view, in other words, make it known to the other systems involved. In the example shown above, the model view “master data” was created in the CORE logical system. However, this also affects the logical systems SALES and PRODUCTION. They receive copies of the new model view. You can distribute a model view to the partner systems using ALE, subject to certain conditions (explained below). It is, however, also possible to transport a model view to other systems.

Use

Partner

Only

Internal

Figure 9: Model View in a Distribution Model

12


2005/Q4

BIT300


Use

Partner

Only

Internal

Figure 10: Distributing Model Views

SAP Use

Only

Internal

Partner

You can find the distribution model in the IMG via SAP NetWeaver → SAP Web Application Server → IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Maintain Distribution Model and Distribute Views.

SAP

Note: To ensure that data remains consistent, you should maintain the distribution model centrally in one logical system and then distribute or transport its views to the other affected logical systems.

2005/Q4


13


BIT300

Lesson Summary You should now be able to: • Explain the terms “logical system” or “logical system name”, “message type” and “distribution model” • Explain the function of the distribution model

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

14


2005/Q4

BIT300

Lesson: Basic ALE Customizing

Lesson: Basic ALE Customizing Lesson Overview This lesson introduces basic ALE Customizing. In addition to this, you will learn where to find information about the ALE scenarios provided by SAP.

Lesson Objectives

Only

•

Partner

Business Example

SAP Use

Only

Internal

You can find all the basic Customizing settings in an SAP system's Implementation Guide (IMG) under SAP NetWeaver → SAP Web Application Server → IDoc Interface / Application Link Enabling (ALE). You can also call this section of the IMG directly by calling transaction SALE.

Partner

ALE Customizing in the Implementation Guide

SAP

You want to use ALE to exchange data between two SAP systems. You therefore want to get an overview of the Customizing settings needed to set up ALE scenarios. You also want to check if there is a standard ALE scenario that would be suited to your purposes.

Use

• • • •

Define logical system names and assign them to clients in SAP systems, where applicable Explain the terms “IDoc” and “basic type” Determine the assignment of message types to basic types Complete a view in a distribution model Explain the function of RFC destinations, ports and partner profiles

Internal


2005/Q4


15

BIT300

Figure 11: Transaction SALE

Partner SAP Use

Only

Internal

Partner

Each system in the system landscape must have a logical system name. This name uniquely identifies the logical system in the system landscape. You can then assign this name to the client of an SAP system.

SAP

Defining Logical System Names and Assigning them to Clients

Use

In the area Modelling and Implementing Business Processes, you will find extensive documentation about ALE scenarios, which you can use in many different applications (→ Configure Predefined ALE Business Processes). If, for example, you are interested in possible uses of ALE in human resources, go to Modelling and Implementing Business Processes → Configure Predefined ALE Business Processes → Human Resources. Depending on the application, you will find, in addition to a description of the scenario and the substeps needed to configure it, supporting functions, such as “auto-Customizing” or a program for checking the completeness and internal consistency of your settings.

Internal

Only


16


2005/Q4

BIT300


SAP Use

Hint: You can also call this table directly, using a transaction code (SCC4).

Message Types and Basic Types In ALE, message types indicate the data that is to be exchanged between each of two systems. MATMAS, for example, represents material records. The material master data to be distributed is transported in an electronic intermediate document (IDoc) from the sender system to the recipient system. This IDoc contains the data from the master record in an SAP-specific format. The structure of the document is determined in a basic type. The basic type defines the formatting structure of the data record that

2005/Q4


17

Only

Internal

You can find the assignment of logical system names to clients in the IMG, via SAP NetWeaver → SAP Web Application Server → IDoc Interface/Application Link Enabling (ALE) → Logical Systems → Assign Logical System to Client.

Partner

Hint: You can also call the table of logical system names directly, using transaction code BD54.

SAP

You can define logical system names in Customizing. In the SAP Reference IMG, choose SAP NetWeaver → SAP Web Application Server → IDoc Interface/Application Link Enabling (ALE) → Logical Systems → Define Logical System.

Use

Partner

Only

Internal

Figure 12: Defining Logical Systems


BIT300

is to be sent. Generally, the name of the IDoc basic type is the same as the name of the message type but with a version number added to it. The current version of the basic type for message type MATMAS, for example, is MATMAS05.

SAP Use

In the distribution model of a logical system, you define for each of your ALE scenarios which logical system sends what type of data to which partner system. You can create new model views in Customizing. To do this, in the IMG, go to SAP NetWeaver → SAP Web Application Server → IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Maintain Distribution Model and Distribute Views or call the distribution model directly via transaction BD64.

18


2005/Q4

Only

Internal

Creating Model Views in the Distribution Model

Partner

Note: The structure and use of IDocs is described in more detail in the lesson on “Intermediate Documents”.

SAP

To find out which version of the basic type is best suited to your SAP system's release level, see the table Output Types and Assignment to IDoc Types. To do this, in the SAP Easy Access Menu, go to Tools → ALE → ALE Development → IDoc → IDoc Type Development → IDoc Type for Message (transaction WE82). For an overview of all the message types, go to Tools → ALE → ALE Development → Logical Messages (transaction WE81).

Use

Partner

Only

Internal

Figure 13: Message Type and Basic Type

BIT300


SAP

SAP

To create a new model view, enter the logical system names of the sender and the recipient and a message type. You can assign logical systems for different message types as well as the sender and recipient roles in the same model view.

Use

Partner

Only

Internal

Figure 14: Distribution Model Maintenance in the IMG

Only

Internal

Use

Partner

Figure 15: Distribution Model

2005/Q4


19


BIT300

To ensure the consistency of the data across the system landscape and beyond, it is advisable to maintain the different views of a distribution model in one central system, and distribute them or transport them to the partner systems (see below).

RFC Destinations and Ports

Only

Use

Partner

Internal

In ALE scenarios, the systems involved exchange data via Remote Function Calls (RFC). From one SAP system, an RFC calls a function module in another SAP system. RFCs make it possible to exchange data between different SAP systems or between one SAP system and a non-SAP system. In non-SAP systems, specially-programmed functions are called instead of function modules; the interface of these functions simulates a function module.

SAP

SAP

For your ALE scenarios, you create RFC destinations for all the partner systems in each system involved. To do this, select in the ALE Customizing IDoc Interface / Application Link Enabling (ALE) → Communication → Create RFC Connections or use transaction SM59. In the RFC destinations, specify a target host, IP addresses, and

20


2005/Q4

Only

Internal

Use

Partner

Figure 16: Defining RFC Destinations

BIT300


(if applicable) the system number and user and logon data for “remote login” in the target system. Thus the RFC destination contains all the technical information that the calling system needs to call the partner from within the network. Hint: If you give the RFC destination the same name as the logical target system, you can have the system carry out certain settings automatically later on.

Use

Only Partner

Note: There are different types of port in SAP systems. ALE always uses RFC ports. In EDI scenarios, you can also use file ports in addition to RFC ports (see lesson on “Intermediate Documents”).

Transferring IDocs Using tRFC

SAP

Only

Internal

Partner

In transactional RFC calls, the data that belongs to an RFC function must be saved temporarily in the SAP database in the RFC client system. Once the processing is complete, this must be confirmed to the calling ABAP program. The tRFC component in the SAP system handles everything else.

SAP

To ensure that RFC functions can be executed reliably, securely, and independently of RFC server or RFC server system availability, the transactional RFC (tRFC) was introduced in SAP R/3 3.0. This ensures that the function module called is only executed once in the RFC server system.

Use

Internal

In order to use ALE scenarios later on, the RFC must be assigned to a port. The sender uses the port to determine the communication channel to the recipient. You can create ports manually or – if the logical target system and the RFC destination have the same name – have the sender system create them.

2005/Q4


21


BIT300

Partner

Only

Internal

Figure 17: Transactional RFC

SAP Use Internal

• • •

22

Suppress batch job in the event of communication errors (manual start with transaction SM58 required) Number of connection attempts Interval in minutes between repeated attempts to transfer data


2005/Q4

Only

In the SAP system, you can set tRFC parameters for the relevant connection in table RFCDES (for connection types T, 3, I) (SM59):

Partner

Note: An external tRFC client needs to repeat the calls itself at a later time.

SAP

If a connection error occurs during a synchronous RFC, the client repeats the call without knowing whether the processing has already taken place. The tRFC solves this problem as tRFC calls can be transferred even if the target system is not available. In these cases, the data is saved locally in the sender system and transmitted later. In SAP R/3 or SAP ECC, automatic job scheduling is used for this purpose. The job starts the corresponding function module(s) in the target system at a later time.

Use

As a database on an external system is not always available, the connection to the tRFC interface is implemented in such a way that the client or server programs must perform a number of administration functions on the RFC API basis to ensure that the function module is executed only once.

BIT300


Partner Profiles In ALE scenarios, application programs check the system's distribution model when they are called, in order to identify the recipient of each message prepared in IDoc format. ALE scenarios require partner profiles for every combination of recipient system and message type. These profiles are also necessary for processing inbound IDocs. There is always an outbound and an inbound partner profile for each message type in an ALE scenario.

Use

Partner

Only

Internal

Internal

From the inbound partner profile, the recipient system reads how and when the data from the inbound IDoc is to be transferred to the relevant application. As a rule, what is known as a process code is used to find a function module for the inbound processing of the IDoc. For a model view to be distributed to all the partner systems, the sender system must contain outbound partner profiles for message type SYNCH for all the affected recipient systems. This message type is used only for determining the RFC destination for the target system. If the name of the logical target system and its RFC destination

2005/Q4


23

Only

On the one hand, the sender system reads the basic type for the message type from the outbound partner profile, so that it can create an IDoc with the data that is to be distributed. On the other, the sender system uses the port assigned to the partner profile to find the RFC destination that enables it to call the recipient system. In addition to this, the partner profile determines whether the IDoc is sent immediately or not until later.

Partner

Use

SAP

SAP

Figure 18: Partner Profiles


BIT300

are the same, the sender system can automatically create a port with the appropriate RFC destination and generate the partner profiles for the message types of a model view. The authorization object for distributing model views is B_ALE_MODL. Note: The lesson on “Intermediate Documents” explains how to create and change ports and partner profiles.

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

24


2005/Q4

BIT300


Exercise 1: Basic ALE Customizing Exercise Objectives

Business Example

Task:

SAP Use

2.

In one of the three clients for the mySAP ERP logistics and accounting system, check the assignment of the logical system names to the three clients. Make a note of the assignment: Logical system

Client

Only

Internal

Search in the IMG documentation for ALE scenarios for master data distribution. To do this, use the IMG section IDoc Interface / Application Link Enabling (ALE) (transaction SALE).

CORE SALES PRODUCTION

Continued on next page

2005/Q4


Partner

1.

SAP

First, look in the IMG documentation to see if there are any ALE scenarios for master data distribution between SAP systems. Next, check the assignment of the logical system names CORE, SALES and PRODUCTION to the three training clients mentioned by your instructor. Then take a look at the distribution model for the CORE logical system.

Use

Partner

You want to use ALE to exchange data between two SAP systems. You therefore want to get an overview of the Customizing settings needed to set up ALE scenarios. You also want to check if there is a standard ALE scenario that would be suited to your purposes.

Internal

Only

After completing this exercise, you will be able to: • Find information about ALE scenarios supplied by SAP • Determine which logical system names are allocated to which clients • Check distribution model views and partner profiles

25


3.

BIT300

In the distribution model for the CORE system, select all the model views containing message type MATMAS.

4.

From the distribution model, display the CORE system's partner profiles for the SALES and PRODUCTION systems. Check the detail settings for the MATMAS message type.

5.

Check the corresponding inbound partner profiles in the SALES system.

Use

Partner

Internal

Only

Hint: Use the Filter model display button.

SAP

SAP Only

Internal

Use

Partner

26


2005/Q4

BIT300


Solution 1: Basic ALE Customizing Task:

a)

Select IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Configure Predefined ALE Business Processes → Logistics → Master Data Distribution.

b)

You will find IMG activities for setting up various master data distribution scenarios.

In one of the three clients for the mySAP ERP logistics and accounting system, check the assignment of the logical system names to the three clients. Make a note of the assignment: Logical system

Client

Use

SALES

a)

Choose IDoc Interface Application Link Enabling (ALE) → Basic Settings → Logical Systems → Assign Logical System to Client.

b)

One by one, select the table entries for the three training clients and click for each one: in the Logical system field, you will see the Details logical system name assigned to the client in question (CORE, SALES or PRODUCTION).


2005/Q4


27

Only

Internal

PRODUCTION

Partner

CORE

SAP

SAP

2.

Search in the IMG documentation for ALE scenarios for master data distribution. To do this, use the IMG section IDoc Interface / Application Link Enabling (ALE) (transaction SALE).

Use

Partner

1.

Internal

Only

First, look in the IMG documentation to see if there are any ALE scenarios for master data distribution between SAP systems. Next, check the assignment of the logical system names CORE, SALES and PRODUCTION to the three training clients mentioned by your instructor. Then take a look at the distribution model for the CORE logical system.


3.

BIT300

In the distribution model for the CORE system, select all the model views containing message type MATMAS.

SAP Use

From the distribution model, display the CORE system's partner profiles for the SALES and PRODUCTION systems. Check the detail settings for the MATMAS message type. a)

In the distribution model's menu, select Environment → Change partner profile.

b)

Open the folder for partner type LS (logical system) and select the entry for the SALES partner.

c)

In the outbound parameters, select the entry for message type MATMAS and click on DetailScreenOutb.Parameter : the SALES port and the MATMAS05 basic type are assigned here. The IDocs should be sent immediately.

Check the corresponding inbound partner profiles in the SALES system. a)

Call the distribution model as in step 3 a).

b)

In the menu, select Environment → Change partner profile, open the folder for partner type LS and select the CORE partner.

c)

Select the inbound parameters for the entry for message type MATMAS and click on DetailScreenInboundParameter : process code MATM is assigned here. The IDocs should be processed immediately.


2005/Q4

Only

Internal

Click on the Filter model displays button, enter MATMAS in the Message Type field and select Execute : the system will only display model views containing message type MATMAS.

Partner

28

b)

SAP

5.

Select IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Maintain Distribution Model and Distribute Views.

Use

Partner

4.

a)

Internal

Only

Hint: Use the Filter model display button.

BIT300


Lesson Summary

Only

Use

Partner

Internal

You should now be able to: • Define logical system names and assign them to clients in SAP systems, where applicable • Explain the terms “IDoc” and “basic type” • Determine the assignment of message types to basic types • Complete a view in a distribution model • Explain the function of RFC destinations, ports and partner profiles

SAP

SAP Only

Internal

Use

Partner

2005/Q4


29


BIT300

Lesson: Intermediate Documents Lesson Overview


• •

Explain and differentiate between the terms “basic type”, “master IDoc” and “communications IDoc” Determine the details of basic types Describe the process from the creation of an IDoc in the sender system through to processing in the target system

SAP

You want to use ALE to exchange data between two SAP systems and, by doing so, find out more about the technical implementation of ALE scenarios.

Use Internal

Note: Message types specify the type of data that is to be distributed. They are included in distribution model views. In the outbound partner profiles for sender and recipient, the appropriate basic type is assigned to one message type (see the lesson on “Basic ALE Customizing”). The example illustrated below shows a section from the structure of the basic type MATMAS05.

30


2005/Q4

Only

In ALE scenarios, data sent between two SAP systems or between SAP systems and non-SAP systems is transported in the form of Intermediate Documents (IDocs). The structure of an IDoc is specified by the basic type or IDoc type. Basic types are linked to message types. A basic type can be compatibly enhanced for a new release, in the same way as the interfaces of an ABAP function module. This means that there are often various basic types for one message type: each basic type represents a version of the same basic pattern.

Partner

Structure of an IDoc: The Basic Type

SAP

Business Example

Use

Partner

•

Internal

Only

In ALE scenarios, the systems involved exchange data in the form of intermediate documents (IDocs). This lesson deals with the structure of IDocs, presents various possible ways of generating IDocs and gives you an overview of the whole process, from IDoc creation in the sender system, through to the processing of the data in the recipient system.

Lesson: Intermediate Documents

Internal

Only

BIT300

SAP Use

The structure of the basic types provided by SAP is documented in detail in SAP R/3 and mySAP ERM. To call this documentation, go to Tools → ALE → ALE Administration → Services → Documentation → IDoc Types and Segments or call transaction WE60.

2005/Q4


31

Only

Internal

Note: For an overview of the segment structure of a basic type, see transaction WE30 (IDoc Type Development).

Partner

An IDoc does not have to contain all the segments of its segment type, and a segment type can have more than one segment. Whether an IDoc must contain a particular segment, and how many segments are permitted for a segment type, is determined in the IDoc type.

SAP

The basic type structures the formatting of the application data that is to be sent. Among other things, it specifies which data is stored in which location (row and offset). It also determines the order in which application data belongs to a message. An IDoc's data is organized in rows. The rows make up the segments of an IDoc, which are, in turn, composed of segment fields. The row structure of an IDoc segment is determined by a segment type. For every segment field, the field name is stored along with the technical properties and semantics of the field. IDoc segments can be hierarchically related to one another.

Use

Partner

Figure 19: The Basic Type


BIT300

In addition to information about the IDoc segments and their hierarchical dependencies, this documentation includes the following attributes: • •

•

IDoc type attributes: information, such as the first release of the IDoc type. Segment type attributes: this includes the information about whether a segment is “required” or “optional” and the minimum or maximum number of segments allowed for a segment type. Segment field attributes: technical and semantic properties of a field.

Only

The Master IDoc

SAP

SAP

The application programs that you use in ALE scenarios always begin by generating an internal table based on the IDoc basic type and using an ABAP program; this table is called a master IDoc. The application data is formatted line by line according to the basic type and then inserted in this internal table. An internal table is a data object in an ABAP program that exists only during the runtime of the program. Internal tables are, therefore, not saved to the database.

Use

Partner

Note: The basic types provided by SAP can be enhanced to suit the customer's needs. The BIT350 training course deals with enhancing IDoc basic types (ALE enhancements).

Internal

In addition to this, the documentation generally contains information about earmarking a segment field for organizational or business needs.

Only

Internal

Use

Partner

Figure 20: Structure of a Master IDoc

32


2005/Q4

BIT300


Each line in the internal table consists of a control part, which contains the meta information for the line, and the actual data part. The most important information in the control part is the name of the segment type that describes the structure of the data part.

Client

DOCNUM

Number of the IDoc

Only

SEGNUM

Consecutive number (line number in internal table)

SEGNAM

Name of the segment type

PSGNUM

Line number of the parent segment

HLEVEL

Hierarchy level

Internal

MANDT

Partner

The control section of every row consists of the following fields:

Overall length of data part

SDATA

Long field of type CHAR. Contains the data in the structure, which is described by the segment type.

Partner

Use

The line type of the internal table is determined by the ABAP Dictionary structure type EDIDD.

The Communications IDoc


Internal

Only

Later in the application program run, the system uses the data from the master IDoc to generate a communications IDoc, an intermediate document that is saved to the database and then sent. When the system or documentation refers to an “IDoc”, they are generally referring to this communications IDoc. Every communications IDoc consists of exactly one control record and multiple data records and status records.

2005/Q4

SAP

DTINT2

Use

SAP

The data part consists of the following fields:

33


BIT300

Use

Partner

Only

Internal

Figure 21: Structure of a Communication IDoc

SAP Use

Creating IDocs Application programs create IDocs in different ways. The figure below covers the four basic forms of IDoc creation:

34


2005/Q4

Only

Internal

The status records contain the processing steps of the IDoc. They log the stations that the IDoc has run through from when it was created to when it was sent; this helps you to monitor data distribution between systems.

Partner

The data records in the communications IDoc correspond to the lines in the master IDoc.

SAP

The important part of the control record is the IDoc number, which is assigned internally in the system. This number is unique within a logical system. You define the value range in each system using a number range interval. The control record also contains the key fields of the partner profiles, and the last processing status.


Internal

Figure 22: How is an IDoc Created?

•

Use

•

Internal

Exchanging Data with IDocs: Overview of the Process Data exchange using IDocs begins in the sender system when an intermediate document is created in IDoc format and ends when the data transported by the IDoc is posted in an application in the target system. In the process, certain stations are processed, which the sender and target systems each mark with status values.

2005/Q4


35

Only

Note: In later units, you will become familiar with examples of IDoc generation using SMD, message control and BAPIs. In each lesson in this unit, you will also learn about how you can use these instruments for your ALE scenarios.

Partner

•

Dedicated transactions: the preconfigured ALE scenarios for centralized master data administration use application transactions that were specifically programmed for creating IDocs. These transactions are brought together in the umbrella term “Shared Master Data” (SMD). Message control: some logistical applications in SAP R/3 and mySAP ERM use message control to output the data from their documents. Formatting the document data in IDoc format is one of the message output options. Application programs: some application programs generate IDocs directly by filling an internal table in IDoc format and further processing it. Business Application Programming Interfaces (BAPIs): the application program uses a BAPI with an ALE interface.

SAP

SAP

•

Use

Partner

Only

BIT300


BIT300

Use

Partner

Only

Internal

SAP Use

•

Note: You will find out about other status values in the unit on “Monitoring Data Processing, Error Handling and Archiving”.

36


2005/Q4

Only

• •

Partner

•

•

Regardless of how the IDoc was created, it is first saved to the sender system's database (status value 01). If all the information required for sending has been obtained from the recipient, then the IDoc receives the status “ready for dispatch” (status value 30). If the outbound partner profiles specify that the IDoc is to be transferred immediately to the port stored in the relevant message type, then the IDoc is sent and receives a corresponding status (status value 03). However, it is also possible to send multiple IDocs bundled together at a later time. The IDoc is saved to the target system's database (status value 50). If all information about further processing is known, the IDoc can be transferred to the application (status value 64). If the inbound partner profiles specify that the IDoc is to be transferred to the application immediately, the target system attempts to post the IDoc data (status value 62). If the inbound processing is successful, the IDoc receives status value 53.

SAP

•

Internal

Figure 23: The IDoc's Path and Status Values

BIT300


Exchanging Data with IDocs: Process Substeps First, the application program generates a master IDoc containing the application data.

Use

Only

Internal

The ALE layer checks the distribution model to determine the recipient(s) of the message.

Partner

The master IDoc is transferred to what is known as the ALE layer. The ALE layer is the ALE-specific part of the application program.

SAP

SAP

Use

Partner

Only

Internal

Figure 24: Generating a Master IDoc

2005/Q4


37


BIT300

Use

Partner

Only

Internal

Figure 25: Recipient Determination in the ALE Layer

SAP Use

Only

Internal

Partner

In order to be able to send the communications IDoc to the recipient, the sender system uses the outbound partner profile to determine the port (in other words, the communication channel) via which the IDoc is to reach the target system. Then the IDoc is converted into the format suitable for the port. This part of the program is also known as the communication layer.

SAP

Next in the program's run, the sender system checks the outbound partner profiles for the message type used. For each recipient, a communication IDoc is created according to the basic type and is saved to the database.

38


2005/Q4

BIT300


Use

Partner

Only

Internal

SAP

The ALE layer can pass a communications IDoc directly to the communication layer. However, for performance reasons, it is often better to first save the IDocs to the database and then to process them collectively later. The partner profile determines whether a communications IDoc is sent to the port immediately or not until later.

SAP

Use

Figure 26: Further Processing in the Communication Layer

Metaphorically speaking, the communications IDoc is like a letter that is to be sent to one or more recipients. The letter is copied and a copy is placed in an envelope for each recipient. The sender and recipient are noted on the envelope. Then it is placed in an out-tray whose contents are later put in a mailbox.

Partner Only

Internal

Two types of port are used for sending IDocs: tRFC ports and file ports.

2005/Q4


39


BIT300

SAP Use Internal

The IDoc is initially saved to the database in the recipient system.

Partner

Not every partner system is able to interpret the RFC protocol. In EDI scenarios involving a converter, a file port is often used, for this reason. The IDoc is stored for this file port as a sequential file at the operating system level in such a way that the target system can access it. A corresponding path in the file system is entered in the port.

SAP

The port type tRFC is short for “transactional Remote Function Call”. The technology of the transactional RFC ensures that the recipient receives the document once and once only. If the recipient cannot be reached at the time of sending, the system attempts to establish the connection again at regular intervals. The document is only deleted from the tRFC queue when it has reached the target system. In ALE scenarios, data transfer is via tRFC.

Use

Partner

Only

Internal

Figure 27: Port Types

Only

40


2005/Q4

BIT300


Use

Partner

Only

Internal

Figure 28: Inbound Processing in the Recipient System

SAP Use

Only

Internal

Partner

The ALE layer uses the partner profile to determine a transaction code that controls how the IDoc is processed further. Generally speaking, the data is transferred to the application by a function module. However, a workflow could also be started instead.

SAP

Depending on the defaults in the partner profiles, the IDoc is either transferred to the ALE layer immediately or not until later by a program for background processing.

2005/Q4


41


BIT300

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

42


2005/Q4

BIT300


Exercise 2: Documentation for Basic Types Exercise Objectives After completing this exercise, you will be able to: • Display documentation about basic types in mySAP ERP

Only SAP

From the application menu, display the documentation for the basic type MATMAS05.

2.

Find segment type E1MARMM (Material master units of measure) and display the structure. Which segment type is dependent on E1MARMM?

3.

Change your user settings so that, in future, the link to the documentation for individual segment fields is displayed next to the link to the structure of the corresponding segment type.

SAP

1.

Use

You want to learn about the structure of the MATMAS05 basic type, so that you can use the “Central Material Master Management” ALE scenario.

Task:

Internal

You want to use ALE to exchange data between two SAP systems and, by doing so, find out more about the technical implementation of ALE scenarios.

Partner

Business Example

Only

Internal

Use

Partner

2005/Q4


43


BIT300

Solution 2: Documentation for Basic Types Task: You want to learn about the structure of the MATMAS05 basic type, so that you can use the “Central Material Master Management” ALE scenario.

SAP Use

In the Basic type field, enter MATMAS05 and select HTML Format

.

Find segment type E1MARMM (Material master units of measure) and display the structure. Which segment type is dependent on E1MARMM? a)

Segment type E1MARMM is dependent on segment type E1MARAM (Material master general data). Click on the Structure link below the status information about segment type E1MARMM to call a list of segment fields.

b)

Segment type E1MARMM (Material master EAN code) is dependent on segment type E1MARMM.

Change your user settings so that, in future, the link to the documentation for individual segment fields is displayed next to the link to the structure of the corresponding segment type. a)

Choose Back

b)

In the transaction's menu, select Goto → User Settings, click on Display <-> Change , set the Documentation Output indicator and save your changes.

c)

Check the changed setting by displaying the HTML display again: you can now access a Documentation link which you can use to call information about the individual segment fields.

to exit the HTML display.


2005/Q4

Only

Internal

b)

Partner

44

Select Tools → ALE → ALE Administration → Services → Documentation → IDoc Types and Segments.

SAP

3.

a)

Use

Partner

2.

From the application menu, display the documentation for the basic type MATMAS05.

Internal

Only

1.

BIT300


Lesson Summary You should now be able to: • Explain and differentiate between the terms “basic type”, “master IDoc” and “communications IDoc” • Determine the details of basic types • Describe the process from the creation of an IDoc in the sender system through to processing in the target system

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


45


BIT300

Lesson: Synchronizing Customizing Lesson Overview Data exchange across system boundaries requires the basic configurations of the applications involved in the sending and target systems to be aligned with each other. This lesson deals with synchronizing Customizing for the purposes of ALE.

Only


Consequences of Distributing Applications Across Two Systems

Previously, you modeled your business processes in one particular system. In the future, you want to outsource a subprocess to a second system. You want to be able to assess the consequences and give yourself an overview of the different methods for aligning the system configuration.

Use

Only

Internal

Partner

If all applications are integrated in one system, the programs access the same database. In this type of system, the consistency of the data is guaranteed because every item of logical information is stored in only one database table, and all programs retrieve data directly from the database. As soon as one application is separated from the rest of the applications by being installed in another system, the applications need to communicate via interfaces. The Customizing settings and master data must be consistent in all the communicating systems.

SAP

Business Example

Use

Partner

Describe methods for adjusting Customizing settings in SAP system landscapes

SAP

•

Internal

Lesson Objectives

46


2005/Q4

BIT300

Lesson: Synchronizing Customizing

SAP Use Internal

2005/Q4


47

Only

A business process often consists of multiple single steps. Within a business process, an agent can be responsible for more than one step. However, process steps can also be carried out by different agents. Applications in SAP can be affected by more than one partial solution. Once a process step has been processed, the newly created or changed data is saved to the database. The agent for the next process step needs to be informed, and the data required for executing the next step needs to be transferred.

Partner

Business Process in One System

SAP

In ALE scenarios, IDocs are used to exchange application data between the systems involved in a process. This exchange can only work if an IDoc contains only field values that are also defined in the target system, unless these are fields for which unrestricted data entry is planned. However, in most of the fields in the master data and documents for SAP applications, only the field values pre-defined in Customizing are allowed. This means that, before you distribute the data, you need to make sure that these catalogs of values match in both the sending and target systems. If you cannot (or do not wish to) match the systems, deviating field values need to be replaced by values from the target system during further processing of either the outbound or the inbound IDoc.

Use

Partner

Only

Internal

Figure 29: Distributing Applications Across Two Systems


BIT300

Use

Partner

Only

Internal

Figure 30: Business Process in One System: Example

SAP Use Internal

48


2005/Q4

Only

If a business process extends across not only various subsolutions but also across different systems, then specific data needs to be forwarded to the next agent. In ALE scenarios, an IDoc functions as a “container” for this data.

Partner

Business Processes in Multiple Systems

SAP

The example shown above illustrates a sales order being processed in an SAP R/3 or SAP ECC system. Agent 1, a sales employee, records the customer's order in the system. The system (agent 2) automatically creates the shipment for this sales order. A further employee (agent 3) creates a transfer order so that the product that is to be shipped is removed from storage. Once the product has been removed from storage, the system (agent 2) posts the goods issue so that the sales employee (agent 1) can end the process by creating the billing document, in other words, the invoice for the customer. This process therefore involves not only various agents but also various subsolutions (sales, delivery processing, warehouse management and inventory management).

BIT300


Use

Partner

Only

Internal

Figure 31: Business Processes in Two Systems: Example

SAP Use

In addition to distributing master data and transaction data, you can also use ALE to align the Customizing settings between systems (in preparation for distributing master and transaction data). Message type CONDA2 is available in the SAP R/3 and SAP ECC systems for this purpose (ALE: Synchronization of Customizing Data). The core of this function is an automatic alignment of selected Customizing objects in two SAP systems: this alignment generates transport requests for all the changes. Note: In systems released before SAP R/3 4.6A, use message type CONDAT instead.

2005/Q4


49

Only

Internal

Synchronizing Customizing Settings with ALE

Partner

Note: This is a simplified representation of the “Decentralized Warehouse Management System” ALE scenario.

SAP

The figure illustrates the same process as the last one. The difference to the first example is that warehouse management is outsourced to a second SAP system. The shipment data from the first system is transferred to the second system in an IDoc. There, it is processed further in the stock removal step. After this procedure has been completed, the warehouse management system creates a second IDoc with all the data necessary for continuing the shipment process in the first system.


BIT300

Note: You can distribute all client-dependent Customizing objects of category CUST. Each object can be assigned to one distribution group, and one only.

Partner SAP Use Internal

50


2005/Q4

Only

As an alternative to distributing Customizing settings with ALE as described in the previous section, you can use the SAP Solution Manager: this is an extensive set of instruments for configuring and operating SAP solutions. The SAP Solution Manager includes two components for synchronizing Customizing settings between SAP systems: the Customizing Scout and Customizing distribution. The Customizing Scout compares the configurations of multiple SAP systems and displays the differences. The comparison can – as in ALE – be carried out interactively or in the background, and periodically, if required. After the settings have been matched,

Partner

Synchronizing Customizing Settings with the SAP Solution Manager

SAP

Note: The ALE transport request can be consolidated by a dedicated transaction (BDXL) with transport requests for exporting the changes to the quality assurance and production systems.

Use

All the Customizing settings you need for cross-system Customizing comparison and subsequent synchronization can be found with transaction SALE. In the menu, select IDoc Interface/Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Synchronization of Customizing Data. You can call the relevant application transactions in SAP Easy Access via Tools → ALE → ALE Administration → Services → Customizing Data. Here you will find a program for matching Customizing tables in the sending and target systems, known as the “Customizing Cross-System Viewer” (transaction SCU0), and transaction for generating and further processing ALE transport requests for Customizing synchronization. The sending system creates IDocs of message type CONDA2 for the transport requests: these IDocs contain the core information about each request. Inbound processing of these IDocs controls the importing of request data in the target system: either a workflow is sent to the responsible administrator requesting him or her to carry out the import, or the import is carried out automatically by a program executed in the background.

Internal

Only

To optimize the use of ALE for Customizing synchronization, one logical system in the system landscape is identified as the central Customizing system. Changes to certain Customizing tables are made in this system only. You can determine exactly which objects should only be changed in the context of ALE distribution. You group together these objects, known as ALE Customizing objects, into distribution groups, which are automatically assigned to the logical maintenance system. You then need to distribute these distribution groups to the target systems. It is now no longer possible (or only partly possible, depending on the particular configuration) to carry out any changes in the target system to the objects contained in the distribution groups.

BIT300


the Customizing distribution instrument can create transport requests for each changed Customizing object in the maintenance system and distribute the requests automatically to the downstream systems. It is, however, also possible to distribute manually. Certain Customizing objects are predefined in the SAP Solution Manager as synchronization objects.

Converting Field Values: Cross-System Company Codes


51

Only Partner SAP Use Internal

Only

2005/Q4

Partner

Note: The configuration of field conversion is one of the topics covered in the BIT350 training course (ALE Enhancements).

SAP

There are only a few cases where you can convert field values directly using Customizing tables before the IDoc is sent or before IDoc inbound processing. For all other field values that need to be replaced by other values, you can use the Field Conversion tool. This allows either the sending or the target system to change the content of IDoc segment fields during runtime of the application program in question. Field conversion is based on rules and allows for a more differentiated data changing procedure than that provided by exchanging values on the basis of Customizing table entries.

Use

Caution: You need to define and assign at least one cross-system company code in the sending and target systems, even if the company code keys are identical. If this setting is missing, IDoc processing fails. The outbound IDoc receives status 29 (Error in ALE Service) and the inbound IDoc receives the corresponding status 65.

Internal

It is not always either possible or desirable to standardize Customizing in a system landscape. If, for example, a logical system represents an enterprise's subsidiary, then the keys for the organizational units will normally differ, at least in part. The subsidiary will be assigned to a different company code than the parent company. For this reason, you use what are known as cross-system company codes in ALE scenarios. These are freely-definable keys that are each assigned to one “genuine” company code, in other words, a company code used in the application. When creating a communications IDoc containing the field Company Code in one of its segments, the sending system replaces the company code key from the application (such as a customer master that is to be distributed) with the key for the assigned cross-system company code. The target system carries out the same operation in reverse: it replaces the cross-system company code with the “genuine” company code, in order to create or change the customer master. You can find the tables for defining cross-system company codes and linking them to the company codes used in the applications under transaction SALE, via IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Global Organizational Units → Cross-System Company Codes. You need to carry out similar settings for the business areas.


BIT300

Lesson Summary You should now be able to: • Describe methods for adjusting Customizing settings in SAP system landscapes

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

52


2005/Q4

BIT300

Lesson: ALE and the SAP NetWeaver Exchange Infrastructure

Lesson: ALE and the SAP NetWeaver Exchange Infrastructure Lesson Overview Lesson Objectives

Only

•

Explain how ALE scenarios are integrated into SAP XI

Business Example

Use

Partner

You have already set up some ALE scenarios in your system landscape and are considering using SAP NetWeaver Exchange Infrastructure to exchange data between the systems involved and with third parties.

Use

SAP XI consists of an Integration Server that acts as a central message bus, receiving and forwarding (routing) messages, thereby carrying out the necessary mapping between different data formats. Messages are processed within SAP XI in the form of XML documents. Any systems that do not directly support this data format can be linked to XI with SAP XI adapters. There are a variety of adapters for this purpose; these are provided either by SAP itself or by SAP's partner companies.

Partner

Note: Adapters need to be configured for the connection to a system. This configuration is carried out in the form of a communication channel. A communication channel defines the rules of inbound and outbound message processing.


53

Only

Internal

The Exchange Infrastructure from SAP NetWeaver (SAP XI) enables you to realize cross-system business processes. SAP XI makes it possible to link systems from various providers in different versions and implemented in different programming languages (Java, ABAP, and so on). SAP XI is based on an open architecture and supports the protocols, data formats and interfaces used in SAP and non-SAP systems.

SAP

SAP

The SAP NetWeaver Exchange Infrastructure

2005/Q4

Internal



BIT300

In addition to the Integration Server, SAP XI consists of a series of components with various different tasks, introduced briefly below: • •

Use

Partner

Internal

Only

•

The Integration Repository is the directory of message interfaces involved in data exchange. The mappings between the interfaces are stored here as well. The configuration is stored in the Integration Directory; in other words, the routing information about which message is to be sent from which system to which other system. The systems themselves are stored in the System Landscape Directory (SLD) in the form of business systems. In addition to system information, the SLD also contains the information about the products and software used.

SAP

SAP

Use

ALE Scenarios and SAP XI

The IDoc adapter converts IDoc data records into IDoc XML, which is then used for processing in the Integration Server. The IDoc adapter also has to convert information from the sending and target systems, since these are present in the Integration Server in the form of business systems that are stored in the SLD. A logical system name can be assigned to these business systems.

54


2005/Q4

Only

Internal

The Integration Server uses the IDoc adapter to connect back-end systems that are to send or receive IDocs. The IDoc adapter is a part of the ABAP side of the Integration Server and communicates with the back-end system via transactional RFC (tRFC).

Partner

Figure 32: Components of SAP NetWeaver Exchange Infrastructure

BIT300


The IDoc adapter requires IDoc type metadata for conversion between IDoc and IDoc XML. You need to define a port in transaction IDX1 in the Integration Server to enable the IDoc adapter to access data in the backend repository: this IDX1 port references an RFC destination (type 3), which refers to the back-end system. Note: After it is accessed, the IDoc type metadata is held in a cache which can be seen on the Integration Server via transaction IDX2, where it can also be manually deleted.

Only Partner SAP Use

• • • •

2005/Q4

SLD: assign a logical system name to the business system assigned to the back-end system Integration Repository: import the IDoc type Integration Server (ABAP): create an RFC destination to the back-end system (transaction SM59) Integration Server (ABAP): create a port with a reference to the RFC destination (transaction IDX1) Integration Directory: create a communication channel of the type “Receiver IDoc”


55

Only

Internal

•

Partner

In a scenario where IDocs are to be exchanged with the Integration Server, you need to carry out the following steps on the Integration Server:

SAP

Note: No communication channel needs to be stored for IDocs sent from the back-end system to the IDoc adapter. However, an IDX1 port is also needed here to access the metadata.

Use

For an IDoc to be sent from the Integration Server to the back-end system, there needs to be a communications channel (of the type “Receiver IDoc”) stored in the Integration Directory, containing technical information about the connection to the back-end system. The communication channel specifies, on the one hand, an RFC destination for sending the IDoc and, on the other hand, a reference to the IDX1 port, which references an RFC destination for accessing the IDoc type metadata.

Internal

The interfaces for the systems involved in data exchange are stored in the Integration Repository so that they can be used for mapping and routing. IDoc types therefore need to be imported into the Integration Repository. To do this, the data for the connection to the back-end system is assigned to the software component version to which the IDoc type belongs and into which it is to be imported. Then the metadata is loaded via RFC call from back-end system into the Integration Repository. The name of the IDoc type is stored in the Integration Repository in the form: ., for example MATMAS.MATMAS05.

BIT300

Internal

Only


Use

Only

Internal

If you do not want to use any logical system names in the IDoc for the sender and recipient information in the control record, but other partner types such as customer or vendor instead, then the IDoc adapter can also reassign these types into the business systems required in the Integration Server. For this to happen, the business system that corresponds to the back-end system needs to be assigned this partner type in the Integration Directory using what is known as a partner object as an identifier.

Partner

Note: The ALE inbound function module IDOC_INBOUND_ASYNCHRONOUS checks whether it has been executed on the Integration Server and, if it has, then it transfers the received IDoc as an XML document to XI processing and not ALE processing.

SAP

SAP

The configuration in the back-end system consists of the usual ALE configuration objects (distribution model, partner profiles, port, RFC destination). The RFC destination that refers to the Integration Server in order to send IDocs there is of type 3 (“connection to R/3 system”) because the IDoc adapter is on the ABAP side of the Integration Server.

Use

Partner

Figure 33: XI IDoc Adapter

56


2005/Q4

BIT300


Lesson Summary You should now be able to: • Explain how ALE scenarios are integrated into SAP XI

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


57

Unit Summary

BIT300

Unit Summary

Only Partner

Use SAP

SAP

Internal

You should now be able to: • List examples of business processes in distributed system landscapes • Differentiate ALE from EDI • Explain the terms “logical system” or “logical system name”, “message type” and “distribution model” • Explain the function of the distribution model • Define logical system names and assign them to clients in SAP systems, where applicable • Explain the terms “IDoc” and “basic type” • Determine the assignment of message types to basic types • Complete a view in a distribution model • Explain the function of RFC destinations, ports and partner profiles • Explain and differentiate between the terms “basic type”, “master IDoc” and “communications IDoc” • Determine the details of basic types • Describe the process from the creation of an IDoc in the sender system through to processing in the target system • Describe methods for adjusting Customizing settings in SAP system landscapes • Explain how ALE scenarios are integrated into SAP XI

Only

Internal

Use

Partner

58


2005/Q4



• •

Use

Lesson: Example: Material Master ................................................ 60 Procedure: Creating and Distributing a Model View ........................ 70 Exercise 3: Master Data Distribution.......................................... 73 Lesson: Using Change Pointers ................................................... 79 Lesson: Data Filtering and Reducing the Scope of Data ....................... 84 Exercise 4: Using a Reduced Message Type ............................... 97

2005/Q4


59

Only

Internal

Unit Contents

Partner

• •

Describe the configuration of an ALE scenario for distributing material master data Distribute material masters Explain the use of change pointers in master data distribution and set them up in the system Describe different methods for filtering data in IDoc processing Create a reduced message type and use it in the distribution process

SAP

SAP

•

Use

Partner

The decision to manage master data centrally is one of the main reasons for using ALE. In this unit you will learn about all the settings needed for setting up a central master data administration.

Internal

Only

Master Data Distribution

Unit 2: Master Data Distribution

BIT300

Lesson: Example: Material Master Lesson Overview Distributing master data is one of the applications of ALE. This lesson introduces the “Shared Master Data” instrument for distributing master data, using the material master as an example.

Only

After completing this lesson, you will be able to: •

Business Example

Central Material Master Administration

Use

Only

Internal

Partner

One method of keeping the master data consistent in a system landscape is to maintain the master data in a central system, and replicate it to the downstream systems at regular intervals. It is either not at all possible, or only possible to a limited extent, to change data in these latter systems.

SAP

SAP

In the future, you want all material masters for the entire corporate network to be stored in the central system only and for them to be sent from there to the downstream sales branch and production systems.

Use

Partner

•

Describe the configuration of an ALE scenario for distributing material master data Distribute material masters

Internal

Lesson Objectives

60


2005/Q4

BIT300

Lesson: Example: Material Master

SAP Use Internal

2005/Q4


61

Only

There are standard ALE scenarios for distributing master data; these are documented in the SAP Library and in the IMG. You can use transaction SALE to find descriptions of how to set up certain master data distribution scenarios. To do this, go to IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Configure Predefined ALE Business Processes → Logistics → Master Data Distribution. For more information, follow menu path IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution. In this section of the IMG, you can carry out the Customizing settings for your master data distribution scenarios described in this lesson.

Partner

Note: The lesson on “Using Change Pointers” deals with distributing changes to the master data at regular intervals.

SAP

In the example illustrated above, the material masters for the enterprise are created and changed in the head office (central system). New material masters and changes to existing data are regularly sent to the downstream systems for the sales and distribution branch and production.

Use

Partner

Only

Internal

Figure 34: Example Scenario


BIT300

You need to answer the following questions before you configure any distribution scenario: • • •

Only

Configuration of the Central Material Master Administration

Use

Partner

The figure below illustrates the most important elements in the example scenario:

Internal

•

Which system is which master data maintained in? When and how often should the master data be replicated to which downstream systems? If there is more than one target system, are all changes to the master data relevant to all target systems? Which Customizing settings need to be synchronized in the systems involved?

SAP

SAP

The head office's logical system is called CORE. The sales and distribution branch's logical system is called SALES and the logical system for production is called PRODUCTION. The message type for distributing material masters is MATMAS. First, use this information to create a new view in the distribution model of one of the system's involved. In the training scenario, CORE is the maintenance system for all model views. In the new view, you need to specify the behavior of the sender and the recipient and inform the system about what type of data is to be distributed.

62


2005/Q4

Only

Internal

Use

Partner

Figure 35: Basic Settings for the ALE Scenario


Figure 36: Maintaining the Distribution Model and Distributing Views

SAP Use

Only

Internal

Partners of the type “logical system” (LS) are always created for ALE scenarios. The name of the partner is always the same as the logical system name.

Partner

Note: If your RFC destinations have different names to the target systems to which they lead, you need to first create the entry for message type SYNCH manually and then assign the RFC destination you require using the relevant port. After you have done this, you can have the system generate the remaining partner profiles.

SAP

If RFC destinations already exist with the same names as the logical target systems, you can now have the system create the outbound partner profiles for the new model view. When it generates partner profiles, the system automatically creates an entry for the message type MATMAS and also an entry for message type SYNCH for each profile (ALE:Dummy Message Type for Determination of RFC Destinations). This message type is not used for generating IDocs: it is only used for determining the RFC destination of the relevant target system. The entry for message type SYNCH is a prerequisite for distributing model views.

Use

Partner

To ensure consistency, you should maintain the distribution model centrally, and distribute or transport the relevant views to the other participating systems.

Internal

Only

BIT300

2005/Q4


63


BIT300

Use

Partner

Only

Internal

Figure 37: Partner Profile: Partner Type

SAP

SAP

The figure below schematically represents the most important settings at the outbound partner profile level:

Only

Internal

Use

Partner

Figure 38: Partner Profile (Outbound)

64


2005/Q4

BIT300


In the outbound partner profile for a message type, store the following information: •

•

Note: If you select the Collect IDocs output mode, you need to execute the RSEOUT00 program to transfer the IDocs to the communication layer. This program is usually scheduled as a periodic background job.

SAP

SAP

After you have created the outbound partner profiles for the target systems, you can distribute the new model view to these systems.

Use

Partner

•

Internal

Only

•

Receiver port: in ALE scenarios, the sending and target systems exchange data via RFC. You therefore need to use a port of the type “transactional RFC” in the outbound partner profiles for ALE scenarios; the RFC destination of this RFC leads to the target system, the partner in the profiles. Output mode: You can choose between Transfer IDoc Immed. and Collect IDocs. Package size: If you choose Transfer IDoc Immed., the IDocs are sent individually. If you choose Collect IDocs, multiple IDocs are collected in packages and sent together. Collecting IDocs to send together can improve performance. As a guideline, we recommended collecting between 20 and 100, depending on the size of the IDocs. Basic type: in this field, you need to enter the IDoc type that is compatible with the target system's release level.

Only

Internal

Use

Partner

Figure 39: Distributing the Model View

2005/Q4


65


BIT300

After you have successfully distributed the model view to the SALES and PRODUCTION systems, you can display the copies in their respective distribution models. In the last step, you have the system generate the inbound partner profiles with the CORE sending system, or you can store the data manually.

Use

Partner

Only

Internal

Figure 40: Partner Profile (Inbound)

SAP

Processing mode: you can choose between Trigger by background program and Trigger immediately. If you choose Trigger by background program, the IDocs are transferred to the ALE layer using the RBDAPP01 program. This program is usually scheduled as a periodic background job.

Internal

Use

•

66


2005/Q4

Only

Process code: the process code is a key that refers either to a function module or a workflow for processing the IDocs. The process code for message type MATMAS is MATM. If you double-click on the process code key, a screen appears containing the information as to which function module or which workflow is used for inbound IDoc processing. As a rule, function modules are used in ALE scenarios. Note: There can be more than one process code for a message type (and, accordingly, more than one inbound function module or workflow). For information about which process codes are assigned to which message types, see the Inbound process code table (transaction WE42).

Partner

•

SAP

In the inbound partner profile for a message type, store the following information:

BIT300


SAP Use

Sending and Requesting Master Data The “Share Master Data” tool offers you a variety of application transactions for generating IDocs for distributing master data. You can find these transactions via menu path Tools → ALE → Master Data Distribution. You can also call all of the SMD transactions directly using transaction BALM.

2005/Q4


67

Only

Internal

Note: Monitoring IDoc processing is covered along with error-handling in the unit “Monitoring Data Distribution, Error-Handling and Archiving”.

Partner

You can check the current status of IDocs in SAP R/3 or mySAP ERM by using a status monitor. You can call this monitor with transaction BD87 or the menu path Tools → ALE → ALE Administration → Monitoring → IDoc Display → Status Monitor.

SAP

You can define variants for the RSEOUT00 and RBDAP001 programs for collective background IDoc processing. You can find both programs in the IMG via transaction SALE, by going to IDoc Interface / Application Link Enabling (ALE) → System Monitoring → IDoc Processing → Dispatch Collected IDocs or Update IDocs in Receiver System.

Use

Partner

Only

Internal

Figure 41: Processing Times

BIT300

Figure 42: Sending Master Data

Partner SAP

SAP

In ALE scenarios, master data is normally sent from the maintenance system to the downstream systems. However, with cross-application master data (material, customer, vendor), it is also possible to retrieve data.

Use

You can send material masters directly using transaction BD10, for example (menu path: Tools → ALE → Master Data Distribution → Cross-Application → Material). In this transaction, you can either specify a target system or get the system to determine the recipient itself from the distribution model. If you do not specify a target system, the sending system might generate multiple IDocs.

Internal

Only


Only

Internal

Use

Partner

Figure 43: Retrieving Master Data

Message type MATFET, for example, is used for fetching material masters. This message type is linked to the corresponding views in the distribution model (see figure). In the application menu, you can find transaction BD11 via Tools → ALE →

68


2005/Q4

BIT300


Master Data Distribution → Cross-Application → Material → Get; the target system can use this transaction to request material masters from the sending system. Message type MATMAS is used for sending the material master IDocs.

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


69


BIT300

Creating and Distributing a Model View Use You want (as part of an ALE scenario) to create a new model view in your central maintenance system's distribution model or enhance an existing model view.

Partner

2.

Click on the Create model view button and, in the window that then appears, enter a short description of your model view and a technical name for identifying the model view. Confirm your entries with Enter and save to create the new model view.

3.

Select your new model view and click on the Add message type button. In the window that now appears, enter both the sender's and recipient's logical system names and a message type of your choice. Confirm these entries with Enter; this will return you to the distribution model, where you can save the changes.

Use

To distribute the model view to a partner system, there must be outbound partner profiles with the partner for message type SYNCH. To check if these exist, select (in the distribution model's menu) Environment → Change partner profile. In the folder for partner type LS, search for an entry for your partner system and check the outbound parameters. If you do not find an entry for message

Only

Internal

4.

Partner

If you want to link a BAPI to the model view instead of a message type, click on the Add BAPI button. Add the sender's and recipient's logical system names (in other words, the method call's target system), enter the description (not the key) of the business object type you want to use and the appropriate method. Then confirm your entries with Enter.

SAP

SAP

In the IMG, select SAP NetWeaver → SAP Web Application Server → IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Maintain Distribution Model and Distribute Views. Switch from display to change mode by clicking on Display <-> Change .

Use

1.

Internal

Only

Procedure


70


2005/Q4

BIT300


type SYNCH, add one manually by assigning a recipient port containing an entry for the RFC destination leading to the partner system. The basic type has SYNCHRON as its key.

Only

Distribute the new (or changed) model view by selecting the relevant entry in the distribution model and going in the menu to Edit → Model view → Distribute. If there is more than one possible recipient for the data being distributed and you only want to send the model view to one particular recipient, deselect the entries for the other recipients in the Distribute Model Views window that now appears. You then receive a log that informs you whether the new (or changed) model view was successfully distributed or not.

Use

You also need to decide whether the IDocs should be sent immediately or later. 7.

2005/Q4

In order to be able to use your new (or changed) model view in an ALE scenario, you now have to create (or have the system generate) suitable inbound partner profiles in the target system. In the inbound partner profiles, you need an appropriate process code for the message type; this code must be linked to the function model or workflow for inbound processing. If you have the system generate the inbound partner profiles, you should check that it has assigned the right process code for your scenario.


71

Only

Internal

Caution: When selecting the version, bear in mind the recipient system's release status, since the basic type needs to be recognized in the target system as well.

Partner

If you have not already done so, create the outbound partner profiles for the message types you have just added to the model view. If there are outbound partner profiles for message type SYNCH (see step 4), you can have the system generate all the partner profiles for all the other message types (Environment → Generate partner profiles). If you create an outbound partner profile manually, you need to assign a recipient port with the appropriate RFC destination and a basic type, in addition to the message type.

SAP

SAP

6.

Use

Partner

5.

Internal

Hint: If the recipient system's logical system name is the same as the name of the RFC destination leading to it, you can have the system automatically create the outbound partner profiles for message type SYNCH and for all of the model view's other message types. To do this, select (in the distribution model's menu) Environment → Generate partner profiles.


BIT300

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

72


2005/Q4

BIT300


Exercise 3: Master Data Distribution Exercise Objectives After completing this exercise, you will be able to: • Send a material master • Display an IDoc in the status monitor

Only

Task: Create a material master in the CORE logical system and send it in IDoc format to the PRODUCTION and SALES logical systems. Check the inbound and outbound processing for each in the status monitor.

Hint: “##” is your group number First send your new material using the relevant transaction in the “Shared Master Data” instrument to the PRODUCTION logical system. How many master IDocs and how many communication IDocs were created? Master IDocs Communication IDocs 3.

Send your material again without specifying a target system. How many master IDocs and communication IDocs were created? Master IDocs Communication IDocs Continued on next page

2005/Q4


73

Only

Internal

2.

Partner

Use

Create the Basic Data 1 and 2 for material MATALE-## with a description of your choice. The material should belong to the Mechanical Engineering industry sector and to material type Finished product. The base unit of measure is a piece (PC).

SAP

SAP

1.

Use

Partner

In the future, you want all material masters for the entire corporate network to be stored in the central system only and for them to be sent from there to the downstream sales branch and production systems.

Internal

Business Example


BIT300

How is the number of IDocs to be sent determined?

5.

Display the outbound IDocs for message type MATMAS in the status monitor in the CORE logical system. What status do the IDocs have?

6.

Next, display the IDocs in the status monitors for each of the two recipient systems: PRODUCTION and SALES. What status do these IDocs have? Also check the material masters yourself.

Use

Partner

Hint: If you want to access one specific IDoc, enter the business object type StandardMaterial and your material number (MATALE-##) as the object keys on the status monitor's initial screen.

Internal

Only

4.

SAP

SAP Only

Internal

Use

Partner

74


2005/Q4

BIT300


Solution 3: Master Data Distribution Task: Create a material master in the CORE logical system and send it in IDoc format to the PRODUCTION and SALES logical systems. Check the inbound and outbound processing for each in the status monitor. Create the Basic Data 1 and 2 for material MATALE-## with a description of your choice. The material should belong to the Mechanical Engineering industry sector and to material type Finished product. The base unit of measure is a piece (PC).

SAP Use

b)

Enter material number MATALE-##, select the industry sector Mechanical Engineering and material type Finished product and confirm your entries with Enter.

c)

Select the views Basic Data 1 and Basic Data 2 and click Enter again.

d)

Assign a material description of your choice and add the base unit of measure PC (piece). You do not need to make any entries in the Basic Data 2 view. Save to create the material master.

Only

Internal

First send your new material using the relevant transaction in the “Shared Master Data” instrument to the PRODUCTION logical system. How many master IDocs and how many communication IDocs were created?

Partner

Select Logistics → Materials Management → Material Master → Material → Create (General) → Immediately.

SAP

2.

a)

Use

Partner

Hint: “##” is your group number

Internal

Only

1.


2005/Q4


75


Master IDocs

1

Communication IDocs

1

Select Tools → ALE → Master Data Distribution → Cross-Application → Material → Send.

b)

Enter the following data: Material

MATALE-##

Message type

MATMAS

Logical system

PRODUCTION

SAP Use

Send your material again without specifying a target system. How many master IDocs and communication IDocs were created? Master IDocs

1

Communication IDocs

2

a)


b)

Re-enter your material MATALE-## and the message type MATMAS but leave the Logical System field blank. Click on Execute .

How is the number of IDocs to be sent determined?


76


2005/Q4

Only

Answer: The number of communication IDocs depends on the number of receiver systems. If the recipient system is specified in the send transaction, only one communication IDoc is created. If you do not specify any recipient system, then the target systems are determined from the distribution model. This could mean that more than one communication IDoc is created. The number of master IDocs always conforms to the number of master records that are to be sent.

Partner

Internal

One master IDoc and one communication IDoc have been created.

SAP

4.

.

Use

Partner

c)

Internal

Only

a)

Then select Execute 3.

BIT300

BIT300


5.

Display the outbound IDocs for message type MATMAS in the status monitor in the CORE logical system. What status do the IDocs have?

Partner SAP Use

In the Message type field, enter the value MATMAS and choose Execute

c)

Under Outbound IDocs, you should see your IDocs with status 03.

d)

Select the entry for message type MATMAS and click on the Display IDocs button: you receive a list of all the IDocs for this message type.

e)

Select one of your IDocs and click Display IDocs again.

.

Next, display the IDocs in the status monitors for each of the two recipient systems: PRODUCTION and SALES. What status do these IDocs have? Also check the material masters yourself. Select Tools → ALE → ALE Administration → Monitoring → IDoc Display → Status Monitor.

b)

In the Message type field, enter the value MATMAS and choose Execute

c)

Under Inbound IDocs, you should see your IDocs with status 53.

d)

Select the entry for message type MATMAS and click on the Display IDocs button: you receive a list of all the IDocs for this message type.

e)

Select one of your IDocs and click Display IDocs again.

f)

Select Logistics → Materials Management → Material Master → Material → Display → Display Current.

g)

Enter your material number (MATALE-##) and click on Enter: both views are created.


.

77

Only

a)

Partner

Internal

b)

SAP

2005/Q4

Select Tools → ALE → ALE Administration → Monitoring → IDoc Display → Status Monitor.

Use

6.

a)

Internal

Only

Hint: If you want to access one specific IDoc, enter the business object type StandardMaterial and your material number (MATALE-##) as the object keys on the status monitor's initial screen.


BIT300

Lesson Summary You should now be able to: • Describe the configuration of an ALE scenario for distributing material master data • Distribute material masters

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

78


2005/Q4

BIT300

Lesson: Using Change Pointers

Lesson: Using Change Pointers Lesson Overview

Internal

Only

You can always change master data at any time over its lifespan. If you have centralized master data distribution, you need to ensure that any changes are promptly transferred to the downstream systems. In this lesson, you will learn about distributing changes to the master data using change pointers.


Business Example

Distributing Master Data Changes

In your enterprise, master data is created and changed in one central system. You need to ensure that any changes are promptly forwarded to the sales and distribution and production systems.

Use

Partner

Explain the use of change pointers in master data distribution and set them up in the system

SAP

•

SAP Only

Internal

Use

Partner

In this example, the system landscape is made up of the head office, a sales and distribution branch and production:

Figure 44: Example Scenario

2005/Q4


79


BIT300

All master data is created and, where necessary, changed in the head office's logical system. Newly created and changed master records should be distributed to sales and production logical systems at regular intervals, so that these system also work with up-to-date data.

Change Pointers

Only

Use

Partner

Internal

Many application programs create change documents for each change made to their objects (master data and documents). These change documents record changes to the application objects, normally specifying the person who made the change and the time of the change. These change documents can be used in ALE to set what are known as change pointers, which allow the sending system to select all changed data records and send only these to the target systems.

SAP

SAP

With master data distribution using the “Shared Master Data” instrument, you can specify in Customizing whether a message type works with the change pointer function or not. The change pointer creates a connection between change documents and the corresponding message type.

80


2005/Q4

Only

Internal

Use

Partner

Figure 45: Change Documents and Change Pointers

BIT300


When it creates or changes a master record, the application program queries whether the change pointer mechanism is activated or not. If the function is active, a change pointer is saved to the database together with the application document and the change document. Note: To view the change documents, use the report RSSCD100. You can also call the change documents from the application transaction in question. To view the change pointers, see the database table view BDCPV.

Use

Partner

Only

Internal

Internal

The application provides a function module which selects the change pointers, and creates a master IDoc for each modified application document relevant for distribution, which it then transfers to the ALE layer. You can display the assignment of message type and function module for evaluating the the change pointer with transaction BD60 (menu path: Tools → ALE → ALE Development → IDoc → Engineering Change Management → Define Function Module for Evaluation).

2005/Q4


81

Only

You can evaluate change pointers by using the program RBDMIDOC. This program is usually scheduled as a periodic background job. You can start the program for testing purposes with transaction BD21 (menu path: Tools → ALE → ALE Administration → Services → Change Pointers → Evaluate).

Partner

Use

SAP

SAP

Figure 46: Generating IDocs from Change Pointers


BIT300

If you want to distribute master data, first check if the change pointer function is activated in general (in other words, for the clients in your SAP system). Then activate change pointer updating for all the message types you want to use in your distribution scenarios. You can find the relevant table in the IMG via transaction SALE, by selecting menu path IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Replication of Modified Data → Activate Change Pointers – Generally or Activate Change Pointers for Message Types.

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

82


2005/Q4

BIT300


Lesson Summary You should now be able to: • Explain the use of change pointers in master data distribution and set them up in the system

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


83


BIT300

Lesson: Data Filtering and Reducing the Scope of Data Lesson Overview In ALE scenarios, not all recipient systems should always receive all of the sending system's data. This lesson presents various options for controlling the amount of data that is sent.

Only

Internal

Lesson Objectives After completing this lesson, you will be able to: Describe different methods for filtering data in IDoc processing Create a reduced message type and use it in the distribution process

Business Example

Segment Filtering

Use

Only

Internal

Partner

If you do not want a recipient to receive the complete data record in an IDoc, you can use segment filtering. Segment filtering is an application-independent ALE service which ensures that individual segments are deleted from the data part before the communications IDoc is saved to the database.

SAP

SAP

In your enterprise, master data is created and changed in the head office. However, the sales branch and production do not always receive the same data. Furthermore, the various departments in sales and production should be able to supplement certain sections of master data in their own systems.

Use

Partner

• •

Figure 47: Segment Filtering

You can use segment filtering to: • •

84

Reduce the dataset to the information that is required by the target system Ensure that detail data maintained in the target system is not overwritten


2005/Q4

BIT300

Lesson: Data Filtering and Reducing the Scope of Data

If you would like to use segment filtering in an ALE scenario, you should first check the structure of the basic type you are going to use to determine the keys for the segments you would like to delete. If, for example, you want the sales area data for the customer masters (basic type DEBMAS0x) to be created in the sales branch system, you can use segment filtering to delete segment group E1KNVVM (Master customer master sales data) from all communications IDocs for message type DEBMAS and recipient “Sales”. The customer masters are then distributed to sales without the sales area data.

Use

Only Partner

Internal

Note: If you select a segment group – that is, a segment with its subsegments – for segment filtering, all the subsegments are deleted from the communications IDoc.

Use

Only

Internal

Partner

You can set up segment filtering in the IMG with transaction SALE, via IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Scope of Data for Distribution → Filter IDoc Segments. In this table, specify the message type and the target system and the segments to be deleted. The next communications IDoc for the message type and recipient specified will be generated without these segments. The figure below schematically illustrates the process flow for IDoc outbound processing with segment filtering.

SAP

SAP

Figure 48: IMG: Segment Filtering

2005/Q4


85


BIT300

Use

Partner

Only

Internal

Figure 49: Outbound Processing with Segment Filtering

SAP Use

Only

Internal

Many applications are designed to be used with filter objects. These objects are application data (often organizational units and groupings) whose individual characteristics can determine whether a communications IDoc is created for a recipient in the first place, or which parts of the data record being distributed are contained in the communications IDoc.

Partner

The following sections introduce filter options that, unlike segment filtering as described above, are application-dependent. You therefore need to check in each individual case if the option is available for your ALE scenario.

SAP

Filter Objects

86


2005/Q4


Internal

Figure 50: Filtering Using Filter Objects

SAP Use

Partner Only

Internal

SAP

If you work with filter objects in ALE scenarios, you have to define conditions that need to be fulfilled for specific application data to be included in a communications IDoc. If the filter object corresponds to a required segment of the basic type in question, then a communications IDoc is only created if the condition is fulfilled. In the example illustrated below, material masters (message type MATMAS) are distributed at regular intervals from the head office to sales and distribution and production. However, sales and distribution is only supposed to receive material masters for finished products whereas production requires the master records for the finished parts and the raw materials.

Use

Partner

Only

BIT300

Figure 51: Example: Distribution Depending on Material Type

2005/Q4


87


BIT300

Use

Only Partner

Note: Customers can enhance the list of filter objects provided by SAP with their own filter objects. The tables required for this can be found in the application menu along the path Tools → ALE → ALE Development → IDoc → Data Filtering.

Internal

The “material type” is one of the filter objects designed for material masters. The material type groups together materials according to their physical properties, such as finished products, trading goods and raw materials. In basic type MATMAS0x, the segment field for material type (MTART) is part of a segment marked as required. If you now use the material type as a filter object for IDocs of message type MATMAS in the model view for distributing the material masters to sales, and assign the finished products material type key (FERT), you are guaranteeing that only material masters of this material type will be distributed to sales. The sending system does not generate any communications IDocs for material masters of other material types, if the recipient is “Sales”. If a filter object refers to an optional segment of the basic type in question, the segment and its subsegments are deleted from the IDoc if a field value does not fulfill a condition that is maintained in the distribution model.

The figure below schematically represents the required Customizing settings:

SAP

SAP Only

Internal

Use

Partner

Figure 52: Distribution Model: Creating Filter Groups

Conditions within a filter group are linked to each other by “AND” logic. You can create more than one filter group for each message type in the distribution model. These filter groups are linked to each other by “OR” logic.

88


2005/Q4

BIT300


Use

Partner

Only

Internal

SAP Internal

2005/Q4


89

Only

Logistics applications in SAP R/3 or SAP ECC systems can use classification, a cross-application function, independently of ALE scenarios. Classification allows you to group application data (generally master data or documents) by fairly freely-definable criteria. You can use these groupings for the targeted selection of specific data records, for example. In the ALE context, however, classification fulfills a different purpose: the membership of a data record to a specific class determines how it is distributed.

Partner

Classification

SAP

The filter objects are evaluated in the ALE layer. If filter values are specified for a message type in a distribution model, the system uses them to derive a condition. If the condition is met, the communications IDoc is transferred unchanged. If the condition is not met, the affected rows are deleted from the data part.

Use

Figure 53: Outbound IDoc Processing with Filter Objects

BIT300

Internal

Figure 54: Filtering Using Classification

SAP

SAP

If you would like to use classification as a filter method in an ALE scenario, you first need to carry out some basic settings in the class system itself. You need to mark one class type as the “distribution class type” and create at least one class for grouping your data in this class type. Then you can add the ALE-specific settings. You can activate the use of classification in an ALE scenario in the filter object area of a model view (see above).

Use

Partner

Only


Only

Internal

Use

Partner

Figure 55: Distribution Using Classes

90


2005/Q4

BIT300


To configure classification for ALE scenarios, call transaction SALE (in the IMG) and select IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Distribution Using Object Classes. You assign application data to classes yourself in the application in question. You classify material masters, for example, by creating a corresponding “view”; that is, a data screen. If a material master record does not belong to the distribution class specified for the target system, it is not distributed to that system.

Only

Use

Partner

Some applications have such flexible programs for inbound and outbound processing that you can choose whether or not each optional segment field is to be transferred. To do this, you create what is known as a reduced message type in the customer namespace as a copy of a message type supplied by SAP; then you select the fields whose content you want to be transferred to a particular target system.

Internal

Reduced Message Types

Internal

The incoming function module ensures that only the fields activated in the reduced message type are written to the target system's database. Segment fields that are absolutely necessary for useful processing in the target system are marked as “required” in the application.

2005/Q4


91

Only

You can use these reduced message types in all ALE scenarios where the distributed data is not processed in the sending system only. In this kind of scenario, for example, the sales branch could independently change the material masters after they had been initially transferred from head office. Sending these master records again would result in all the fields that had been changed in the sales system being overwritten: the sales personnel's work would have been wasted. If, on the other hand, a reduced message type without these fields is used in this scenario, then the locally maintained data is protected from overwriting because the fields – contained in the segment but not selected – are filled with a “no-data” character (/).

Partner

Use

SAP

SAP

Figure 56: Filtering with Reduced Message Types

BIT300

Internal

Figure 57: Prerequisites for Using Reduced Message Types

Before you can use reduced message types, the application must have the following functions:

To create a reduced message type, call transaction SALE and go to IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Scope of Data for Distribution → Message Reduction → Create Reduced Message Type.

92


2005/Q4

Only

Internal

•

Partner

Use

•

Outbound function module: an ALE function checks whether or not a reduced message type should be used. When the master IDoc is generated, a “no-data” character (/) is entered in all fields that are not to be transferred. Inbound function module: each segment is checked to see which fields have a “no-data” character. These fields are not written to the database. This enables you to maintain specific detail data in the local systems, and to ensure that data is not “accidentally” overwritten with an initial value when master data is replicated. Message type: the message type is marked as “reducible”.

SAP

SAP

•

Use

Partner

Only


BIT300


Use

Partner

Only

Internal

SAP

SAP

Select a segment by highlighting it and clicking on the Select button. Note: when you select a segment, only fields that are defined in a standard SAP system as required fields will be selected. To select additional fields for a selected segment, navigate to the detail view. In the detail view, first select the additional fields, then click on Select again. Optional segments or fields that have not yet been selected are marked with a red background. Optional segments or fields that have already been selected are colored white.

Partner

Caution: You have to click on the Select button before you can exit the detail screen by selecting Enter. If you select fields and then click on Enter immediately, your selection is not saved. If you would like to use the change pointer function (see the lesson on “Using Change Pointers”) for a reduced message type, you need to set the corresponding indicator for this reduced message type. To do this, call transaction SALE and go to IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Message Reduction → Create Reduced Message Type.

2005/Q4


93

Only

Internal

When you create a new reduced message type, it is based on the most current IDoc type. First the required segments are selected and then only the fields in these segments that are marked in a standard SAP system as required fields. These segments and fields are marked with a green background.

Use

Figure 58: Creating a Reduced Message Type


BIT300

Using Reduced Message Types • • • •

Create reduced message type Select required fields Save and assign a change request Activate change pointers (if applicable)

Only

Use

Partner

Internal

Reduced message types must be recognized in all participating sending and target systems.

SAP Use

Only

Internal

Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Scope of Data for Distribution → Message Reduction → Generate Transport Request for Message Type.

Partner

Because message types are cross-client Customizing objects, they are transported using a workbench request. You can generate a transport request for any reduced message type. To do this, go to

SAP

Figure 59: Transporting Reduced Message Types

94


2005/Q4

BIT300


Use

Partner

Only

Internal

Figure 60: Outbound Processing with Reduced Message Types

SAP Use

Partner Only

Internal

SAP

The same program is responsible for generating IDocs for a reduced message type as for generating IDocs for the template message type. When creating a master IDoc, the application program first determines detail information about the reduced message type being used. An ALE function module is used to enter “/” in the inactive fields of the master IDoc. The master IDoc is then transferred to the ALE layer.

2005/Q4


95


BIT300

Use

Partner

Only

Internal

Figure 61: Inbound Processing with Reduced Message Types

SAP

SAP

The same inbound function module is used for inbound processing as for an IDoc for the template message type. The system checks all optional segments to determine if they contain “/”. Only fields that do not contain “/” are written to the database.

Only

Internal

Use

Partner

96


2005/Q4

BIT300


Exercise 4: Using a Reduced Message Type Exercise Objectives

Business Example

Use

Partner

In your enterprise, material masters are created in the head office and sent to production (and elsewhere). The local business department makes changes to specific data views, which you want to protect from being overwritten when the master records are sent again.

Task: Create a reduced message type as a copy of MATMAS and connect it to your distribution model. Then test the configuration by sending a material master.

SAP Use

E1MARAM

ERNAM (Created by)

Internal

BISMT (Old material number) BRGEW (Gross weight)

Partner

In the CORE logical system, create a reduced message type ZMATMAS## with reference to message type MATMAS. In addition to the segments E1MARAM (Master material general data) and E1MAKTM (Master material short texts), the reduced message type should contain the following segments and segment fields:

SAP

1.

Internal

Only

After completing this exercise, you will be able to: • Create a reduced data type • Create and distribute a view in the distribution model • Create outbound and inbound partner profiles

NTGEW (Net weight)

Only

GEWEI (Weight unit) E1MTXHM

Select all

E1MTXLM

Select all

Caution: In the segment E1MARAM, ensure the fields LAEDA (Date of last change), AENAM (Last changed by), VOLUM (Volume) and VOLEH (Volume unit) are not selected. Continued on next page

2005/Q4


97


BIT300

2.

You want to use the change pointer function for your reduced message type in the future. Set the appropriate indicator.

3.

In the CORE logical system's distribution model, create a new model view, TRAINING##, with CORE as its sender and PRODUCTION as its recipient. Use your reduced message type, ZMATMAS##, from the first task.

4.

Now have the system generate the outbound partner profiles for message type ZMATMAS## in the CORE logical system. What basic type is proposed?

Only

If the PRODUCTION logical system is in a different physical system than the CORE logical system, then you need to define the reduced message type ZMATMAS## in this system as well before you can distribute the TRAINING## model view. Hint: You can also transport the reduced message type to the target system. Distribute your TRAINING## model view to the PRODUCTION partner system. In the PRODUCTION system, generate the inbound partner profiles for message type ZMATMAS##. Which process code is proposed? Change some values in your material MATALE-## in the CORE logical system. Make sure you change the volume and the volume unit.

8.

Send the changed material directly to the PRODUCTION logical system. Display the outbound and inbound IDocs in the status monitor for each system. Did the settings you made in task 1 produce the desired effect? Hint: Use your reduced message type ZMATMAS##.

9.

Display the material MATALE-## in the PRODUCTION system. Which changes have been transferred from the CORE system?

10. Now change the Old material number field in your MATALE-## material and then have the system evaluate the change pointers for message type ZMATMAS##. How many communications IDocs are created? 11. Check the result in the CORE and PRODUCTION systems' status monitors. In the segment E1MARAM, what is in the fields Old material number (BISMT), Date of last change (LAEDA), and Last changed by (AENAM), and why?

98


2005/Q4

Only

Internal

7.

Partner

Use

Process code: _____________

SAP

SAP

6.

Use

Partner

5.

Internal

Basic type: ______________________

BIT300


Solution 4: Using a Reduced Message Type Task: Create a reduced message type as a copy of MATMAS and connect it to your distribution model. Then test the configuration by sending a material master. In the CORE logical system, create a reduced message type ZMATMAS## with reference to message type MATMAS. In addition to the segments E1MARAM (Master material general data) and E1MAKTM (Master material short texts), the reduced message type should contain the following segments and segment fields:

Partner

E1MARAM

ERNAM (Created by) BISMT (Old material number) BRGEW (Gross weight)

Use

NTGEW (Net weight) Select all

E1MTXLM

Select all

SAP

SAP

GEWEI (Weight unit) E1MTXHM

Internal

Only

1.

Only

Internal

Use

Partner


2005/Q4


99


BIT300

Partner SAP Use

c)

Enter the template message type MATMAS and select Enter. Add a description of your choice and click on Enter again.

d)

Select the segment E1MARAM and then Choose

e)

Select the ERNAM, BISMT, BRGEW, NTGEW and GEWEI fields, click on the Select button and then Enter.

f)

Display the substructure of the E1MARAM segment, select the E1MTXHM segment (Master material long text header and click on the Select button.

g)

Display the substructure of the E1MTXHM segment, select the E1MTXLM subsegment (Master material long text line and click on the Select button again.

h)

Save to create the reduced message type. A query appears for a workbench request for transporting the message type to other systems later. Choose Create Request , enter a short description of your choice and create the request by saving it.

.

You want to use the change pointer function for your reduced message type in the future. Set the appropriate indicator. a)

Exit the overview of the reduced message type's segments in order to return to the maintenance transaction's initial screen.

b)

Click on the Activate change pointers button.


100


2005/Q4

Only

Internal

In the Reduced message type field, enter the value ZMATMAS## and choose Create .

Partner

b)

SAP

In the CORE logical system, call transaction SALE and go to IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Message Reduction → Create Reduced Message Type.

Use

2.

a)

Internal

Only

Caution: In the segment E1MARAM, ensure the fields LAEDA (Date of last change), AENAM (Last changed by), VOLUM (Volume) and VOLEH (Volume unit) are not selected.

BIT300


a)

Select IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Maintain Distribution Model and Distribute Views and switch to change mode ( ).

b)

Click on the Create model view button, enter a short text of your choice and the technical name TRAINING## and confirm your entries with Enter.

c)

Select the model view and click on the Add message type button.

d)

Enter CORE as the sender, PRODUCTION as the receiver and ZMATMAS## as the message type, and then select Enter. Create the new model view by saving it.

Now have the system generate the outbound partner profiles for message type ZMATMAS## in the CORE logical system. What basic type is proposed?

Use

Partner

4.

In the CORE logical system's distribution model, create a new model view, TRAINING##, with CORE as its sender and PRODUCTION as its recipient. Use your reduced message type, ZMATMAS##, from the first task.

Select your new model view and in the menu, go to Environment → Generate partner profile.

b)

Choose Execute : you receive a log containing a message to the effect that outbound partner profiles for message type ZMATMAS## and the partner PRODUCTION have been created. Exit the log with Back .

c)

Display one of the two new partner profiles via Environment → Change partner profile: select the partner PRODUCTION (partner type LS).

d)

Select the outbound parameters for message type ZMATMAS## and click on DetailScreenOutb.Parameter : the basic type MATMAS05 is assigned here.

Partner

Use

a)

SAP

SAP

Basic type: ______________________

Only

Internal

Internal

Only

3.


2005/Q4


101


5.

BIT300

If the PRODUCTION logical system is in a different physical system than the CORE logical system, then you need to define the reduced message type ZMATMAS## in this system as well before you can distribute the TRAINING## model view.

In the PRODUCTION logical system, go to IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Message Reduction → Create Reduced Message Type.

b)

Create the reduced message type ZMATMAS## as described in step 1.

Distribute your TRAINING## model view to the PRODUCTION partner system. In the PRODUCTION system, generate the inbound partner profiles for message type ZMATMAS##. Which process code is proposed?

Use Internal

b)

Confirm the system selection with Enter: you will receive a message informing you that your model view was successfully distributed.

c)

Switch to the PRODUCTION logical system and call the distribution model from there as well, to check if the copy of your model view is available.

d)

Select the model view, on the menu bar choose Environment → Generate partner profiles and then Execute .

e)

Go back to the distribution model and select Environment → Change partner profile to check the inbound partner profile for message type ZMATMAS##.

f)

Mark the partner CORE, in the inbound parameters, select the entry ZMATMAS## and click on DetailScreenInboundParameter : the process code MATM is assigned here.


102


2005/Q4

Only

Select your model view and in the menu, go to Edit → Model view → Distribute.

Partner

a)

SAP

SAP

Process code: _____________

Use

Partner

6.

a)

Internal

Only

Hint: You can also transport the reduced message type to the target system.

BIT300


a)

Select Logistics → Materials Management → Material Master → Material → Change → Immediately.

b)

Enter T-MATALE-## as your material number and click on Enter.

c)

Select the Basic Data 1 view and click on Enter again.

d)

Enter a value in each of the fields Old material number, Gross weight and Weight unit, for example. Also add a volume with a suitable unit of measure. Save your changes.

Send the changed material directly to the PRODUCTION logical system. Display the outbound and inbound IDocs in the status monitor for each system. Did the settings you made in task 1 produce the desired effect?

c)

Select Tools → ALE → ALE Administration → Monitoring → IDoc Display → Status Monitor.

Use

d)

Enter the message type ZMATMAS## and select Execute

e)

Select the entry under ZMATMAS## and click on the Display IDocs button.

f)

On the next screen, select your IDoc and then click again on the Display IDocs button.

g)

Display the data records and select the segment E1MARAM, to check that the system has placed “no-data” characters in the unselected optional fields. You should also be able to see this character in the fields that you did not select in your reduced message type: VOLUM (Volume) and VOLEH (Volume unit).

SAP

Enter the material master MATALE-##, message type ZMATMAS## and the logical system PRODUCTION and then select Execute .

.


2005/Q4


103

Only

b)

Partner


SAP

a)

Internal

Hint: Use your reduced message type ZMATMAS##.

Use

Partner

8.

Change some values in your material MATALE-## in the CORE logical system. Make sure you change the volume and the volume unit.

Internal

Only

7.


Display the material MATALE-## in the PRODUCTION system. Which changes have been transferred from the CORE system? a)

Select Logistics → Materials Management → Material Master → Material → Display → Display Current.

b)

Enter T-MATALE-## as your material number and click on Enter.

c)

Select the Basic Data 1 view and click again on Enter: the entries in the Volume and Volume unit fields were not transferred.

d)

Check the inbound IDoc in the status monitor as described in steps 8. c) to g).

SAP

Call the material master as described in step 7 to change it.

b)

Enter a value in the Old material number field and save the change.

c)

Select Tools → ALE → ALE Administration → Services → Change Pointers → Evaluate.

d)

Enter your message type ZMATMAS## and select Execute

e)

IDocs are generated for all materials that were changed since the change pointer function was activated for your message type.

.

Use Internal

First call one of the outbound IDocs for message type ZMATMAS## in the status monitor in the CORE system. Proceed as in step 8.

b)

The change you have made is visible in the field Old material number, because you selected this field in your reduced message type. The fields Date of last change and Last changed by, contain “/”. This is because you did not select these fields when creating the reduced message type.

c)

To finish, display an inbound IDoc for message type ZMATMAS## in the PRODUCTION system: the Old material number field contains the changes you made, the Date of last change and Last changed by fields contain “/”.


2005/Q4

Only

104

a)

Partner

11. Check the result in the CORE and PRODUCTION systems' status monitors. In the segment E1MARAM, what is in the fields Old material number (BISMT), Date of last change (LAEDA), and Last changed by (AENAM), and why?

SAP

a)

Use

Partner

10. Now change the Old material number field in your MATALE-## material and then have the system evaluate the change pointers for message type ZMATMAS##. How many communications IDocs are created?

Internal

Only

9.

BIT300

BIT300


Lesson Summary You should now be able to: • Describe different methods for filtering data in IDoc processing • Create a reduced message type and use it in the distribution process

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


105

Unit Summary

BIT300

Unit Summary

Only

Use

Partner

Internal

You should now be able to: • Describe the configuration of an ALE scenario for distributing material master data • Distribute material masters • Explain the use of change pointers in master data distribution and set them up in the system • Describe different methods for filtering data in IDoc processing • Create a reduced message type and use it in the distribution process

SAP

SAP Only

Internal

Use

Partner

106


2005/Q4

Unit 3 Only

Unit Overview

Partner

Use

Transaction data (documents, postings) can also be distributed beyond system boundaries using ALE. Message control is one of the methods you can use to implement cross-system processes. However, you can also use it for electronic communication with business partners (suppliers, customers).

Unit Objectives

SAP Use

Lesson: Message Control and IDoc Generation................................ 108 Exercise 5: Partner Profiles and Condition Record ........................ 117 Lesson: Example: Purchase Order Processing ................................ 123 Exercise 6: Sending a Purchase Order to a Vendor ....................... 131 Exercise 7: Optional: ALE Scenario “Stock Transfer Between Distributed Systems” ........................................................................ 135

2005/Q4


107

Only

Internal

Unit Contents

Partner

Differentiate ALE and EDI Describe the basic functions of message control Explain how message control is used to generate IDocs Create a purchase order and check the events of your message determination Describe the cross-system purchase order process Explain the most important Customizing settings for this process

SAP

After completing this unit, you will be able to: • • • • • •

Internal

Distributing Transaction Data: Message Control

Unit 3: Distributing Transaction Data: Message Control

BIT300

Lesson: Message Control and IDoc Generation Lesson Overview This lesson tells you about message control as an instrument for distributing transaction data in the IDoc format.

Lesson Objectives

Only

Differentiate ALE and EDI Describe the basic functions of message control Explain how message control is used to generate IDocs

Business Example

SAP

ALE and EDI: a Comparison

Use

Only

Internal

Partner

For ALE and EDI scenarios you always use the same instrument: the data, such as purchase orders, order confirmations or invoices, are sent to the respective recipient in the IDoc format, or are recevied by your system as IDocs and are subsequently transferred to the target applications.

SAP

Up to now, your company has sent purchase orders to suppliers by post in paper form. For the future, you want to convert this process to electronic communication. In addition, you want the purchase orders of the sales branch to be automatically converted into orders after they are received by head office.

Use

Partner

• • •

Internal


108


2005/Q4

Lesson: Message Control and IDoc Generation

Internal

Figure 62: EDI: Purchase Order at a Vendor

SAP Use

Only

Internal

Partner

In many cases, the external vendors are not part of the company network. Therefore, the electronic communication with them is often by means of intermediary subsystems, known as EDI converters. SAP provides an open interface to such systems (CA-EDI). The EDI subsystems assume the responsibility for all EDI-specific tasks, such as data conversion, partner profile management and process monitoring.

SAP

Up to now, the purchase orders at a vendor in our example company have been processed on paper: the purchasing employees create purchase orders in the system at head office, possibly on the basis of purchase requisitions from other departments, and send them by post to the vendor. However, in the future the vendor should receive the purchase order data electronically in an EDI standard format.

Use

Partner

Only

BIT300

Figure 63: Communication by Means of an EDI Subsystem

2005/Q4


109


BIT300

The SAP application sends an IDoc to the subsystem. In the case of a purchase order, the message type is ORDERS. The subsystem reads the IDoc and converts it into an EDI document. This document is sent to the vendor, whose EDI converter converts the incoming data into a format that can be processed in the vendor's ERP system. Often an order is automatically created from the data of the purchase order received.

SAP

SAP

Use

Partner

Only

Internal

Figure 64: Port Types

Use Internal

110


2005/Q4

Only

Partner profiles for EDI scenarios must always refer to partners of the partner types LI (vendor) or KU (customer), while the partners in ALE scenarios are always logical systems (partner type LS).

Partner

Many subsystems are capable of communicating with SAP systems by means of tRFC. However, if your subsystem cannot decrypt RFC protocols, you usually use a port of the “file” type. The directory of the operating system, in which incoming and outgoing data is to be saved, is entered in the detailed settings for this port.

BIT300


SAP

SAP

Thus, for the EDI scenario represented in the first illustration of the lesson, partner profiles of partner type LI would be required. When creating such partner profiles, you always refer to the vendor master data. Therefore, if the vendor was created using the key T-BIL00, the EDI partner is also called T-BIL00.

Use

Partner

Only

Internal

Figure 65: Partner Profile: Partner Type LI

Only

Internal

Use

Partner

Figure 66: Partner Functions

2005/Q4


111


BIT300

The “vendor” business partner can have various functions with regard to the company. During a procurement procedure, a vendor is first the recipient of the purchase order, then the goods supplier, later the invoicing party and finally the payment recipient. A partner does not always carry out all the functions himself. Thus a party other than the purchase order recipient can deliver the goods. For this reason, logistical appliations in SAP R/3 and SAP ECC systems work with partner functions that are assigned in the partner master data and can be changed in the application documents, if necessary.

Use

Partner

Only

Internal

SAP

SAP

Therefore, when creating partner profiles for EDI partners, in contrast to ALE, you always have to enter the respective function in which a partner is sending or receiving a message.

Internal

Message Control: Introduction The application mySAP ERP Procurement already enables you to send a purchase order by means of a printed form or in IDoc format. For this, the application uses a cross-application function packet, the message control. In SAP systems, a message is information that is output in various formats. The purchase order printed on paper or sent as an IDoc is only one of many examples of the use of message control in

112


2005/Q4

Only

For EDI scenarios, the distribution model you were introduced to as an important ALE element does not play any role. The application programs determine the recipient of the message from the respective application document. The communication IDoc is then created on the basis of the parameters in the partner profiles and processed further - for example, it is stored as a sequential file on the operating system level.

Partner

Use

Figure 67: Partner Profile for EDI

BIT300


logistics applications. You can also send the information contained in your SAP R/3 or SAP ECC documents as a fax or an e-mail to employees or partners. The format in which the message is output is determined by the transmission medium, which you define in advance or which you can - depending on the default settings - specify in individual cases before the output.

Use

Partner

Only

Internal

SAP

SAP

The individual message, such as the IDoc with the purchase order data, is always created on the basis of a message type which is defined in the Customizing of the respective application. Message types are keys to which the most important control parameters for determining and subsequently outputting messages are linked. For example, the message type for outputting purchase document data is called NEU (new printing of purchase order).

2005/Q4


113

Only

Internal

Every time you save a new or altered purchasing document (for example, a request for quotation, a purchase order or an outline agreement), the system checks whether a message has to be created for this document, and in which format - that is, by means of which transmission medium - this message is to be output.

Partner

Use

Figure 68: Transmission Medium


BIT300

Use

Partner

Only

Internal

Figure 69: Message Types

SAP Use Internal

The condition type works with what are known as condition elements, which are dependent on one another. The illustration below shows the inner hierarchy of the condition elements using the example of message control for Purchasing:

114


2005/Q4

Only

The message control works with the condition type, a method of enabling the system to find application objects on the basis of previously defined conditions. The condition type is used in many applications in SAP R/3 and SAP ECC. Examples are the price determination in Purchasing and Sales and the batch determination in the overall logistics. The system also finds messages on the basis of condition records, which are combinations of conditions under which a certain message is to be output in a certain format.

Partner

Message Determination

SAP

Message types are application-specific. Every application that uses the message control is indicated by a two-character key. For example, Purchasing, which is responsible for the purchase order processing, has the key EF. To get an overview of all the applications that use the message control, you use transaction NACE. With this transaction (message types button) you can also call up the list of all the message types defined for an application.

BIT300


115

SAP Use Internal

Only


Partner

2005/Q4

SAP

The respective application program (for example, “create purchase order”) specifies the application (for example, EF). The suitable output determination procedure (for example, RMBEF1), which groups together message types on the basis of various perspectives, is found by means of Customizing tables, depending on the application. Thus, for example, the document type can decide on the procedure to be used. Every message type of a procedure (for example, NEU) is assigned an access sequence (for example, 0001). Access sequences group together condition tables. These condition tables contain, in various arrangements, all the document fields that are to function as conditions for determining the messages in the application document. In the example shown, the access sequence 0001 contains three condition tables which are checked in the sequence specified in the access sequence. The first condition table in this sequence (27) contains the fields purchasing organization and vendor. If you now want to define conditions for the determination of the message type NEU, the system now asks you, on the basis of the assigned access sequence, for the “key combination”, that is, for the desired combination of fields according to the condition table. Depending on the selection, you then have to make certain entries, such as for the purchasing organization and the vendor. In this way you specify, for example, that the message NEU is always output in IDoc format when the purchase order is from the purchasing organization 1000 for the business partner T-BIL00 in his function as vendor (LF).

Use

Partner

Only

Internal

Figure 70: Message Control: Condition Elements


BIT300

Along with the transmission medium (see above), you also always have to enter a processing time in the condition record. You have a choice of three processing times: • • •

Immediate transmission when the document is created (4) Subsequent transmission by means of a job (1 and 2) Subsequent transmission triggered by the user by means of a dedicated transaction (3)

Only

Use

Partner

Internal

If you select the transmission medium “EDI” in the condition record, you must create appropriate partner profiles for the partner entered there and his function. If you want to use the transmission medium “ALE”, in addition to the partner profiles there must also be a corresponding model view in the distribution model.

SAP

SAP

Internal

Use

Partner

Figure 71: Message Determination in the Purchase Order

116


2005/Q4

Only

When creating a purchase order, the application program checks in the message determination whether a message is to be created. If the transmission medium is “EDI” or “ALE”, the system checks whether suitable partner profiles exist and which IDoc type is specified for the data output. If the message determination is successful, a message is created. All messages are stored in the database table NAST. Based on the IDoc basic type specified in the partner profiles, the program RSNAST00 creates a communication IDoc from the data of the purchase order. (If, on the other hand, “print output” were specified, then the corresponding form would be filled.)

BIT300


Exercise 5: Partner Profiles and Condition Record Exercise Objectives

Only

Business Example

Task: Create partner profiles for the vendor and then a suitable determination record for the message type of the purchase order data output.

Use

Process code: _______________

2.

Get the system to check the partner profiles you have just created.

3.

In the application menu of Purchasing (purchase orders), create a determination record for the message type NEU. Messages of this message type should always be output if the purchasing organization 1000 orders goods from the vendor T-K515D##. The system should output the message in IDoc format by means of EDI. The IDoc should be generated immediately after a purchase order is created.


2005/Q4


117

Only

Internal

Hint: Please also remember the partner type and the partner function.

Partner

Create partner profiles with the vendor T-K515D## for the message type ORDERS. Use the IDoc basic type ORDERS05 and the file port SUBSYSTEM. The IDocs should be transferred to the subsystem together, but this should not be started by the SAP system. The appropriate message type has the key NEU. You work on the application level of Purchasing. Which process code is specified? Assign yourself as the agent in the case of an error.

SAP

SAP

1.

Use

Partner

In the future, you want to send purchase orders to one of your vendors by means of EDI.

Internal

After completing this exercise, you will be able to: • Set up partner profiles for the EDI communication with a vendor • Create a message determination record


4.

BIT300

Optional: How do you proceed if you also have an agreement with your vendor T-K515D## that in future he should send you order confirmations by EDI for your purchase orders? Hint: If necessary, use the input help for the Message type field to look for a suitable message type using the short description “Order confirmation”. You can also use the short description to determine the appropriate process code.

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

118


2005/Q4

BIT300


Solution 5: Partner Profiles and Condition Record Task: Create partner profiles for the vendor and then a suitable determination record for the message type of the purchase order data output.

Process code: _______________

Use Internal

b)

Choose Create , enter the partner number T-K515D## and the partner type LI and save your entries.

c)

In the output parameter area, choose Create output parameter

d)

Add the partner function LF and on the Outbound Options tab page, add the message type ORDERS, the receiver port SUBSYSTEM and the IDoc basic type ORDERS05. If they are not already selected, choose Collect IDocs and Do not start subsystem.

e)

Choose the Message Control tab page and here choose Add row

f)

Enter the application EF and the message type NEU. In the input help for the field Process Code, ME10 (ORDERS: Purchase order) appears. Press Enter to accept this key.

g)

Select the Post Processing: Permitted Agent tab page to assign your user BIT300-## (agent type US) and a notification language of your choice. Save these changes.

.

.


2005/Q4


119

Only

Choose Tools → ALE → ALE Administration → Runtime Settings → Partner Profiles.

Partner

a)

SAP

SAP

Hint: Please also remember the partner type and the partner function.

Use

Partner

Create partner profiles with the vendor T-K515D## for the message type ORDERS. Use the IDoc basic type ORDERS05 and the file port SUBSYSTEM. The IDocs should be transferred to the subsystem together, but this should not be started by the SAP system. The appropriate message type has the key NEU. You work on the application level of Purchasing. Which process code is specified? Assign yourself as the agent in the case of an error.

Internal

Only

1.


2.

Partner

a)

If necessary, open the folder for the partner type LI and select your vendor T-K515D##.

b)

Choose Check , then choose Execute in the window displayed: you obtain a detailed log of the check on your settings.

In the application menu of Purchasing (purchase orders), create a determination record for the message type NEU. Messages of this message type should always be output if the purchasing organization 1000 orders goods from the vendor T-K515D##. The system should output the message in IDoc format by means of EDI. The IDoc should be generated immediately after a purchase order is created. Choose Logistics → Materials Management → Purchasing → Master Data → Messages → Purchase Order → Create.

b)

Enter the output type NEU and choose Enter.

c)

Choose the key combination Purchasing Output Determination: Purch. Org./Vendor for EDI and confirm your choice with Enter.

d)

Enter the purchasing organization 1000, the vendor T-K515D##, the partner function LF, the medium 6 and the time 4. Create the determination record by saving.

Use

Only

Internal

Partner

Hint: If you leave the Language field empty, the system uses the language of the vendor in his master record.

SAP

a)

Use

SAP

Get the system to check the partner profiles you have just created.

Internal

Only

3.

BIT300


120


2005/Q4

BIT300


4.

Optional: How do you proceed if you also have an agreement with your vendor T-K515D## that in future he should send you order confirmations by EDI for your purchase orders?

Open the folder for the partner type LI and select your vendor T-K515D##.

c)

In the inbound parameter area, select Create inbound parameters first enter the partner role LF again.

d)

Call up the input help for the field Message type and open the details in the Restrictions tab page by clicking on the small triangle in the bar below the tab page.

e)

In the field Short text, enter *Order confirmation* and press Enter to confirm: The system prompts you with, among other things, the message type ORDRSP (Purchase order/Order confirmation). Select the default and accept it with Enter.

SAP

Partner

b)

f)

Now call up the input help for the field Process code and follow the short description of the process: The suitable process code has the key ORDR (ORDRSP Sales order confirmation). Accept it with a double-click and save your changes.

and

Only

Internal

Use

SAP

Choose Tools → ALE → ALE Administration → Runtime Settings → Partner Profiles.

Partner

a)

Use

Internal

Only

Hint: If necessary, use the input help for the Message type field to look for a suitable message type using the short description “Order confirmation”. You can also use the short description to determine the appropriate process code.

2005/Q4


121


BIT300

Lesson Summary You should now be able to: • Differentiate ALE and EDI • Describe the basic functions of message control • Explain how message control is used to generate IDocs

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

122


2005/Q4

BIT300

Lesson: Example: Purchase Order Processing

Lesson: Example: Purchase Order Processing Lesson Overview This lesson tells you about IDoc generation by means of the message control, using the example of a purchase order. In addition, you will also be introduced to one of the ALE scenarios provided (“stock transfer between distributed systems”).

Only

After completing this lesson, you will be able to: Create a purchase order and check the events of your message determination Describe the cross-system purchase order process Explain the most important Customizing settings for this process

Business Example

SAP Use

Only

Internal

Logistical applications in SAP R3 and SAP ECC systems can use the message control to generate IDocs for sending transaction data. The system transfers the data of an application document into the fields of the IDoc on the basis of the respective IDoc basic type. Then the IDoc can be sent to either a business partner or another logical system within the company.

Partner

Message Control: Transmission Media “ALE” and “EDI”

SAP

The sales branch regularly orders stock replenishments at head office for processing its customer orders; head office is where the main warehouse of the company is located. In the future, these purchase orders should be sent to head office using ALE and be automatically converted into orders there. The sales branch receives an electronic order confirmation by return. The purchase orders at vendors are also created electronically by head office, but by means of an EDI connection.

Use

Partner

• • •

Internal

Lesson Objectives

2005/Q4


123


BIT300

Use

Partner

Only

Internal

Figure 72: Example: Sending a Message in EDI Format

SAP

SAP

Here you see the transmission of an IDoc to an external vendor by means of an EDI converter. Therefore, the transmission medium “EDI” (6) was entered in the message determination record. In addition, there must also be partner profiles for the partner type “vendor” (LI) to which a receiver port is assigned, which represents a connection to the EDI converter, or which contains a directory for storing IDocs as sequential files.

Only

Internal

Use

Partner

124


2005/Q4

BIT300


Use

Partner

Only

Internal

Figure 73: Partner Profiles with an External Vendor

SAP

SAP

If, on the other hand, the transmission medium of the determination records is “ALE” (A), then suitable partner profiles with a logical system (partner type LS) must be created. The field Partner role remains empty. The settings for the generation of an IDoc (IDoc basic type and process code) are identical. The port is usually a tRFC port.

Only

Internal

Use

Partner

2005/Q4


125


BIT300

Use

Partner

Only

Internal

Figure 74: Partner Profile with a Logical System

SAP Use Internal

126


2005/Q4

Only

For ALE scenarios in which transaction data is to be sent with the aid of message control, you must create or expand corresponding views in the distribution model of the maintenance system and then distribute them to the respective receiving systems.

Partner

Note: The attribute With ALE services in the process code is used to control whether you can adapt the IDoc using the ALE services “segment filtering” and “field conversion”. If this attribute is not set, the master IDoc is transferred unchanged into the data section of the communication IDoc and stored on the database.

SAP

If you want to use the message control to distribute transaction data, there must be a process code for the outbound processing. This process code is used to determine the function module that subsequently uses the entry created by the message determination in the table NAST (“NAST record”) to determine the relevant application data and create the master IDoc.


In the example shown, Sales and Distribution - that is, the logical system SALES - sends purchase orders (message type ORDERS) to head office (logical system CORE). After receiving and checking the purchase orders, head office sends order confirmations (message type ORDRSP) to Sales and Distribution.

SAP Use

Only

Internal

Partner

When creating a purchase order, the system performs message determination on the basis of the application-specific Customizing settings for message control. If this determination is successful, you can immediately call up the result from the application document (menu entry Goto → Messages or button Messages in the initial screen).

SAP

Message Determination in Ordering and IDoc Generation

Use

Partner

Figure 75: Model View for the Distribution of Purchase Orders

Internal

Only

BIT300

2005/Q4


127


BIT300

Use

Partner

Only

Internal

Figure 76: IDoc Generation using Message Control

SAP Use Internal

128


2005/Q4

Only

In SAP R/3 or SAP ECC systems, you will find support for the configuration of an ALE scenario “Stock transfer between two systems”. You can use this scenario if sales branches or production sites are separated from one another or from the central warehouse or the central Sales and Distribution not only physically, but also in terms of the systems involved.

Partner

ALE Scenario: Stock Transfer Between Two Systems

SAP

If the transmission medium “ALE” or “EDI” is assigned in the determination record, a master IDoc is created from the NAST record on the basis of the outbound parameters of the corresponding partner profiles. The transaction code controls which application function module is used to generate this IDoc. The application document key is transferred from the NAST record to this application function module. The module reads the document data and transfers it into the segment fields of the master IDoc. If the processing time 4 was entered in the determination record, the system executes the program RSNAST00 immediately after you save, in order to generate an IDoc from the NAST record. If the processing time 1 is specified, only a NAST record is created for now. The program RSNAST00 must be planned as a background job or be started manually. In the program RSNAST00, the master IDoc is transferred as the data section of the communications IDoc, and a control record and a status record are added to it. The communication IDoc is then saved on the database and, depending on the settings in the partner profiles, sent immediately or later.

BIT300


129

SAP Use Internal

Only


Partner

2005/Q4

SAP

With this scenario, you can represent the following basic process: The branch orders goods from head office. The incoming purchase order in IDoc format (message type ORDERS) is automatically converted into a sales order by the receiving system. The logical system of head office also automatically sends an order confirmation (message type ORDRSP) to the branch. The inbound processing of the order confirmation is updated in the purchase order: The purchasing area agent usually sees the document number of the sales order of head office on the document item level of his purchase order. At head office, if the goods are available, a delivery is created for the sales order. The message control can be used to automatically send a shipping notification in IDoc format for this delivery (message type DESADV) to the branch. Depending on the settings in the system of the branch, an inbound delivery - an additional SAP document - is created there during the IDoc inbound processing, or else a corresponding note is entered in the purchase order. After the goods are shipped to the branch, the head office can also transfer the invoice electronically (message type INVOIC). If the inbound processing of the IDoc at the branch is successful, an incoming invoice is automatically posted.

Use

Partner

Only

Internal

Figure 77: Scenario: Stock Transfer Between Two Systems


BIT300

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

130


2005/Q4

BIT300


Exercise 6: Sending a Purchase Order to a Vendor Exercise Objectives

Only

Create a purchase order to an external vendor in the system at company headquarters and check whether an IDoc was generated with the data of this purchase order. In the CORE system, create a purchase order at the vendor T-K515D## for 100 pcs. of the material T-M15A## for the plant 1000. You work for the purchasing organization 1000 and the purchasing group 001 in the company code 1000. Which message type is found, and how is the message to be processed? Message type: _______

SAP

SAP

1.

Use

Task:

The central purchasing department of the company orders goods from a vendor by means of an EDI connection.

Internal

Business Example

Partner

After completing this exercise, you will be able to: • Send a purchase order in IDoc format to an external vendor

2.

Check the outbound processing of the IDoc in the purchase order. What status does the IDoc have? Also note the IDoc number. Number: ________________

3.

Display your IDoc in the status monitor as well and send it. What status does the IDoc have now? What is the text for this status? Hint: You will find the text under the heading Error text.

2005/Q4


131

Only

Internal

Status: ____

Partner

Use

Transmission medium: _______


BIT300

Solution 6: Sending a Purchase Order to a Vendor Task: Create a purchase order to an external vendor in the system at company headquarters and check whether an IDoc was generated with the data of this purchase order. In the CORE system, create a purchase order at the vendor T-K515D## for 100 pcs. of the material T-M15A## for the plant 1000. You work for the purchasing organization 1000 and the purchasing group 001 in the company code 1000. Which message type is found, and how is the message to be processed?

Use Internal

Choose Logistics → Materials Management → Purchasing → Purchase Order → Create → Vendor/Supplying Plant Known.

b)

Enter the vendor T-K515D## and confirm your entry with Enter.

c)

On the Org.data tab page, enter the purchasing organization 1000, the purchasing group 001 and the company code 1000.

d)

Choose Item overview , enter the material T-M15A##, the order quantity 100 and the plant 1000 and confirm these entries with Enter.

e)

Choose the Output button: The output type NEU was found. The message is to be output by means of EDI (transmission medium 6).

f)

Create the purchase order by saving.

Check the outbound processing of the IDoc in the purchase order. What status does the IDoc have? Also note the IDoc number. Status: ____

Partner

2.

a)

SAP

SAP

Transmission medium: _______

Use

Partner

Message type: _______

Internal

Only

1.

Only


132


2005/Q4

BIT300


Choose Logistics → Materials Management → Purchasing → Purchase Order → Display.

b)

Choose the Messages button: The message should have the status Successfully processed. Choose Back .

c)

In the menu, choose System → Services for Object and then Display links : The number of the outbound IDoc is displayed.

d)

Double-click the number of the IDoc to call it up for display. It has the status 30 (IDoc is ready to be sent).

Display your IDoc in the status monitor as well and send it. What status does the IDoc have now? What is the text for this status?

Use

b)

Enter the number from step 2 in the field IDoc number and choose Execute .

c)

Select the row under the output type ORDERS and choose the Process button.

d)

Confirm the message on your selection with Enter: The IDoc now has the status 03 (Data passed to port OK). The “error text” is: IDoc written to file. You can also find out the file path using the Error long text button.

Only

Internal

Choose Tools → ALE → ALE Administration → Monitoring → IDoc Display → Status Monitor.

Partner

a)

SAP

SAP

Hint: You will find the text under the heading Error text.

Use

Partner

3.

a)

Internal

Only

Number: ________________

2005/Q4


133


BIT300

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

134


2005/Q4

BIT300


Exercise 7: Optional: ALE Scenario “Stock Transfer Between Distributed Systems” Exercise Objectives

Business Example

Task:

SAP Internal

In the SALES system, create a purchase order of the document type NB (normal order) at the vendor CORE for 100 pcs. of the material DPC1002. You are ordering with the authorization of the purchasing organization 1000 for the plant 1000. You belong to the purchasing group 001. The responsible company code is 1000. Check the results of the message determination: Which message type was found? Which transmission medium is used? Make a note of the document number of the purchase order. Message type: ________

Partner

Use

1.

SAP

Create a purchase order with head office in the Sales and Distribution system, check the results of the message determination, and then display the automatically created order in the head office system. Also check the updating of the purchase order after the order confirmation is received.

Use

Partner

Sales and Distribution regularly orders stock replenishments at head office for processing its customer orders; head office is where the main warehouse of the company is located. These purchase orders are sent to head office using ALE and are automatically converted into sales orders there.

Internal

Only

After completing this exercise, you will be able to: • Create a sales order from a purchase order using ALE

Transmission medium: ______ 2.

Display the outbound IDoc in the status monitor of the SALES sender system. Search for the IDoc using the business object type PurchaseOrder and your document number from step 1. Check the content of individual segments and compare them with your purchase order.


2005/Q4


135

Only

Number of the purchase order: _________________

BIT300

3.

In the CORE system, check whether a sales order was created for the purchase order of the SALES system. Use your purchase order number from step 1 as the search criterion. Make a note of the document number of the order: ______________

4.

Was an order confirmation also created in the CORE system and sent to the SALES system? Check the results of the message determination in the order.

5.

In the CORE system, you now display the outbound IDoc for the order confirmation using the object services in the order. Then check the purchase order in the SALES system: What has changed?

Use

Partner

Hint: In the purchase order, check the Confirmations tab page on the document item level.

Internal

Only


SAP

SAP Only

Internal

Use

Partner

136


2005/Q4

BIT300


Solution 7: Optional: ALE Scenario “Stock Transfer Between Distributed Systems” Task:

Only

In the SALES system, create a purchase order of the document type NB (normal order) at the vendor CORE for 100 pcs. of the material DPC1002. You are ordering with the authorization of the purchasing organization 1000 for the plant 1000. You belong to the purchasing group 001. The responsible company code is 1000. Check the results of the message determination: Which message type was found? Which transmission medium is used? Make a note of the document number of the purchase order. Message type: ________ Transmission medium: ______

SAP Use

Choose Logistics → Materials Management → Purchasing → Purchase Order → Create → Vendor/Supplying Plant Known.

b)

Enter the vendor CORE, and on the Org.data tab page, on the document header level, enter the purchasing organization 1000, the purchasing group 001 and the company code 1000.

c)

On the document item level, enter the material DPC1002, the order quantity 100 and the plant 1000. Confirm your entries with Enter.

d)

Choose the Output button: The output type NEU was found. The transmission medium is A. Create the purchase order by saving.

Only

Internal

Hint: If the document levels (header or item) are not visible, choose Header or Item overview .


2005/Q4


Partner

a)

SAP

Number of the purchase order: _________________

Use

Partner

1.

Internal

Create a purchase order with head office in the Sales and Distribution system, check the results of the message determination, and then display the automatically created order in the head office system. Also check the updating of the purchase order after the order confirmation is received.

137


In the field Business object, enter PurchaseOrder, and in the field Object key enter the purchase order number from step 1, then choose Execute .

c)

An IDoc for the message type ORDERS should be found under Outbound IDocs. Select the entry underneath the message type and choose the Display IDocs button.

d)

Select the IDoc and choose the Display IDocs button again. Open the Data records folder to display the segments of the IDoc.

a)

Choose Logistics → Sales and Distribution → Sales → Order → Change.

b)

In the Search criteria area, enter your purchase order number from step 1 in the corresponding field and choose Perform search.

c)

Select the search result and accept it with Enter: You now enter the overview screen of the order that was created from the data of the purchase order.

Was an order confirmation also created in the CORE system and sent to the SALES system? Check the results of the message determination in the order. a)

In the menu of the order, select Extras → Output → Header → Edit.

b)

The system found the output type BA00 (Order Acknowl.) and immediately processed it into an IDoc when creating the order.


138


2005/Q4

Only

Internal

4.

Partner

In the CORE system, check whether a sales order was created for the purchase order of the SALES system. Use your purchase order number from step 1 as the search criterion. Make a note of the document number of the order: ______________

SAP

Partner

b)

SAP


Use

a)

Use

3.

Display the outbound IDoc in the status monitor of the SALES sender system. Search for the IDoc using the business object type PurchaseOrder and your document number from step 1. Check the content of individual segments and compare them with your purchase order.

Internal

Only

2.

BIT300

BIT300


5.

In the CORE system, you now display the outbound IDoc for the order confirmation using the object services in the order. Then check the purchase order in the SALES system: What has changed?

a)

Choose System → Services for Object and then choose Display links

Only

b)

Double-click the number of the outbound IDoc of the message type ORDRSP to call up the IDoc for display.

c)

In the system SALES, choose Logistics → Materials Management → Purchasing → Purchase Order → Display.

Partner

Hint: In the purchase order, check the Confirmations tab page on the document item level.

d)

Select the tab page Confirmations on the document item level: In the Order confirmation field you will see the document number of the sales order from the CORE system.

.

Internal Use

SAP

SAP Only

Internal

Use

Partner

2005/Q4


139


BIT300

Lesson Summary You should now be able to: • Create a purchase order and check the events of your message determination • Describe the cross-system purchase order process • Explain the most important Customizing settings for this process

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

140


2005/Q4

BIT300

Unit Summary

Unit Summary

Only

Use

Partner

Internal

You should now be able to: • Differentiate ALE and EDI • Describe the basic functions of message control • Explain how message control is used to generate IDocs • Create a purchase order and check the events of your message determination • Describe the cross-system purchase order process • Explain the most important Customizing settings for this process

SAP

SAP Only

Internal

Use

Partner

2005/Q4


141

Unit Summary

BIT300

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

142


2005/Q4



SAP Use

Lesson: Business Object Types and BAPIs ..................................... 144 Lesson: The Usage of BAPIs in ALE............................................. 152 Lesson: Example: Travel Expenses.............................................. 162 Exercise 8: Trip Cost Accounting with Two Systems ...................... 169 Exercise 9: ALE Scenario for Setting Up Travel Expenses ............... 173

2005/Q4


143

Only

Internal

Unit Contents

Partner

• • •

Explain the terms “business object type” and “BAPI” Determine business object types and BAPIs using the BAPI Explorer, and also determine detailed information on BAPIs Enter Customizing settings for synchronous BAPI calls Enter Customizing settings for asynchronous BAPI calls using the ALE interface To describe the configuration of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting”.

SAP

• •

Use

Partner

This unit explains how transaction data in a system landscape can be distributed in ALE using preconfigured interfaces to business object types, the Business Application Programming Interfaces (BAPIs).

Internal

Only

Distributing Transaction Data: BAPIs

Unit 4: Distributing Transaction Data: BAPIs

BIT300

Lesson: Business Object Types and BAPIs Lesson Overview This lesson introduces business object types and BAPIs. You will find out how to search for and find BAPIs, and how to recognise whether an asynchronous ALE interface exists for a BAPI.

Only


What is a Business Object Type?

You want to set up a business process in a distributed system landscape. For this purpose, you look for corresponding inbound interfaces in receiving systems and check whether these interfaces have been used in a pre-defined ALE scenario.

Use

Only

Internal

Partner

Integration scenarios are important for the design phase of distributed business processes. For the technical integration, it is necessary to have a more in-depth understanding of the underlying technology (business objects and options for accessing business objects).

SAP

Business Example

Use

Partner

Explain the terms “business object type” and “BAPI” Determine business object types and BAPIs using the BAPI Explorer, and also determine detailed information on BAPIs

SAP

• •

Internal

Lesson Objectives

144


2005/Q4

BIT300

Lesson: Business Object Types and BAPIs

SAP

SAP

The business object types are an important part of the Internet Business Framework and are prerequisites for interoperability. Business object types cover a wide spectrum of SAP business data and processes, and they can be used by means of standardized methods - the BAPIs. The business object types and their BAPIs thus provide an object-oriented view of the business functions in SAP systems.

Use

Partner

Only

Internal

Figure 78: Business Object Type - Definition

Only

Internal

Use

Partner

Figure 79: Business Object Type - Representation

2005/Q4


145


BIT300

To achieve this encapsulation, business object types are created as entities with different layers: At the center of the business object type is the kernel, which represents the inherent data of the object. The second layer, the integrity layer, represents the business logic of the object. It comprises of the business rules for the consistent embedding in the environment and the constraints with regard to the values and areas relating to the business object type.

Use

Partner

The fourth and outermost layer of a business object type is the access layer. This layer defines the technologies that can be used for external access to the data of the object type - for example, COM/DCOM (Component Object Model/Distributed Component Object Model).

Internal

Only

The third layer, the interface layer, describes the implementation and structure of the business object type, and defines the object's interface to the outside world.

SAP

SAP

Internal

Use

Partner

Figure 80: Examples of SAP Business Object Types

146


2005/Q4

Only

Every individual business object belongs to a specific business object type, depending on its properties. For example, all the employees of a company belong to the business object type “employee”. An employee with the employee number 4711 is an instance of the business object type “employee” and is designated a business object.

BIT300


SAP

SAP

All the business object types and their methods are defined in the Business Object Repository (BOR) within SAP systems. The BOR was first introduced in SAP R/3 3.0, at the same time as the introduction of the business object types and the SAP Workflow. In SAP R/3 3.0, the BOR was mainly used by the SAP Workflow.

Use

Partner

Only

Internal

Figure 81: Business Object Repository (BOR)

•

Business object types

•

Technical object types These are elements such as texts, work items, archived documents, as well as development and modeling objects.

With the introduction of the BAPIs in SAP R/3 3.1, the importance of BOR increased. It is now the central point of access to the business object types and their BAPIs in SAP systems for external applications.

2005/Q4


147

Only

Internal

These are the business object types already discussed. In the BOR, the business object types are hierarchically assigned to the application components, such as Sales and Distribution and Materials Management.

Partner

Use

The BOR contains two categories of object types:


BIT300

What is a BAPI? External applications can access business objects in SAP systems through standardized, platform-independent interfaces - BAPIs. The business object types and their BAPIs provide an object-oriented view of the business processes and data in an SAP System.

Use

Only

Internal

For example, the functions that are implemented with the business object type “material” include a check for the material's availability. Therefore, the business object type “material” has a BAPI with the name “Material.CheckAvailability”.

Partner

A BAPI is a standard interface that provides access to the business data and business processes of business object types in SAP systems.

SAP

SAP

Use

Partner

Only

Internal

Figure 82: Interfaces of Business Object Types

148


2005/Q4


You can use the BAPI Explorer to obtain information on business object types and their related BAPIs. In the application menu, choose Tools → Business Framework → BAPI Explorer or call the transaction BAPI directly.

Use

Partner

Figure 83: How is a BAPI implemented in an SAP system?

Internal

Only

BIT300

SAP

SAP Only

Internal

Use

Partner

Figure 84: BAPI Explorer

The display of the BAPI Explorer is divided into a hierarchy area and a detail window. The component hierarchy is displayed in the hierarchy area. You can open the folders of the application components and obtain the business object types belonging to each

2005/Q4


149


BIT300

respective component. If you open the directory of a business object type, you see a subtree with its key attributes and its API methods. (API stands for Application Programming Interface.)

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

150


2005/Q4

BIT300


Lesson Summary You should now be able to: • Explain the terms “business object type” and “BAPI” • Determine business object types and BAPIs using the BAPI Explorer, and also determine detailed information on BAPIs

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


151


BIT300

Lesson: The Usage of BAPIs in ALE Lesson Overview This lesson shows how BAPIs can be used in an ALE scenario to realize synchronous checks and queries and asynchronous data exchanges.

Only

Enter Customizing settings for synchronous BAPI calls Enter Customizing settings for asynchronous BAPI calls using the ALE interface

You want to configure an ALE scenario in which the transaction data is distributed using BAPIs.

Synchronous Communication with BAPIs

SAP

SAP

Since SAP R/3 4.6, BAPIs are realized as function modules. You can use the BAPI Explorer to navigate to the display of the function module for the selected BAPI in the “Function Builder”:

Use

Business Example

• •

Internal


Partner

Lesson Objectives

Only

Internal

Use

Partner

Figure 85: BAPI Function Modules

152


2005/Q4

BIT300

Lesson: The Usage of BAPIs in ALE

BAPIs can be used for the synchronous communication between two systems.

Use

Partner

Only

Internal

SAP

The application program determines the receiver and, if applicable, filter values for filter objects from the distribution model. If the BAPI is not contained in the distribution model, it is usually called up locally.

1.

Determination of the RFC destination: If the logical system in which the BAPI is to be called is known, the application program of the calling system determines the RFC destination for this remote system from a table, which you can find by using the transaction BD97 or in the IMG in the Customizing of the ALE (transaction SALE) by means of the path IDoc Interface / Application Link Enabling (ALE) → Communication→ Determine RFC Destinations for Method Calls.

3.

Calling up the BAPI function module using RFC: The calling system transfers the application data by means of RFC by calling up the BAPI function module in the target system.

2005/Q4


153

Only

Internal

Querying the distribution model:

Partner

2.

SAP

For the synchronous call of a BAPI within an ALE scenario, the following steps must be realized in the application program:

Use

Figure 86: Synchronous call of a BAPI

You can use the transaction BD97 to assign a standard destination for BAPIs to a target system. All BAPI calls for which no specific destination has been entered use this destination. The RFC user for the standard destination must have the appropriate application authorizations. You can also maintain a destination for each method call for every target system. In this case, you can assign the authorizations of the RFC user more precisely.

SAP

SAP

In the distribution model, you can add BAPIs to the individual model views using the Add BAPIs button.

Use

Figure 87: RFC Destinations for Synchronous Method Calls

Internal

Only

BIT300

Partner


Along with the sending and receiving systems, you enter in the model view the name of the business object type involved and the desired method, that is, the BAPI. In the fields Business object type and Method you enter the name from the BAPI Explorer and not the technical names of the business object types from the “Business Object Builder”.

154


2005/Q4

Only

Internal

Use

Partner

Figure 88: Distribution Model: Adding BAPIs

BIT300


Figure 89: Asynchronous Call of a BAPI in the Target System

Partner

Use

In order to call a BAPI asynchronously in the target system, an IDoc is sent to the target system. This contains the interface parameters of the BAPI, and in the case of instance methods, the key fields of the business object. In the target system, the BAPI function module is called locally with the parameters from the IDoc.

Internal

Only

Asynchronous Communication with BAPIs

SAP

SAP Only

Internal

Use

Partner

Figure 90: ALE Interface of a BAPI

You go to the display of the ALE interface of a BAPI by clicking on the ALE message type in the detail view of of the BAPI Explorer. In this way you call the transaction BDBG, with which you can display the existing ALE interfaces of BAPIs, but can also generate new interfaces.

2005/Q4


155


BIT300

In the transaction BDBG, you select the Display interface button to display the automatically generated elements of the ALE interface of a BAPI.

Use

Partner

Only

Internal

Figure 91: ALE Interface of a BAPI

SAP

•

SAP

The following elements are part of the generated ALE interface of a BAPI: Message type:

Use

• •

•

156

IDoc type: The IDoc type is the basis of the IDoc required for the asynchronous communication with BAPIs. Segment types: The elementary import parameters are grouped together in a segment type. A segment type is created for every structured import parameter. Function module for ALE output: In the outbound function module, the interface parameters are copied into the IDoc segments and a master IDoc is created. Then a function module is called that transfers this master IDoc to the ALE layer. Function module for ALE input: The inbound function module copies the contents of the segment fields onto the related interface parameters and calls the BAPI function module locally in the target system.


2005/Q4

Only

Internal

•

Partner

Message types of the ALE interface of BAPIs are not directly assigned to a model view. They are used exclusively in the partner profiles between sending and receiving systems. The BAPIs themselves are assigned in the distribution model (see above).

BIT300


Use

Partner

Only

Internal

Figure 92: Outbound Processing of an IDoc for a BAPI Call

SAP

1.

Use Internal

2005/Q4


157

Only

The communication IDoc is created in the same way as in the non-BAPI-based ALE scenarios: For the message type of the BAPI, there must be partner profiles with the recipient system in which the generated IDoc basic type of the ALE scenario of the BAPI, and a suitable RFC port, are assigned.

Partner

2.

After the application data is determined, the receiving system and any filter values for filter objects from the distribution model of the sending system are determined. Subsequently, the generated outbound function module of the ALE interface of the BAPI is called. This module creates the master IDoc and transfers it to the ALE layer.

SAP

The following steps are carried out in the application program:


BIT300

Use

Partner

Only

Internal

Figure 93: Sending the Communication IDoc

SAP

SAP

The communication IDoc is sent by means of RFC immediately or later, depending on the specifications in the partner profiles with the receiving system.

Only

Internal

Use

Partner

158


2005/Q4

BIT300


Use

Partner

Only

Internal

Figure 94: Inbound Processing of an IDoc for a BAPI Call

SAP Use

Only

Internal

Partner

By means of the BAPI process code in the partner profiles, the ALE detects learns that the input function module of the ALE interface generated for the BAPI is to be called. The inbound function module copies the contents of the segment fields of the IDoc onto the BAPI interface parameters and then calls the BAPI function module locally.

SAP

In the receiving system, the IDoc is stored on the database. Depending on the setting in the partner profiles, it is either transferred to the application immediately, or processed later as by the program RBDAPP01 as a background job.

2005/Q4


159


BIT300

Use

Partner

Only

Internal

Figure 95: Outbound Partner Profile in the Sending System

SAP

SAP

If possible, generate the partner profiles of BAPI-based ALE scenarios from the distribution model. The system then enters the message type and IDoc type relevant to the BAPI.

Only

Internal

Use

Partner

Figure 96: Inbound Partner Profile in the Receiving System

Also generate the partner profile in the receiving system from the distribution model: The system assigns the process code BAPI.

160


2005/Q4

BIT300


Lesson Summary You should now be able to: • Enter Customizing settings for synchronous BAPI calls • Enter Customizing settings for asynchronous BAPI calls using the ALE interface

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


161


BIT300

Lesson: Example: Travel Expenses Lesson Overview This lesson explains the configuration of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting”. This scenario uses BAPIs for both the synchronous and the asynchronous communication.

Only


Partner

•

To describe the configuration of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting”.

Your company has moved the human resources to its own system. The employees enter the costs for their business trips in the Travel Management of this system. In the future, the results of the travel expenses are to be transferred to the Accounting system using ALE.

Use

Travel Expenses: Process

SAP

SAP

Business Example


2005/Q4

Use Internal

Only

It is not absolutely necessary to systematically separate the Travel Management from the other applications of Accounting. However, it is not infrequently assigned to the separately operated system for human resources (in the example HR_TRAVEL). If the systems are thus separated, then the results of the travel expenses must be transferred to the Accounting system (in the example: CORE) for posting and for the subsequent payout of reimbursement amounts. In SAP R/3 and SAP EEC, you are provided with the pre-configured ALE scenario “Transferring the accounting results of the travel expenses to Accounting” for this process.

Partner

The Travel Management is part of the mySAP ERP Financials application, but it also affects human resources. For this reason, you will find the application transactions for using the functions of Travel Management in the reporting menus of both applications.

162

Internal

Lesson Objectives

BIT300

Lesson: Example: Travel Expenses

Use

Partner

Only

Internal

Figure 97: Travel Expenses: Posting Procedure

SAP

SAP

The figure illustrates the posting procedure of the process. It comprises the following individual steps:

Only

Internal

Use

Partner

2005/Q4


163


•

•

Posting the posting run: Finally, the Travel Management system transfers the results of the settlement to the Accounting system. The BAPIs used by the system in this step are called asynchronously, in the course of IDoc inbound processing.

Required Presettings For the ALE scenario “Transferring the accounting results of the travel expenses to Accounting” to function, a necessary prerequisite is the advance distribution of the master data required in both systems (personnel master data, cost centers). In addition, the Customizing in the areas involved must be synchronized.

164


2005/Q4

Only

Internal

Note: A posting run is a kind of “container” for the documents in which the the results of the travel expenses are kept. Every posting run is given a unique, sequential number by the system.

Partner

Use

•

SAP

SAP

•

Use

Partner

•

Entering the trip costs: In the Travel Management, the employee enters the details (start and end of trip, destination, expenses for accommodation, transport, and so on) of his business trip (“Create trip”). Authorization of trip: The supervisor or personnel department employee authorizes the reimbursement of costs (“Authorize trip”). Accounting of trip: The personnel department gets the system to calculate the reimbursement amounts. Among other things, this step takes into account the daily rates for calculating expenses stored in the system (“Settle trip”). Creating the posting run: When creating what is known as the posting run, the trip cost management system performs synchronous BAPI calls. In this way it checks, among other things, whether the accounts on which the postings are to be made, the account assignment objects of Controlling determined in the travel expenses, and the vendor master records required for the reimbursement of expenses, exist in the Accounting system for the personnel numbers of the employees on the trip. Checking the posting run: In order to ensure that postings are allowed to be made on the accounts and account assignment objects of Accounting at the time of the actual settlement data transfer, the Travel Management system can perform additional synchronous BAPI calls.

Internal

Only

•

BIT300

BIT300


SAP Use

Only

Internal

To be able to create a posting run in the system of the Travel Management, you transfer the relevant BAPIs (see figure below) into a corresponding view of the distribution model in the maintenance system and assign the target system of these synchronous method calls an RFC destination using the transaction BD97.

Partner

Details of the Posting Run for the Travel Expenses

SAP

You will find more detailed information on these settings in IMG through transaction SALE. Then choose IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Configure Predefined ALE Business Processes → Human Resources → HR <-> AC → Set Up Trip Costs Transfer to FI.

Use

Partner

Only

Internal

Figure 98: Master Data Distribution

2005/Q4


165


BIT300

Use

Partner

Only

Internal

Figure 99: Model View: Creating a Posting Run

SAP

SAP

To check a posting run, you also transfer the relevant BAPIs into a view of the distribution model and assign the target system of the synchronous method call an RFC destination using the transaction BD97.

Only

Internal

Use

Partner

Figure 100: Model View: Checking a Posting Run

166


2005/Q4

BIT300


To post a posting run in the Accounting system, you transfer the relevant BAPIs into a view of the distribution model and generate the partner profiles for the IDoc generation in the sending and receiving systems.

SAP

SAP

Use

Partner

Only

Internal

Figure 101: Model View: Posting a Posting Run

Use

Only

Internal

Partner

When you display the trip transfer documents in the Travel Management system after transferring the posting run to the Accounting system, a traffic light will tell you whether the data transfer was successful.

2005/Q4


167


BIT300

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

168


2005/Q4

BIT300


Exercise 8: Trip Cost Accounting with Two Systems Exercise Objectives

Only Use Internal

In the HR_TRAVEL system, create a new trip for the employee with the personnel number 60995##. Enter the costs for accommodation and taxis. The trip was in the previous week and took two days. Write down the number of the trip: ___________

2.

Approve the reimbursement of the trip costs you have just entered and then perform the settlement. Write down the settlement period: ___________

3.

Create a posting run with the data for your trip.

4.

Now transfer the settlement results to Accounting in the logical system CORE.

5.

Then display the inbound IDoc in the status monitor of the logical system CORE. You can also directly access your IDoc using the transaction IDoc Search for Contents (transaction code WE09). Using the IDoc basic type ACC_EMPLOYEE_PAY01, select the segment E1BPACHE06, segment field USERNAME, and enter your user BIT300-## as an additional search criteria.


169

Only

2005/Q4

1.

Partner

Caution: When the trip costs are being transferred to Accounting, the system checks that the receiver is unique. Therefore, a test run is performed with the model view that the instructor created. Exercise 2, in which you create a new view in the distribution model with all the BAPIs required for the ALE scenario, must therefore be performed after this exercise.

SAP

SAP

In the logical system HR_TRAVEL, enter the data of a business trip, settle this business trip, and transfer the settlement data to the logical system CORE for posting in Accounting.

Use

Task:

Your company has moved the human resources to its own system. Business trips are recorded in the SAP Travel Management of this system and subsequently transferred to the Accounting system for reimbursement purposes.

Internal

Business Example

Partner

After completing this exercise, you will be able to: • Transfer trip costs from the Human Resources system to the Accounting system within the SAP Travel Management


BIT300

Solution 8: Trip Cost Accounting with Two Systems Task:

c)

Choose Create

d)

Enter a date in each of the fields Start and Finish. Next, in the ExpTy field, enter HOTL and in the Amount field the total cost of the accommodation. Confirm these entries with Enter.

e)

In the Description field, enter a text of your choice and select Enter again to leave the detail screen.

f)

Next, in the ExpTy field, enter TAXI and in the Amount an amount of your choice. Create the trip by saving and make a note of the trip number.

SAP

Enter the personnel number 60995## and confirm the entry with Enter.

2.

to call up the screen for entering the trip costs.

Approve the reimbursement of the trip costs you have just entered and then perform the settlement. Write down the settlement period: ___________ a)

Select your trip from step 1 and choose the Approve button.

b)

Then choose the Settle button. Confirm the default for the settlement period and make a note of the period. Continued on next page

170


2005/Q4

Only

b)

Partner

Choose Human Resources → Travel Management → Travel Expenses → Travel Expense Manager.

SAP

a)

Use

In the HR_TRAVEL system, create a new trip for the employee with the personnel number 60995##. Enter the costs for accommodation and taxis. The trip was in the previous week and took two days. Write down the number of the trip: ___________

Internal

1.

Use

Partner

Caution: When the trip costs are being transferred to Accounting, the system checks that the receiver is unique. Therefore, a test run is performed with the model view that the instructor created. Exercise 2, in which you create a new view in the distribution model with all the BAPIs required for the ALE scenario, must therefore be performed after this exercise.

Internal

Only

In the logical system HR_TRAVEL, enter the data of a business trip, settle this business trip, and transfer the settlement data to the logical system CORE for posting in Accounting.

BIT300


SAP Use

Enter the payroll area D2, choose Other period and enter the period from step 2. Also enter the personnel number 60995## and the number of the trip from step 1 and choose Execute .

c)

If the synchronous check of the accounts, account assignment objects and HR payee assignment for the personnel number was successful, you will see a green traffic light for the number of the posting run. Leave the transaction.

Now transfer the settlement results to Accounting in the logical system CORE. a)

Choose Human Resources → Travel Management → Travel Expenses → Periodic Processing → Transfer to Accounting → Manage Posting Runs.

b)

Select Execute

c)

Select your posting run and choose the Post button. Answer the query on the processing time by choosing the Post immediately button: If the transfer was successful, you will see a green traffic light with the text Posting run completely transferred to target system CORE.

to display your posting run from step 3.

Then display the inbound IDoc in the status monitor of the logical system CORE. You can also directly access your IDoc using the transaction IDoc Search for Contents (transaction code WE09). Using the IDoc basic type ACC_EMPLOYEE_PAY01, select the segment E1BPACHE06, segment field USERNAME, and enter your user BIT300-## as an additional search criteria. a)

In the CORE system, choose Tools → ALE → ALE Administration → Monitoring → IDoc Display → Status Monitor to call the status monitor, or Tools → ALE → ALE Administration → Services → IDoc Search for Contents to go to transaction WE09.

b)

In the field Basic type enter ACC_EMPLOYEE_PAY01, in the field Search in segment enter E1BPACHE06, in the field Search in field enter USERNAME and in the field For value enter your user BIT300-## and choose Execute .

c)

Click on the number of the IDoc to display the details.


171

Only

Internal

b)

Partner

2005/Q4

Choose Human Resources → Travel Management → Travel Expenses → Periodic Processing → Transfer to Accounting → Create Posting Run.

SAP

5.

a)

Use

Partner

4.

Create a posting run with the data for your trip.

Internal

Only

3.


BIT300

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

172


2005/Q4

BIT300


Exercise 9: ALE Scenario for Setting Up Travel Expenses Exercise Objectives

Only

Business Example

Task 1:

SAP Use

2.

Which BAPIs are involved in the transfer of the trip costs to Accounting? Make a note of the BAPIs for the business object types used for the steps “Create posting run”, “Check posting run” and “Post posting run”.

Only

Internal

In the IMG documentation, search for the description of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting”.

Partner

1.

SAP

In the IMG documentation, search for the description of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting” and make a note of the BAPIs required for this scenario.

Use

Partner

Your company has moved the human resources to its own system. Business trips are recorded in the SAP Travel Management of this system and subsequently transferred to the Accounting system for reimbursement purposes.

Internal

After completing this exercise, you will be able to: • Determine BAPIs using the BAPI Explorer • Check the ALE interface belonging to a BAPI • Set up an ALE scenario with BAPIs


2005/Q4


173


BIT300

Business object type

Method (BAPI)

AcctngServices Vendor Customer

Internal

Only

AcctngEmplyeePaybles AcctngEmplyeeRcvbles

3.

In the BAPI Explorer, check for which of the BAPIs entered in the above table there is an ALE interface. Note the names of the assigned message types. BAPI

Message type

Use

Partner

AcctngEmplyeeExpnses

Hint: To be able to perform this exercise with different exercise groups, we have to use a little trick: All the groups are to set up the distribution between the systems HR_TRAVEL and CORE. However, just like message types, BAPIs may only appear in one view of the distribution model in the relationship between two logical systems. For this reason, you use the logical system CORE## as the target system, but you enter a port to which an RFC destination of the system CORE is assigned. 1.

In the logical system CORE, you define the logical system CORE##, but you do not assign it to any client. Continued on next page

174


2005/Q4

Only

Internal

In the logical system CORE, define a new logical system CORE## and then create a model view with this logical system as the target system of the method calls determined in the first task.

Partner

Use

SAP

SAP

Task 2:

BIT300


3.

In the distribution model of the system CORE, create a new view with the short text BIT300BAPI## and the technical name BAPI##. Add the BAPIs that you determined in the first task. The sender is the system HR_TRAVEL, and the receiver the system CORE##.

Only

Is this logical system name now known in the logical system HR_TRAVEL? If applicable, also create CORE## in HR_TRAVEL.

Distribute the new model view to the system HR_TRAVEL and there you create the corresponding partner profiles. You also add an RFC destination to the system CORE## for synchronous method calls. Distribute the new model view to the logical system HR_TRAVEL and check the result.

In the logical system HR_TRAVEL, create outbound partner profiles with the partner CORE## for the message type SYNCH. The receiving port is CORE with the RFC destination of the same name.

3.

In the logical system HR_TRAVEL, you now generate the outbound partner profiles with the system CORE## for the three asynchronous method calls, or you create them manually.

Only

Internal

2.

Partner

Use

Caution: Do not distribute the view to the logical system CORE##, because this logical system is not assigned to a client.

SAP

SAP

1.

Use

Partner

Task 3:

Internal

2.


2005/Q4


175

BIT300

In the logical system CORE, check the inbound partner profiles with the logical system HR_TRAVEL for the message types for asynchronous communication. Which process code is assigned? Why do you not need any separate inbound partner profiles for the logical system CORE##?

5.

In the HR_TRAVEL system, which RFC destination do you have to assign to the logical system CORE## for synchronous method calls? Add the corresponding entry.

Use

Partner

4.

Internal

Only


SAP

SAP Only

Internal

Use

Partner

176


2005/Q4

BIT300


Solution 9: ALE Scenario for Setting Up Travel Expenses Task 1: In the IMG documentation, search for the description of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting” and make a note of the BAPIs required for this scenario.

Only Partner SAP

b)

Choose Documentation for IMG activity

.

Which BAPIs are involved in the transfer of the trip costs to Accounting? Make a note of the BAPIs for the business object types used for the steps “Create posting run”, “Check posting run” and “Post posting run”. Business object type

Method (BAPI)

AcctngServices

PreCheckPayrollAccountAssign

Vendor

Find

Customer

Find

AcctngEmplyeePaybles

Check

Partner

Use

Call the transaction SALE and choose IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Configure Predefined ALE Business Processes → Human Resources → HR <-> AC → Set Up Trip Costs Transfer to FI → Travel Management and Accounting are Release 4.5A or Later.

Post AcctngEmplyeeRcvbles

Check

Only

Post AcctngEmplyeeExpnses

Check Post

3.

In the BAPI Explorer, check for which of the BAPIs entered in the above table there is an ALE interface. Note the names of the assigned message types.


2005/Q4


SAP

Internal

a)

Use

2.

In the IMG documentation, search for the description of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting”.

Internal

1.

177

BAPI

Message type

AcctngEmplyeeExpnses.Post

ACC_EMPLOYEE_EXP

AcctngEmplyeePaybles.Post

ACC_EMPLOYEE_PAY

AcctngEmplyeeRcvbles.Post

ACC_EMPLOYEE_REC

a)

Choose Tools → Business Framework → BAPI Explorer.

b)

Select the tab page Alphabetical and expand each of the entries for the business object types AcctngEmplyeeExpnses, AcctngEmplyeePaybles and AcctngEmplyeeRcvbles.

c)

Select each respective entry for the method Post: You will find the message type on the tab page Detail in the field ALE message type.

Task 2: In the logical system CORE, define a new logical system CORE## and then create a model view with this logical system as the target system of the method calls determined in the first task.

SAP Use

a)

Call the transaction SALE and choose IDoc Interface / Application Link Enabling (ALE) → Basic Settings → Logical Systems → Define Logical System. Confirm the message about client independence with Enter.

b)

Choose the New entries button, enter the logical system name CORE## and a name of your choice and save your entry.

c)

In the screen prompting the workbench request, choose Create Request , enter a short description of your choice and choose Save . Then choose or Enter and leave the table. Continue Continued on next page

178


2005/Q4

Only

Internal

In the logical system CORE, you define the logical system CORE##, but you do not assign it to any client.

Partner

1.

SAP

Hint: To be able to perform this exercise with different exercise groups, we have to use a little trick: All the groups are to set up the distribution between the systems HR_TRAVEL and CORE. However, just like message types, BAPIs may only appear in one view of the distribution model in the relationship between two logical systems. For this reason, you use the logical system CORE## as the target system, but you enter a port to which an RFC destination of the system CORE is assigned.

Use

Partner

BIT300

Internal

Only


BIT300


2.

Is this logical system name now known in the logical system HR_TRAVEL? If applicable, also create CORE## in HR_TRAVEL. Answer: This depends on whether you are working with one or more SAP systems in the course. •

Switch to the change mode (Switching between display and edit modes and choose the Create model view button.

SAP

c)

Enter the short text BIT300BAPI## and the technical name BAPI## and choose Enter.

d)

Select the view and choose the Add BAPI button.

e)

Enter the sender HR_TRAVEL, the receiver CORE##, the object name AcctngEmplyeeExpnses and the method Check, and confirm your entries with Enter.

f)

In this way, you add the remaining BAPIs that you require for the ALE scenario. Create the new model view by saving.

)

Task 3: Distribute the new model view to the system HR_TRAVEL and there you create the corresponding partner profiles. You also add an RFC destination to the system CORE## for synchronous method calls. 1.

Distribute the new model view to the logical system HR_TRAVEL and check the result.


2005/Q4


179

Only

Internal

b)

Partner

Call the transaction SALE and choose IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Maintain Distribution Model and Distribute Views.

SAP

a)

Use

In the distribution model of the system CORE, create a new view with the short text BIT300BAPI## and the technical name BAPI##. Add the BAPIs that you determined in the first task. The sender is the system HR_TRAVEL, and the receiver the system CORE##.

Use

Partner

3.

Internal

Only

•

If you are using clients in two SAP systems: The logical system name CORE## must also be defined in the logical system HR_TRAVEL. If you are only using clients of one SAP system: The logical system name CORE## is already known in the system HR_TRAVEL, because the logical system names are saved in a cross-client table.


BIT300

a)

In the distribution model of the system CORE, select the new model view and choose Edit → Model view → Distribute.

b)

In the next screen, deselect the entry for the logical system CORE## and confirm the change with Enter. You receive a log of the successful distribution of the view to the system HR_TRAVEL.

c)

In the system HR_TRAVEL, call the distribution model for display, as described in task 2.

Partner Use

a)

In the system HR_TRAVEL, in the menu of the distribution model, choose Environment → Change Partner Profile.

b)

Choose Create , enter the partner number CORE## and the partner type LS and create the new partner by saving.

c)

In the outbound parameter area, choose Create outbound parameter , and in the message type SYNCH, enter the receiving port CORE and the IDoc type SYNCHRON. Choose the immediate IDoc transfer and save your changes. Leave the partner profile maintenance.

Partner Only

Internal

In the logical system HR_TRAVEL, create outbound partner profiles with the partner CORE## for the message type SYNCH. The receiving port is CORE with the RFC destination of the same name.

SAP

SAP

2.

Use

Hint: If your BAPI## view has not been distributed, this could be because the message type SYNCH does not exist in the partner profiles of the system CORE with the system HR_TRAVEL, or because the RFC destination does not lead to the client of the system HR_TRAVEL.

Internal

Only

Caution: Do not distribute the view to the logical system CORE##, because this logical system is not assigned to a client.


180


2005/Q4

BIT300


Partner SAP

b)

Then choose Environment → Change Partner Profile to check the automatically created partner profiles.

c)

To create the partner profiles manually, choose Environment → Change Partner Profile.

d)

Select the partner CORE## and in the outbound parameter area, choose Create Outbound Parameter .

e)

Enter the message type ACC_EMPLOYEE_EXP, the port CORE and the IDoc type ACC_EMPLOYEE_EXP01, select the immediate processing, and create the partner profiles by saving. Proceed in the same way with the message types ACC_EMPLOYEE_REC and ACC_EMPLOYEE_PAY. The corresponding IDoc types are ACC_EMPLOYEE_REC01 and ACC_EMPLOYEE_PAY01 respectively.

In the logical system CORE, check the inbound partner profiles with the logical system HR_TRAVEL for the message types for asynchronous communication. Which process code is assigned? Why do you not need any separate inbound partner profiles for the logical system CORE##? Answer: In the inbound partner profiles for the message types ACC_EMPLOYEE_EXP, ACC_EMPLOYEE_PAY and ACC_EMPLOYEE_REC, the process code BAPI is assigned. Because the logical system CORE## is not assigned to any client, but rather the system HR_TRAVEL actually calls the system CORE## on the basis of the assignment of the receiving port CORE in the outbound partner profiles with CORE##, no inbound partner profiles are required for CORE##.

Partner

Use

Select your model view and in the menu of the distribution model, choose Environment → Generate Partner Profile.

SAP Only

Internal

a)

Use

4.

In the logical system HR_TRAVEL, you now generate the outbound partner profiles with the system CORE## for the three asynchronous method calls, or you create them manually.

Internal

Only

3.


2005/Q4


181


a)

Because the logical system name CORE## is not assigned to any client, you must assign the RFC destination CORE to the logical system of the same name.

b)

Call the transaction SALE and choose IDoc Interface / Application Link Enabling (ALE) → Communication → Determine RFC Destinations for Method Calls.

c)

In the menu of the transaction, choose Edit → Find. In the Search for field, or Enter. enter your logical system CORE## and choose Find

d)

Click on the system name to return to the system overview at the position of the corresponding entry.

e)

Select your logical system CORE## and choose the button Standard Dest. for BAPIs. Enter the RFC destination CORE, choose Enter, and save the change.

Use

Partner

In the HR_TRAVEL system, which RFC destination do you have to assign to the logical system CORE## for synchronous method calls? Add the corresponding entry.

Internal

Only

5.

BIT300

SAP

SAP Only

Internal

Use

Partner

182


2005/Q4

BIT300


Lesson Summary You should now be able to: • To describe the configuration of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting”.

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


183

Unit Summary

BIT300

Unit Summary

Only

Use

Partner

Internal

You should now be able to: • Explain the terms “business object type” and “BAPI” • Determine business object types and BAPIs using the BAPI Explorer, and also determine detailed information on BAPIs • Enter Customizing settings for synchronous BAPI calls • Enter Customizing settings for asynchronous BAPI calls using the ALE interface • To describe the configuration of the ALE scenario “Transferring the accounting results of the travel expenses to Accounting”.

SAP

SAP Only

Internal

Use

Partner

184


2005/Q4

Unit 5 Only

Unit Overview

Use

Partner

This unit handles various different tasks that arise from the implementation of ALE and EDI scenarios. You will learn how to monitor the evolution of an IDoc, how to correct errors and then how to archive IDocs that are no longer needed.


SAP Use

Use the status monitor efficiently Set up and use the ALE audit Perform error analysis using the ALE status monitor Resolve errors in the IDoc processing Check workflow settings for the error handling of IDocs Understand the settings for process codes Describe the notification concept Monitor the IDoc processing using the SAP Workflow Describe the IDoc archiving procedure Set the archivable statuses in the system

Partner

Unit Contents Lesson: IDoc Status Management ............................................... 187 Exercise 10: Monitoring IDocs in the Status Monitor ...................... 193 Exercise 11: ALE Audit ........................................................ 195 Lesson: Error Analysis and Handling ............................................ 198 Procedure: Problem: The IDoc Was Not Created.......................... 205 Procedure: Problem: The IDoc was Created, but was not Sent ......... 208

2005/Q4


185

Only

Internal

SAP

• • • • • • • • • •

Internal

Monitoring Data Distribution, Error-Handling and Archiving

Unit 5: Monitoring Data Distribution, Error-Handling and Archiving

BIT300

Procedure: Problem: The IDoc was Successfully Sent, but it was not Received by the Receiving System .......................................... 209 Procedure: Problem: The IDoc was Received by the Receiving System, but was not Posted ............................................................. 210 Exercise 12: Error Analysis and Handling................................... 213 Lesson: SAP Workflow in ALE Environment .................................... 222 Exercise 13: Processing an Incorrect IDoc from a Work Item ............ 233 Lesson: Archiving IDocs ........................................................... 238

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

186


2005/Q4

BIT300

Lesson: IDoc Status Management

Lesson: IDoc Status Management Lesson Overview This lesson provides you with more detailed information on the IDoc status monitor. You also learn how the sender system uses the ALE audit to obtain information about the further processing of IDocs in the receiving system.

Only

Internal

Lesson Objectives After completing this lesson, you will be able to: Use the status monitor efficiently Set up and use the ALE audit

Business Example

IDoc Status Management

Use

• • • • • • •

2005/Q4

IDoc numbers Creation date and time Change date and time IDoc status Partner systems Message types Business object types and object keys


Only

Internal

Because you usually do not want to display all the IDocs that have not been archived yet at the same time, the status monitor provides you with various selection criteria for displaying specific documents:

Partner

The status monitor provides you with an overview of the outbound and inbound IDocs from the perspective of the logical system by executing the transaction (transaction code BD87). From SAP R/3 4.6C on, the status monitor displays all IDocs, even those that were processed correctly.

SAP

SAP

You are using various ALE scenarios and have to monitor the data distribution. Errors in the IDoc outbound and inbound processing should be detected early. You are also looking for options to call information in the sender system about the further processing of IDocs in the receiving system.

Use

Partner

• •

187


BIT300

The IDocs determined on the basis of the selection specifications are first grouped in the status monitor in terms of direction (outbound or inbound). They are also grouped into status groups. For example, all the outbound IDocs for a message type that were successfully transferred to a tRFC port are grouped into status group 03. Each status value is assigned to a traffic light symbol. Successfully processed IDocs are displayed with green traffic light symbols in the status monitor, not yet (completely) processed IDocs with yellow traffic light symbols and incorrectly processed IDocs with red traffic light symbols.

Use

Partner

Only

Internal

Note: In SAP R/3 4.7, you will find these transactions with the menu path Tools → Business Communication → IDoc Basis → Control → Status. In SAP ECC 5.0, you call the transactions from the IMG (transaction SALE) by choosing IDoc Interface / Application Link Enabling (ALE) → System Monitoring → Set IDoc Status Display → Process IDoc Status Values or Process Status Groups. In Settings → Hierarchy in the menu of the status monitor you can choose whether to highlight the message type or the status value.

188


2005/Q4

Only

Internal

The assignment of a status to a traffic light symbol can be changed. To do this, you call transaction WE47. Status values are grouped together into status groups. The traffic light symbols are assigned to status groups in a table that you can call using transaction WELI.

Partner

Use

SAP

SAP

Figure 102: Status Groups

BIT300


Displaying and Monitoring IDocs Use the button Display IDocs to call a list of all the IDocs for a message type.

Use

Partner

Only

Internal

SAP Use

Only

Internal

Under certain conditions, you can also call and display from the sender system an IDoc in the receiver system. This function (“Monitor IDocs”) is also available in the status monitor by pressing the corresponding button.

Partner

By double-clicking on one of the IDoc numbers in this list you enter the display of the document itself. Here you can check the control record, the data records and the status records.

SAP

Figure 103: Displaying IDocs

2005/Q4


189


BIT300

Partner

Only

Internal Use

Figure 104: Monitoring IDocs

To use this function, the following preconditions must be fulfilled:

SAP

•

ALE Audit The function “ALE Audit” provides the sending system with information about the processing status of an IDoc in the receiving system.

190


2005/Q4

Only

Internal

•

Partner

Use

•

In the outbound partner profiles with the respective receiving system, there must be parameters for the message type SYNCH. The RFC user entered in the RFC destination which is assigned to the port of the outbound partner profile for the message type SYNCH must have the authorization “Execute” in the receiving system for the function group BDMT for the authorization object S_RFC. In the sending system, an RFC destination for dialogs must be assigned to the receiver system. You can make this assignment in the IMG by calling the transaction SALE and choosing IDoc Interface / Application Link Enabling (ALE) → Communication → Determine RFC Destinations for Method Calls. The RFC user must be a dialog user in the receiving system with the corresponding authorizations for the authorization object S_IDOCMONI.

SAP

•

BIT300


SAP Use

2.

3. 4.

2005/Q4

Add the message type ALEAUD to all the relevant model views. The receiving system of the IDocs, whose status values are to be transferred in the audit, is the sending system for the message type ALEAUD. If required, you can filter by message type. A corresponding filter object exists. Enter as filter values all the message types for which you want to create an audit message. Distribute the changes message views again and generate the partner profiles in all the systems involved. Include the program RBDSTATE for sending the audit confirmations.


191

Only

Internal

1.

Partner

Setting up the ALE Audit

SAP

The receiving system uses the asynchronous IDoc interface in order to send back status information to the sending system of an IDoc. The message type of the confirmation is ALEAUD. The receiving system creates its own IDoc with status information on IDocs that it received for certain message types within a specific period. This audit confirmation is usually sent periodically by means of a background job, but it can also be triggered directly from the status monitor.

Use

Partner

Only

Internal

Figure 105: ALE Audit: Model View


BIT300

SAP

•

You will find the functions of the ALE Audit in the menu of the status monitor through the path Goto → ALE Audit. You can send confirmations directly (by starting the program RBDSTATE), create statistical evaluations, and delete audit statistics that are no longer required.

192


2005/Q4

Only

Internal

•

If the inbound IDoc in the receiving system has the status 53 (application document posted), then the corresponding outbound IDoc in the sending system gets the status 41 (application document created in target system). If the IDoc has reached the receiving system with the status 64 (IDoc is ready for transfer to the application) or 62 (IDoc transferred to application), but the data has not been posted in the application yet, then the corresponding IDoc in the sending system is given the status 39 (IDoc in target system). Therefore, status 39 only means that the IDoc has reached the receiving system. Status 39 does not tell you whether the IDoc still has status 64 because the program RBDAPP01 was not started yet, or whether an error has occurred. If the IDoc was processed incorrectly in the receiving system, and if this error cannot be corrected - for example, if the IDoc was sent to the wrong receiving system - then the IDoc can be changed to status 68. In this case, the status of the related IDoc in the sending system is set to status 40 (application document in target system not created).

Partner

Use

•

SAP

The status value of an outbound IDoc in the sending system after the successful inbound processing of the confirmation IDoc for the message type ALEAUD, depends on the status of the corresponding inbound IDoc in the receiving system at the time of execution of the program RBDSTATE:

Use

Partner

Only

Internal

Figure 106: ALE Audit: Status Values

BIT300


Exercise 10: Monitoring IDocs in the Status Monitor Exercise Objectives

Business Example

Partner

You have set up various ALE scenarios in your system landscape. Now you want to check whether the IDocs sent for test purposes have arrived in the respective receiving systems without logging on to these receiving systems.

2.

In the CORE system, call the status monitor and select the IDocs of the message type MATMAS that have been created since the start of the course. Use the function “Monitor IDocs” to determine the status of these IDocs in the receiving system PRODUCTION. Display one of the IDocs in the PRODUCTION system.

SAP

Use

In the CORE system, check whether the PRODUCTION system is assigned an RFC destination for dialogs.

Only

Internal

1.

Partner

In the logical system CORE, display IDocs for the message type MATMAS and check whether they have been processed successfully in the logical system PRODUCTION. However, first check the assignment of an RFC destination for dialogs to the logical system PRODUCTION.

Use

SAP

Task:

Internal

Only

After completing this exercise, you will be able to: • Use the status monitor to monitor IDocs in your receiving system

2005/Q4


193


BIT300

Solution 10: Monitoring IDocs in the Status Monitor Task:

Only SAP Use

b)

In the menu of the transaction, choose Edit → Find. In the Search for field, or Enter. enter the logical system PRODUCTION and choose Find

c)

Click on the system name to return to the system overview at the position of the corresponding entry: The logical system PRODUCTION is assigned the RFC destination for dialogs of the same name.

In the CORE system, call the status monitor and select the IDocs of the message type MATMAS that have been created since the start of the course. Use the function “Monitor IDocs” to determine the status of these IDocs in the receiving system PRODUCTION. Display one of the IDocs in the PRODUCTION system. a)


b)

Enter the message type MATMAS, the partner system PRODUCTION, and as the change date, the starting date of the course, and choose Execute .

c)

Select the entry (or one of the entries) underneath the message type and choose the Monitor IDocs button.

d)

Check the status of the IDoc(s): If the inbound processing was successful, you will find the status 53 beside the IDoc number.

e)

Double-click on the number of the inbound IDoc in the PRODUCTION system: You enter the display of the IDoc in the receiving system.


2005/Q4

Only

Internal

Call the transaction SALE and choose IDoc Interface / Application Link Enabling (ALE) → Communication → Determine RFC Destinations for Method Calls.

Partner

194

a)

SAP

2.

In the CORE system, check whether the PRODUCTION system is assigned an RFC destination for dialogs.

Use

Partner

1.

Internal

In the logical system CORE, display IDocs for the message type MATMAS and check whether they have been processed successfully in the logical system PRODUCTION. However, first check the assignment of an RFC destination for dialogs to the logical system PRODUCTION.

BIT300


Exercise 11: ALE Audit Exercise Objectives After completing this exercise, you will be able to: • Use the functions of the ALE Audit.

You want to be able to detect by the status value of an ALE scenario in the sending system whether the transfer of the data to the corresponding application in the receiving system was successful, or whether errors occurred.

1.

Send an IDoc with the status confirmations from the system PRODUCTION to the system CORE. Only send confirmations for IDocs for your reduced message type ZMATMAS##, namely, for all those created since the start of the course.

2.

Check the result of the confirmation in the status monitor of the CORE system and display one of the IDocs involved.

SAP

SAP

Test the ALE Audit using your Message Type ZMATMAS##.

Use

Partner

Task:

Internal

Only

Business Example

Only

Internal

Use

Partner

2005/Q4


195


BIT300

Solution 11: ALE Audit Task: Test the ALE Audit using your Message Type ZMATMAS##.

Partner SAP Use

Enter the Message Type ZMATMAS##. Also enter the start date of the course as the first change date and choose Execute . (You may also select all the IDocs if you want. The selection for the audit is not made until the next step.)

c)

In the menu of the status monitor, choose Goto → ALE Audit → Send Audit Confirmations.

d)

In the field Confirmations to system, enter CORE, in the field Message type, enter ZMATMAS##, and in the fields Date IDoc changed, enter the date on which the course started and today's date. Choose Execute. .

e)

Confirm the message regarding the generation of the Audit IDoc, go back to the initial screen of the status monitor and refresh the display by choosing Refresh IDoc Display : In the area of the IDoc outbound processing you will see an entry for the message type ALEAUD.

Check the result of the confirmation in the status monitor of the CORE system and display one of the IDocs involved. a)

In the system CORE, call the status monitor as described in step 3 a), enter the message type ZMATMAS##; and choose Execute . Your outbound IDocs for the message type ZMATMAS## now have different status values. If the processing was successful in the application in the PRODUCTION system, you will see the status 41, otherwise you see the status 39, which may also mean, however, that your IDoc has not been transferred to the application yet. If the outbound processing contained errors, the status is set to 40.

b)

Select the entry underneath the message type and choose the Display IDocs button.

c)

Select an IDoc and choose the Display IDocs button again. Open the folder of the status records in order to monitor the updating of the status values.


2005/Q4

Only

Internal

b)

Partner

In the PRODUCTION system, choose Tools → ALE → ALE Administration → Monitoring → IDoc Display → Status Monitor.

SAP

196

a)

Use

2.

Send an IDoc with the status confirmations from the system PRODUCTION to the system CORE. Only send confirmations for IDocs for your reduced message type ZMATMAS##, namely, for all those created since the start of the course.

Internal

Only

1.

BIT300


Lesson Summary You should now be able to: • Use the status monitor efficiently • Set up and use the ALE audit

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


197


BIT300

Lesson: Error Analysis and Handling Lesson Overview

Internal

Only

IDoc processing does not always work at once. Configuration errors in the ALE area and in the affected application itself can lead to errors in the IDoc generation or the further IDoc processing. This lesson will show you how to systematically analyze errors and then resolve them.

Lesson Objectives After completing this lesson, you will be able to: Perform error analysis using the ALE status monitor Resolve errors in the IDoc processing

Business Example

IDoc Outbound Processing

Use

Only

Internal

Partner

In the outbound processing, an IDoc goes through various phases, the results of which are represented by status values. Successful IDoc outbound processing involves three obligatory and three optional status values:

SAP

SAP

You have set up various ALE scenarios. An administrator is to take over the error handling in the future. You want to get an overview of the options for error analysis and error resolution.

Use

Partner

• •

198


2005/Q4

BIT300

Lesson: Error Analysis and Handling

Partner

SAP

• • •

Use

SAP

Only

Internal

Figure 107: Status Values for Error-Free IDoc Outbound Processing

01: IDoc created 30: IDoc is ready for sending (ALE service) 03: Data passed to port OK

Use Internal

If you have set up the ALE Audit, then there are also the following status values: • •

2005/Q4

39: IDoc in target system (ALE service) 41: Application document created in receiving system


199

Only

Status 03 only informs you that the IDoc data was successfully transferred to the port. You only find out whether the IDoc was actually received by the receiving system when you run the program RBDMOIND. This program, which is intended for regular background processing with jobs, checks whether there are still IDocs in the tRFC queue. All the IDocs no longer contained in this queue are given the status 12 (Sending OK).

Partner

Whether or not the sender system sends an IDoc at once depends on the specifications in the respective outbound partner profile. If the Group IDocs option is selected there, the IDocs are only transferred to the receiving port of the partner profile after the program RSEOUT00 is executed. Therefore, status 30 is always an intermediate status.


BIT300

For the ALE Audit, the program RBDSTATE must be executed in the receiving system. This program is also intended for regular background processing with jobs. Status 39 informs you in the sending system that an IDoc has been stored on the database in the receiving system, but that it has not been transferred to the application yet. Therefore, the IDoc can have the status 64 or 62 in the receiving system. Status 41, on the other hand, indicates an IDoc whose data has been successfully posted in the corresponding application of the receiving system (status 53).

Only

Use

Partner

Internal

If errors occur in the IDoc outbound processing, the sender system sets one of the following status values:

Partner

Use

SAP

SAP

Figure 108: Status Values for Incorrect IDoc Outbound Processing

Internal

02: 26: 25: 29:

Error transferring data to port Syntax error in IDoc (outbound) Further processing despite syntax error (outbound) Error in ALE service

Status 02 is set instead of status 03 if an error occurs during the transfer to the port. The sender system determines the transaction code EDIO and on the basis of the assigned workflow task, sends a workflow item to the agent responsible. After the error is resolved, the IDoc can be transferred to the port again from this work item or from the IDoc status monitor. Status 26 indicates that the IDoc is missing a segment which the IDoc basic type specifies is required, that there are more segments for a segment type than specified in the IDoc basic type, or that there is some other breach of the specifications of the IDoc basic type. If the indicator Terminate the processing if syntax error occurs is not set in

200


2005/Q4

Only

• • • •

BIT300


the outbound partner profile, the IDoc is still transferred to status 30 and processed further. However, if the indicator is set, the sender system determines the transaction code EDIX and sends a work item in accordance with the assigned workflow task. It is possible to trigger the further processing of the IDoc despite a syntax error. The IDoc first gets the status 25 and is then switched to status 02.

Only

In the inbound processing, an IDoc also goes through various phases, the results of which are represented by status values. Successful IDoc inbound processing involves four obligatory status values:

Use

Partner

IDoc Inbound Processing

Internal

If outbound partner profiles are competely missing or incomplete, the system gives the IDoc involved the status 29. This status is also assigned if a global company code or a business area is missing. If the IDoc is processed again after the missing settings are added, the system logs this as editing of the IDoc and creates a copy of the original, which is kept for documentation purposes, even in its incorrect form. The copy is given status 30 and the original gets status 33 (Original of an IDoc that has been edited).

SAP

SAP Only

Internal

Use

Partner

Figure 109: Status Values for Error-Free IDoc Inbound Processing

• • • •

2005/Q4

50: 64: 62: 53:

IDoc added IDoc is ready for transfer to the application IDoc transferred to application Application document posted


201


BIT300

Whether or not the receiving system transfers an IDoc to the application at once depends on the settings in the respective inbound partner profile. If the Start in background job option is selected there, the IDoc is only transferred to the application after the program RBDAPP01 is executed.

Only

Use

Partner

If errors occur in the IDoc inbound processing, the sender system sets one of the following status values:

Internal

Note: In scenarios such as this, the RFC user only requires the authorization to store IDocs on the database. Required are the RFC authorizations for the function groups EDIN and ERFC (authorization object S_RFC) and the authorization for the authorization object B_ALE_RECV with the desired message types. The user for the background processing of the program RBDAPP01 must have authorizations to read the IDoc from the database (authorization object S_IDOCMONI) and the application authorizations to post the data by means of the application program.

SAP

SAP Only

Internal

Use

Partner

202


2005/Q4

BIT300


Use

Partner

Only

Internal

Figure 110: Status Values for Incorrect IDoc Inbound Processing

SAP Use

Incorrect IDoc added Syntax error in IDoc (inbound) Further processing despite syntax error (inbound) Error in ALE service Application document not posted

Status 56 usually tells you that the inbound partner profile is missing for the message type.

Internal

If the transfer of the IDoc data to the corresponding application fails, then the IDoc is given status 51 in most cases. A number of logistical applications have their own status (52 and 54), but they all indicate an error in the processing of the IDoc data in the application program itself. Work items are sent to the responsible agents. Depending on the application, such an IDoc can also be processed “in the foregound”, meaning interactively. Missing or incorrect values can then be added or corrected manually.

2005/Q4


203

Only

If the indicator Terminate the processing if syntax error occurs is set in the inbound partner profile, an IDoc with a syntax error is given the status 60. The system sends the responsible agent a work item on the basis of the workflow task assigned to the process code EDIY. If the syntax check is not activated, then the incorrect IDoc is moved directly from status 60 to status 64. If an IDoc with a syntax error with status 60 is processed further, it is first given status 61 and then status 64. The system sets status 65 if a global company code or a business area is missing.

Partner

56: 60: 61: 65: 51:

SAP

• • • • •


BIT300

The end of this lesson you will find suggestions for systematic error analysis, with information on resolving errors.

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

204


2005/Q4

BIT300


Problem: The IDoc Was Not Created Prerequisites An ALE scenario has been configured. You know the message type of the scenario and the program with which the IDoc outbound processing is carried out. However, no IDoc has been created in the sending system.

Procedure

Only

Analyze the type of the outbound processing. Is the IDoc to be created by means of the message control? You can use transaction WE64 to find the message types for IDoc scenarios that were created using the message control.

Partner SAP Use

Has a change pointer been set for the change document whose data is to be distributed in an IDoc? If the master data has been changed since the last time IDocs were created from change pointers, there should be change documents as well as change pointers. You can view the change documents with the program RSSCD100. You can check the change pointers in the database table BDCPV. Has the program RBDMIDOC been started?


2005/Q4


205

Only

Internal

Master data distribution using the SMD tool

Partner

2.

SAP

If the IDoc is to be created using message control, then proceed with step 2. In a scenario in which change pointers are to be evaluated, you proceed with step 3. In all other cases, you can proceed directly to step 4.

Use

Is the scenario involved a master data distribution scenario, in which change pointers are to be evaluated? You can use transaction SALE to find message types for ALE scenarios that work with change pointers by choosing IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Replication of Modified Data. If you have created a reduced message type which is not in this list for a message type that is in this list, then you proceed as follows: Choose IDoc Interface / Application Link Enabling → Modelling and Implementing Business Processes → Master Data Distribution → Scope of Data for Distribution → Message Reduction → Create Reduced Message Type (transaction BD53). Select the reduced message type and choose the button Activate change pointers.

Internal

1.


BIT300

The program RBDMIDOC is usually scheduled as a regular background job. This program triggers the generation of IDocs from change pointers. Make sure that the correct message type is selected in the selection screen. Check whether the report was scheduled with the correct variant, and when it was last run. For test purposes, you can also start this program using transaction BD21. 3.

IDoc generation using message control Was the message determination and processing successful?

Only Partner SAP Use Internal

Has the program RSNAST00 been started?


206


2005/Q4

Only

Call the transaction WE20 or choose Tools → ALE → Runtime Settings → Partner Profiles. Search for the partner: In EDI scenarios, the partner must be created for partner type LI (vendor) or KU (customer), and in ALE scenarios for partner type LS (logical system). In EDI scenarios, always check the partner function too: Does it match the partner function of the determination record? Have outbound parameters been created for the respective message type? Is the required data entered in these parameters (application, message type, process code)?

Partner

Do corresponding partner profiles exist?

SAP

If the expected message was not found in the document, check the determination record (condition record) for the message type. It is possible that there is no corresponding determination record for the key combination in the document. If you are not familiar with the application involved, you can also search for determination records using transaction NACE. If the message was found, but not processed correctly, check the transmission medium and the transmission time. To generate IDocs, the transmission medium A (ALE) or 6 (EDI) must be entered in the determination record.

Use

Are the condition records maintained correctly?

Internal

The message determination is usually linked to an application document, such as a purchase order, an order or an invoice. Call up the document whose data should have been sent in IDoc format in the display or change mode and check the result of the message determination. In most documents, you can call up this information with the menu entries Goto or Extras. In purchasing documents, there is a separate button Messages. Check whether the message was found, and whether it was processed successfully (green traffic light symbol). Usually you can also call up a processing log for display from the details of the message determination.

BIT300


Often, the message is not immediately processed by the program RSNAST00, but at a later date by means of a background job or an application-specific transaction. The program triggers the generation of IDocs from messages in the message control. If the transmission time in the condition record is not 4, but 1,2 or 3, then the program RSNAST00 must be started in a separate step. 4.

Is the distribution model maintained correctly?

Only

The validity of model views is limited. If necessary, check whether your views can still be used at the present time. To do this, double-click the name of the model view. Are filters defined for the message by means of filter objects?

SAP Use Internal

2005/Q4


207

Only

In the distribution model, check whether a filter group is created in the view involved. If the indicator Dependent on class membership is set, then the filtering is performed by means of the classification. Then choose IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Master Data Distribution → Distribution Using Object Classes → Assign Classes to Receiving Logical System. If necessary, check in the master data to be distributed whether the view Classification is created, and whether it refers to the correct class.

Partner

Is the filtering performed by means of classification? Is the class in the sending system assigned to the logical system of the receiver? Is the master data to be distributed assigned to the distribution class?

SAP

Check the affected view in your distribution model. If filter objects are entered, then the values entered for the filter object must match the values transferred with the IDoc from the application. It is possible that the filter object refers to a required segment in the IDoc basic type. If the conditions for the field values are not fulfilled, no communication IDoc is created.

Use

Partner

Is the model view still valid?

Internal

Does the distribution model of the sending system contain a view with the required message type or BAPI? If your distribution model contains many views, you can also use the menu entry Edit → Filter Display or the button Filter model display to make a selection based on message type or business object type. If necessary, add the missing view or the missing message type or missing BAPI in the maintenance system and transport or distribute this view to the systems involved.


BIT300

Problem: The IDoc was Created, but was not Sent Prerequisites An ALE scenario has been configured. An IDoc has been created in the sending system, but it was not sent.

Procedure Outbound partner profile is missing (status 29): Use transaction WE20 to check whether the sending system has an outbound partner profile with the receiving system for the message type involved. If not, generate the missing partner profile from the corresponding view of the distribution model and check the settings or create the partner profile manually. IDoc remains in status 30:

SAP

3.

Error in the data transfer to the port (status 02):


2005/Q4

Use Internal

Only

208

Partner

In the control record of the IDoc, check which port it was sent through. Call up the IDoc for display. In the Technical short info area, the field Port provides you with the name of the port which was determined by means of the partner profile. Check the attributes of this port using transaction WE21. If the port has been configured incorrectly, you can correct this error here and send the IDoc again. If, on the other hand, an incorrect port is entered in the partner profile, then you correct the partner profile. In IDocs that have already been sent, you can manually change the value of the port in the control record. To do this, double-click the control record in the IDoc display and choose Control Record → Display -> Change. The change mode appears. Choose the Partner tab page and enter the correct port in the field Port. You can then resend the IDoc.

SAP

Use transaction WE20 to check in the sending system the outbound partner profile with the receiving system for the message type involved. If the output mode Group IDocs is selected there, the program RSEOUT00 must be executed first. Check whether this program is planned as a job for the background processing and whether the message type involved is scheduled in a variant. For test purposes you can start the report manually or select the IDoc in the monitor (transaction BD87) and trigger the sending by means of the button Execute.

Use

Partner

2.

Internal

Only

1.

BIT300


Problem: The IDoc was Successfully Sent, but it was not Received by the Receiving System Prerequisites An IDoc was sent to a receiving system through a tRFC port. The IDoc has the status 03 in the sending system, but it did not reach the receiving system. Report RBDMOIND does not result in a status change.

Only

From the IDoc display, you can use the object link to check whether a tRFC ID is entered. If such an ID exists, then the IDoc was transferred to the fRFC level. If a Display button appears, then the data packet is still in the tRFC queue. You can use this button to navigate directly into the tRFC queue (transaction SM58). Examine the error message for the corresponding entry in the fRFC queue.

SAP Use

Hint: You can check the general settings for the tRFC using transaction SM58. Choose Execute to go from the selection screen to the list and choose Information → System Setting to navigate to a dialog window with the desired information. You can use a local setting to override this system setting in every RFC destination. Navigate to the display of the RFC destination (for example, by means of transaction SM59). There, choose Destination → tRFC Options.

2005/Q4


209

Only

Internal

When you have resolved the error, you can manually trigger the processing in the tRFC queue: To do this, select the entry and choose Edit → Execute LUW. Depending on the settings, the RFC level starts this processing automatically after a few minutes.

Partner

2.

SAP

Hint: One cause could be authorization restrictions for the user entered in the RFC destination. The user could possibly be blocked because of multiple incorrect logons, or there may be an incorrect password stored in the RFC destination. Therefore, you must also check the RFC destination in the sending system and the authorizations of the user entered there in the receiving system. Note that usually the RFC destination and the RFC user are used by various programs. Changing the properties can therefore influence other ALE scenarios.

Use

Partner

1.

Internal

Procedure


BIT300

Problem: The IDoc was Received by the Receiving System, but was not Posted Prerequisites An IDoc was received by the receiving system, but it does not have status 53 yet.

Procedure Inbound partner profile is missing (status 56)

2.

IDoc remains in status 64 (the IDoc is ready to be transferred to the application):

SAP Use

IDoc is in status 51:

•

•

Incorrect process code in the partner profile: If the status text / error text is “No function module for inbound process code xy”, then there is an incorrect process code in the partner profile. Authorizations missing: Does the RFC user (for immediate processing) or the batch user (for background processing) have the required authorizations?

You can have incorrect IDocs with status 51 processed after the error is resolved by executing the program RBDMANI2 (Posting incorrect IDocs). This program can be scheduled as a background job. Continued on next page

210


2005/Q4

Only

Internal

Check whether there is more detailed information on the cause of the error in the long text of the error message for the status. In general, you require knowledge of the application for the error search. Two technical errors are often the cause of incorrect IDoc processing in the application:

Partner

3.

SAP

If the indicator Start through background program is set in the partner profile, then the IDoc is generally transferred to the application by the program RBDAPP01. Choose System → Services → Jobs → Job Overview, and in the field ABAP program name, enter RBDAPP01. Then choose the button Execute: You are told when and at what intervals the program has been scheduled as a background job. For testing purposes, you can start it manually or you can transfer the IDoc from the status monitor directly to the application. If the IDoc is always to be transferred to the application immediately, then you set the indicator Start immediately in the partner profile.

Use

Partner

If the status text states that the partner profile is missing, you add it manually or have it generated by the system from the distribution model. If necessary, you can determine from the control record of the incorrect IDoc which logical system was the sender.

Internal

Only

1.

BIT300


4.

No (active) partner profile exists (status 63): You have the option to set the partner profile for a partner to inactive. In the receiving system, check the partner profile with the sending system, by entering transaction WE20 and calling the partner profiles for display and choosing the tab page Classification on the header level. If the partner status is “I”, then the partner is inactive. You can change the value to A (active).

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


211


BIT300

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

212


2005/Q4

BIT300


Exercise 12: Error Analysis and Handling Exercise Objectives After completing this exercise, you will be able to: • Find the causes of errors in the IDoc processing • Correct these errors

Only

Task 1: Analysis of the IDoc Status Values

Use

The IDoc was not created.

2.

The IDoc was created, but was not sent.

3.

The IDoc was successfully sent, but it was not received by the receiving system.

Partner


2005/Q4


213

Only

Internal

1.

SAP

SAP

In the case of incorrect IDoc processing, you can analyze the status values of the IDoc involved to determine in which part of the process an error occurred. Which status values belong to which (error) situation?

Use

Partner

In the logical system CORE , you have created or changed master data and distributed it to the receiving systems PRODUCTION and SALES. The data transfer was not always successful. You check the situation in the status monitor and resolve the errors.

Internal

Business Example


4.

BIT300

The IDoc was received by the receiving system, but was not processed yet.

Only

2.

Send the changed material to the logical system PRODUCTION and display the outbound IDoc in the status monitor. What status does the outbound IDoc have? What status does the inbound IDoc have in the receiving system?

SAP

SAP

In the logical system CORE, add the division 99 to your material master MATALE-##.

Only

Internal

In the system PRODUCTION, call up and display the IDoc in the status monitor and find out the cause of the processing error. Make a note of the number of the IDoc: __________

Partner

Use

Hint: Use the function “Monitor IDocs” in the system CORE to gain information about the inbound processing in the system PRODUCTION. 3.

Use

1.

Internal

The IDoc inbound processing can fail because of discrepancies between the application-specific Customizing settings in the sending and receiving systems. The IDoc is given the status 51 (application document not posted). In this exercise you will learn how to postprocess an incorrect IDoc so that its data can be posted in the application.

Partner

Task 2: Postprocessing of an Incorrect IDoc


214


2005/Q4

BIT300


5.

Call the incorrect IDoc for display, switch to the change mode, and replace the value 99 in the field DIVISION with a value defined in the system PRODUCTION.

Only

What conclusion do you draw from the error message? What options do you have for solving the problem?

6.

Now try to transfer the IDoc to the application again. What happens? Check the status records of your IDoc.

Task 3: Setting a Deletion Flag for an IDoc

SAP Use

2.

In the system PRODUCTION, your IDoc has the status 51 again. Instead of editing it, you now set a deletion flag for the subsequent archiving.

Only

Internal

Send your changed material MATALE-## from the system CORE to the system PRODUCTION again and call up the status monitor there.

Partner

1.

SAP

In some cases, it is no longer possible, or is not desirable, to handle an error by correcting system settings or editing the IDoc. You want the IDoc to be archived unchanged. In such cases, you can flag the IDoc for deletion so that it can be archived at the next opportunity.

Use

Partner

Hint: In doing this, use the input help for the field DIVISION.

Internal

4.

2005/Q4


215


BIT300

Solution 12: Error Analysis and Handling Task 1: Analysis of the IDoc Status Values In the case of incorrect IDoc processing, you can analyze the status values of the IDoc involved to determine in which part of the process an error occurred. Which status values belong to which (error) situation? 1.

The IDoc was not created.

Only

2.

The IDoc was created, but was not sent.

3.

SAP

Answer: The IDoc has the status 03 (data passed to port OK) and also, if the program RBDMOIND was executed after it was sent, the status 12 (sending process OK). The IDoc was received by the receiving system, but was not processed yet.

SAP

4.

The IDoc was successfully sent, but it was not received by the receiving system.

Use

Partner

Answer: Both status 30 (IDoc is ready to be sent) and status 02 (Error in the data transfer to port) could apply here.

Internal

Answer: No status value: An IDoc only gets a status once it has been saved on the database.

Answer: If the ALE Audit is set up, the IDoc in the sending system has the status 39 (IDoc in target system). In the receiving system the IDoc has the status 64 (IDoc is ready for transfer to the application).

Only

Internal

Use

Partner


216


2005/Q4

BIT300


Task 2: Postprocessing of an Incorrect IDoc The IDoc inbound processing can fail because of discrepancies between the application-specific Customizing settings in the sending and receiving systems. The IDoc is given the status 51 (application document not posted). In this exercise you will learn how to postprocess an incorrect IDoc so that its data can be posted in the application.

Choose Logistics → Materials Management → Material Master → Material → Change → Immediately.

b)

Enter the material number MATALE-## and choose Enter.

c)

Select the view Basic data 1 and choose Enter.

d)

In the field Division, enter 99 and save the change.

Hint: Use the function “Monitor IDocs” in the system CORE to gain information about the inbound processing in the system PRODUCTION.

Internal

Choose Tools → ALE → Master Data Distribution → Cross-Application → Material → Send.

b)

Enter your material MATALE-##, your reduced message type ZMATMAS## and the logical system PRODUCTION and choose Execute .

c)


d)

Enter your message type ZMATMAS## and choose Execute has the status 03.

e)

Select the entry underneath the message type and choose the button Monitor IDocs: In the system PRODUCTION, the IDoc has the status 51.

: The IDoc


2005/Q4


217

Only

a)

Partner

Use

SAP

Send the changed material to the logical system PRODUCTION and display the outbound IDoc in the status monitor. What status does the outbound IDoc have? What status does the inbound IDoc have in the receiving system?

SAP

Partner

a)

Use

2.

In the logical system CORE, add the division 99 to your material master MATALE-##.

Internal

Only

1.


Partner


b)

Enter your message type ZMATMAS## and choose Execute

c)

Select the entry underneath the message type and choose the Display IDocs button.

d)

Select the IDoc and choose the button Display status long text: You will see that an application log has been written from which you can obtain more detailed information about the problem.

e)

Copy the number of the log and click on Execute.

f)

In the field Ext. number of the application log, enter this number and choose Execute .

g)

Double-click on the entry with the red traffic light (Problem Class: Very Important): You will see that the value 99 is not permitted for the field MARA-SPART (division). Leave the log and the display of the error long text.

.

What conclusion do you draw from the error message? What options do you have for solving the problem?

Use

Only

Internal

Partner

Answer: Division 99, which you entered in the material master in the sending system before the distribution, is not defined in the receiving system. Therefore, the Customizing settings of the two systems are inconsistent. Now you can either also define division 99 in the receiving system and have the IDoc processed again, or you can edit the IDoc and have a value defined in the receiving system for the field Division transferred to the application. In the exercise, you edit your IDoc.

SAP

SAP

a)

Use

4.

In the system PRODUCTION, call up and display the IDoc in the status monitor and find out the cause of the processing error. Make a note of the number of the IDoc: __________

Internal

Only

3.

BIT300


218


2005/Q4

BIT300


5.

Call the incorrect IDoc for display, switch to the change mode, and replace the value 99 in the field DIVISION with a value defined in the system PRODUCTION.

Partner SAP

Open the tab page Data records and double-click on the symbol to the left of the segment E1MARAM.

c)

Choose Display Data Record -> Change and confirm the information that your changes have been saved in the database with Enter.

d)

Navigate to the field DIVISION and call up the input help. Use a double-click to accept one of the entries in the list of permitted values. Save this change, leave the data record editor, and then leave the IDoc display.

Now try to transfer the IDoc to the application again. What happens? Check the status records of your IDoc. : The

Go back to the status monitor and choose Refresh IDoc display system sets the status 69 (IDoc has been edited).

b)

Select the entry for your edited IDoc and choose the button Process: The status of the IDoc has been changed from 69 to 53.

c)

Choose the button Display IDoc again and open the folder Status records: You see that after the editing, your IDoc has been reset to status 51 and then transferred to the application again.

d)

Go from the IDoc display back to the status monitor: The system has created a second IDoc and assigned to it the status 70 (original of an IDoc that has been edited). The long text is: “This IDoc has been stored as the original of an edited document.” Thus, the system keeps a copy of the incorrect IDoc as it was before the editing.

e)

Call up the edited IDoc for display again, open the folder of the status records and double-click on the symbol to the left of the status long text for the status 69: You will see which user edited this IDoc in which segment, and which number the copy with the original data has.

f)

Leave the IDoc display, select your IDoc and choose the button Display relationships: A screen appears with the two IDoc numbers.


2005/Q4


219

Only

a)

Partner

Use

b)

SAP

Internal

Choose the button Display IDocs.

Use

6.

a)

Internal

Only

Hint: In doing this, use the input help for the field DIVISION.


BIT300

Task 3: Setting a Deletion Flag for an IDoc In some cases, it is no longer possible, or is not desirable, to handle an error by correcting system settings or editing the IDoc. You want the IDoc to be archived unchanged. In such cases, you can flag the IDoc for deletion so that it can be archived at the next opportunity.

Proceed in the way described in the second task in step 2, in order to distribute your material MATALE-##.

b)

Find the incorrect IDoc in the system PRODUCTION in the status monitor (see step 3): It has the status 51 again.

In the system PRODUCTION, your IDoc has the status 51 again. Instead of editing it, you now set a deletion flag for the subsequent archiving. a)

Select your IDoc in the status monitor and choose Edit → Restrict and process.

b)

Remove the indicator Background proc. and choose Execute

c)

Choose the button Deletion flag and confirm the confirmation prompt with Enter: A message appears that your IDoc has been flagged for deletion.

d)

Check the result in the status monitor: The IDoc now has the status 68 (error, no further processing).

.

SAP

SAP

a)

Use

Partner

2.

Send your changed material MATALE-## from the system CORE to the system PRODUCTION again and call up the status monitor there.

Internal

Only

1.

Only

Internal

Use

Partner

220


2005/Q4

BIT300


Lesson Summary You should now be able to: • Perform error analysis using the ALE status monitor • Resolve errors in the IDoc processing

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


221


BIT300

Lesson: SAP Workflow in ALE Environment Lesson Overview In this lesson you learn how to use the SAP Workflow for IDoc inbound processing, error handling and active monitoring.

Lesson Objectives

Only

Check workflow settings for the error handling of IDocs Understand the settings for process codes Describe the notification concept Monitor the IDoc processing using the SAP Workflow

Business Example

SAP

Using the SAP Workflow in ALE Scenarios

Use Internal

IDoc Inbound Processing Using SAP Workflow A process code for the IDoc inbound processing can refer to a task or a workflow.

222


2005/Q4

Only

In ALE scenarios, you can use the functions of the SAP Workflow for the IDoc inbound processing, as an alternative to inbound function modules, for monitoring the inbound and outbound IDocs during ongoing operation, and for processing incorrect IDocs.

Partner

The SAP Workflow is a tool for the automation of business processes within an SAP system, but also beyond system boundaries. It is not connected to specific applications, but functions independently in all applications. The primary aim is to provide the correct agent with a task at the correct time.

SAP

You have configured ALE scenarios in your system landscape. If errors occur, an administrator or an employee of the business department should be informed by means of the SAP Workflow.

Use

Partner

• • • •

Internal


Lesson: SAP Workflow in ALE Environment

Internal

Figure 111: IDoc Inbound Processing Using Workflow

For the inbound IDoc, a workflow can be started by means of a process code. You can define such a workflow freely and assign it to the desired process code. Examples of the use of such workflows are:

SAP

You will find an example of a workflow-based IDoc inbound processing in the ALE scenario “Stock Transfer Between Distributed Systems”. For the usual inbound processing of IDocs with purchase order data, the specified process code is ORDE, to which a function module is assigned for the transfer of data to the application. In certain cases, however, the order is not to be created automatically in the receiving system, but rather by a business department employee, only after the puchase order data has been checked. Such cases use the process code ORDE_BY_WORKFLOW, which refers to a workflow and not to a function module. In this way, the IDoc inbound processing can be performed interactively. The employee can not only check the data, but can also make changes.

2005/Q4


223

Only

Internal

• • •

Partner

Use

•

You want to generate an application document automatically from the IDoc. Subsequently, the application document is to be passed to an employee for checking. The IDoc is to be checked and, if necessary, changed before the application document is created. In this case, the IDoc is edited, not the application document. The IDoc or the application document is to be forwarded to one or more agents. New (outbound) IDocs are to be sent on the basis of the inbound IDoc. The receipt of an IDoc is to trigger some other action.

SAP

•

Use

Partner

Only

BIT300


BIT300

IDoc Monitoring with Workflow Connection

Only

Error Handling with SAP Workflow

SAP

SAP

The exception and error handling in the ALE environment is always realized through a workflow. In the case of an exception, one or more agents are informed of the error situation by means of a work item, and they are provided with the IDoc involved.

Use

Partner

You can use the program RSEIDOCA to perform the active monitoring. For this purpose, you must define a variant (menu path: Tools → ALE → ALE Administration → Services → Periodic Processing → Schedule IDoc Monitoring with Workflow Connection).

Internal

The active monitoring of inbound and outbound IDocs is usually scheduled as a periodic background job. The monitoring evaluates whether the number of IDocs with a particular status exceeds a previously defined threshold value. During the selection run, the IDocs that fulfill the selection criteria are evaluated. If the currect status value of an IDoc corresponds to the status in the selection screen, this IDoc is evaluated as critical. If the number of critical IDocs exceeds the threshold value entered, then this situation is evaluated as critical and a status confirmation is triggered automatically. The task “ActiveIDocMonitoring” (TS4508518) is started and a work item is sent to the recipient that is determined.

Only

Internal

Use

Partner

Figure 112: Error Handling with Workflow

The respective agents responsible are entered in the partner profiles or the settings for the IDoc administration, and the general potential agents are entered in the task definition. If an organization model is maintained in your company, along with users you can also assign positions or organization units as agents (see below).

224


2005/Q4

BIT300


Behind the exception handling cases of the IDoc interface that are delivered by SAP, there are individual tasks. They are started by means of the process codes of the error handling. These process codes are subdivided into system and status process codes. If you set the express indicator in the detailed settings of a process code, the agents of the corresponding task immediately receive an express message on their screens when there is a new work item in their inbox. The figure below shows the exception handling in the IDoc outbound processing:

Use

Partner

Only

Internal Partner

Use

SAP

SAP Only

Internal

Figure 113: Process Codes for Errors in the Outbound IDoc

2005/Q4


225


• • •

Only SAP Use

Only

Internal

The inbound exception handling corresponds to the outbound exception handling. Corresponding process codes are used to start tasks for which a work item is sent to the agents that are determined.

Partner

You can define additional exception handling cases for the status confirmation and identify them using process codes.

SAP

Hint: The process code EDIR is new to SAP R/3 4.6A. It replaces the process code EDIS. During an upgrade, you must explicitly perform the change to EDIR in IMG.

Use

Partner

•

The process code EDIM applies to outbound and inbound processing. It applies when it has not been possible to create an IDoc yet. EDIN is used for outbound processing by means of message control: You can use the NAST record to branch to the application document from the work item. EDIO reacts to an outbound IDoc for which a general processing error has occurred. EDIX reacts to an outbound IDoc for which a syntax error has occurred. EDIP reacts to an IDoc stack (batch run of the report RSEOUT00) for which a processing error has occurred which affects all the IDocs to the same degree (example: a non-existant port). The work item sent when the corresponding task is started allows you to correct the error and trigger the processing of the IDoc stack again. If an error status is confirmed by the external system, then a task for the error handling is also started by means of the status process code EDIS. With the status process code EDIR you can also trigger the outbound processing again after you have corrected the error.

Internal

• •

BIT300

226


2005/Q4


Internal

Figure 114: Process Codes for Errors in the Inbound IDoc

•

Note: The tasks supplied by SAP for errors during posting in the application usually have the name suffix “error” - for example, MATMAS_error or ORDERS_error. For IDocs created by BAPI calls, in the case of an error, the task IDOC_APPL_Er (TS20000051) provided by SAP is used. This task is also started by an event. All selected agents now receive the notification as a work item (as a concrete "instance" of the workflow task) in their integrated inbox. "Repairs", and therefore further processing of the work item with errors, are only possible from this inbox.

2005/Q4


227

Only

Internal

If errors occur while the application documents are being posted (for example, because Customizing settings are not synchronous), a different technique is used for the error handling. Instead of the relatively rigid reaction by means of process codes, the application uses the more flexible event concept. In the case of an exception, an event is triggered which can start 1 to n tasks and send corresponding work items.

Partner

Use

•

SAP

SAP

• •

As in the outbound processing, the process code EDIM applies when it has not been possible to create an IDoc. EDII and EDIY correspond to the outbound process codes EDIO and EDIX. You can use the IDoc type TXTRAW01 to send messages of your choice in text format. This technique is used, for example, if an exception has occurred in the external system and the SAP system is to be informed of this exception. If it was not possible to read a status file of the external system, the process code EDIL becomes active. In the exception handling, the error message of the SAP system is displayed.

Use

Partner

Only

BIT300


BIT300

Authorization Concept In the case of an exception, a task is started by means of a process code. A work item is created as an instance of this task. In order to determine the correct agent for the work item, the system requires two quantities of agents, the “potential” and the “permitted” agents. The intersection of these quantities filters out the recipients of the work item.

Use

Partner

Only

Internal


2005/Q4

SAP Use Internal

Only

228

Partner

In every partner profile for ALE or EDI scenarios, you must assign the partner a permitted agent for the error and exception handling. You can also enter for each message type a permitted agent that differs from this higher-level agent. In the case of an error (for example, an inbound IDoc with a syntax error), the system first tries to determine an agent for the combination of partner and message type. If no specific agent exists for the message type which contains the error, then the agent assigned to the partner is notified. If there are no partner profiles with the partner, the system then tries to determine the IDoc administrator. Therefore, for situations in which the system cannot find any partner profiles, you should nominate an agent in the general settings for the IDoc administration, so that an employee will be notified if an error occurs. For this purpose, call transaction SALE and choose IDoc Interface / Application Link Enabling (ALE) → Basic Settings → IDoc Administration.

SAP

Figure 115: Determining the Work Item Agents

BIT300


SAP Use Internal

Maintenance of an Organizational Structure In the automatic Workflow Customizing (transaction SWU3), the workflows for IDoc processing supplied by SAP which are located in the task group TG74500044, are declared to be “general”. They can thus be processed by all users. The restriction to the relevant agents for IDoc errors is effected by an intersection with the permitted agents for the IDoc interface (see above).

2005/Q4


229

Only

You can enter users or elements of the organizational management, such as positions or organization units, as permitted agents. The use of elements of the organization management increases the flexibility for organizational changes.

Partner

The tasks of the IDoc error handling are classified as general tasks in SAP R/3 or SAP ECC, in the Workflow Customizing (transaction SWU3). With this setting, every user is a potential agent, and all the permitted agents receive the work item. If there are a number of recipients for a work item, as soon as the first agent accesses it, the work item is deleted from the inboxes of the other recipients.

SAP

When a task is started, a rule entered for the task is used to determine the group of potential agents, on the basis of the task definition. Then the system determines the intersection of the potential and permitted agents on the basis of the partner profiles and the IDoc Administration. All the permitted agents receive the work item for the task. The work item is put into the inbox of the recipient's SAP Business Workplace. The item provides him with direct access to the incorrect IDoc, and he can begin the error processing immediately.

Use

Partner

Only

Internal

Figure 116: Agent Search in the ALE Environment


BIT300

Use

Partner

Only

Internal

Figure 117: Organizational Structure

SAP Use Internal

230


2005/Q4

Only

In the simple maintenance, you create the hierarchical structure of your organizational model, starting with the root organizational unit. In a further step, you create the required positions and assign them to the desired organizational units. In the last step, you assign users to the positions as position holders.

Partner

Note: The use of such organizational models is independent of the use of the application mySAP ERP Human Capital Management. The basic system provides everyone with the required tool (simple maintenance of the organizational management – transactions PPOC, PPOM, PPOS).

SAP

If you use elements of an organizational model to define the permitted agents, you can, for example, assign a whole group of agents to the respective level by entering a correspondingly occupied organization unit or position. You can also switch to the organizational responsibility centrally in the maintenance of the organizational model, by means of a simple reassignment. This saves you the effort of searching all the levels of the IDoc interface.

BIT300


Processing Work Items in the SAP Business Workplace The SAP Business Workplace integrates workflow functions into general office functions. There, along with work items, you also receive mails, documents and deadline messages. The agents receive the work items intended for them in the inbox of their Business Workplace. You reach the Business Workplace through transaction SBWP.

SAP

SAP

Use

Partner

Only

Internal

Figure 118: SAP Business Workplace

Use

Tools of the Workflow Administration When you are working with workflow support, you can also use tools of the workflow administration if required - for example, if a work item has an incorrect status and you want to restart the workflow after removing the cause of the error, or if a workitem has no recipient and the administrator who finds it is to process it himself or forward it to the actual person responsible. You may also want to search directly for work items whose deadline has been exceeded.

2005/Q4


231

Only

Internal

If an express indicator is set in the settings for the process codes, then the recipients of the work items receive an express notification, no matter where they currently are in the SAP system. From the express notification, they can then navigate directly to their Business Workplace and react quickly.

Partner

From there, you choose the folder Inbound and the area Workflow to go to the worklist display. You will see all the active work items. You double-click to start the execution of the selected work item. If one of the recipients has called up the work item for processing in this way, it is deleted from the inboxes of the other recipients.


BIT300

Work items that were created within the IDoc exception handling are critical. Therefore, you require tools in order to quickly detect and resolve technical or organizational errors. The most widely-used tools are the following transactions: • •

•

Use

Partner

The transactions listed are for finding work items for specific tasks, thus enabling you to find IDoc-relevant work items. You can then branch from the work item found to the IDoc display.

Internal

Only

•

Transaction SWI1 (selection report for work items) for finding incorrect work items Transaction SWPR (workflow restart after error) for the restart of an incorrect work item after the error has been resolved Transaction SWI2_DEAD (work items with exceeded deadline) for finding work items with exceeded deadlines Transaction SWI2_ADM1 (work items without agent) for finding work items with no recipient

SAP

SAP Only

Internal

Use

Partner

232


2005/Q4

BIT300


Exercise 13: Processing an Incorrect IDoc from a Work Item Exercise Objectives

Business Example

Task:

SAP Use

2.

Send the master record of the vendor T-K515D## from the system CORE to the system PRODUCTION. Check the inbound IDoc in the status monitor of the receiving system. What status does it have? Make a note of the number of the IDoc: ________________ Hint: Use the message type ZCREMAS##.

2005/Q4

3.

Check in the system PRODUCTION whether your inbox in the SAP Business Workplace contains a work item for this IDoc. Display the IDoc from the attachment of the work item, determine the cause of the error, and add the missing settings.

4.

Then try to start the processing of the IDoc again. What status does the IDoc have now?


233

Only

Internal

In the logical system CORE, in your model view TRAINING##, add an entry for the message type ZCREMAS##. The sender is the logical system CORE, and the receiver is PRODUCTION. Generate the outbound partner profiles for this message type and distribute your model view again to the system PRODUCTION.

Partner

1.

SAP

Transfer the message type ZCREMAS## into your model view TRAINING##, generate the outbound partner profiles with the partner system PRODUCTION and distribute the model view again. Then send a vendor master and check the inbound IDoc. Find the corresponding work item and remove the error by means of the work item processing.

Use

Partner

You have configured ALE scenarios in your system landscape. If errors occur, an administrator or an employee of the business department should be quickly informed by means of a workflow.

Internal

Only

After completing this exercise, you will be able to: • Process an incorrect IDoc from a work item


BIT300

Solution 13: Processing an Incorrect IDoc from a Work Item Task:

Only

c)

Enter the message type ZCREMAS## and choose Enter. Save your changes.

Use

d)

Select your model view TRAINING##, and in the menu of the distribution model, choose Environment → Generate Partner Profile and in the next screen, choose Execute : Outbound parameters are created for the message type ZCREMAS##. Leave the log display.

e)

Select your model view TRAINING## and in the menu of the distribution model, choose Edit → Model View → Distribute. Deselect the entry for the logical system SALES and choose Enter.

SAP

Switch to the change mode (Switching between display and change mode ) and in your model view TRAINING## select the entry for the receiving system PRODUCTION and choose the button Add message type.


234


2005/Q4

Only

b)

Partner

Call the transaction SALE and choose IDoc Interface / Application Link Enabling (ALE) → Modelling and Implementing Business Processes → Maintain Distribution Model and Distribute Views.

SAP

a)

Internal

In the logical system CORE, in your model view TRAINING##, add an entry for the message type ZCREMAS##. The sender is the logical system CORE, and the receiver is PRODUCTION. Generate the outbound partner profiles for this message type and distribute your model view again to the system PRODUCTION.

Use

Partner

1.

Internal

Transfer the message type ZCREMAS## into your model view TRAINING##, generate the outbound partner profiles with the partner system PRODUCTION and distribute the model view again. Then send a vendor master and check the inbound IDoc. Find the corresponding work item and remove the error by means of the work item processing.

BIT300


2.

Send the master record of the vendor T-K515D## from the system CORE to the system PRODUCTION. Check the inbound IDoc in the status monitor of the receiving system. What status does it have? Make a note of the number of the IDoc: ________________

Partner SAP

b)

In the field Account number of the vendor, enter T-K515D##, in the field Message type, enter ZCREMAS## and in the field Target system, enter PRODUCTION and choose Execute . A master IDoc and a communication IDoc are created.

c)

In the PRODUCTION system, choose Tools → ALE → ALE Administration → Monitoring → IDoc Display → Status Monitor.

d)

Enter your message type ZCREMAS## and choose Execute has the status 03 (incorrect IDoc added).

e)

Select the entry and click on the Display IDocs button. Make a note of the number of the IDoc.

: Your IDoc

SAP

Choose Tools → ALE → Master Data Distribution → Cross-Application → Vendor → Send.

Use

a)

Internal

Only

Hint: Use the message type ZCREMAS##.

Only

Internal

Use

Partner


2005/Q4


235


Partner SAP Use

b)

Choose Inbox → Workflow → Grouped according to content. Search the list for your IDoc from step 2 e) and select it so that your work item appears in the detail window on the right half of the screen.

c)

Choose Execute , and in the next screen (the status display of the IDoc) choose the button IDoc display.

d)

Open the folder Status records and double-click on the symbol beside the status long text (EDI: Inbound partner profile does not exist).

e)

The error analysis tells you that the inbound partner profiles with the partner PRODUCTION are missing for the message type ZCREMAS##. Click on the text “Execute function”.

f)

The system takes you to the transaction for maintaining partner profiles. Select the system CORE in the folder of the partner type LS, and in the inbound parameter area, choose Create inbound parameter .

g)

Enter the message type ZCREMAS## and the process code CRE1 and save the change. Leave the maintenance of the partner profiles, close the display of the status long text and leave the IDoc display.

Then try to start the processing of the IDoc again. What status does the IDoc have now? In the status record display, choose the button Process: A message tells you that your IDoc was processed successfully.

b)

Confirm the message with Enter and choose Refresh has been deleted from your inbox.

c)

Call up the status monitor again. You will find a description of the procedure in step 2 c). If your status monitor was still open in another mode, choose Refresh IDoc display : The IDoc now has the status 53 (application document posted).


: The work item

2005/Q4

Only

a)

Partner

Internal

Choose Menu → Business Workplace.

SAP

236

a)

Use

4.

Check in the system PRODUCTION whether your inbox in the SAP Business Workplace contains a work item for this IDoc. Display the IDoc from the attachment of the work item, determine the cause of the error, and add the missing settings.

Internal

Only

3.

BIT300

BIT300


Lesson Summary You should now be able to: • Check workflow settings for the error handling of IDocs • Understand the settings for process codes • Describe the notification concept • Monitor the IDoc processing using the SAP Workflow

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


237


BIT300

Lesson: Archiving IDocs Lesson Overview This lesson shows you how to archive IDocs using transaction SARA, and the options for displaying archived IDocs. Additional reorganization options in the IDoc environment are also shown.

Only

Internal


Partner

• •

Describe the IDoc archiving procedure Set the archivable statuses in the system

You have set up various ALE scenarios and want to archive the IDocs that have been processed successfully. You also want to delete from the database table entries for IDoc connections and processed change pointers.

Use

Archiving IDocs

SAP

SAP

Business Example

Use

Only

Internal

Partner

IDocs cannot be directly deleted from the database, but only within the data archiving process. The data archiving takes place in two steps: Firstly, archive files are written for the IDocs selected for archiving, then the corresponding database entries are deleted.

238


2005/Q4

Lesson: Archiving IDocs

Internal

Partner

Only

BIT300

The archiving is realized by means of an archiving object, which provides all the functions required for archiving a business object, especially the necessary write and delete programs. The archiving object for archiving IDocs is called IDOC.

Use

After setting the desired Customizing options, you can use transaction SARA to start the data archiving with the archiving object IDOC by creating a variant of the write program with the desired selection values, maintaining the start data and the spool parameters, and starting the execution.

SAP

SAP

Figure 119: Archiving IDocs - First Step: Writing Archive Files

Use

Only

Internal

Partner

Depending on the Customizing setting, the second step of the data archiving - the deletion of the corresponding database entries - is either carried out automatically directly after the write run, or it is started manually with transaction SARA.

2005/Q4


239

BIT300

SAP Use

Archivability Criterion: IDoc Status The IDoc status is the only archivability criterion which the write program checks for the archiving object IDOC. You can use transaction WE47 to display the IDoc statuses which are indicated as archivable.

240


2005/Q4

Only

Internal

Note: In an SAP R/3 or SAP ECC system you will find the archive information structure SAP_IDOC_001 for this purpose. However, you can also create user-defined archive information structures on the basis of the field catalog of the same name.

Partner

You can display the archived IDocs with transaction WE09. However, you can also call them up for display with the archive information system (transaction SARI). A prerequisite for this is that an active archive information structure must exist, which you have filled either implicitly with the deletion run, or explicitly with transaction SARI.

SAP

In the selection for the deletion run, you can only choose archive files that have already been written. This ensures that no data is deleted from the database for which no archive files exist yet. You also maintain the start date and spool parameters and start the execution here. From transaction SARA you can navigate directly to the job overview and view the log for the respective run there. The actual archiving is complete when the delete run is finished.

Use

Partner

Figure 120: Archiving IDocs - Second Step: Deleting IDocs from the Database

Internal

Only



Internal

Figure 121: Status Maintenance - Archiving

The following two figures provide you with an overview of the standard settings for archivable IDocs in outbound as well as inbound processing.

Use

Partner

Only

BIT300

SAP

SAP Only

Internal

Use

Partner

Figure 122: Archivable Status Values in Outbound Processing

2005/Q4


241


BIT300

You can determine the meanings of the individual statuses directly in transaction WE47 in the detailed view of the status, or in transaction BD87 in the input help for the field Status.

Data passed to port OK

12

Dispatch OK

31

Error, no further processing

39

IDoc in receiving system (ALE service)

40

Application document not created in target system

41

Application document created in target system

It is sometimes necessary to change these standard settings, for example if you set ALE audit for all message types, and status 03 is therefore not a final status value. If an error occurs that cannot (or should not) be corrected, you can transfer the IDocs from any status with errors to status 31 (error - no further processing) and then archive it.

SAP

SAP

To transfer an incorrect IDoc to status 31, proceed as follows: In transaction BD87, select the entry with the incorrect IDoc. Choose Edit → Restrict and process, remove the indicator Background processing and in the next screen choose the button Delete flag and confirm the confirmation prompt with Enter.

Use

Partner

03

Internal

Only

The following status values are indicated as archivable in outbound processing:

Only

Internal

Use

Partner

242


2005/Q4

BIT300


Use

Partner

Only

Internal

Figure 123: Archivable Status Values in Inbound Processing

Application document posted

68

Error, no further processing

Deleting Links with IDocs

As the number of IDocs increases, it is not only the table of data records that gets big. The tables in which the links are updated also increase in size, so that obsolete entries should be deleted from them from time to time. Since SAP R/3 4.6B, the program RSDLDREL has been available. You can use this program to delete application links stored in the table IDOCREL. In contrast to the archiving process, this results in them being lost forever. Since SAP Web Application Server 6.20, it is possible to archive the links as well when archiving IDocs. Since SAP Web Application Server 6.40, the links are archived automatically along with the IDocs. If you no longer need the links, you can still delete this data with the program RSRLDREL before archiving.

2005/Q4


243

Only

Internal

There may be links between IDocs and other objects. In the status monitor (transaction BD87), you can display these link relationships. For example, an outbound IDoc can be linked to an inbound IDoc, an edited IDoc or an application document.

Partner

Use

53

SAP

SAP

The following status values are indicated as archivable in inbound processing:


BIT300

Reorganizing Change Pointers If you are using the change pointer mechanism to create large numbers of IDocs, you fill the corresponding database tables. Because change pointers are obsolete after they are processed, you should regularly delete the table entries that are no longer required. The program RBDCPCLR is provided for this purpose. You can call this program using transaction BD22. It deletes change pointer entries from the database tables.

Only

Use

Partner

Internal

You can select obsolete and/or processed change pointers. It is also possible to make a selection based on the date and time. You can display in advance a list of the change pointer entries selected in the test mode. Obsolete change pointers are those created before the date and time specified by you in the selection screen. The change pointers you have selected as obsolete are deleted, whether or not they have already been processed. Processed change pointers are those processed before the date and time specified by you in the selection screen. Therefore, only the change pointers already processed are deleted.

SAP

SAP Only

Internal

Use

Partner

244


2005/Q4

BIT300


Lesson Summary You should now be able to: • Describe the IDoc archiving procedure • Set the archivable statuses in the system

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


245

Unit Summary

BIT300

Unit Summary

Only

Use

Partner

Internal

You should now be able to: • Use the status monitor efficiently • Set up and use the ALE audit • Perform error analysis using the ALE status monitor • Resolve errors in the IDoc processing • Check workflow settings for the error handling of IDocs • Understand the settings for process codes • Describe the notification concept • Monitor the IDoc processing using the SAP Workflow • Describe the IDoc archiving procedure • Set the archivable statuses in the system

SAP

SAP Only

Internal

Use

Partner

246


2005/Q4


Unit Objectives After completing this unit, you will be able to: Explain the correct procedure for changing logical system names Describe the IDoc recovery procedure and the settings required for this function

Unit Contents

Use

Only

Internal

Partner

Lesson: Renaming Logical Systems ............................................. 248 Lesson: IDoc Recovery Following Database Error ............................. 254

SAP

SAP

• •

Use

Partner

In this appendix, you will find information about renaming logical systems and about courses of action for identifying and resending lost IDocs after a database breakdown.

Internal

Only

Appendix

2005/Q4


247

Unit 6: Appendix

BIT300

Lesson: Renaming Logical Systems Lesson Overview This lesson explains why it is problematic to rename logical systems and how logical system names can be changed, if required.

Lesson Objectives

Only

•

Explain the correct procedure for changing logical system names

When setting up an SAP system, you used a name that no longer complies with your current naming conventions. So you want to check whether it is possible to change the logical system name now, and which is the best procedure to follow.

Renaming Logical Systems

SAP

SAP

Logical systems have a technical name up to 10 characters long and an explanatory short text. The definition of logical systems is a Customizing activity of ALE. Since SAP R/3 4.5A, certain applications require the assignment of a logical system name to the client.

Use

Partner

Business Example

Internal


Only

Internal

Use

Partner

248


2005/Q4

BIT300

Lesson: Renaming Logical Systems

Use

Partner

Only

Internal

Figure 124: Logical Systems

SAP Use

Only

Internal

ALE provides a tool for renaming logical systems in application tables, the transaction BDLS.

Partner

If the logical system name of a client is changed, the modeling of the ALE message flow may become inconsistent. Application documents created before the logical system name was changed are classified as external documents after the change, and can therefore often no longer be found.

SAP

Application documents in which the field Logical system has remained empty, or which are saved with the current logical system name of your client, are interpreted as local documents by the client.

2005/Q4


249

Unit 6: Appendix

BIT300

SAP Use

Only

Internal

Partner

Caution: You are strongly advised against changing the names of logical systems in production systems, since this may lead to data losses and data inconsistency.

SAP

Client and database copies are often used to set up a development and test landscape. If users are managed centrally, the participating logical systems must have unique names. Within an independent SAP system, any logical system names can be assigned.

Use

Partner

Only

Internal

Figure 125: Conversion of Logical System Names

250


2005/Q4

BIT300


Use

Partner

Only

Internal

Figure 126: What is the Problem?

SAP

SAP Only

Internal

Use

Partner

Figure 127: How Are Logical System Names Changed?

2005/Q4


251

Unit 6: Appendix

BIT300

For information on changing the logical system name of a client, see the SAP library or go to the Customizing in ALE and choose IDoc Interface / Application Link Enabling (ALE) → Basic Settings → Logical Systems → Convert Logical System Names in Application Tables. Note: An appropriate authorization is required for the execution of the program (authorization object B_ALE_LSYS).

Only

Use

Partner

Internal

You are advised to start the conversion in test mode. If you set the indicator Test run, all relevant tables will be analyzed and the number of entries contained in the tables will be determined. These will then be output in a list. If the new logical system name is already available in the relevant tables, the system queries whether the conversion is to be continued or not. You must check the table in which this logical system name was found and determine whether you want to perform the conversion for these entries. If you do not want to convert these entries, cancel the conversion.

SAP

SAP Only

Internal

Use

Partner

Figure 128: Conversion - Points to Observe

252


2005/Q4

BIT300


Lesson Summary You should now be able to: • Explain the correct procedure for changing logical system names

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


253

Unit 6: Appendix

BIT300

Lesson: IDoc Recovery Following Database Error Lesson Overview This lesson tells you when and how to use the functions for IDoc recovery.

Lesson Objectives •

Describe the IDoc recovery procedure and the settings required for this function

Business Example

Use

Partner

During an IDoc transfer, the database of the receiving system crashed. You want to use the IDoc recovery to restart the transfer of all the IDocs which could not be saved on the database of the receiving system.

Internal

Only


IDoc Recovery Following Database Error

SAP

SAP Only

Internal

Use

Partner

Figure 129: IDoc Recovery Following Database Error

254


2005/Q4

BIT300

Lesson: IDoc Recovery Following Database Error

The IDoc recovery uses two transactions: • •

Transaction BDRC for determining the recovery objects Transaction BDRL for processing the recovery objects

SAP

SAP

Use

Partner

Only

Internal

Figure 130: IDoc Recovery - Procedure I

Use

S1 sends RCYFET to S2 S1 sends RCYLST to S2 The model view created in the system S1 is distributed to the system S2. The partner profiles are generated in both systems. The transaction is started in system S1. The participating system S2 is chosen. The system settings in S1 and S2 are checked. If the check ran successfully, the recovery objects are determined (F8). Finally, the system reports that 1 IDoc has been set up for the message type RCYFET. As soon as the IDocs for the message types RCYFET, RCYRSP and RCYLST have been successfully posted in both systems S1 and S2, the next step of “processing recovery objects” can be started.

2005/Q4


255

Only

Internal

S1 receives RCYRSP from S2

Partner

Before the transaction is started, the following entries are added to the distribution model in a model view: (S1 is the system affected by the database crash.)

Unit 6: Appendix

BIT300

We recommend using the ALE audit technology for message type RCYFET from the partner system in order to inform the recovered system that the activity was performed in this partner system.

SAP

SAP

Use

Partner

Only

Internal

Figure 131: IDoc Recovery - Procedure II

Use

Only

Internal

The IDocs that are missing in this system and the further activities that are to be carried out are determined in the reset system. This information is sent to the partner systems in IDocs for the message type RCYLST, in order to derive the activities for certain objects in the partner systems.

Partner

All participating systems are provided with information on the date and time of the reset system by using message type RCYFET. IDocs, which were exchanged with the reset system, are selected here and confirmed with message type RCYRSP.

256


2005/Q4

BIT300

Lesson: IDoc Recovery Following Database Error

Use

Partner

Only

Internal

Figure 132: IDoc Recovery - Procedure III

SAP

SAP Only

Internal

Use

Partner

2005/Q4


257

Unit 6: Appendix

BIT300

Lesson Summary You should now be able to: • Describe the IDoc recovery procedure and the settings required for this function

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

258


2005/Q4

BIT300

Unit Summary

Unit Summary You should now be able to: • Explain the correct procedure for changing logical system names • Describe the IDoc recovery procedure and the settings required for this function

Use

Partner

Only

Internal

SAP

SAP Only

Internal

Use

Partner

2005/Q4


259

Course Summary

BIT300

Course Summary You should now be able to: • •

Only

Use

Partner

Internal

• •

Set up a distribution model for exchanging master and transaction data between systems Create partner profiles for data exchange in enterprises and for electronic communication with business partners Determine the scope of data to be distributed, depending on its type and recipient Monitor data exchange between systems

SAP

SAP Only

Internal

Use

Partner

260


2005/Q4

A

E

Access sequence, 115 Adapter, 53 ALE Customizing object, 50 ALE layer, 37 Archiving object, 239

EDI converter, 109 Event, 227

SAP

C

Use Internal

Data record, 33 Distribution group, 50 Distribution model, 62, 126, 153, 165 Distribution Model, 18

2005/Q4

Global company code, 203

I IDoc, 17, 30, 47, 155, 167, 187 IDoc basic type, 123, 200 IDoc status, 35, 198

L Logical system, 9, 16, 62, 125

M Master IDoc, 32, 128 Message, 112 Message category, 155 Message control, 112, 123 Message type, 11, 17, 30, 62, 80, 85, 91, 113, 115 reduced, 91 Model view, 11, 18, 62

O Organizational management, 229 Output determination procedure, 115


261

Only

D

G

Partner

Change documents, 80 Change pointers, 80, 93 Classification, 89 Communication layer, 38 Communications IDoc, 33 Condition table, 115 Condition type, 114 Control record, 33 Cross-system company code, 51 Customizing, 47

Field value conversion, 51 File port, 40 Filter group, 88 Filter object, 86

SAP

BAPI, 145, 152 BAPI Explorer, 152 Basic type, 17, 30, 85, 87, 93 Business object, 144 Business Object Repository, 147 Business object type, 144

F

Use

Partner

B

Internal

Only

Index

BIT300

P

S

Partner function, 112 Partner profile, 23, 34, 63, 110, 124, 157, 167, 199, 228 Partner type, 110 Port, 21, 38, 110, 124, 199 Port type, 110 Process code, 23, 41, 66, 126, 200, 222 Processing time, 116

SAP Solution Manager, 50 SAP Workflow, 222 Segment, 31, 84 Segment field, 31 Segment filtering, 84 Segment type, 31, 91 Status record, 33

R

Transmission medium, 124 tRFC port, 40 tRFC queue, 40

W Work Item, 200, 224

Use

Partner

Remote Function Call (RFC), 20–21 RFC destination, 20, 63, 153, 165

T

Internal

Only

Index

SAP

SAP Only

Internal

Use

Partner

262


2005/Q4

Feedback Only

Use

Partner

Internal

SAP AG has made every effort in the preparation of this course to ensure the accuracy and completeness of the materials. If you have any corrections or suggestions for improvement, please record them in the appropriate place in the course evaluation.

SAP

SAP Only

Internal

Use

Partner

2005/Q4


263

BIT300 Integration Technology ALE en Col54

Recommend Documents