Certains gestionnaires ou handler des points de connexion sont fournis en standard.

Pour la configuration des échanges, voir aussi les paramètres du module.

Fichier simple

Les données sont échangées sous forme de fichiers, à lire (Import) ou écrire (Export) dans les répertoires précisés en paramètre.

• Fichier simple : Tous les fichiers présents dans le répertoire sont traités, quel que soit leur contenu.

Exemple de fichier xml :

<entities externalSystem="CODE_SYSTEME_EXTERNE" exchangeInterface="CODE_INTERFACE" >

Exemple fichier csv :

externalSystem;CODE_SYSTEME_EXTERNE;exchangeInterface;CODE_INTERFACE

Lors de l'exécution d'une interface sur un système externe, CARL Source ne traite que les fichiers de l'interface sur le système en cours. Ainsi, les fichiers de plusieurs interfaces et systèmes externes peuvent être stockés dans un même répertoire.

Attributs de configuration

• Répertoire de sortie : Chemin complet du répertoire où sont déposés les fichiers en sortie, produits par CARL Source (y compris les fichiers d'erreur).
• Répertoire d'entrée : Chemin complet du répertoire où sont lus les fichiers à intégrer par CARL Source.
• Extension des fichiers : Suffixe du fichier. Le suffixe est indépendant du format, même s'il est conseillé de suivre l'usage.
• Nom des fichiers : En sortie, les fichiers générés porteront ce nom, suivi de l'extension (cet attribut n'est pas pris en compte lors d'un import/une entrée).
• Encodage : Encodage du fichier, pour conservation des caractères spéciaux.
• Répertoire de sauvegarde des messages en entrée : Répertoire où sera stockée une copie du fichier avant import.
  Ce répertoire doit impérativement être différent du répertoire d'entrée, sinon, tout fichier traité sera de nouveau présent dans le répertoire des fichiers à traiter.
• Nom des fichiers de sauvegarde des messages en entrée : Nom de la copie de sauvegarde avant import, qui sera suivi d'un suffixe unique et de l'extension.
• Répertoire de sauvegarde des messages en sortie : Répertoire où sera stockée une copie du fichier exporté.
• Nom des fichiers de sauvegarde des messages en sortie : Nom de la copie de sauvegarde du fichier exporté, qui sera suivi d'un suffixe unique et de l'extension.
• Nom du fichier de filtrage lors de l'import : Préfixe du fichier à importer.
• Suffixe automatique (si le nom des fichiers est renseigné) : En cochant cette case, cela signifie qu'un identifiant unique s'ajoute entre le nom du fichier et l'extension (si celle-ci est renseignée).
• Répertoire d'entrée dans le ZIP : Si ce paramètre est renseigné le Handler tentera de décompresser le fichier dans un répertoire temporaire créé dans le répertoire d'entrée, puis recherchera le fichier à traiter dans ce sous-répertoire.
  Le répertoire d'entrée dans le ZIP est relatif au répertoire temporaire résultant de la décompression.
  Un point (.) indique donc que le fichier doit être sélectionné directement dans le répertoire temporaire.
  Le chemin doit être noté avec le style Unix; utilisation du slash (/) comme séparateur.
• Préfixe du fichier dans le ZIP : Paramètre utilisé pour sélectionner le fichier à traiter parmi ceux obtenus à l’issu de la décompression.
• Extension du fichier dans le ZIP : Paramètre utilisé pour sélectionner le fichier à traiter parmi ceux obtenus à l’issu de la décompression.
• Compression du fichier en sortie : Cocher cette case signifie que le fichier en sortie sera compressé et transformé en archive au format ZIP.

Fichier simple filtré

Les données sont échangées sous forme de fichiers, à lire (Import) ou écrire (Export) dans les répertoires précisés en paramètre.

• Fichier simple filtré : L'interface et le système externe doivent être indiqués dans l'en-tête des fichiers.

Attributs de configuration

• Répertoire de sortie : Chemin complet du répertoire où sont déposés les fichiers en sortie, produits par CARL Source (y compris les fichiers d'erreur).
• Répertoire d'entrée : Chemin complet du répertoire où sont lus les fichiers à intégrer par CARL Source.
• Extension des fichiers : Suffixe du fichier. Le suffixe est indépendant du format, même s'il est conseillé de suivre l'usage.
• Nom des fichiers : En sortie, les fichiers générés porteront ce nom, suivi de l'extension (cet attribut n'est pas pris en compte lors d'un import/une entrée).
• Encodage : Encodage du fichier, pour conservation des caractères spéciaux.
• Répertoire de sauvegarde des messages en entrée : Répertoire où sera stockée une copie du fichier avant import.
  Ce répertoire doit impérativement être différent du répertoire d'entrée, sinon, tout fichier traité sera de nouveau présent dans le répertoire des fichiers à traiter.
• Nom des fichiers de sauvegarde des messages en entrée : Nom de la copie de sauvegarde avant import, qui sera suivi d'un suffixe unique et de l'extension.
• Répertoire de sauvegarde des messages en sortie : Répertoire où sera stockée une copie du fichier exporté.
• Nom des fichiers de sauvegarde des messages en sortie : Nom de la copie de sauvegarde du fichier exporté, qui sera suivi d'un suffixe unique et de l'extension.
• Suffixe automatique (si le nom des fichiers est renseigné) : En cochant cette case, cela signifie qu'un identifiant unique s'ajoute entre le nom du fichier et l'extension (si celle-ci est renseignée).

Fichier erreur

Attributs de configuration

• Répertoire de sortie : Chemin complet du répertoire où sont déposés les fichiers en sortie, produits par CARL Source (y compris les fichiers d'erreur).
• Extension des fichiers : Suffixe du fichier. Le suffixe est indépendant du format, même s'il est conseillé de suivre l'usage.
• Encodage : Encodage du fichier, pour conservation des caractères spéciaux.

Échanges avec un serveur web

Attributs de configuration

• Répertoire de sortie : Chemin complet du répertoire où sont déposés les fichiers en sortie, produits par CARL Source (y compris les fichiers d'erreur).
• Répertoire d'entrée : Chemin complet du répertoire où sont lus les fichiers à intégrer par CARL Source.
• Extension des fichiers : Suffixe du fichier. Le suffixe est indépendant du format, même s'il est conseillé de suivre l'usage.
• Nom de la machine hôte : Nom du host (ou adresse IP).
• Port : Port de connexion sur le host.
• Nom des fichiers : En sortie, les fichiers générés porteront ce nom, suivi de l'extension (cet attribut n'est pas pris en compte lors d'un import/une entrée).
• Encodage : Encodage du fichier, pour conservation des caractères spéciaux.
• Répertoire de sauvegarde des messages en entrée : Répertoire où sera stockée une copie du fichier avant import.
  Ce répertoire doit impérativement être différent du répertoire d'entrée, sinon, tout fichier traité sera de nouveau présent dans le répertoire des fichiers à traiter.
• Nom des fichiers de sauvegarde des messages en entrée : Nom de la copie de sauvegarde avant import, qui sera suivi d'un suffixe unique et de l'extension.
• Répertoire de sauvegarde des messages en sortie : Répertoire où sera stockée une copie du fichier exporté.
• Nom des fichiers de sauvegarde des messages en sortie : Nom de la copie de sauvegarde du fichier exporté, qui sera suivi d'un suffixe unique et de l'extension.
• Nom du fichier de filtrage lors de l'import : Préfixe du fichier à importer.
• Suffixe automatique (si le nom des fichiers est renseigné) : En cochant cette case, cela signifie qu'un identifiant unique s'ajoute entre le nom du fichier et l'extension (si celle-ci est renseignée).
• Répertoire d'entrée dans le ZIP : Si ce paramètre est renseigné le Handler tentera de décompresser le fichier dans un répertoire temporaire créé dans le répertoire d'entrée, puis recherchera le fichier à traiter dans ce sous-répertoire.
  Le répertoire d'entrée dans le ZIP est relatif au répertoire temporaire résultant de la décompression.
  Un point (.) indique donc que le fichier doit être sélectionné directement dans le répertoire temporaire.
  Le chemin doit être noté avec le style Unix; utilisation du slash (/) comme séparateur.
• Préfixe du fichier dans le ZIP : Paramètre utilisé pour sélectionner le fichier à traiter parmi ceux obtenus à l’issu de la décompression.
• Extension du fichier dans le ZIP : Paramètre utilisé pour sélectionner le fichier à traiter parmi ceux obtenus à l’issu de la décompression.
• Commande HTTP utilisée pour télécharger le fichier : Commande pour télécharger le fichier : GET, POST.
• Chemin d'accès de la ressource à télécharger : URL de la ressource à télécharger (import).
• Chemin d'accès de la ressource à uploader : URL de la ressource à uploader (export).
• Protocole de connexion sur le serveur distant : Nom du protocole : http, https.
• Identifiant pour l'authentification sur le serveur distant : Login pour l’authentification.
• Mot de passe pour l'authentification sur le serveur distant : Mot de passe pour l’authentification.
• Compression du fichier en sortie : Cocher cette case signifie que le fichier en sortie sera compressé et transformé en archive au format ZIP.

Échanges avec un serveur FTP

Attributs de configuration

• Répertoire de sortie : Chemin complet du répertoire où sont déposés les fichiers en sortie, produits par CARL Source (y compris les fichiers d'erreur).
• Répertoire d'entrée : Chemin complet du répertoire où sont lus les fichiers à intégrer par CARL Source (vu du serveur d'application).
• Extension des fichiers : Suffixe du fichier. Le suffixe est indépendant du format, même s'il est conseillé de suivre l'usage.
• Nom de la machine hôte : Nom du host (ou adresse IP).
• Port : Port de connexion sur le host.
• Nom des fichiers : En sortie, les fichiers générés porteront ce nom, suivi de l'extension (cet attribut n'est pas pris en compte lors d'un import/une entrée).
• Encodage : Encodage du fichier, pour conservation des caractères spéciaux.
• Répertoire de sauvegarde des messages en entrée : Répertoire où sera stockée une copie du fichier avant import.
  Ce répertoire doit impérativement être différent du répertoire d'entrée, sinon, tout fichier traité sera de nouveau présent dans le répertoire des fichiers à traiter.
• Nom des fichiers de sauvegarde des messages en entrée : Nom de la copie de sauvegarde avant import, qui sera suivi d'un suffixe unique et de l'extension.
• Répertoire de sauvegarde des messages en sortie : Répertoire où sera stockée une copie du fichier exporté.
• Nom des fichiers de sauvegarde des messages en sortie : Nom de la copie de sauvegarde du fichier exporté, qui sera suivi d'un suffixe unique et de l'extension.
• Nom du fichier de filtrage lors de l'import : Préfixe du fichier à importer.
• Suffixe automatique (si le nom des fichiers est renseigné) : En cochant cette case, cela signifie qu'un identifiant unique s'ajoute entre le nom du fichier et l'extension (si celle-ci est renseignée).
• Répertoire d'entrée dans le ZIP : Si ce paramètre est renseigné le Handler tentera de décompresser le fichier dans un répertoire temporaire créé dans le répertoire d'entrée, puis recherchera le fichier à traiter dans ce sous-répertoire.
  Le répertoire d'entrée dans le ZIP est relatif au répertoire temporaire résultant de la décompression.
  Un point (.) indique donc que le fichier doit être sélectionné directement dans le répertoire temporaire.
  Le chemin doit être noté avec le style Unix; utilisation du slash (/) comme séparateur.
• Préfixe du fichier dans le ZIP : Paramètre utilisé pour sélectionner le fichier à traiter parmi ceux obtenus à l’issu de la décompression.
• Extension du fichier dans le ZIP : Paramètre utilisé pour sélectionner le fichier à traiter parmi ceux obtenus à l’issu de la décompression.
• Protocole de connexion sur le serveur distant : Nom du protocole : ftp, ftpes.
• Identifiant pour l'authentification sur le serveur distant : Login pour l’authentification.
• Mot de passe pour l'authentification sur le serveur distant : Mot de passe pour l’authentification.
• Répertoire d'entrée sur le serveur : Répertoire distant dans lequel sera recherché le fichier à télécharger (vu du serveur FTP).
• Répertoire de sortie sur le serveur : Répertoire distant dans lequel sera transféré le fichier à uploader (vu du serveur FTP).
• Mode du client : Mode FTP : ACTIVE ou PASSIVE
• Action à exécuter après le téléchargement : Action à effectuer après avoir récupéré le fichier : NONE, DELETE, MOVE
• Répertoire relatif de déplacement (.=renommer) : Répertoire distant dans lequel doit être déplacé le fichier téléchargé.
• Préfixe appliqué lors du déplacement : Préfixe appliqué au fichier.
• Suffixe appliqué lors du déplacement : Suffixe appliqué au fichier.
• Compression du fichier en sortie : Cocher cette case signifie que le fichier en sortie sera compressé et transformé en .ZIP

Échanges avec un serveur SFTP

Attributs de configuration

Seuls les attributs spécifiques au connecteur SFTP seront décrits ci-dessous.
Pour ce qui concerne les autres attributs, se référer aux informations relatives au connecteur FTP (cf. chapitre précédent).

• Authentification par clé (avec ou sans passphrase) : Booléen.
  Si positionné à [Faux] : l'authentification est effectuée par mot de passe.

Le mode d'authentification choisi doit être configuré du côté du serveur SFTP, et indiqué par son gestionnaire.

Il existe trois possibilités d’authentification :

• Avec l’identifiant et le mot de passe.
• Avec l’identifiant et l’authentification par clé (en précisant l’emplacement de celle-ci).
• Avec l’identifiant et l’authentification par clé (en précisant l’emplacement de celle-ci) ainsi que la passphrase de la clé.
  Remarque : la passphrase peut être définie (ou non) par l'administrateur lors de la génération de la clé. Par conséquent, elle n'est pas obligatoire.

• Emplacement de la clé : Emplacement et nom du fichier contenant la clé (cette dernière doit être au format OPENSSH).
  Le fichier doit être placé sur un chemin accessible par le serveur d’application CARL Source.
  Ce paramètre est à renseigner si le paramètre "Authentification par clé (avec ou sans passphrase)" (voir plus haut) est coché.
• Passphrase de la clé : mot de passe de la clé.
• Chemin d'accès au fichier known_hosts : le fichier known_hosts contient une liste de serveurs approuvés ainsi que leurs clés publiques.
  • Une ligne dans un fichier known_hosts est composée :
    • Du nom d'hôte, c'est-à-dire le serveur SSH. L'adresse IP est également répertoriée.
      Un certain nombre de noms d'hôtes et d'adresses IP séparés par des virgules peuvent être répertoriés au sein du fichier.
    • De l'algorithme de clé publique applicable : "ssh-rsa" (pour les paires de clés RSA) ou "ssh-dss" (pour les paires de clés DSA).
    • De la clé publique codée en base 64.
  • Le fichier known_hosts se compose théoriquement de plusieurs lignes, une pour chacun des hôtes auxquels le client peut souhaiter se connecter.