Command Format

SAPAgent is an R/3 application that is integrated into the SAPgui as a graphical user interface. To run SAPAgent:

1. Log on to the R/3 server (Siemens recommends that you select English (EN) as the dialog language)

2. In the R/3 SAPgui browser command line, type the transaction code /sie/dirx_ag (or /n/sie/dirx_ag), and then press Enter.

SAPAgent runs and displays its main window.

The title bar indicates whether SAPAgent is running on a customizing or a production client. In general, you run SAPAgent on a customizing client to configure a transfer and transport it to the production client. You run SAPAgent on a production client to activate the transfer for R/3 job scheduler execution (or for immediate execution without R/3 scheduling).

To exit SAPAgent, click the back icon or press function key F3.

8.2 Configuration

Each SAPAgent transfer is described by a configuration. SAPAgent can manage multiple configurations. A configuration can be active (entered into the R/3 job scheduler) or inactive.

The SAPAgent installation procedure creates a base (default) configuration. New configurations are inherited from this base configuration. The base configuration cannot be deleted. SAPAgent allows you to select a configuration out of a list of available

configurations. All changes are then applied to this configuration. To select a configuration in the SAPAgent main window, use the selection button or press F4.

Use the Configuration menu selection in the main SAPAgent window to: · Create a new configuration from a template configuration

· Select the Human Resources data to be applied to a configuration · Define a job for the configuration

· Quit the configuration process

To create a new configuration from a template configuration: 1. Select an existing configuration or use the base configuration.

2. From the Configuration menu, select Create from template. The New Configuration dialog box appears.

3. In New Configuration, enter the name of the new configuration, and then click OK. SAPAgent copies the existing configuration into the new configuration.

You use the Edit Configuration menu selection to select the Human Resources data to be applied to the configuration. You select this data in two dimensions:

· Selection of persons, called vertical selection

· Selection of person attributes, called horizontal selection

You also use the Edit Configuration menu selection to define a job for a configuration. This section also describes:

· The default configuration

· Transport from customizing to production

· Configuration activation and immediate (ad-hoc) execution

8.2.1

Vertical (Person) Selection

You use the SAPAgent vertical selection dialog to determine the person data that is to be exported from the SAP/R3 database. To display the vertical selection dialog:

1. Click Configuration.

2. Select Edit Configuration, and then select Edit Attributes.

SAPAgent displays the vertical selection dialog. The dialog box contains two areas for vertical selection:

· Selections - defines the selection criteria for extracting persons from the database for export; for example, by ranges of personnel numbers, employment status, company code, personnel area and/or subarea and employee group and/or subgroup

· Other attributes - defines the type of export to be performed (full or delta) and defines export data file format

The vertical selection dialog box also contains a configuration area that displays information about the selected configuration, as shown in the following figure.

Use the Save button in the application toolbar to apply the changes made to a configuration; this is the button that appears below the dialog title line in the previous figure. Do not use the standard R/3 Save icon (which appears above the title line as shown in the previous figure) to save configuration changes.

Use the Execute icon or press F8 to generate a text overview of a selected configuration. The Selections Area

The following figure shows the Selections area of the vertical selections dialog box.

Each selection criteria field is displayed on a separate line. Click in any selection criteria field (or press F4) to display a list of the entries that are allowed for the field. The Personnel number field is a mandatory selection field, and you must always supply a range. Selection criteria fields that have no values entered in the lower portion of a range are not used for limiting the selection.

Note that fields with a zero value are left blank; this is an R/3 issue. The Other Attributes Area

The next sections describe the fields of the Other attributes area. Full Export (vs. Delta)

This field selects whether the configuration is a full export or a delta export of SAP/R3 person entries. Selecting this field marks the configuration for exporting all data within the vertical selection regardless of the type of export performed in the last export.

If you do not select this field, the configuration is a delta export. A delta export only selects the data that has changed since the last export. The first export after the creation or change of a configuration is always a full export.

This is a mandatory field for a full export. Date of Last Delta Export

This field is an informational field that displays the date of the last delta export. SAPAgent automatically generates this field. Entering a different date into this field overwrites the internal date so that you can generate a delta export for a longer or shorter time period. Do not enter a date that is prior to the date of the first delta export for the configuration. Export Format

This field selects the export data file format. The possible selections are:

· LDIF-Selects LDAP Data Interchange Format (LDIF) file format. Use this format for full exports or delta exports.

· CSV-Selects Character Separated Value (CSV) format. Use this format for full exports only.

This is a mandatory field. Separator

This field specifies the separators between entries (fields) in the export data file and between multiple values within one entry (field). This is a mandatory field if the Export Format selected is CSV.

Date Format

This field specifies the format in which date values are to be represented in the export data file. The standard format is:

DDD, DD.MMM.YYYY

for example:

MON, 26.JUN.2000

You can also use a two-digit representation for the month; for example: MON, 26.06.2000

This is an optional field. Code Page

This field selects a code page (the number assigned to a character code set) into which the characters of the export are to be converted. If this field is not specified, SAPAgent uses the standard code page (1103) for the configuration. Select code page 1133 to use the ISO-8859-1 character code set.

8.2.2

Horizontal (Attribute) Selection

You use the SAPAgent horizontal selection function to determine the person attributes that are to be exported from the SAP/R3 database. To display the horizontal selection dialog: 1. Click Configuration.

2. Select Edit Configuration, and then select Edit Tags. SAPAgent displays the horizontal selection dialog.