Utilisation des variables dans les fiches d'instructions HTML et les cockpits

Utilisation des variables dans les fiches d'instructions HTML et les cockpits

Utilisation

Lors de la définition des instructions de process, vous pouvez utiliser les variables globales ou simples définies dans une autre instruction de process.

· Vous pouvez utiliser des variables simples dans les fiches d'instructions HTML et dans les cockpits de production. Cependant, ces variables sont valables seulement pour une même recette de contrôle ou un même cockpit.

· Les variables globales peuvent être échangées comme suit :

¡ À l'aide de la déclaration entre différentes fiches d'instructions d'un même ordre de process ;

¡ Comme des points de données à l'aide de l'interface interne Accès aux données de fabrication :

§ entre fiches d'instructions de différents ordres de process,

§ entre fiches d'instructions et cockpits,

§ entre différents cockpits.

Vous pouvez utiliser des variables, par exemple, dans les cas suivants :

· Pour transférer une valeur de caractéristique en tant que valeur par défaut pour la saisie ;
Voir aussi : Type 0 : définition des valeurs par défaut

· Pour transférer une valeur de caractéristique qui n'est disponible que dans la fiche d'instructions ou le cockpit en tant que valeur de paramètre dans les validations des entrées ;
Voir aussi : Type 0 : définition des validations des entrées

· Pour afficher dans la fiche d'instructions ou le cockpit des valeurs habituellement traitées en arrière-plan (par exemple, dans les calculs) ;
Voir aussi : Type 0 : définition des zones d'édition pour les valeurs de variables

· Pour transférer une valeur de caractéristique d'une instruction de process à une autre ;
Voir aussi : Type 0 : définition de la valorisation via des variables

· Pour transférer dans le module fonction la valeur d'un paramètre d'export, de table ou de modification qui n'est pas encore disponible dans la fiche d'instructions ou le cockpit.
Voir aussi : Type 0 : définition des paramètres d'export, Type 0 : définition des paramètres de table et Type 0 : définition des paramètres de modification.

Conditions préalables

· Si vous souhaitez transférer la valeur d'une variable à l'instruction de process actuelle, les conditions suivantes doivent être remplies :

¡ La variable simple doit être définie dans une même fiche d'instructions ou cockpit.

¡ La variable globale doit être définie pour la totalité de l'ordre de process.

Exception :
Vous n'avez pas à définir les variables système suivantes, qui sont définies par SAP et commencent par SY_, dans l'instruction de process :

Variable système	Signification
SY_MODE	Mode actuel de la fiche d'instructions
SY_TEST	Statut de la fiche d'instructions (test ou actif)
SY_ROW	Ligne de table actuelle
SY_VALUE et X	Fait référence à la valeur de saisie précédente

Voir aussi : Utilisation des variables système

· Le type de données de la variable doit être approprié à l'utilisation que vous souhaitez en faire. Vous devez utiliser :

¡ le type de données NUM pour les formules de contrôle des validations des entrées et les règles de calcul ;

¡ le type de données du paramètre correspondant pour les fonctions de contrôle des validations des entrées et les appels dynamiques de fonction ;

¡ le type de données de la valeur de saisie significative pour les valeurs par défaut ;

¡ tout type de données pour les valeurs d'édition ;

¡ le type de données de la caractéristique de message à laquelle affecter une valeur pour des demandes de données cachées.

Le type de données d'une variable est identique à celui de la caractéristique ou du paramètre auquel il fait référence.

Voir aussi : Définition des variables

Activités

Utilisation des variables simples

· Dans les demandes de données simples

Les variables simples définies dans une demande de données simple ou un appel de fonction font référence à une valeur précise. Dans ce cas, vous devez uniquement saisir le nom de la variable pour transférer la valeur dans une autre instruction de process.

Exemple

La variable simple VAR est définie pour la valeur de saisie « Quantité d'article ». La valeur de la variable VAR doit s'afficher dans l'instruction de process 0020 de la même fiche d'instructions.

Instruction de process 0010 :

	PPPI_INPUT_REQUEST	Quantité d'article
	PPPI_VARIABLE	VAR
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL_QUANTITY

Instruction de process 0020 :

	PPPI_OUTPUT_TEXT	Quantité d'article
	PPPI_OUTPUT_VARIABLE	VAR

· Dans les demandes de données répétées

Les variables simples définies dans une demande de données répétée représentent une colonne de table entière. Pour faire référence à une entrée de table particulière, vous devez étendre le nom de la variable. Les règles suivantes doivent être respectées :

<Nom de la variable>_1	®	Valeur de la première ligne du tableau
<Nom de la variable>_2	®	Valeur de la deuxième ligne du tableau
Etc.		Etc.
<Nom de la variable>_SUM	®	Total des valeurs de la colonne du tableau
<Nom de la variable>_COUNT	®	Nombre de valeurs dans la colonne de la table

Note

Les variables qui se réfèrent à des tables sont transférées ligne par la ligne. Si vous souhaitez afficher une variable comme valeur par défaut (PPPI_DEFAULT_VARIABLE), par exemple, le système affiche la valeur par défaut significative lorsqu'une nouvelle ligne est créée. Si aucune valeur n'a été affectée à une variable, la ligne dans la table éditée reste vide.

Utilisation de variables globales

Les options suivantes sont disponibles pour l'utilisation des variables globales :

· En tant que point de données
Si vous souhaitez échanger des variables entre fiches d'instructions et cockpits, vous devez utiliser l'interface interne Accès aux données de fabrication. Les valeurs de variable sont transférées lorsqu'elles ont été modifiées.

Pour plus d'informations sur l'accès aux données de fabrication, reportez-vous à :

¡ Accès aux données de fabrication

¡ Points de données de fabrication

¡ Type 0 : définition de l'accès aux données de fabrication

Utilisez les caractéristiques suivantes selon la séquence spécifiée :

Lecture des données

	Caractéristique	Signification
	PPPI_DATA_ACCESS	Accès aux données de fabrication
	PPPI_BUTTON_TEXT	Texte du bouton de commande
	PPPI_FUNCTION_DURING_DISPLAY	Paramétrage permettant d'indiquer si la fonction est autorisée en mode d'affichage
	PPPI_IMPORT_DATA	Variable globale de l'application depuis laquelle la valeur doit être transférée à la variable suivante
	Caractéristique de paramètre	Noms de variables avec le type de données correspondant

Exemple

La variable globale VARGL est définie pour la valeur de saisie « Quantité d'article » dans le cockpit PMC1.
La valeur de la variable globale VARGL doit être lue comme un point de données dans le cockpit PMC2 via l'interface Accès aux données de fabrication. La valeur de la variable VARGL doit être transférée à la variable locale VARLC et affichée dans le cockpit.

Cockpit PMC1 :

	PPPI_INPUT_REQUEST	Quantité d'article
	PPPI_GLOBAL_VARIABLE	VARGL
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL_QUANTITY

Cockpit PMC2 :

	PPPI_DATA_ACCESS	Accès aux données de fabrication
	PPPI_BUTTON_TEXT	Lire la quantité d'article de PCM1
	PPPI_FUNCTION_DURING_DISPLAY	Autorisé
	PPPI_IMPORT_DATA	PMC: 1100.PMC1.VARGL
	PPPI_STRING_VARIABLE	VARLC
	PPPI_OUTPUT_TEXT	Quantité d'article de PMC1
	PPPI_OUTPUT_VARIABLE	VARLC

Écriture des données

	Caractéristique	Signification
	PPPI_DATA_ACCESS	Accès aux données de fabrication
	PPPI_BUTTON_TEXT	Texte du bouton de commande
	PPPI_FUNCTION_DURING_DISPLAY	Paramétrage permettant d'indiquer si la fonction est autorisée en mode d'affichage
	PPPI_EXPORT_DATA	Point de données ou variable globale de l'application dans laquelle la valeur de la variable suivante doit être transférée
	Caractéristique de paramètre	Noms de variables avec le type de données correspondant

· Utilisation d'une déclaration
Si vous souhaitez échanger des variables entre fiches d'instructions d'un même ordre de process, vous pouvez utiliser la méthode de la déclaration.
Vous devez d'abord déclarer la variable globale dans la recette de contrôle dans laquelle vous souhaitez l'utiliser.
Lorsque vous utilisez les variables de cette façon, les valeurs de variable ne sont pas transférées avant que la fiche d'instructions soit clôturée. Vous pouvez déclarer les variables globales uniquement dans les fiches d'instructions.
Pour ce faire, définissez les informations suivantes dans l'instruction de process :

¡ Le nom de variable que vous souhaitez déclarer ;

¡ La caractéristique spécifiant le type de variable utilisé

Pour la saisie de ces informations, affectez les caractéristiques suivantes à l'instruction de process en respectant la séquence ci-dessous :

Caractéristique	Signification	Valeurs autorisées
PPPI_DECLARE_VARIABLE	Déclaration de la variable globale	Nom de variable existant
PPPI_VARIABLE_TYPE	Type de variable	Caractéristique utilisée pour définir la variable globale

Exemple

Fiche d'instructions 0001 :

	PPPI_INPUT_REQUEST	Quantité d'article
	PPPI_GLOBAL_VARIABLE	VARGL
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL_QUANTITY

Fiche d'instructions 0002 :

	PPPI_DECLARE_VARIABLE	VARGL
	PPPI_VARIABLE_TYPE	PPPI_MATERIAL_QUANTITY
	PPPI_OUTPUT_TEXT	Quantité d'article de
	PPPI_OUTPUT_VARIABLE	VARGL

Pour les demandes de données répétées, notez les points suivants :

Vous pouvez utiliser les variables globales pour transférer des tables entières (demande de données répétée) dans une autre recette de contrôle, par exemple un module fonction.

Cependant, à l'heure actuelle, il est impossible d'afficher la table entière dans la fiche d'instructions. Vous pouvez néanmoins vous référer aux valeurs individuelles d'une table. Pour ce faire, vous devez définir une variable avec une extension pour la ligne de table significative pour chaque valeur de table. À cette fin, ajoutez le suffixe _1, _2, _3 etc. au nom de variable pour chaque ligne de table.

Exemple :

WERT_1 ® Valeur de la première ligne de la table
WERT_2 ® Valeur de la deuxième ligne de la table
etc.

Pour pouvoir utiliser les variables dans une recette de contrôle, vous devez d'abord déclarer chaque nom de variable (avec le suffixe ci-dessus) dans la recette dans laquelle vous souhaitez utiliser la variable.