Utilisation des variables internes à MapReport

De MappingDoc

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+ :