Utilisation des variables internes à MapReport
Sommaire
Présentation / Objectif
Un certain nombre de variables internes permettent de définir des fonctionnements de MapReport, soit différents, soit plus explicites.
Pré-requis
Connaître le fonctionnement de MapReport
Variables pour la gestion des formats de sortie
Par défaut MapReport exécute une sortie texte. Vous pouvez définir un sortie de type PCL, listing ou Excel. Pour cela, il faut utiliser le paramètre
DB.MAPPING_DATASTREAM=
- Pour fixer le flot de sortie en PCL, il faut ajouter soit même dans le report les tags de sélection de police et de positionnement…
DB.MAPPING_DATASTREAM=PCL
- Pour fixer le flot de sortie en Listing, c’est à dire que MapReport n’effectue plus de saut de page mais un fichier continue sauf quand les sauts de page sont explicites par une action Mapping.
DB.MAPPING_DATASTREAM=LISTING
- Pour fixer la sortie au format Excel, c’est à dire que chaque champ d’une même ligne dans un bloc d’écriture est considéré comme une nouvelle colonne dans Excel, avec comme règle pour chaque ligne le 1er texte dans la 1ere colonne, le 2eme texte dans la 2eme colonne,…
- Chaque ligne est considérée comme un nouvelle ligne dans Excel.
Vous devez préciser comme paramètre -outfile : un fichier ayant pour extension .xls
DB.MAPPING_DATASTREAM=XLS
Variables pour changer les limites de fonctionnement
- Par défaut MapReport, pour éviter les boucles infinies, n’autorise pas une infinité de boucles dans un while. Si vous rencontrez des problèmes avec cette limitation, vous pouvez la déplacer en ajoutant le paramètre :
DB.MAPPING_MAXWHILE=10000
- Vous pouvez changer pour un report donné la largeur maximum d’une ligne (en nombre de caractères), si vous avez par exemple des sauts de ligne sur des champs plus grands que la limite normale de MapReport :
DB.WIDTHPAGE=1000
Vous pouvez redéfinir la hauteur de page en 300 DPI que MapReport doit utiliser pour traiter ce report :
HEIGHTPAGE=4000
Calcul de la taille en DPI
(Taille en cm * 300) / 2,54 = Taille en DPI ou Taille en inches * 300 = Taille en DPI
Désactivation du count pour améliorer les performances d’un report (entraine la suppression de certain évènements):
DB.MAPPING_DISABLESQLCOUNT=1
Variable pour la gestion de la traduction
Vous pouvez demander à MapReport de placer dans un fichier de traduction l’ensemble des mots qui ne sont pas encore traduits.
DB.MAPPING_APPENDLANG
Remarque : Il existe une documentation uniquement sur les traductions.
Variables pour ajouter des traces
Récupération des trames de debug sur les connect, disconnect, … des serveurs SQL.
DB.MAPPING_DEBUG=1
Récupération des lancements de chaque action de MapReport
DB.MAPPING_TRACE=1
Définition du niveau de warning, pour obtenir en ligne de commande les mêmes erreurs qu’en preview MapReport
DB.MAPPING_WARNING=1
Récupération de toutes les requêtes SQL lancées par MapReport
DB.MAPPING_TRACESQL=1
Récupération de toutes les modifications des changements des champs, avec comme format :
LIB.FILE(FIELD)=VALUE DB.MAPPING_TRACEDATA=1
Ajout d’un timer sur chaque action de MapReport est un résumé en fin de traitement
DB.MAPPING_TRACETIME=1
Changement d'instance de base de donnée
Pour basculer d'une instance Mapping à une autre, vous pouvez utiliser :
DB.MAPPING_INSTANCE=”INSTANCE_NAME”
Format de la sortie sur stderr
Il s’agit d’un format de fichier texte ou chaque ligne est précédée par un tag qui identifie le type de ligne.
DATA : ERROR : INFO : WARNING: TRACE : EXIT : DEBUG : SQL : TIME : TRACE+ :