Actions

Les ensembles nommés d'étiquettes, de rapports, d'actions Logic et de lignes de base de données qu'un essai émet au Démarrage ou à la Fin, leurs commandes, les correspondances de marqueurs d'une étiquette, les colonnes d'une ligne de base de données, et comment une procédure les sélectionne.

Une action est un ensemble nommé de documents qu'un essai émet : à l'intérieur, une commande par émission, chacune disant ce qui sort (une étiquette, un rapport, l'exécution d'une action Logic ou une ligne dans une base de données de l'usine), quand (au Démarrage ou à la Fin), avec quel modèle de la bibliothèque de la station, quelle action Logic ou quelle table de base de données et, à la Fin, pour quels verdicts. Une procédure sélectionne des actions entières, donc un ensemble écrit une fois sert chaque procédure qui l'émet, et corriger une commande est une seule modification au lieu d'une par procédure. Les actions vivent sous Process > Modèles > modèle > Réglage > Actions du modèle. Les créer, les retirer et modifier le nom d'une action, ses commandes et leurs correspondances dépendent tous de la même permission Modifier recettes et évaluations, et les pages le disent (« Changer les actions exige la permission « Modifier recettes et évaluations ». »).

Le dossier Actions

Sélectionner la ligne Actions du modèle ouvre une page différente des autres dossiers de Réglage : une liste des actions du modèle à côté de celle qui y est choisie, parce qu'une action se lit face à ses voisines. L'ordre de la liste est l'ordre dans lequel toute procédure émet les actions, donc les verbes de ligne déplacent une action et jamais une commande. La page charge les deux bibliothèques de la station (modèles d'étiquette et mises en page de rapport) pour juger de l'état de préparation ; quand l'une ne peut pas être chargée, un bandeau indique « Les modèles d'étiquette globaux n'ont pas pu être chargés : … » ou « Les rapports globaux n'ont pas pu être chargés : … ».

La colonne à côté de la liste est titrée Action du modèle et montre le Nom de l'action choisie (modifiable là aussi), ses Commandes comme des lignes en lecture seule portant chacune un badge Prête ou À vérifier (« Les commandes se modifient sur la page propre de cette action dans la colonne, dans cet ordre. »), et un bandeau À vérifier qui liste tout ce qui manque. Sans aucune action, la liste indique « Aucune action. Ajoutez-en une quand une procédure de ce modèle doit émettre des étiquettes ou des rapports, exécuter des actions Logic ou écrire des lignes de base de données. » ; sans rien de choisi, la colonne indique « Sélectionnez une action pour lire ce qu'elle émet. Ses commandes se modifient sur sa propre page dans la colonne. »

La page de l'action

Sélectionner une action dans l'arborescence l'ouvre : l'en-tête avec le nom de l'action et un badge qui compte ses commandes, les bandeaux de permission et de bibliothèque, une carte Action du modèle avec le champ Nom (validé quand vous quittez le champ ; vide refusé), et la liste Commandes à côté de la commande qui y est choisie.

La liste des commandes

Sans aucune commande, la liste indique « Aucune commande. Ajoutez-en une quand cette action doit émettre une étiquette ou un rapport. » ; sans rien de choisi, la colonne indique « Sélectionnez une commande pour tout modifier au même endroit. Ajoutez-en une depuis la barre ci-dessus quand cette action doit émettre une étiquette ou un rapport. »

La commande en entier

La colonne ouvre la commande choisie, titrée Commande <n> · <Type> (<Déclencheur>). Elle ne montre que les champs que le type choisi possède.

Un bandeau À vérifier sous les champs liste tout ce qui manque à la commande (voir État de préparation ci-dessous).

La file vers laquelle part un document imprimé n'est pas un champ de la commande : elle est résolue par le type et le déclencheur de la commande à travers les quatre emplacements d'imprimante de l'unité, donc deux commandes de la même combinaison partagent l'imprimante délibérément. Voir Imprimantes. Une commande d'action Logic n'imprime rien et n'a pas d'emplacement.

Commandes d'action Logic

Une commande d'action Logic est le point d'accroche qu'un essai laisse à qui programme la station : à une frontière, elle exécute une action de Logic, qui peut envoyer l'essai vers un autre système par n'importe quel pilote, allumer un voyant ou remettre un compteur à zéro. L'action est choisie par son identité, donc la renommer sur la page Logic ne change rien ici ; son propre éditeur liste cette commande dans sa carte Utilisé par.

Plusieurs commandes d'action Logic d'un même moment s'exécutent l'une après l'autre, dans l'ordre d'émission ci-dessous, et aucune n'est sautée parce qu'une précédente tourne encore : chaque essai a la sienne. Ce qu'un essai fait à l'action se lit sur la page de l'action : son rail DERNIÈRE EXÉCUTION nomme l'essai Process · <unit> · <action>, avec l'erreur et les écritures refusées s'il y en a eu, et le journal technique les conserve ; rien n'est écrit dans le fichier d'essai. Une action supprimée après la configuration de la commande est sautée et un avertissement est journalisé ; une action désactivée refuse de s'exécuter et en note la raison.

Commandes de ligne de base de données

Une commande Ligne de base de données ajoute une ligne à une table d'une base de données de l'usine, la table de traçabilité qu'un MES tient déjà : le numéro de série, le verdict et les valeurs mesurées de la pièce, sous les noms de colonne que cette table porte déjà. La ligne passe par un équipement du driver Database de la page Connector, qui détient la connexion et l'identification, donc la commande ne nomme aucun serveur et ne garde aucun mot de passe. La table existe déjà : la station n'en crée ni n'en modifie jamais, elle y ajoute seulement des lignes.

Pendant la lecture des tables, la ligne sous le sélecteur dit « Lecture des tables de la base de données… » ; quand elles ne peuvent pas être lues, elle dit pourquoi (« Les tables de <device> n'ont pas pu être lues : <cause> »), et une base de données de plus de 500 tables dit « La base de données contient plus de tables que la liste n'en montre : les 500 premières sont listées. » Une ligne de base de données naît, comme un rapport, pour tous les verdicts finaux.

Sous les champs, Colonnes de la table liste une ligne par colonne de la table, dans l'ordre de la table, chacune avec son type tel que la base de données l'écrit et, là où la table refuse une ligne sans valeur dans cette colonne (la colonne n'accepte pas de valeur vide, n'a pas de valeur par défaut et n'est ni une colonne d'identité, ni auto-incrémentée, ni calculée), la mention Exigée par la table. Chaque colonne reçoit une Valeur ; une colonne laissée à la base de données reste hors de la ligne, donc la base de données la remplit avec sa propre valeur par défaut.

Les valeurs à la Fin sont celles que le LastRun de l'unité sert à Logic, un critère étant replié sur chaque cycle où il a été jugé ; un champ que l'essai n'a pas demandé, et un critère qu'il n'a pas jugé, ne donnent aucune valeur (NULL). Relire les colonnes, dans l'en-tête de la liste, relit les colonnes de la table dans la base de données : une colonne garde la valeur qu'on lui a donnée, une nouvelle rejoint la liste sans aucune, et une que la table n'a plus la quitte.

La ligne est un seul INSERT qui nomme les colonnes ayant une valeur, chaque valeur étant un paramètre de son propre type et jamais du texte écrit dans l'instruction, donc un numéro de série contenant des apostrophes ou des mots SQL est enregistré comme le texte qu'il est. La base de données convertit chaque valeur au type de sa colonne comme elle convertit n'importe quelle valeur. Une base de données qui refuse la ligne, ne répond pas dans les 10 secondes du driver ou ne peut pas être jointe se contente d'avertir : l'essai n'est pas touché, le journal technique consigne le refus, et le dossier de l'essai garde la ligne avec le refus et sa raison dans le dossier Lignes de base de données des Historiques. Rien n'est gardé pour être envoyé plus tard ; Renvoyer, là, envoie les mêmes valeurs à la main. Plusieurs lignes de base de données d'un même moment sortent l'une après l'autre, dans l'ordre d'émission ci-dessous.

Ce qui manque à une commande de ligne de base de données entre dans la liste de l'État de préparation ci-dessous, dans l'ordre où on le répare : « Choisissez un équipement Database. », « L'équipement Database qu'elle nomme n'existe plus. », « L'équipement qu'elle nomme, <device>, n'est pas un équipement Database. », « Choisissez une table. », « Donnez une valeur à au moins une colonne : une ligne sans colonne n'est pas écrite. », « <column> est exigée par la table et n'a pas de valeur. », « <column> : cette valeur n'existe pas encore au démarrage ; seuls un champ de métadonnées ou un texte fixe existent alors. », « <column> : sélectionnez un champ du catalogue de métadonnées de ce modèle. » et « <column> : sélectionnez un critère dans l'une des évaluations de ce modèle. » Ce que seule la base de données peut dire est lu tant que la commande est ouverte sur cette page, et entre là dans la même liste : « La table <table> n'est plus dans la base de données. », « <column> n'est plus une colonne de la table. Relisez les colonnes. », « La table a des colonnes que cette commande n'a pas encore lues : <columns>. Relisez les colonnes. » et « La table n'a pas pu être lue dans la base de données : <cause> ». Une procédure qui sélectionne l'action dit ce qui lui manque pour une colonne : « La colonne <column> lit un champ de métadonnées que cette procédure ne demande pas. Cochez-le dans Métadonnées ci-dessus. », « La colonne <column> lit le résultat d'un critère, et cette procédure ne juge par aucune évaluation. » ou « La colonne <column> lit un critère que l'évaluation de cette procédure ne déclare pas. »

Marqueurs

Les marqueurs sont les champs {{NAME}} qu'un modèle d'étiquette laisse à l'essai pour qu'il les remplisse, donc cette section est dessinée pour une commande d'étiquette et pour rien d'autre. Son état suit le modèle :

Les sources, dans l'ordre où le sélecteur les liste :

Sous les lignes de marqueur, Marqueurs retirés liste les correspondances enregistrées pour des marqueurs que le modèle actuel ne déclare plus (« <n> périmées » ; « Ces correspondances n'existent plus dans le modèle sélectionné et doivent être retirées. »), chacune avec Retirer la correspondance de marqueur périmée.

État de préparation

Les badges Prête / À vérifier des deux pages, et les lignes que liste la page Vérification, viennent d'un seul jugement. Une action sans commande en manque d'une : « Ajoutez une commande : cette action n'émet encore rien. » Une commande manque de ceci, dans l'ordre où cela se répare :

• « Sélectionnez au moins un verdict de fin. » (une commande de Fin sans aucun verdict coché)
• « Choisissez un rapport. » / « Le rapport sélectionné n'existe plus. »
• « Choisissez une action Logic. » / « L'action Logic qu'elle nomme n'existe plus. » / « L'action Logic qu'elle nomme est désactivée : elle est refusée chaque fois qu'elle est déclenchée. »
• « Choisissez un modèle d'étiquette. » / « Le modèle a été effacé ou supprimé ; les correspondances enregistrées sont conservées. » / « Le modèle global sélectionné n'existe plus. »
• « Le modèle sélectionné n'a encore aucune commande d'imprimante ; écrivez-les ou importez-les avant qu'un essai n'atteigne cette commande. »
• « Les marqueurs du modèle ne peuvent pas être lus : <error> »
• « {{M}} a besoin d'une source. » / « {{M}} est associé plus d'une fois. »
• « {{M}} : choisissez une source », « cette source n'est pas disponible au démarrage », « sélectionnez un champ du catalogue de métadonnées de ce modèle », « sélectionnez un critère dans l'une des évaluations de ce modèle », « fixez un cycle explicite, numéroté à partir de zéro, de 0 à <n> », « retirez les décimales de cette source de date et heure », « utilisez le format par défaut pour cette source numérique », « les décimales doivent être comprises entre 0 et 9 », « retirez la mise en forme numérique ou de date de cette source de texte »
• « {{M}} a été retiré du modèle actuel ; supprimez sa correspondance enregistrée. »

Une commande à vérifier s'exécute tout de même : rien n'est abandonné à l'émission, et un marqueur qui ne peut pas se résoudre fait échouer cette seule étiquette, comme toujours. L'écran de configuration est l'endroit où cela s'apprend, pas l'étiquette imprimée.

Comment une procédure sélectionne des actions

La page d'une procédure porte la carte Actions que cette procédure émet avec un badge « <n> sélectionnées » et une case à cocher par action du modèle, dans l'ordre de la liste. Chaque ligne montre la ligne d'émission de l'action (« Étiquette au démarrage, Étiquette et rapport à la fin », ou « N'émet encore rien : cette action n'a aucune commande. ») et, une fois sélectionnée, un badge Prête ou À vérifier. À vérifier liste ce qui manque à cette procédure pour les marqueurs de l'action, une remarque par marqueur, parce qu'un marqueur résolu par essai ne se résout que là où la procédure a ce qu'il nomme :

• « {{M}} lit un champ de métadonnées que cette procédure ne demande pas. Cochez-le dans Métadonnées ci-dessus. »
• « {{M}} lit le résultat d'un critère, et cette procédure ne juge par aucune évaluation. »
• « {{M}} lit un critère que l'évaluation de cette procédure ne déclare pas. »
• « {{M}} lit le cycle <c>, et cette procédure n'exécute qu'un seul cycle. » / « … et cette procédure en exécute <n>. »
• « L'action Logic qu'elle nomme n'existe plus. » (une commande d'action Logic de l'action, dont l'action a été supprimée : la procédure n'exécuterait rien à sa place)

L'action n'est ni cachée ni refusée : la procédure dit ce qui lui manque, et le remède est sur la même page. Sans aucune action dans le modèle, la carte indique « Aucune action dans ce modèle pour l'instant. Ajoutez-en sous les Actions du modèle. »

L'ordre d'émission

À une frontière d'essai, les actions sélectionnées émettent dans l'ordre de la liste du modèle, et à l'intérieur de chaque action dans son ordre de commandes, filtrées sur le déclencheur de cette frontière : une seule réponse pour tout le modèle, jamais une par procédure. Les commandes de Démarrage s'exécutent une fois l'essai matérialisé (après la réservation des métadonnées séquentielles), et les commandes de Fin une fois le verdict final scellé. Chaque commande est isolée : un échec ne publie rien, ne change rien à l'essai et n'arrête jamais les commandes derrière elle. Un rapport est nommé d'après l'essai et l'action qui l'a émis ; un rendu ultérieur de la même commande remplace le document de cette commande et rien d'autre. Une commande d'action Logic garde cet ordre parmi les commandes d'action Logic de son moment ; quand elle s'exécute est dit sous Commandes d'action Logic. Ce que chaque émission enregistre dans l'essai, et comment elle est réémise depuis les Historiques, est sur Émettre des étiquettes et des rapports.

Ce qu'une action ne fait pas

• Elle n'émet rien toute seule. Une procédure doit la sélectionner, et un essai de cette procédure doit atteindre la frontière.
• Elle ne contrôle pas la procédure. Que la procédure demande le champ ou juge par l'évaluation qu'un marqueur nomme est indiqué sur la page de la procédure, à côté de la sélection.
• Elle ne choisit pas l'imprimante. La file est celle de l'unité, par type et par déclencheur, sur Imprimantes.
• Elle ne modifie aucun modèle de document. Les commandes d'étiquette et les mises en page de rapport s'écrivent sous Modèles de documents ; l'action ne fait que les nommer.
• Elle ne confirme aucune impression physique. L'acceptation par la file est ce qu'une étiquette ou un rapport imprimé enregistre, jamais la preuve que du papier est sorti.
• Elle n'attend pas une action Logic et ne l'enregistre pas dans l'essai. Le résultat de l'action est sur sa propre page dans Logic et dans le journal technique.
• Elle ne crée ni ne modifie aucune table, et ne garde pas une ligne refusée pour l'envoyer plus tard. Une ligne de base de données va dans une table que la base de données de l'usine contient déjà ; un refus est enregistré dans l'essai et renvoyé à la main depuis Historiques.