Avant de pouvoir exploiter des documents XML avec XéMéLios, il faut importer les fichiers généré par les progiciels comptables ou RH. Les exemples suivants sont réalisés avec des Documents de paye.

Importer un fichier

Les fichiers importables dans XéMéLios ont en général l'extension .xhl ou .xml. XéMéLios sait aussi importer des fichiers compressés au format ZIP.
L'importation permet à l'outil de prendre en compte les données transmises par l'ordonnateur pour effectuer des recherches.
Les données importées sont stockées dans la base XéMéLios et y seront conservées sans limitation de temps.

Procédure d'importation

Important : il est fortement conseillé de copier les fichiers à importer sur le disque dur avant de les importer dans XéMéLios.
L'import direct de fichier depuis un CD-ROM dans XéMéLios peut poser des problèmes ; dans certains cas (CD-ROM sale, lecteur défectueux ou très ancien) le système n'arrive pas à lire les fichiers, XéMéLios affiche des messages d'erreur que l'utilisateur impute à tort à l'outil.
En copiant d'abord les fichiers sur le disque dur, c'est l'explorateur Windows qui remontera ce type d'erreur et non plus XéMéLios.
Un même fichier (i.e de même nom) ne doit être importé qu'une seule fois. Dans le cas d'un travail d'équipe sur des données en base partagée, il convient donc de confier la tâche d'importation à une seule personne (ayant les droits pour le faire). Si un fichier précédemment importé est réimporté, les anciennes données précédemment importées sont écrasées par les nouvelles ; ceci permet par exemple d'importer successivement plusieurs versions d'un même fichier et de ne conserver que les données les plus récentes.
Plusieurs fichiers peuvent être importés en même temps : dans ce cas, la barre de progression supérieure indique la progression de l'ensemble de l'import, la barre de progression inférieure indique la progression d'import du fichier en cours.

1 - Cliquez sur Fichier / importer et choisissez le type de document à importer.

2 - Sélectionnez le ou les fichiers à importer.

3 - L'import démarre. Si XéMéLios n'arrive pas à déterminer sur quel budget porte un fichier en particulier, il affiche la boite de dialogue suivante :

Cette boite de dialogue permet à l'utilisateur de spécifier sur quel budget porte ce fichier. L'utilisateur peut sélectionner dans la liste l'un des budgets proposés (budget par défaut ou budgets pour lesquels il y a déjà des données), ou peut saisir un nouveau budget (code et libellé) dans les champs appropriés ; attention, ce libellé est réutilisé dans les fenêtres de recherche de XéMéLios.

4 - Pendant l'import, XéMéLios affiche une boite indiquant la progression de l'import. La ligne de progression supérieure indique la progression globale de l'import, la ligne inférieure la progression du fichier en cours. Lorsque l'utilisateur n'importe qu'un seul fichier, les deux lignes de progression avancent en même temps. Le temps d'import dépend grandement du volume des données à importer, mais aussi des performances de la machine ; à titre indicatif, une machine "standard" est capable d'importer 400 bulletins de paye par minute.

5 - A la fin de l'import, XéMéLios affiche une boite de dialogue indiquant le type et la quantité de données importées.

Supprimer des données importées

Pour supprimer des données importées,cliquez sur Fichier / Supprimer . Cette fonction n'est pas accessible aux utilisateurs ne disposant pas des droits d'écriture. Une boite de dialogue présentant les données précédement importées s'affiche. Ces informations sont présentées sous forme d'un arbre. L'utilisateur peut sélectionner n'importe quel niveau et cliquer sur Supprimer pour supprimer les données sélectionnées.

Dans cet exemple, les bulletins de paye d'octobre 2005 du département des Yvelines pour le budget principal seront définitivement supprimées. Par mesure de sécurité, XéMéLios demande à l'utilisateur de confirmer la suppression des données.

Importer des données par batch

Depuis la version 3.1, XéMéLios est capable d'importer des données en mode batch. Cette utilisation convient particulièrement aux grosses collectivités dans lesquelles XéMéLios a été installé en client/serveur, et où l'administrateur désire réaliser les imports pendant la nuit, afin de ne pas monopoliser les postes par de longues opérations d'import.

Pour utiliser l'importeur batch, il faut faire les opérations suivantes :

Ouvrir une console (Menu Démarrer / Exécuter... / cmd.exe).
Se positionner dans le répertoire d'installation de XéMéLios (par défaut C:\Program Files\DGCP\Xemelios)
Aller dans le répertoire .\Xemelios\root
Exécuter l'instruction suivante :

java -jar import-batch.jar -d documentPaye -c SIRET "libellé de la collectivité" -b 00 "libellé du budget 00" -f fichier1.xhl fichier2.zip ...

où les paramètres sont :

Option Description Obligatoire

-d [ DOCID ] Permet de spécifier le type de document à importer. A ce jour, les valeurs possibles sont :
documentPaye pour les Etats de paye,

etatVersement pour les Etats de versement,

compteGestionM14 pour les comptes de gestion de la nomenclature M14

Pour les nouveaux types de documents, cet identifiant est disponible dans le fichier de configuration du document, à l'emplacement suivant : /documents/document/@id OUI

-c [ CODE ][ LIBELLE ] Permet de spécifier le code de la collectivité et son libellé. Si ce paramètre n'est pas présent, XéMéLios cherchera aux emplacements normaux cette information.
Attention: si le libellé de la collectivité contient des espaces, il faut le mettre entre guillemets ("). NON

-b [ CODE ][ LIBELLE ] Permet de spécifier le budget. Si ce paramètre n'est pas fournit, XéMéLios cherchera aux emplacements normaux cette information.
Attention: si le libellé de la collectivité contient des espaces, il faut le mettre entre guillemets ("). NON

-i [ YES|NO ][ YES|NO ] Permet de spécifier à XéMéLios que l'import peut être interactif. Le premier argument permet de définir si la recherche de la collectivité peut être interactive, le second argument permet de spécifier si la recherche du budget peut être interactive.
Si une recherche est définie comme interactive, et si XéMéLios ne trouve pas l'information ni dans le fichier à importer, ni dans la configuration, alors XéMéLios demande à l'utilisateur de saisir l'information manquante. Ce mode de fonctionnement est identique à l'import depuis XéMéLios. NON

-f [ FICHIER1 [ FICHIER2 [...]]] Permet de spécifier la liste de fichiers à importer. OUI

Option	Description	Obligatoire
`-d [ DOCID ]`	Permet de spécifier le type de document à importer. A ce jour, les valeurs possibles sont : `documentPaye` pour les Etats de paye, `etatVersement` pour les Etats de versement, `compteGestionM14` pour les comptes de gestion de la nomenclature M14 Pour les nouveaux types de documents, cet identifiant est disponible dans le fichier de configuration du document, à l'emplacement suivant : `/documents/document/@id`	OUI
`-c [ CODE ][ LIBELLE ]`	Permet de spécifier le code de la collectivité et son libellé. Si ce paramètre n'est pas présent, XéMéLios cherchera aux emplacements normaux cette information. Attention: si le libellé de la collectivité contient des espaces, il faut le mettre entre guillemets (").	NON
`-b [ CODE ][ LIBELLE ]`	Permet de spécifier le budget. Si ce paramètre n'est pas fournit, XéMéLios cherchera aux emplacements normaux cette information. Attention: si le libellé de la collectivité contient des espaces, il faut le mettre entre guillemets (").	NON
`-i [ YES\|NO ][ YES\|NO ]`	Permet de spécifier à XéMéLios que l'import peut être interactif. Le premier argument permet de définir si la recherche de la collectivité peut être interactive, le second argument permet de spécifier si la recherche du budget peut être interactive. Si une recherche est définie comme interactive, et si XéMéLios ne trouve pas l'information ni dans le fichier à importer, ni dans la configuration, alors XéMéLios demande à l'utilisateur de saisir l'information manquante. Ce mode de fonctionnement est identique à l'import depuis XéMéLios.	NON
`-f [ FICHIER1 [ FICHIER2 [...]]]`	Permet de spécifier la liste de fichiers à importer.	OUI