Configuration d'une passerelle de script FTP
Une passerelle de script FTP s'exécute d'après la planification que vous avez définie. Le
comportement d'une passerelle de script FTP est régi par un script de commande FTP.
Création du script FTP
Pour utiliser une passerelle de script FTP, vous devez créer un fichier incluant
toutes les commandes FTP requises et pouvant être acceptées par votre serveur FTP.
- Créez
un script pour les passerelles de façon à indiquer les actions que vous souhaitez effectuer. Le script suivant est un exemple pour se connecter au serveur FTP indiqué (le
nom et le mot de passe étant précisés), passer au répertoire indiqué sur le
serveur FTP et envoyer tous les fichiers vers le répertoire sur le serveur.
open %BCGSERVERIP% %BCGUSERID% %BCGPASSWORD% %BCGOPTIONx%
cd %BCGOPTIONx%
mput *
quit
Lorsque la passerelle est mise en service, les paramètres fictifs (par
exemple %BCGSERVERIP%) sont remplacés par les valeurs saisies lors de la création d'une instance
spécifique d'une passerelle de script FTP, comme indiqué dans la table suivante :
Tableau 17. Mappage des paramètres de script et des informations des zones de passerelle de script FTP
Paramètre de script |
Informations des zones de la passerelle de script FTP |
%BCGSERVERIP% |
IP serveur |
%BCGUSERID% |
ID utilisateur |
%BCGPASSWORD% |
Mot de passe |
%BCGOPTIONx% |
Optionx, sous Attributs définis par l'utilisateur |
Il peut y avoir jusqu'à 10 options définies par l'utilisateur.
- Enregistrez le fichier.
Commandes de script FTP
Vous pouvez utiliser les commandes suivantes pour créer le script :
- ascii, binary, passive
Ces commandes ne sont pas envoyées au serveur FTP. Elles modifient le mode
de transfert (ascii, binaire ou passif) vers le serveur FTP.
- cd
Cette commande permet de passer au répertoire indiqué.
- delete
Cette commande supprime un fichier du serveur FTP.
- mkdir
Cette commande crée un répertoire sur le serveur FTP.
- mput
Cette commande utilise un seul argument, qui décrit un ou plusieurs fichiers
à transférer sur le système éloigné. Cet argument peut contenir les
caractères génériques standard ('*' et '?') pour identifier plusieurs fichiers.
- open
Cette commande utilise trois paramètres : l'adresse IP du serveur FTP, le
nom de l'utilisateur et un mot de passe. Ces paramètres correspondent aux
variables %BCGSERVERIP%, %BCGUSERID% et %BCGPASSWORD%.
Par conséquent, la première ligne du script de passerelle FTP doit être :
open %BCGSERVERIP% %BCGUSERID% %BCGPASSWORD%
- quit, bye
Cette commande arrêtre la connexion à un serveur FTP.
- quote
Cette commande indique que tout élément après la commande QUOTE doit être
envoyé en tant que commande au système éloigné. Elle permet d'envoyer à un
serveur FTP éloigné des commandes qui ne seraient pas définies dans le
protocole FTP standard.
- rmdir
Cette commande supprime un répertoire du serveur FTP.
- site
Cette commande peut servir à lancer des commandes spécifiques à un site sur un système éloigné. Celui-ci
détermine si le contenu de la commande est valide.
Passerelles de script FTP
Si vous pensez utiliser des passerelles de script FTP, procédez comme suit :
Pour créer des
passerelles de script FTP, procédez comme suit :
- Cliquez sur Administrateur du compte > Profils > Participant de communauté.
- Entrez les critères de recherche et cliquez sur
Rechercher, ou cliquez sur
Rechercher sans entrer aucun critère pour afficher la
liste de tous les participants.
- Cliquez sur l'icône Afficher les détails pour afficher le profil du participant.
- Cliquez sur Passerelles.
- Cliquez sur Créer.
Détails sur la passerelle
Dans la page Liste des passerelles, procédez comme suit :
- Entrez un nom pour identifier la passerelle. Cette zone doit être renseignée.
- Indiquez éventuellement l'état de la passerelle. L'état par défaut est Activé. Une passerelle activée est prête à envoyer des documents.
Une passerelle désactivée ne peut pas envoyer de documents.
- Indiquez éventuellement si la passerelle est en ligne ou hors ligne.
Par défaut, elle est en ligne (Connecté).
- Entrez éventuellement une description de la passerelle.
Configuration de la passerelle
Dans la section Configuration de la passerelle, procédez comme suit :
- Sélectionnez Script FTP dans la liste des transferts.
- Entrez l'adresse IP du serveur FTP auquel vous voulez envoyer des documents. La valeur
indiquée ici remplacera %BCGSERVERIP% lorsque le script FTP sera exécuté.
- Indiquez l'ID utilisateur et le mot de passe requis pour accéder au serveur FTP.
Les valeurs indiquées ici remplaceront %BCGUSERID% et %BCGPASSWORD% lorsque le script FTP sera exécuté.
- Si la cible est en mode sécurisé, utilisez la valeur par défaut
Oui pour Mode FTPS.
Sinon, cliquez sur Non.
- Envoyez le script en procédant comme suit :
- Cliquez sur Télécharger le fichier de script.
- Entrez le nom du fichier contenant le script de traitement des documents, ou utilisez
Parcourir pour accéder au fichier.
- Cliquez sur Charger le fichier pour charger le
fichier de script dans la zone de texte Fichier de script actuellement chargé.
- Si ce fichier de script est bien celui que vous voulez utiliser, cliquez sur Enregistrer.
- Cliquez sur Fermer la fenêtre.
- Dans la zone Nombre de relances, indiquez le nombre de fois
que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
- Dans la zone Intervalle de relance, indiquez le délai
d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
- Dans Délai de connexion, indiquez
le nombre de secondes durant lesquelles une connexion pourra rester ouverte en l'absence de trafic. La valeur par défaut est 120 secondes.
- Dans la zone Verrouiller
l'utilisateur, indiquez si la passerelle demandera un verrouillage pour
qu'aucune autre instance d'une passerelle de script FTP ne puisse accéder
simultanément au même répertoire du serveur FTP.
Remarque : Les valeurs Attributs de script FTP
globaux sont déjà renseignées et ne peuvent être modifiées dans cette
page.
Pour modifier ces valeurs, utilisez la page Attributs de transfert
globaux, de la façon indiquée à la section Définition des valeurs de transfert globales.
Attributs définis par
l'utilisateur
Si vous souhaitez préciser des attributs supplémentaires, procédez comme suit. La valeur entrée pour l'option remplacera %BCGOPTIONx%
lorsque le script FTP sera exécuté (x correspond au
numéro de l'option.)
- Cliquez sur Nouveau.
- Saisissez une valeur en regard de Option 1.
-
Si vous souhaitez spécifier d'autres attributs, cliquez de nouveau sur
Nouveau et saisissez une valeur.
- Répétez l'étape 3 aussi souvent
que nécessaire pour définir tous les attributs.
Prenons un exemple de script FTP :
open %BCGSERVERIP% %BCGUSERID% %BCGPASSWORD%
cd %BCGOPTION1%
mput *
quit
Dans ce cas, %BCGOPTION% serait un nom de répertoire.
Planification
Dans la section Planification de la page, procédez comme suit :
- Indiquez si vous souhaitez procéder à une planification en fonction d'un intervalle ou du calendrier.
- Si vous avez sélectionné Planification en fonction de
l'intervalle, sélectionnez le nombre de secondes qui doivent s'écouler
avant que le serveur gateway ne soit interrogé (ou acceptez la valeur par
défaut).
- Si vous avez sélectionné Planification en fonction du
calendrier, choisissez le type de planification
(Planification quotidienne,
Planification hebdomadaire ou
Planification personnalisée).
- Si vous sélectionnez Planification quotidienne, choisissez l'heure de la journée
à laquelle la passerelle doit être interrogée.
- Si vous sélectionnez Planification hebdomadaire,
choisissez un ou plusieurs jours de la semaine, en plus de l'heure.
- Si vous sélectionnez Planification personnalisée,
choisissez l'heure de la journée puis Intervalle ou
Sélection des jours pour indiquer la semaine et le mois. Dans
Intervalle, indiquez une date de début et une date de fin. Par exemple, vous pouvez cliquer sur Lun et
Ven, si vous souhaitez que le serveur soit interrogé à
une certaine heure uniquement les jours ouvrés.
Sélection des jours
permet de choisir certains jours de la semaine ou du mois.
- Pour configurer l'étape Preprocess ou Postprocess de la passerelle, voir
Configuration de récupérateurs.Sinon, cliquez sur
Sauvegarder.
