Présentation de la bibliothèque

Informations générales

La bibliothèque FtpRemoteFileHandling fournit les fonctionnalités de client FTP nécessaires pour gérer les fichiers distants :

oLecture de fichiers

oÉcriture de fichiers

oSuppression de fichiers

oAffichage du contenu de répertoires distants

oAjout de répertoires

oSuppression de répertoires

1 Contrôleur en tant que client FTP

2 Téléchargement du fichier (commande Store)

3 Serveur FTP (sur le PC ou le contrôleur)

4 Chargement du fichier (commande Retrieve)

Caractéristiques de la bibliothèque

Le tableau suivant indique les caractéristiques de la bibliothèque :

Caractéristique	Valeur
Titre de la bibliothèque	FtpRemoteFileHandling
Société	Schneider Electric
Catégorie	Communication
Composant	Suite de protocoles Internet
Espace de noms par défaut	SE_FTP
Attribut du modèle de langage	Uniquement accès qualifié
Bibliothèque post-compatible	Oui (FCL)

NOTE : Cette bibliothèque est paramétrée en Uniquement accès qualifié . Cela signifie que l'on ne peut accéder aux POU, aux structures de données, aux énumérations, et aux constantes qu'en utilisant l'espace de noms de la bibliothèque. L'espace de noms par défaut de la bibliothèque est SE_FTP.

Exemple de projet

Le projet d'exemple FTPRemoteFileHandlingExample est fourni avec la bibliothèque. L’exemple de projet montre comment implémenter les composants à partir de la bibliothèque FtpRemoteFileHandling.

Étape	Action	Commentaire
1	Dans EcoStruxure Machine Expert Logic Builder, exécutez la commande Nouveau projet.	–
2	Dans la boîte de dialogue Nouveau projet, sélectionnez A partir de l’exemple dans la liste Type de projet.	–
3	Sur la droite de la boîte de dialogue Nouveau projet, sélectionnez le contrôleur⁽¹⁾ dans la liste Contrôleur.	Résultat : les exemples disponibles sont répertoriés dans la zone de texte Exemples correspondants.
4	Sélectionnez l’exemple dans la liste Exemples correspondants.	–
5	Entrez le nom du nouveau projet et sélectionnez l’emplacement du fichier.	–
6	Cliquez sur le bouton OK.	Résultat : un nouveau projet est créé en fonction de l’exemple sélectionné.

Éléments généraux à prendre en compte

Prenez en compte les limites suivantes du transfert de données FTP :

oSeuls les symboles ASCII sont pris en charge pour les noms de fichier et de répertoire à échanger avec le serveur FTP.

oSeul le protocole IPv4 (Internet Protocol version 4) est pris en charge.

oSeul le mode FTP passif est pris en charge.

oSeule une connexion FTP est autorisée à la fois.

oComme le temps de réponse du serveur FTP n'est pas contrôlable, exécutez les blocs fonction dans une tâche cyclique à faible priorité. Configurez la fonction d'horloge de surveillance pour qu'elle autorise un temps suffisant à la connexion. L'autre solution consiste à exécuter les blocs fonctions dans une tâche Roue libre. Pour ce type de tâche, aucune durée de cycle n'est définie.

La bibliothèque décrite dans ce document utilise la bibliothèque TcpUdpCommunication en interne.

Les bibliothèques TcpUdpCommunication (Schneider Electric) et CAA Net Base Services (CAA Technical Workgroup) utilisent les mêmes ressources système sur le contrôleur. Leur utilisation simultanée dans la même application peut perturber le fonctionnement du contrôleur.

AVERTISSEMENT

FONCTIONNEMENT IMPRÉVU DE L’EQUIPEMENT

N'utilisez pas la bibliothèque TcpUdpCommunication (Schneider Electric) avec la bibliothèque CAA Net Base Services (CAA Technical Workgroup) simultanément dans la même application.

Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels.

Éléments à prendre en compte concernant la cybersécurité

Les fonctions de la bibliothèque FtpRemoteFileHandling ne prennent pas en charge les connexions sécurisées par TLS (Transport Layer Security) ou SSL (Secure Socket Layer). Par conséquent, la communication ne peut avoir lieu qu'au sein de votre réseau industriel, isolé des autres réseaux de votre entreprise et protégé d'Internet.

NOTE : Schneider Electric respecte les bonnes pratiques de l'industrie, en vigueur dans le développement et la mise en œuvre des systèmes de contrôle. Cette approche, dite de « défense en profondeur », permet de sécuriser les systèmes de contrôle industriels. Elle place les contrôleurs derrière des pare-feu pour restreindre leur accès aux seuls personnels et protocoles autorisés.

AVERTISSEMENT

ACCÈS NON AUTHENTIFIÉ ET UTILISATION NON AUTORISÉE DE LA MACHINE

oEstimer si votre environnement ou vos machines sont connecté(e)s à votre infrastructure vitale et, le cas échéant, prendre les mesures nécessaires de prévention, basées sur le principe de défense en profondeur, avant de connecter le système d'automatisme à un réseau quelconque.

oLimiter au strict nécessaire le nombre d'équipements connectés à un réseau.

oIsoler votre réseau industriel des autres réseaux au sein de votre société.

oProtéger chaque réseau contre les accès non autorisés à l'aide d'un pare-feu, d'un VPN ou d'autres mesures de sécurité éprouvées.

oSurveiller les activités au sein de votre système.

oEmpêcher tout accès direct ou liaison directe aux équipements sensibles par des utilisateurs non autorisés ou des actions non authentifiées.

oPréparer un plan de récupération intégrant la sauvegarde des informations de votre système et de votre processus.

Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels.

Présentation des POU

Bloc fonction	Utilisation
FB_FTPClient	Met en œuvre un client FTP qui se connecte à un serveur FTP pour effectuer des opérations sur les fichiers et les répertoires.

Présentation des structures dans l'interface propre au module

Structure	Utilisation
ST_Credentials	Contient des informations propres à l'utilisateur, permettant de se connecter à un serveur FTP externe.
ST_Content	Contient les informations utilisateur concernant le répertoire sélectionné.
ST_Element	Sous-structure de ST_Content, contenant des informations propres aux éléments.

Présentation des énumérations

Énumération	Utilisation
ET_FtpCommand	Définit les commandes que le bloc fonction FB_FTPClient peut exécuter via i_etCommand.
ET_Result	Contient les valeurs possibles qui donnent les résultats des opérations exécutées par le bloc fonction.