Voir la source de Multi-Instance de bases de données avec M-Connect

{{DISPLAYTITLE:Editing Multi-Instance dans MAPREPORT}}

==Présentation / Objectif==
Cette documentation présente l’utilisation dans un même report de 1 à n bases de données
différentes.

==Pré-requis==
* Connaître le fonctionnement de MapReport.
*Connaître les adresses IP, comptes utilisateurs et mots de passe des différentes bases de données.
*Avoir installé au minimum la partie client de la base de donnée.

==Configuration serveur==
Dans le fichier mapping.conf, vous devez définir au minimum une
connexion par défaut :
*[MAPREPORT_SERVERPASSWORD] coginord
*[MAPREPORT_SERVERUSER] root
*[MAPREPORT_SERVERPORT] 3306
*[MAPREPORT_SERVERADDRESS] 127.0.0.1
*[MAPREPORT_SERVERTYPE] mysql
Ensuite, vous devez ajouter pour chaque paramètre de configuration MapReport un suffixe
commencent obligatoirement par un souligné « _ »
<br /><br />

'''Exemple : Vous désirez créer un environnement ENV1 et un environnement ENV2 :'''
*[MAPREPORT_SERVERPASSWORD_ENV1] coginord
*[MAPREPORT_SERVERUSER_ENV1] root
*[MAPREPORT_SERVERPORT_ENV1] 3306
*[MAPREPORT_SERVERADDRESS_ENV1] 192.168.1.1
*[MAPREPORT_SERVERTYPE_ENV1] mysql<br/><br/>
*[MAPREPORT_SERVERPASSWORD_ENV2] coginord
*[MAPREPORT_SERVERUSER_ENV2] root
*[MAPREPORT_SERVERPORT_ENV2] 3306
*[MAPREPORT_SERVERADDRESS_ENV2] 192.168.1.2
*[MAPREPORT_SERVERTYPE_ENV2] mysql

==Utilisation dans Mapreport==

===Déclarer une variable DB.MAPPING_INSTANCE===
Il faut tout d'abord créer une variable MAPPING_INSTANCE dans le noeud DB.<br />
Pour cela, dans la vue des éléments, étendre "Paramètres MAPRUNRPT" puis double cliquer sur "MAPPING_INSTANCE".<br />
La variable de type paramètre d'entrée sera automatiquement créée dans DB. (type ____abcd de longueur 255)

===Spécifier l'instance à utiliser===
Dans MapReport, pour basculer d’un environnement à l’autre vous devez préciser l’instance à utiliser : 
 DB.MAPPING_INSTANCE=’ENV1’ ou DB.MAPPING_INSTANCE=’ENV2’

'''Changement d’instance à la volée :'''<br />

Avant chaque read ou calcul de type sql, il suffit d’ajouter
 DB.MAPPING_INSTANCE=’ENV1’

{{Warning}}
A partir du moment où vous décidez d’utiliser le changement d’instance, il vaut
mieux toujours préciser l’instance à utiliser pour éviter de lire une mauvaise base de
donnée.<br />
<br/>
'''Passage de paramètre à l'exécution'''<br />

Si vous désirez utiliser un environnement spécifique pour tout le projet, vous pouvez le préciser au moment du lancement de la commande maprunrpt.<br/>
Exemple :
 maprunrpt –rptname:MYRPT -param:DB.MAPPING_INSTANCE=ENV1