Gestionnaire de recettes

Présentation

Le Gestionnaire de recettes fournit une fonctionnalité permettant de gérer des listes définies par l'utilisateur de variables de projet (appelées définitions de recette) ainsi que des ensembles de valeurs pour ces variables (appelés recettes) dans une définition de recette.

Les recettes permettent de modifier ou de lire des valeurs de recette pour un ensemble de variables (définition de recette) sur le contrôleur. Elles peuvent également être chargées à partir de fichiers et y être enregistrées. Ces interactions sont possibles grâce à des éléments de visualisation que vous devez configurer de façon appropriée (commande d'exécution d'une configuration d'entrée). Vous pouvez également utiliser certaines commandes de recette dans l'application.

Après avoir sélectionné une recette, vérifiez qu'elle est adaptée au processus à contrôler.

AVERTISSEMENT
	FONCTIONNEMENT IMPRÉVU DE L'ÉQUIPEMENT Procédez à une analyse de sécurité de l'application et de l'équipement installé. Vérifiez l'adéquation entre la recette et le processus, l'équipement ou la fonction dans l'installation. Définissez les paramètres appropriés, notamment pour les limites et les autres éléments liés à la sécurité. Vérifiez que tous les capteurs et les actionneurs sont compatibles avec la recette sélectionnée. Effectuez un test approfondi de toutes les fonctions pendant la vérification et la mise en service. Établissez des chemins indépendants pour les fonctions de contrôle critiques (arrêt d'urgence, dépassement de limites, etc.) en fonction de l'analyse de la sécurité et des réglementations et consignes applicables. Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels.

AVERTISSEMENT

FONCTIONNEMENT IMPRÉVU DE L'ÉQUIPEMENT

Procédez à une analyse de sécurité de l'application et de l'équipement installé.
Vérifiez l'adéquation entre la recette et le processus, l'équipement ou la fonction dans l'installation.
Définissez les paramètres appropriés, notamment pour les limites et les autres éléments liés à la sécurité.
Vérifiez que tous les capteurs et les actionneurs sont compatibles avec la recette sélectionnée.
Effectuez un test approfondi de toutes les fonctions pendant la vérification et la mise en service.
Établissez des chemins indépendants pour les fonctions de contrôle critiques (arrêt d'urgence, dépassement de limites, etc.) en fonction de l'analyse de la sécurité et des réglementations et consignes applicables.

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

Par défaut, le gestionnaire de recettes est chargé sur le contrôleur lors du téléchargement. Il traite l'écriture et la lecture des recettes lors de l'exécution de l'application sur le contrôleur. Toutefois, si vous utilisez des recettes uniquement pour l'échange de paramètres au démarrage du système cible (lorsque EcoStruxure Machine Expert est encore connecté au contrôleur), il est inutile de charger le gestionnaire de recettes sur le contrôleur. Vous pouvez désactiver son téléchargement à l'aide de l'option Gestion des recettes dans l'API. L'écriture et la lecture des valeurs de la recette sont ensuite traitées par les commandes et les services en ligne standard. Si la gestion des recettes doit s'exécuter sur le contrôleur, car elle est requise par le programme d'application pendant l'exécution, le bloc fonction RecipeCommands est chargé de gérer les commandes de recette.

Pour une description du comportement des recettes dans les différents modes en ligne, consultez le chapitre Définition de recette.

Si le gestionnaire de recettes réside sur un contrôleur différent de l'application affectée par les recettes, la lecture/écriture de celles-ci est effectuée par le serveur de données. La lecture et l'écriture des variables est effectuée de façon synchrone. L'appel de g_RecipeManager.LastError après lecture/écriture permet de vérifier si la transmission a réussi (g_RecipeManager.LastError=0 dans ce cas).

Objets de gestion de recettes dans l'arborescence Outils

Pour ajouter un Gestionnaire de recettes dans l'arborescence Outils, sélectionnez le nœud Application, cliquez sur le signe plus de couleur verte, puis exécutez la commande Ajouter d'autres objets... > Gestionnaire de recettes.... Validez la boîte de dialogue Ajouter un gestionnaire de recettes en cliquant sur Ajouter. Le nœud Gestionnaire de recettes est inséré sous le nœud Application.

Vous pouvez ajouter un ou plusieurs objets Définition de recette sous un nœud Gestionnaire de recettes. Pour cela, cliquez sur le signe plus de couleur verte associé au nœud Gestionnaire de recettes et exécutez la commande Définition de recette.... Entrez un Nom dans la boîte de dialogue Ajouter à la définition de recette et cliquez sur Ajouter. Double-cliquez sur le nœud pour afficher et modifier les définitions de recette qui contiennent les recettes particulières dans une fenêtre d'éditeur séparée. Pour une description du comportement des recettes dans les différents modes en ligne, consultez le chapitre Définition de recette.

Editeur Gestionnaire de recettes, onglet Enregistrement

Par défaut, les recettes sont enregistrées automatiquement dans des fichiers en fonction des paramètres définis dans l'onglet Enregistrement de l'éditeur Gestionnaire de recettes.

Paramètre	Description
Type d'enregistrement	Sélectionnez le type d'enregistrement Textuel ou Binaire.
Chemin du fichier	Indiquez l'emplacement où doit être enregistrée la recette sur le contrôleur ou dans le système de fichiers local. NOTE : Pour les gestionnaires de recettes qui fonctionnent dans des simulations, le chemin d'accès au fichier doit commencer par un point (.), par exemple : `./Rcp`.
Extension de fichier	Indiquez l'extension du fichier de recette.

NOTE : Il est également possible de définir un fichier d'enregistrement avec l'entrée sur un élément de visualisation (entrée de la configuration, exécution de la commande, enregistrement/chargement d'une recette à partir d'un fichier). Toutefois, lors de la définition du nom d'un tel fichier dans la configuration de visualisation, veillez à ne pas supprimer le fichier *.txtrecipe / *.rcp défini ici dans le gestionnaire de recettes.

Paramètre	Description
Séparateur	Lors d'un enregistrement de type textuel, un séparateur délimite les colonnes sélectionnées pour l'enregistrement. Sélectionnez l'une des six options proposées.
Colonnes disponibles	Toutes les colonnes de la définition de recette représentées par leur en-tête respectif.
Colonnes sélectionnées	Colonnes sélectionnées dans la définition de recette, c'est-à-dire les colonnes à enregistrer. Cette sélection comporte au moins la colonne contenant la Valeur actuelle. Il est impossible de la désélectionner.
Boutons fléchés	Il est possible de déplacer les autres colonnes vers la droite ou vers la gauche en sélectionnant l'entrée appropriée et en cliquant sur les boutons fléchés. Vous pouvez également déplacer simultanément toutes les entrées d'un côté à l'autre à l'aide des boutons représentant des flèches doubles.
Boutons Monter et Descendre	Cliquez sur ces boutons pour modifier l'ordre des colonnes sélectionnées, soit l'ordre des colonnes dans le fichier d'enregistrement. Pour chaque recette, un fichier <nom de la recette>.<définition de la recette>.<extension de fichier> est créé dans le dossier spécifié. À chaque redémarrage de l'application, ce fichier sera rechargé dans le gestionnaire de recettes. Pour configurer l'actualisation des fichiers d'enregistrement de recettes, consultez la description de l'onglet Général.
Enregistrer comme défaut	Cliquez sur le bouton Enregistrer comme défaut pour utiliser comme paramètres par défaut les paramètres définis dans la boîte de dialogue pour chaque gestionnaire de recettes supplémentaire inséré.

NOTE : Les valeurs à virgule flottante (type REAL/LREAL) sont enregistrées dans les fichiers de recette textuels aux formats décimal et hexadécimal. (En effet, la valeur hexadécimale correspond à la valeur exacte, tandis que la valeur décimale REAL représente la valeur avec sept chiffres après la virgule.)

Exemple : PLC_PRG.realVar:=22.0F16#1600000H-5

Pour modifier manuellement une valeur du fichier de recette, modifiez la valeur décimale et supprimez l'entrée hexadécimale qui suit. (Lorsque les deux valeurs sont disponibles, la valeur hexadécimale est chargée.)

Éditeur Gestionnaire de recettes, onglet Général

Paramètre	Description
Gestion des recettes dans l'API	Si le gestionnaire de recettes est inutile sur le contrôleur faute de recette à traiter pendant l'exécution de l'application, vous pouvez désactiver cette option pour ne pas télécharger le gestionnaire. La mise à jour automatique du fichier de recettes est possible uniquement une fois le téléchargement terminé. Pour télécharger la gestion des recettes sur le contrôleur, sélectionnez cette option.
Enregistrer la recette
Enregistrer automatiquement les modifications des recettes dans les fichiers de recette	Cette option n'est disponible que si l'option Gestion des recettes dans l'API a été sélectionnée. Sélectionnez l'option Enregistrer automatiquement les modifications des recettes dans le fichier de recette pour mettre à jour les fichiers de recette automatiquement en mode exécution chaque fois qu'une recette est modifiée.
Charger la recette	Si l'option Gestion des recettes dans l'API est activée, les deux options suivantes sont disponibles pour configurer le téléchargement à partir du contrôleur.
Ne télécharger qu'en cas de conformité exacte avec la liste des variables	Sélectionnez cette option pour ne charger des fichiers de recette que si le fichier contient toutes les variables disponibles dans la liste des variables de la définition de recette de l'application. L'ordre des variables du fichier et de la liste doit être identique. Les entrées supplémentaires à la fin sont ignorées. Sinon, la recette ne peut pas être chargée et la valeur renvoyée ERR_RECIPE_MISMATCH est définie (RecipeManCommands.GetLastError).
Télécharger les variables avec nom coïncidant	Sélectionnez cette option pour ne charger que les variables dont le nom correspond dans le fichier de recette. Aucun état d'erreur n'est activé en cas d'incohérence entre la liste de variables du fichier et la liste de la définition de recette de l'application. Autrement dit, les fichiers de recette peuvent être chargés même si des variables du fichier ou de la définition de recette ont été supprimées.
Remplacer les recettes existantes lors du téléchargement	Sélectionnez cette option pour remplacer les fichiers de recette disponibles sur le contrôleur par les valeurs configurées dans le projet au démarrage de l'application. Si cette option n'est pas sélectionnée, les valeurs des fichiers de recette existants sont chargées. Condition préalable : le paramètre Type d'enregistrement est réglé sur Textuel et l'option Enregistrer automatiquement les modifications des recettes dans le fichier de recette est sélectionnée.
Ecrire la recette
Limiter la variable à min/max si la valeur de recette est hors plage	Sélectionnez cette option pour écrire la valeur minimale ou maximale définie sur le contrôleur si la recette contient une valeur hors de la plage spécifiée.
Ne pas écrire une variable si la valeur de recette est en dehors de la plage min/max	Sélectionnez cette option pour empêcher l'inscription d'une valeur sur le contrôleur si la recette contient une valeur hors de la plage spécifiée. La valeur enregistrée sur le contrôleur est conservée.
Lire la recette
Vérifier recette pour les changements	Utilisez le bloc fonction RecipeManCommands de la bibliothèque RecipeManagement pour lire des recettes. N'appelez pas la méthode de manière cyclique, car son exécution prend du temps et monopolise les capacités du contrôleur. Sélectionnez cette option pour lire les valeurs de variables présentes dans le contrôleur, dans la recette avec chaque appel de méthode. Le fichier de recette n'est mis à jour que si les valeurs ont été modifiées. Comme cette procédure génère du code supplémentaire pour comparer les valeurs anciennes et actuelles, considérez qu'elle a un impact sur les performances. Si cette option n'est pas sélectionnée, les valeurs de variable présentes dans le contrôleur sont lues dans la recette à chaque appel de méthode. Ensuite, la recette est écrite dans le fichier correspondant dans le système de fichiers local. NOTE : Cette opération d'écriture dans le système de fichiers local à chaque appel de méthode peut avoir un impact notable sur les performances du contrôleur.