Manuel des Scripts Automation Engine > JCL AE pour les applications > SAP > R3_CREATE_VARIANT

R3_CREATE_VARIANT

Crée une nouvelle variante.

Transaction :  SA38

Interface : Standard

Syntaxe

R3_CREATE_VAR[IANT]

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

Syntaxe

Description / format

REP[ORT]=

Nom du rapport
Format : littéral de script

VAR[IANT]=

Nom de la variante.
Format : littéral de script

TEXT=

Forme résumée de la variante.
Format : littéral de script

Ce texte est écrit dans la langue définie par l'administrateur dans le fichier INI de l'agent. Le langage peut aussi être défini dans les paramètres du job. Cette dernière remplace l'option figurant dans le fichier INI.

 Si vous n'indiquez pas ce paramètre, le nom de la variante est utilisé dans sa forme résumée.

PROTECTED=

Protection contre les modifications.
Format : littéral de script

Valeurs autorisées : "YES" et "NO" (valeur par défaut)

"YES" - Seul l'utilisateur CPIC peut modifier la variante créée.
"NO" - La variante peut être modifiée sans restriction.

Commentaires

Lors de la création de la variante, AE indique automatiquement qu'elle est destinée au traitement en arrière-plan. Les autres propriétés de la variante sont définies comme dans la GUI SAP.

La fonction R3_CREATE_VARIANT crée toujours une variante sans contenu. Utilisez R3_MODIFY_VARIANT ou R3_SET_SELECT_OPTION pour ajouter des entrées à ces variantes. Si vous souhaitez exécuter un rapport avec une nouvelle variante, respectez l'ordre suivant lors de l'appel des fonctions :

  • R3_SET_SELECT_OPTION - Définition des critères de sélection
  • R3_CREATE_VARIANT - Création de la variante
  • R3_ACTIVATE_REPORT - Exécution du rapport avec la variante

    • Si la variante existe déjà, mais qu'elle doit être recréée, supprimez-la au préalable à l'aide de la fonction R3_DELETE_VARIANT.

    Le Job est interrompu si une erreur survient lors de la création de la variante.

    Le client de la variante est automatiquement celui auquel l'agent SAP s'est connecté, conformément à son objet Login. Vous pouvez également créer des variantes système SAP (CUS& et SAP&). Dans ce cas, le Client de la variante est toujours automatiquement défini sur 0000.

    Pour utiliser R3_CREATE_VARIANT, XBP version 2.0 ou supérieure est nécessaire (version SAP 4.6+).

    Exemple

    L'exemple définit la valeur "17" pour le paramètre "Age minimum". Le critère de sélection est ensuite utilisé pour créer une variante.

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

    Rubriques connexes :

    Généralités sur le JCL SAP