6.1 Configuring the SAP System

As part of configuring the SAP system, you should complete the following steps in this order:

  1. Defining Sending and Receiving Systems

  2. Creating a Logical System

  3. Assigning a Client to the Logical System

  4. Creating a Distribution Model

  5. Creating a Port Definition

  6. Partner Profiles

  7. Modify Port Definition

  8. Activating Central User Administration

  9. Create a Communication (CPIC) User

NOTE:The following instructions are for SAP version 4.6C. If you are using a previous version of SAP, the configuration process is the same; however, the SAP interface will be different.

6.1.1 Defining Sending and Receiving Systems

The sending and receiving systems must be defined for messaging. In order to distribute data between systems you must first define both the sending and receiving systems as unique logical systems.

For this particular solution, we recommend defining two logical systems. One logical system represents the driver and acts as the receiver system. The other logical system represents the SAP system and acts as the sender system. Because only one of these clients is used as a data source (that is, the client/logical system where SAP User data is stored and “actions” occur), there is no need to assign a client to the receiving logical system.

NOTE:Depending on your current SAP environment, you might not need to create a logical system. You might only need to modify an existing Distribution Model by adding the USERCLONE message type to a previously configured Model View. For more information, see Creating a Distribution Model.

It is important, however, that you follow SAP’s recommendations for logical systems and configuring your ALE network. The following instructions assume that you are creating new logical systems and a new model view.

Creating a Logical System

  1. In SAP, type transaction code BD54.

  2. Click New Entries.

  3. Type an easily identifiable name to represent the SAP sender system. SAP recommends the following format for logical systems representing R/3 clients: systemIDCLNTclient number (such as ADMCLNT100).

  4. Type a description for the logical system (such as Central System for SAP User Distribution).

  5. Add a second logical system name to represent the Identity Manager external receiver system (such as DRVCLNT100).

  6. Type a description for the logical system (such as IDM User Management Integration).

  7. Save your entries.

Assigning a Client to the Logical System

  1. In SAP, type transaction code SCC4.

  2. Click Table View > Display > Change to switch from display to change mode.

  3. Select the client from which you want User information distributed (such as 100).

  4. Click Goto > Details > Client Details.

  5. In the Logical System field, browse to the sender logical system you want to assign to this client (such as ADMCLNT100).

  6. Save your entry.

6.1.2 Creating a Distribution Model

The distribution model contains essential information about message flow. The model view defines the systems that will communicate with each other and the messages that will flow between them. The distribution model forms the basis of distribution and controls it directly.

To create a distribution model:

  1. Verify that you are logged on to the sending system/client.

  2. In SAP, type transaction code BD64. Ensure that you are in Change mode (click Table View > Display > Change.)

  3. Click Edit > Model View > Create.

  4. Type the short text to describe the distribution model (such as Client 100 Distribution to IDM).

  5. Type the technical name for the model (such as SAP2IDM).

  6. Accept the default Start and End dates or specify valid values. Click the check mark icon to save your entry.

  7. Select the view you created, then click Add BAPI.

  8. In the Sender/Client field, type the name of the sender logical system (such as ADMCLNT100).

  9. In the Receiver/Client field, add the name of the receiver logical system (such as DRVCLNT100).

  10. In the Obj. Name/Interface field, add the USER object name.

    NOTE:Ensure that you add the USER object name with all capital letters.

  11. In the Method field, add Clone.

  12. Click the check mark icon to save the BAPI.

  13. Select the SAP2IDM model view.

  14. Click Add BAPI.

  15. Define the sender (logical system ADMCLNT100).

  16. Define the receiver (logical system DRVCLNT100).

  17. In the Obj. Name/Interface field, add the UserCompany object name.

  18. In the Method field, add Clone.

  19. Click the check mark icon to save your BAPI entries.

  20. Save the Distribution Model entries.

6.1.3 Creating a Port Definition

The port is the communication channel to which IDocs are sent. The port describes the technical link between the sending and receiving systems.

TRFC Port Definition

The driver can be configured to support a connection via a TRFC port or to consume IDocs distributed via a File port. The default driver configuration assumes that you use the TRFC port configuration.

Create RFC Destination

NOTE:If you are distributing data to multiple drivers, each driver must have a unique RFC destination and program ID.

  1. In SAP, type transaction code SM59.

  2. Click the Create icon.

  3. Name the RFC destinations (use the driver’s logical system name, for example, DRVCLNT100.)

  4. Select T as the connection type (for a TCP/IP connection.)

  5. Add a description for the destination (such as JCO Server in IDM User Driver.)

  6. Save your entry.

  7. Select the option for Registration or Registered Server Program. Type the program ID to be used for the driver. In the default driver configuration, this value is set to IDMUser100.

  8. (Conditional) If the SAP server is configured to use a Unicode database, complete the following steps:

    1. Select the Special Options tab.

    2. Select Unicode.

  9. Save your entry.

TRFC Port Definition

NOTE:If you are distributing data to multiple drivers, each driver must have a unique TRFC port.

  1. In SAP, type transaction code WE21.

  2. Select Transactional RFC, then click the Create icon.

  3. Select Own Port Option Name.

    1. Type a port name (such as IDMPORT).

    2. Type a description for the port definition (such as Port to IDM User Driver).

    3. Select a version (such as IDoc record types SAP release 4.X)

    4. Specify the RFC destination. This is the name of the RFC destination representing the driver (such as DRVCLNT100.)

  4. Save your entries.

File Port Definition

NOTE:If you are distributing data to multiple drivers, each driver must have a unique file port.

  1. In SAP, type transaction code WE21.

  2. Select File, then click the Create icon.

    1. Type a port name (such as IDMFILE).

    2. Type a port description (such as File Port to IDM User Driver).

    3. Select a version (such as SAP release 4.X).

  3. Define the outbound file:

    1. Select the physical directory. This is the directory where you want IDocs placed. You might need to create this directory.

      Type the directory where the outbound files are written, for example: \\sapdev\nov\sys\global\sapndsconnector.

    2. Type the function module. This names the IDoc file in a specific format. Use the following: EDI_PATH_CREATE_CLIENT_DOCNUM.

  4. Save your changes.

    NOTE:You do not need to configure the other three tabs for the port properties (outbound:trigger, inbound file, and status file).

6.1.4 Partner Profiles

The system automatically generates a partner profile or you can manually maintain the profile.

NOTE:If you are using an existing distribution model and partner profile, you do not need to automatically generate a partner profile. Instead, you can modify it to include the USERCLONE BAPI.

  1. In SAP, type transaction code BD82.

  2. Select the Model View. This should be the Model View previously created in Creating a Distribution Model.

  3. Ensure that the Transfer IDoc Immediately and Trigger Immediately option buttons are selected.

  4. Click the Execute icon.

    NOTE:When the status screen appears, ignore any red error or warning messages related to the driver’s logical system.

Modify Port Definition

The port definition might have been generated incorrectly. For your system to work properly, you might need to modify the port definition.

  1. In SAP, type transaction code WE20.

  2. Select Partner Type LS.

  3. Select your receiver logical system (such as DRVCLNT100).

  4. Click the Create Outbound Parameter icon, then select message type USERCLONE.

  5. Modify the receiver port so it is the file or TRFC port name you created earlier (such as IDMPORT or IDMFILE).

  6. Under Output Mode, select Transfer IDoc Immediately to send IDocs immediately after they are created.

  7. In the IDoc Type section, select the Basic type and the appropriate USERCLONE:

    • For SAP 4.5, select USERCLONE01

    • For SAP 4.6a, select USERCLONE02

    • For SAP 4.6c, select USERCLONE03

    • For SAP 6.10, select USERCLONE04

    • For SAP 6.20 or greater, select USERCLONE05

  8. Save your entries.

    NOTE:The following procedures are only necessary if you want to distribute company address data.

  9. Click the Create Outbound Parameter icon, then select message type CCLONE.

  10. Modify the receiver port so it is the file or TRFC port name you created earlier (such as IDMPORT or IDMFILE.)

  11. (Conditional) If you are using a TRFC port, modify the packet size. Select Packet Size = 1.

  12. Under Output Mode, select Transfer IDoc Immediately to send IDocs immediately after they are created.

  13. In the IDoc type section, select Basic type and the appropriate CCLONE. (For all SAP versions, select CCLONE01.)

  14. Save your entries.

6.1.5 Activating Central User Administration

Central User Administration (CUA) is the process that activates the distribution model.

  1. In SAP, type transaction code SCUA.

  2. In the Maintain System Landscape dialog box, select the distribution Model View previously created (such as SAP2IDM).

  3. Save your entry.

    You might see a message stating “Unable to distribute the system landscape to system IDMDRV.” This is an informative message and is not an error or issue of concern.

On some versions of SAP, all systems in the distribution, including the IDM driver, must be accessible during this step. If a TRFC port is being used for the driver Publisher channel, the driver should be running to ensure connectivity and completion of the CUA configuration.

6.1.6 Create a Communication (CPIC) User

Users are client-independent. For each client that will be using the driver, a system user with CPIC access must be created.

  1. In SAP, type transaction code SU01.

  2. From User Maintenance, enter a username in the User dialog box (such as IDM_CPIC), then click the Create icon.

  3. Click the Address tab, then type data in the last name fields (Last_IDM).

  4. Click the Logon Data tab, then define the initial password and set the user type to CPIC (Communication).

  5. Click the Profiles tab, then add the S_A.CPIC profile. The driver must also have sufficient rights to perform required operations, which might include SAP_ALL and SAP_NEW depending on your company’s system security policy.

    NOTE:We recommend using the most restrictive rights possible.

  6. Click the Systems tab. Add the logical name of the sender system (such as ADMCLNT100). This enables the CPIC user to authenticate to the client system.

  7. Click Save.

NOTE:Initially, you can create a dialog user to test your SAP system configuration. If there are processing problems, you can analyze the dialog user in the debugger. You should also log into the SAP system once to set this user’s password. After the system is tested and works properly, you should switch to a CPIC user for security measures.