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

R3_SET_PRINT_DEFAULTS

Définit des valeurs par défaut pour les paramètres d'impression utilisés lors de l'exécution de rapports.

Transaction : -

Interface : L'Automation Engine et Standard

Syntaxe

R3_SET_PRINT_DEF[AULTS]

[DESTINATION=...]
[,COVERPAGE=...]
[,IMMEDIATELY=...]
[,RELEASE=...]
[,COPIES=...]
[,LIST_NAME=...]
[,LIST_TEXT=...]
[,NEW_LIST_ID=...]
[,EXPIRATION=...]
[,LINE_COUNT=...]
[,LINE_SIZE=...]
[,LAYOUT=...]
[,SAP_COVER_PAGE=...]
[,RECEIVER=...]
[,DEPARTMENT=...]
[,AUTHORITY=...]
[,DATA_SET=...]
[,TYPE=...]
[,OS_COVER_PAGE=...]
[,SPOOL_PRIORITY=...]
[,TEXTONLY=...]
[,FRAMES=...]
[,SUPPRESS_SHADING=...]
[,WITH_STRUCTURE=...]
[,DEFAULT_SPOOL_SIZE=...]
[,PRINTER_MAIL_ADDRESS=...]
[,SPOOL_PAGE_FROM=...]
[,SPOOL_PAGE_TO=...]
[,ARCHIVE_MODE=...]
[,ARCHIVE_SAPOBJECT=...]
[,ARCHIVE_OBJECT=...]
[,ARCHIVE_INFO=...]
[,ARCHIVE_TEXT=...]
[,MONITOR=...]

Elément de syntaxe

Description/format

DEST[INATION]=

Périphérique de sortie
Format : Littéral de script

Ce paramètre permet d'indiquer le nom du système de sortie. Il s'agit dans la plupart des cas du nom d'une imprimante, mais il peut également s'agir de celui d'un télécopieur, etc.

 Attention : pour des raisons techniques liées à l'interface XBP de SAP, vous ne pouvez pas utiliser les noms d'imprimante SAP longs dans l'Automation Engine. Par conséquent, indiquez le nom technique de quatre caractères.

Paramètres d'impression

 

COVER[PAGE]=

Sélection de la page de garde
Format : Littéral de script

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

Ce paramètre détermine si une page de garde contenant les sélections de rapports doit figurer avant la liste. Si une page de garde est générée, elle est également reprise dans le rapport de Job. Cela permet de documenter les paramètres de cette exécution.

IMM[EDIATELY]=

Impression Immédiate
Format : Littéral de script

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

REL[EASE]=

Supprimer après Impression
Format : Littéral de script

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

Ce paramètre permet de déterminer si la requête spool doit être supprimée dès que le périphérique de sortie a effectué l'impression ou seulement à l'expiration de la période de rétention.

COPIES=

Nombre de copies
Format : Entier

Valeur par défaut : "0"

Entre ici le nombre désiré de copies de votre document.

LIST_N[AME]=

Nom de la requête spool
Format : Littéral de script

Ce paramètre vous permet d'indiquer le nom de la requête spool. Ce dernier peut contenir des lettres, des chiffres, des caractères spéciaux et des espaces dans tous les modes. Le nom proposé par défaut pour les requêtes spool est composé des huit caractères du nom du rapport, du séparateur "_" et des trois premiers caractères du nom de l'utilisateur.

LIST_T[EXT]=

Texte de la page de garde
Format : Littéral de script

Ce paramètre vous permet d'indiquer le texte décrivant la requête spool. Ce dernier peut contenir des lettres, des chiffres, des caractères spéciaux et des espaces.

NEW_LIST_ID=

Nouvelle requête spool
Format : Littéral de script

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

EXPIR[ATION]=

Période de Rétention
Format : Entier

Valeur par défaut : "0"

Ce paramètre permet de déterminer le nombre de jours pendant lequel la requête spool doit être conservée dans le système spool avant d'être supprimée.

LINE_COUNT=

Longueur des pages de la liste
Format : Entier

Valeur par défaut : "0"

Nombre de lignes par page. Si ce champ contient le chiffre zéro ou est vide, le nombre de pages de la liste est illimité (non autorisé pour l'impression). La longueur de la liste est alors uniquement déterminée par son contenu. Lors de l'impression, le nombre maximal de lignes par page dépend du format choisi. Pour modifier le nombre de lignes, vous devez sélectionner un autre format.

LINE_SIZE=

Largeur des lignes de la liste
Format : Entier

Valeur par défaut : "0"

Ce paramètre détermine la largeur actuelle des lignes de la liste. Lors de l'impression, la largeur maximale des lignes dépend du format choisi. Pour modifier la largeur des lignes, vous devez sélectionner un autre format.

LAYOUT=

Préparation à l'impression
Format : Littéral de script

Ce paramètre détermine le format de la sortie de la requête spool. Concrètement, il définit le format des pages, c'est-à-dire le nombre maximal de lignes et de colonnes par page imprimée.

SAP_COVER[_PAGE]=

Page de Garde SAP
Format : Littéral de script

Valeurs autorisées : "" (valeur par défaut), "X" et "D"

"" - Pas d'impression de la page de garde
"X" - Impression de la page de garde
"D" - L'impression de la page de garde dépend du paramétrage de l'imprimante

Ce paramètre détermine si une page de garde contenant certaines informations (destinataire, département, format utilisé,...) doit être jointe à l'impression issue de la requête spool.

RECEIVER=

Destinataire
Format : Littéral de script

Ce paramètre indique le nom du destinataire de la requête spool. Ce nom figure sur la page de garde imprimée. Par défaut, le nom du destinataire est celui de l'utilisateur actuel.

DEPART[MENT]=

Département sur la page de garde
Format : Littéral de script

Ce paramètre indique le nom du département concerné par la requête spool. Celui-ci est imprimé sur la page de garde.

AUTHORITY=

Autorisation
Format : Littéral de script

Ce paramètre indique l'autorisation qui s'applique à la requête spool (12 caractères au maximum). Le contenu de la requête spool n'est visible que pour les utilisateurs disposant de l'autorisation indiquée.

DATA_SET=

Nom du jeu de données spool
Format : Littéral de script

TYPE=

Type de la requête spool
Format : Littéral de script

OS_COVER[_PAGE]=

Page de garde du spooler de l'hôte
Format : Littéral de script

Valeurs autorisées : "" (valeur par défaut), "X" et "D"

"" - Pas d'impression de la page de garde
"X" - Impression de la page de garde
"D" - L'impression de la page de garde dépend du paramétrage de l'imprimante

SPOOL_PRI[ORITY]=

Priorité de la requête spool
Format : Entier

Valeur par défaut : "5"

TEXTO[NLY]=

Texte seulement
Format : Littéral de script

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

Ce paramètre contrôle le mode de sortie des caractères non-ASCII d'une liste imprimée.

Prérequis d'utilisation du paramètre (voir également la note SAP 777337) :

  • SAP Basis version 6.20 avec le package de support SAPKB62045
  • SAP Basis version 6.40 avec le package de support SAPKB64010

FRAMES=

Cadre
Format : Littéral de script

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

Contrôle la mise en cadre par défaut. Ses conditions d'utilisation sont identiques à celles du paramètre TEXTONLY=.

SUPPRESS_SHADING=

Ne pas imprimer les couleurs et les ombres.

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

WITH_STRUCTURE=

Inclure les informations structurées.

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

DEFAULT_SPOOL_SIZE=

Définir 255 caractères comme largeur de lignes maximale.

Valeurs autorisées : "YES", "NO" (valeur par défaut)
"YES" = après la 255e colonne, un retour à la ligne est forcé
"NO" = pas de limitation de longueur de lignes

PRINTER_MAIL_ADDRESS=

Adresse e-mail d'une imprimante e-mail
Format : Littéral de script

SPOOL_PAGE_FROM=
SPOOL_PAGE_TO=

Numéro de la page à partir de laquelle et/ou jusqu'à laquelle l'impression doit être effectuée.
Format : Nombre

Par défaut, toutes les pages sont imprimées.

Paramètres d'archivage

Paramètres d'archivage avec R3_ACTIVATE_REPORT

ARCHIVE_M[ODE]=

Mode de sauvegarde
Format : Littéral de script

Valeurs autorisées : "1" (valeur par défaut),"2" et "3"

"1" - Le document est seulement imprimé.
"2" - Le document est seulement sauvegardé dans une archive optique.
"3" - Le document est imprimé et sauvegardé dans une archive optique.

ARCHIVE_S[APOBJECT]=

Type de l'objet Business
Format : Littéral de script

Les objets SAP sont classés en fonction de leur type.

ARCHIVE_O[BJECT]=

Type de document
Format : Littéral de script

Les objets d'archivage sont classés en fonction du type de document.

ARCHIVE_I[NFO]=

Zone d'informations
Format : Littéral de script

Abréviation d'information pour la requête d'archivage.

ARCHIVE_T[EXT]=

Champ de texte d'information
Format : Littéral de script

Texte décrivant la requête d'archivage. Ce dernier peut contenir des lettres, des chiffres, des caractères spéciaux et des espaces.

Paramètres de contrôle

 

MON[ITOR]=

Suivi du statut dans le protocole d'activation
Format : Littéral de script

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

Remarques

Les scripts permettent d'attribuer des valeurs par défaut aux paramètres d'impression. Celles-ci s'appliquent à l'ensemble du script ou jusqu'à l'attribution d'une nouvelle valeur par défaut. Les valeurs par défaut ne sont valides que pour le Job dans lequel elles ont été définies.

La définition de valeurs par défaut améliore la visibilité du script AE. En même temps, les problèmes liés à la limitation à 1024 caractères/ligne sont évités, car l'instruction de traitement même est seulement compilée dans l'Agent SAP.

Le script peut uniquement être utilisé avec R3_ACTIVATE_REPORT pour attribuer des valeurs par défaut aux paramètres d'impression.

Exemple

L'exemple suivant montre comment sont définies les valeurs par défaut pour l'imprimante et le nombre d'exemplaires. Lors de l'exécution du rapport, le nombre de copies sera remplacé par la valeur "6". Toutefois, cette modification ne s'applique qu'à ce rapport. La valeur par défaut ("8") demeure inchangée.

R3_SET_PRINT_DEFAULTS DESTINATION=PR01
R3_SET_PRINT_DEFAULTS COPIES=8
R3_ACTIVATE_REPORT REPORT=RSM04000,COPIES=6

 

Rubriques connexes :