Configuration d'une passerelle de script FTP
Un passerelle de script FTP s'exécute en fonction du calendrier que
vous avez défini. 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 contenant
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
permettant de se connecter au serveur FTP indiqué (à l'aide du nom et du mot
de passe spécifiés), d'accéder au répertoire indiqué sur le serveur FTP et d'envoyer tous les fichiers vers le répertoire spécifié sur le serveur.
open %BCGSERVERIP% %BCGUSERID% %BCGPASSWORD% %BCGOPTIONx%
cd %BCGOPTIONx%
mput *
quit
Lorsque la cible 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 cible
de script FTP, comme indiqué dans le tableau suivant :
Tableau 3. 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, binary ou passive) 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 permet de créer un répertoire sur le serveur FTP.
- mput
Cette commande utilise un seul argument, qui décrit un ou plusieurs fichiers à transférer
vers le système éloigné. Cet argument peut contenir les caractères génériques standard pour identifier plusieurs
fichiers ('*' et '?').
- open
Cette commande comprend 3 paramètres ; l'adresse IP du serveur FTP, le nom d'utilisateur,
et le mot de passe. Ces paramètres mappent respectivement vers les variables
%BCGSERVERIP% %BCGUSERID% et %BCGPASSWORD%. La ligne de votre script de cible
FTP doit prendre la forme suivante :open %BCGSERVERIP% %BCGUSERID% %BCGPASSWORD%.
- quit, bye
Cette commande permet de fermer une connexion existante à 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 permet de supprimer 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 > Passerelles.
- Cliquez sur Créer.
Caractéristiques de la passerelle
Depuis la page Liste des passerelles, exécutez les étapes suivantes :
- Entrez un nom pour identifier la passerelle. Cette zone est obligatoire.
- 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.
La valeur par défaut est En ligne.
- Entrez éventuellement une description de la passerelle.
Configuration de la passerelle
Dans la section Configuration de la passerelle de la page, procédez comme suit :
- Sélectionnez Scripts FTP dans la liste Transfert.
- Entrez l'adresse IP du serveur FTP auquel vous envoyez 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 le Mode FTPS.
Sinon, cliquez sur Non.
- Téléchargez le fichier script vers l'amont en procédant comme suit :
- Cliquez sur Télécharger un fichier script vers l'amont.
- Entrez le nom du fichier contenant le script de traitement des documents
ou cliquez sur Parcourir pour accéder au fichier.
- Cliquez sur Charger un fichier pour charger le fichier script
dans la zone de saisie Fichier script actuellement chargé.
- Si le fichier script est celui que vous souhaitez utiliser, cliquez sur
Sauvegarder.
- Cliquez sur Fermer la fenêtre.
- Dans la zone Nombre de relances, indiquez le nombre de tentatives
que la passerelle doit effectuer pour envoyer un document avant que l'opération n'échoue. La valeur par défaut est 3.
- Dans la zone Intervalle de relance, entrez la durée pendant laquelle la passerelle doit attendre avant de tenter d'envoyer le document une nouvelle fois. La valeur par défaut est 300 secondes.
- Dans la zone Délai de connexion, indiquez
le nombre de secondes durant lesquelles une connexion peut 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.
Attributs définis par l'utilisateur
Si vous souhaitez indiquer des attributs supplémentaires, exécutez
les étapes ci-après. La valeur indiquée pour l'option remplacera
%BCGOPTIONx% lorsque le script FTP sera exécuté
(x correspond au numéro de l'option).
- Cliquez sur Nouveau.
- Entrez une valeur en regard de Option 1
-
Si vous souhaitez spécifier d'autres attributs, cliquez
de nouveau sur Nouveau et entrez 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% est un nom de répertoire.
Planification
Depuis la section Planification de la page, exécutez les étapes suivantes :
- Indiquez si vous souhaitez procéder à une planification en fonction d'un intervalle ou du calendrier.
- Si vous sélectionnez Planification en fonction de
l'intervalle, choisissez le nombre de secondes qui doivent s'écouler
avant que la passerelle ne soit interrogée (ou acceptez la valeur par défaut).
- Si vous sélectionnez 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 de fin. Vous pouvez, par exemple, cliquer sur Lun et Ven
si vous souhaitez que le serveur soit interrogé à une certaine heure uniquement les jours ouvrés.
L'option Sélection des jours permet de choisir certains jours de la semaine ou du mois.
- Si vous souhaitez configurer l'étape Traitement préalable ou Traitement ultérieur
de la passerelle, voir Configuration de récupérateurs.
Sinon, cliquez sur Sauvegarder.
