Home > Engine & Repository
Historization
Each persistent modification in webMethods MDM repository, the following informations are logged:
- Action source. If the action is initiated by webMethods Master Data Manager, this source is described by user login, HTTP session identifier and client IP address.
- Date/Time of the action
- If failure, failure information
- Type of modification: creation, content modification, etc. (see below)
- Detail of modification, if any
Files organization
Modification history is a component of the XML repository. All files are stored
in the directory ${mdm.repository.directory}/History (the property mdm.repository.directory of
the file mdm.properties indicates
the root directory of the XML repository)
"Closed" history files
Each file is named as:
aaaa-mm-dd-partnn.xml
where aaaa-mm-dd is the file date and nn is
the file index in this day.
Temporary files for writing
When a history files is being written, the XML structuration implies to work
in an opened mode. XML elements of the modifications are added in a text file
named:
aaaa-mm-dd-partnnContent.txt
The standard XML format is still available in an XML file that reference the
text file. This file is named:
aaaa-mm-dd-partnnRef.xml
Those two files are the re aggregated in a "closed" XML file when:
- the JVM is stopped ;
- Repository hot reload ;
- webMethods MDM restart.
Example of an history file:
2004-04-05-part00.xml |
Historisation
Toute modification persistente du référentiel webMethods MDM est systématiquement journalisée dans un fichier XML. A chaque modification les informations suivantes sont enregistrées :
- La source de l'action ; quand l'action est initiée via l'outil Web webMethods Master Data Manager, cette source est décrite par le login utilisateur, l'identifiant de session HTTP et l'adresse IP du client.
- La date et l'heure d'exécution de l'action.
- En cas d'échec, la raison de cet échec.
- Le type de modification : création, modification d'entête ou de contenu, etc. (les types sont détaillées plus bas).
Organisation des fichiers
L'historique des modifications est une composante indissociable du référentiel
XML oł elles ont eu lieu. A ce titre, l'ensemble des fichiers d'historisation
sont placés dans le répertoire ${mdm.repository.directory}/History
(la propriété mdm.repository.directory du fichier
mdm.properties indique le répertoire
racine du référentiel XML).
Fichiers d'historisation "fermés"
Chaque fichier est nommé selon la syntaxe suivante :
aaaa-mm-dd-partnn.xml
oł aaaa-mm-dd désigne la date du
fichier et nn désigne l'index du fichier
dans ce jour (plusieurs fichiers peuvent exister pour une même journée).
Fichiers temporaires pour l'écriture
Quand le fichier d'historisation est en cours d'écriture, la structuration
XML implique de travailler en mode ouvert. Les éléments XML des
modifications sont à cet effet ajoutés au fur et à mesure
dans un fichier texte temporaire nommé :
aaaa-mm-dd-partnnContent.txt
Le format standard XML reste accessible via un fichier XML d'accompagnement
qui fait référence au fichier texte sus-nommé. Ce fichier
est nommé :
aaaa-mm-dd-partnnRef.xml
Ces deux fichiers sont réagrégés dans un fichier XML "fermé" unique quand l'un des événements suivants survient :
- arrêt normal de la machine virtuelle Java ;
- changement de référentiel à chaud ;
- redémarrage de la plate-forme MDM, suite à un arrêt brutal de la machine virtuelle qui n'a pas permis la fermeture du cas 1.
Exemple de fichiers d'historisation :
2004-04-05-part00.xml |
Home > Engine & Repository