Automation Engine Script-Leitfaden > AE JCL für Anwendungen > SAP > R3_CREATE_VARIANT

R3_CREATE_VARIANT

Legt eine neue Variante an.

Transaktion: SA38

Schnittstelle: Standard

Syntax

R3_CREATE_VAR[IANT]

REP[ORT]=...
,VAR[IANT]=...
[,TEXT=...]
[,PROTECTED=...]

Syntax	Beschreibung/Format
REP[ORT]=	Name des Reports Format: Script-Literal
VAR[IANT]=	Name der Variante Format: Script-Literal
TEXT=	Kurztext der Variante. Format: Script-Literal Der Text wird in der Spracheinstellung des Agenten, die der Administrator in der INI-Datei konfiguriert, oder jener des Jobs angelegt. Letztere übersteuert die Option in der INI-Datei. Wenn Sie diesen Parameter nicht angeben, wird der Name der Variante als Kurztext verwendet.
PROTECTED=	Schutz vor Änderungen. Format: Script-Literal Erlaubte Werte: "YES" und "NO" (Standardwert) "YES" - Nur der CPIC-User kann die Variante nach der Erstellung ändern. "NO" - Die Variante lässt sich uneingeschränkt modifizieren.

Kommentare

Die AE setzt beim Anlegen automatisch das Attribut "Variante für Hintergrundverarbeitung". Die restlichen Eigenschaften der Variante werden so gesetzt, als würde Sie jene mit dem SAP GUI erstellen.

Die Funktion R3_CREATE_VARIANT legt die Variante immer ohne Inhalt an. Verwenden Sie R3_SET_SELECT_OPTION, um deren Inhalt zu befüllen. Möchten Sie einen Report mit einer neuen Variante ausführen, ist folgende Reihung beim Aufrufen der Funktionen zu berücksichtigen:

R3_SET_SELECT_OPTION - Selektionskriterien definieren

R3_CREATE_VARIANT - Variante anlegen

R3_ACTIVATE_REPORT - Report mit dieser Variante ausführen

Falls die Variante bereits existiert und neu angelegt werden soll, so können Sie diese zuvor mit der Funktion R3_DELETE_VARIANT löschen.

Der Job wird abgebrochen, wenn beim Anlegen der Variante ein Fehler auftritt.

Der Mandant der Variante ist automatisch jener Mandant, in dem sich der SAP-Agent aufgrund des Login-Objektes angemeldet hat. SAP-Systemvarianten (CUS& und SAP&) können ebenfalls angelegt werden. Dabei wird der Mandant der Variante automatisch immer auf 0000 gesetzt.

Voraussetzung für den Einsatz von R3_CREATE_VARIANT ist XBP 2.0 oder höher (SAP Release 4.6+).

Beispiel

Das Beispiel definiert den Wert "17" für den Parameter "Mindestalter". Das Selektionskriterium wird anschließend für das Anlegen einer Variante verwendet.

R3_SET_SELECT_OPTION SELNAME='MIN_AGE',KIND='P',LOW='17',SIGN='I'
R3_CREATE_VARIANT REP=REPORT01,VAR=NEW,TEXT='New variant'

Siehe auch:

Allgemeines zur SAP-JCL

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support