Cet automate permet d’intégrer un ensemble de fichiers d’interface en une seule opération, y compris si ces fichiers concernent d'autres sociétés que la société courante (celle sous laquelle cette fenêtre est ouverte). Elle peut être lancée par l’option de menu Outils/Automate d’interface avec autres applications.

Cet automate recherche les fichiers à intégrer dans LDCompta en se basant sur une liste de règles. Chaque fichier correspondant à l’une des règles établies est intégré dans LDCompta au travers des fenêtres de l’interface standard en entrée de LDCompta, mais de façon entièrement automatisée.

On peut également, comme cela est prévu quand on passe par la fenêtre d'interface standard, déclencher une fenêtre de prétraitement du fichier qui sera alors exécutée juste avant le contrôle du fichier d'interface.

Enfin, cet automate gère tout un ensemble de comptes-rendus permettant de savoir précisément ce qui s’est fait au cours du temps.

Définition des règles

Les règles doivent être définies dans un fichier nommé IAAAUT.INI, ce fichier devant se trouver dans le sous-répertoire Interfaces du répertoire des données. Ce fichier est accessible par le bouton Définir les règles dans la fenêtre de l'automate. Dans ce fichier, chaque règle est définie par une section de la forme :

• [REGLEnnn]        ou nnn est le N° de la règle, obligatoire sur 3 chiffres        

Chaque règle est définie par une successions de couples MOT-CLE=VALEUR. Ces mots-clés et leur signification sont présentés ci-après :

• LIBELLE. Libellé qui s’affiche pour cette règle en partie haute de la fenêtre de l'automate.
• REPSOURCE. Répertoire source à explorer, celui où seront placés les fichiers à interfacer.
• NOMSOURCE. Nom générique des fichiers à traiter. On peut indiquer plusieurs noms génériques ; il faut alors les séparer par un point-virgule.
  Exemple : IntVente*.csv
• FICHIER_DESCRIPTION. Lorsque ce paramètre n'est pas précisé, l'interface est exécutée avec le fichier de description par défaut spécifié dans la fenêtre d'interface, c'est à dire celui enregistré lors de la dernière interface lancé par l'option de menu Outils/Interface avec autres applications. Pour éviter toute erreur, il est préférable de fixer le format du fichier d'interface en indiquant ici le nom du fichier de description de ce format (fichier ayant l'extension .fdf).
  Si on renseigne ce mot-clé, on peut indiquer soit simplement un nom de fichier (par exemple : INTCPTV11.FDF), soit un nom complet avec le répertoire. Si le répertoire n'est pas précisé, le fichier indiqué doit être présent dans le répertoire des programmes de LDCompta.
• SOCCIBLE. Code de la société dans laquelle le fichier sera intégré.
• REPCIBLE. Répertoire dans lequel sera déplacé le fichier une fois intégré (uniquement si l’intégration a aboutie)
• FILTRE_SOCIETE. Si renseigné, la règle ne sera affichée dans la fenêtre d'interface (ou même traitée si cette fenêtre est lancée en mode Automatique, voir ci-après) que si le code société courant est égal au code indiqué ici.
• FILTRE_UTILISATEUR. Si renseigné, la règle ne sera affichée dans la fenêtre d'interface (ou même traitée si cette fenêtre est lancée en mode Automatique, voir ci-après) que si le code utilisateur courant est égal au code indiqué ici.
• FILTRE_MOTSCLES. Si renseigné, la règle ne sera traitée, en mode Automatique, que si le mot-clé passé en paramètre à cette fenêtre Automate en ligne de commande (sous la forme AUTO=XXXX ) est présent dans la liste des mots-clés indiqués ici.
• AFFICHER_FENETRE. Indiquer O (Oui) pour que les fenêtres de la procédure d'interface standard qui vont s'ouvrir pour chaque fichier d'interface à traiter soient affichées. Si vous indiquez N (Non) ces fenêtres n'apparaissent pas, l'interface se fait en mode « silencieux ».
  Si ce mot-clé n’est pas renseigné, les fenêtres seront affichées, sauf si la fenêtre d'automate est appelée en mode Automatique. Le fait d’afficher la fenêtre permet de corriger « à la volée » certaines erreurs présentes dans le fichier (compte général manquant par exemple), alors que si la fenêtre n’est pas affichée, aucune correction n’est possible « à la volée ».
• TRAITEMENT. Permet de spécifier le type de traitement à réaliser : 1=Contrôle seulement (surtout utilisé en phase de test), 2=Contrôle et validation (fonctionnement normal). Si non renseigné, la valeur 2 est prise par défaut.
• FENETRE_PRETRAITEMENT. Nom de la fenêtre de pré-traitement à appeler en amont de la fenêtre standard d’interface, pour chaque fichier à interfacer. Ces fenêtres de prétraitement permettent d'effectuer des traitements spécifiques sur le fichier d'interface : conversion de format (il existe par exemple des fenêtres de prétraitement pour convertir des fichiers d'interface du format SAGE Ligne 100 ou CEGID TRA au format standard LDCompta), ou correction ou complétion de valeurs.
• AFFICHER_ENREGISTREMENTS. Indiquer O (Oui) pour que la fenêtre d’interface affiche tous les enregistrements du fichier traité, N (Non) sinon. Cette option n’a de sens que si la fenêtre d’interface est elle-même affichée, selon l'option AFFICHER_FENETRE. Par défaut, ce paramètre prend la même valeur que le paramètre AFFICHER_FENETRE.
• IMPRIMER_LISTE_CONTROLE. Indiquer O (Oui) pour que la fenêtre d’impression de la liste de contrôle d’interface soit systématiquement proposée, N (Non) sinon. Par défaut, la valeur est N.
• EXECUTION_AUTOMATIQUE. Indiquer N (Non) pour qu’il n’y ait pas enchaînement automatique de l’exécution des différentes fenêtres, prétraitement d’une part, contrôle et validation des écritures d’autre part. On peut ainsi intervenir dans la fenêtre de prétraitement pour compléter ou modifier certains paramètres, dans la fenêtre avant contrôle et validation des écritures pour modifier le contenu du fichier résultant du prétraitement (bouton Éditer fichier). Si la valeur est O (Oui) ou n’est pas renseignée, toutes les fenêtres s’enchaînent automatiquement. C’est ce qui est requis si vous souhaitez que la règle puisse être exécutée de manière entièrement automatique dans une tâche planifiée.

Remarque : les paramètres obligatoires figurent ci-dessus en gras.

Exemple :

[REGLE001]

LIBELLE=Interface Ventes Société LDZ

REPSOURCE=U:\Applications\MaSociété\Compta\Interfaces

NOMSOURCE=IntVte*.csv

SOCCIBLE=LDZ

REPCIBLE=U:\Applications\MaSociété\Compta\Interfaces\Traités

FILTRE_SOCIETE=

FILTRE_UTILISATEUR=

FILTRE_MOTSCLES=VENTES

AFFICHER_FENETRE=N

TRAITEMENT=2

AFFICHER_ENREGISTREMENTS=N

IMPRIMER_LISTE_CONTROLE=N

EXECUTION_AUTOMATIQUE=O

[REGLE002]

LIBELLE=Interface Achats Société LDZ

REPSOURCE=U:\Applications\MaSociété\Compta\Interfaces

NOMSOURCE=IntAch*.csv

SOCCIBLE=LDZ

REPCIBLE=U:\Applications\MaSociété\Compta\Interfaces\Traités

FILTRE_SOCIETE=

FILTRE_UTILISATEUR=

FILTRE_MOTSCLES=ACHATS

AFFICHER_FENETRE=N

TRAITEMENT=2

AFFICHER_ENREGISTREMENTS=N

IMPRIMER_LISTE_CONTROLE=N

EXECUTION_AUTOMATIQUE=O

Fonctionnement de l’automate

Lorsque l’automate est lancé, il affiche en partie haute les règles qui s’appliquent compte tenu du filtre sur les codes société et utilisateur courant, et les règles affichées sont toutes sélectionnées par défaut. On peut éventuellement désélectionner une ou plusieurs règles.

Lorsqu’on clique sur le bouton Intégrer maintenant, le système traite une à une les règles sélectionnées. Pour chaque règle, il traite un à un les fichiers qui correspondent au(x) nom(s) générique(s) indiqué(s), présents dans le répertoire source indiqué. Chaque fichier est contrôlé et éventuellement validé, dans la société cible indiquée.

Si la validation aboutit, le fichier intégré est alors déplacé dans le répertoire cible indiqué, et son nom est complété de la date et de l’heure de modification de ce fichier (pour le cas où le même nom de fichier reviendrait périodiquement dans le répertoire source ; cela permet de conserver toutes les versions successives des fichiers intégrés). Le fichier contenant le compte-rendu d’intégration du fichier est également placé dans ce répertoire cible ; il porte le même nom que le fichier ayant été intégré, mais avec l’extension .log. On peut ainsi consulter le compte-rendu d’intégration même après coup.

En revanche, en cas d’erreur, le fichier à intégrer est conservé dans le répertoire source. Et le fichier contenant le compte-rendu se trouve dans ce cas lui aussi dans le répertoire source, toujours avec le nom que le fichier à intégrer, complété de la date et l’heure de dernière modification de ce fichier, et l’extension .log.

En partie basse de l’automate, une trace présente sous forme d’une suite de message l’essentiel des traitements réalisés. Cette trace est automatiquement enregistrée, à la fermeture de la fenêtre d'automate, dans un fichier nommé IAAAUT_AAAAMMJJ_HHMMSSCC.txt, où AAAAMMJJ_HHMMSSCC est la date et l’heure d’ouverture de la fenêtre (au centième de seconde près). Ce fichier se trouve au même endroit que le fichier contenant les règles, c’est à dire dans le sous-répertoire Interfaces du répertoire des sous-répertoires de LDCompta (quelque chose comme X:\Ldsystem\Fichiers\Compta\Interfaces ).

Le bouton Rechercher fichier permet quant à lui de vérifier la présence de fichiers en attente d’intégration, pour la ou les règles sélectionnées. Lorsqu’on clique sur ce bouton, le système affiche en partie basse les noms des fichiers en attente d’intégration, pour chaque règle sélectionnée, mais sans lancer l’intégration de ceux-ci. En fonction du résultat affiché, on peut alors modifier la sélection des règles, puis lancer l’intégration en cliquant sur le bouton Intégrer maintenant.

Un mécanisme d’enregistrement de tous les fichiers ayant été intégrés permet d’éviter que l’on intègre deux fois le même fichier, même si celui-ci est replacé dans le répertoire source avec son nom d’origine. C’est le fichier IAAAUT.DAT qui contient la liste de tous les fichiers intégrés, avec la date et l’heure de modification du fichier. Aussi, si pour une raison ou une autre, on souhaite réintégrer un fichier déjà intégré (cas où l’on a procédé à l’effacement des données intégrées au travers de la procédure de suppression par N° d’entrée), il faut commencer par effacer la ligne correspondant à ce fichier au sein du fichier IAAAUT.DAT. Le fichier IAAAUT.DAT, présent dans le sous-répertoire Interfaces du répertoire des sous-répertoires de LDCompta (quelque chose comme X:\Ldsystem\Fichiers\Compta\Interfaces ), peut être ouvert et modifié très facilement par le bloc-notes Windows, en cliquant sur le bouton Fichiers déjà traités.

Fonctionnement en mode automatique

L’automate peut recevoir un paramètre facultatif, qui doit être :

• Soit simplement AUTO pour demander une exécution automatique sans filtre sur un mot-clé.
• Soit AUTO=XXXX pour demander une exécution automatique avec filtre sur le mot-clé XXXX

Si ce paramètre AUTO est renseigné, la fenêtre s’exécute automatiquement, sans même s’afficher à l’écran. Les règles qui vont s’appliquer sont celles qui respectent les filtres éventuels sur la société et l’utilisateur courant. De plus, si un mot-clé a été indiqué suite à l’option AUTO, seules les règles ayant ce mot-clé dans le paramètre FILTRE_MOTSCLES seront traitées.

Bien évidemment, si l’on veut utiliser cet automate en mode automatique, tout particulièrement si c’est via une tâche planifiée, donc sans utilisateur devant l’écran, il faut indiquer la valeur N=Non pour le paramètre AFFICHER_FENETRE et O=Oui pour le paramètre EXECUTION_AUTOMATIQUE dans les différentes règles exécutées en automatique. Car sinon, même si la fenêtre de l’automate ne s’affiche pas en mode automatique, les fenêtres de l’interface standard et éventuellement de prétraitement seront elles affichées. Et il faudra confirmer la validation du fichier dans ces fenêtres.

De même, il ne faut pas non plus indiquer la valeur O=Oui pour le paramètre IMPRIMER_LISTE_CONTROLE, car la fenêtre de demande d’impression de cet état (celle où l’on choisit de faire un aperçu avant impression ou une impression directe, et qui permet également de choisir l’imprimante cible) sera affichée. Cela aura pour effet de bloquer le traitement automatique le temps que l’utilisateur vienne cliquer sur le bouton Aperçu, Imprimer ou Fermer dans cette fenêtre.

En combinant cette option AUTO avec la possibilité de déclencher une exécution automatique de LDCompta avec ouverture directe d’une fenêtre donnée (voir chapitre 1.4  Options de la ligne de commande), on peut programmer une exécution automatique et périodique de cet automate au travers des Tâches planifiées de Windows.

La ligne de commande à inscrire dans les tâches planifiées est de la forme :

C:\Ldsystem\Program\Compta\LDCPTV11.EXE SSS  /U=UTILISATEUR:MOTPASSE /FEN=IAAAUT01('AUTO=XXXX')

Avec

SSS = Code de la société dans laquelle sera déclenchée l’automate.

UTILISATEUR = Code utilisateur de LDCompta sous lequel l’automate va s’exécuter.

MOTPASSE = Mot de passe de l’utilisateur indiqué (ce mot de passe peut éventuellement être indiqué ici en forme chiffrée, en le plaçant entre accolades {}.

XXXXX = Mot-clé permettant de choisir la ou les règles à déclencher.