L’importation de fichiers peut être faite manuellement via le navigateur web, fichier par fichier, cependant lorsque de nombreux fichiers doivent être importés, cette méthode devient très chronophage.

Une solution consiste à importer plusieurs fichiers à la fois, non pas via le navigateur web, mais directement sur un répertoire du serveur. Cela peut être fait « manuellement » à l’aide d’un logiciel de transfert de fichiers comme FileZilla / WinSCP, ou alors entièrement automatiquement en programmant des tâches planifiées via une plateforme EAI.

Le guide ci-dessous explique comment réaliser la configuration d’une plateforme EAI pour intégrer automatiquement des fichiers sur le serveur BI et expose ainsi également comment réaliser des imports « manuels » de nombreux fichiers à la fois grâce à un logiciel de transfert de fichiers type FileZilla ou WinSCP.

Principes

Plutôt que d’importer des fichiers de données (ex : b2, rsf, etc.) manuellement via l’interface web du serveur BI, ce qui peut prendre un certain temps, il est aussi possible d’automatiser le dépôt des fichiers dans des répertoires spécifiques du serveur BI afin de les voir intégrés automatiquement par la plateforme décisionnelle.

La production des fichiers est à la charge du système connecté à la plate-forme BI. Ces fichiers sont généralement produits par un EAI (Enterprise Application Integration) dans les établissements (Antares… Enovacom, Cloverleaf ) ou directement par les éditeurs des logiciels.

Schéma de principe :

Le serveur BI contient en interne des répertoires spécifiques permettant le dépôt de fichiers de données normés. Par exemple, le répertoire dédié au dépôt des fichiers b2 est /home/incoming/flux/sih0/facturation/b2/wait.

Une fois le flux dédié à l’intégration des fichiers b2 également paramétré et planifié, alors tous les fichiers du répertoire de dépôt seront régulièrement intégrés en base de données BI.

Solutions techniques

1. Prérequis : compte utilisateur pour la connexion

Les traitements étant exécutés par l’utilisateur système « incoming », les fichiers devront lui appartenir. Voici les informations pour s’identifier en SSH avec cet utilisateur système :

S’identifier avec l’utilisateur système :
login : incoming 
Mot de passe : à demander auprès du Support Technique

Attention ! En aucun cas ce mot de passe système ne doit être modifié.

2. Transfert vers le serveur BI

2.1 SCP / rsync

La solution est qu’un serveur tiers transfère le fichier par la commande scp. Cette commande récupérera l’ensemble des fichiers .txt disponibles dans le dossier de sauvegarde.

scp /emplacement/du/serveur.tiers/acte_tmp
incoming@ip.serveur.pmsipilot:/home/incoming/flux/sih0/répertoire de dépôt/wait

Ne transférez que les derniers fichiers : Utilisez la commande » rsync » .

2.2 SFTP

Le fonctionnement est identique à celui de FTP en ligne de commande.

sftp incoming@ip.serveur.pmsipilot
cd /home/incoming/flux/sih0/répertoire de dépôt/wait
put fichier.txt

2.3 Garantie du transfert complet des fichiers à importer

Attention : Pour garantir le transfert complet des fichiers dans les répertoires de dépôt, il est obligatoire de nommer temporairement chaque fichier de données déposé avec une extension différente de l'extension attendue (par exemple .b2.tmp)..

Le but est d’éviter toute intégration de données dans la plate-forme PMSIpilot BI si les fichiers sont encore en cours de transfert réseau.

Conventions de nommage des fichiers

1. Conventions de nommage

Le nom de chaque fichier déposé sur le serveur doit être un nom unique et comportant un identifiant unique de type date :

ID unique de type date : YYYYMMDD-HHmmssSSS

La convention aux millièmes est retenue sur le format de date afin que deux fichiers arrivant dans la même seconde ne s’écrasent pas l’un l’autre.

La Convention de nommage est décrite par l’extension du fichier. Par exemple pour l’extension d’un fichier de facturation au format b2 :

20190131-104233111.b2

Liste des extensions de fichiers acceptées :

Remarque : Les noms de fichier ne peuvent pas contenir d’espaces ni de caractères spéciaux ( sauf underscore) ou accentués.

Remarque : Les fichiers sans extension reconnue par le système ne sont pas intégrés.

2. Format

Les formats d’encodage de fichiers autorisés sont UTF 8, ISO-8859-1 et ASCII.

Les fichiers ne respectant pas ce format seront alors remontés en erreur et sont rejetés par le système d’intégration dans la base de données PMSIpilot BI.

Arborescence des répertoires de dépôt

1. Notion

Afin de visualiser
Pour commencer, rendez-vous dans l’application Superviseur sur le serveur BI.

Accès Superviseur : https://IP serveur/superviseur/

Importez ensuite le fichier de mise à jour dans le menu “Mise à jour” puis validez.

Importer fichier : Superviseur > Menu “Données” > Onglet “SIHs”

2. Répertoire racine de dépôt de fichiers

/home/incoming/flux/sih de l’établissement

3. Répertoire de dépôt des fichiers par format de fichier

Les fichiers doivent être déposés au sein de sous répertoires déjà existants au sein du répertoire racine de dépôt des fichiers :

/home/incoming/flux/sih de l’établissement/répertoire de dépôt/

Ci-dessous la liste des répertoires de dépôts par format de fichier entrant :

Description	Extension de fichier autorisé dans le répertoire
/home/incoming/flux/sih de l’établissement/facturation/arlnoe/wait (Contient tous les fichiers arl et noemie. Si l’établissement ne peut pas faire la distinction entre ces fichiers , ils seront ensuite traités par un process et déposés dans les dossiers : – arl (/home/incoming/flux/sih0/facturation/arl/wait) – noemie (/home/incoming/flux/sih de l’établissement/facturation/noemie/wait)	.*
/home/incoming/flux/sih de l’établissement/facturation/noemie/wait	.noe
/home/incoming/flux/sih de l’établissement/facturation/arl/wait	.arl
/home/incoming/flux/sih de l’établissement/facturation/b2/wait	.b2
/home/incoming/flux/sih de l’établissement/facturation/pesv2/wait	.pesv2
/home/incoming/flux/sih de l’établissement/facturation/hrerec/wait	.hre
/home/incoming/flux/sih de l’établissement/facturation/htitre/wait	.hti
/home/incoming/flux/sih de l’établissement/facturation/rsface/wait/	.txt
/home/incoming/flux/sih de l’établissement/facturation/rsfaceuf/wait/	.csv
/home/incoming/flux/sih de l’établissement/RH/XEM/wait	.xhl
/home/incoming/flux/sih de l’établissement/mesures/wait (Qualité)	.csv

Paramétrage et planification des flux

L’équipe Support Ospi vous accompagnera dans cette tâche.

Les flux seront paramétrés dans le Superviseur (onglet “Données”) puis planifiés avec le logiciel Stambia depuis l’interface de planification des flux “Analytics” (https://votre-serveur-BI/analytics/).