Type 0 : définition des paramètres d'import 

Utilisation

Notez que, par paramètres d'import, vous devez comprendre paramètres d'import de la fiche d'instructions ou du cockpit (PPPI_IMPORT_PARAMETER), c'est-à-dire les valeurs transférées du module fonction à la fiche d'instructions ou au cockpit. Du point de vue du module fonction, il s'agit de paramètres d'export.

Vous définissez les paramètres d'import (paramètres d'export du module fonction) dans les appels dynamiques de fonction. Vous affectez au paramètre d'import la variable dont vous souhaitez transférer la valeur du module fonction à la fiche d'instructions ou au cockpit.

Vous pouvez afficher la variable dans la fiche d'instructions ou dans le cockpit.
Par ailleurs, vous pouvez utiliser la variable pour transférer la valeur aux instructions de process suivantes de la même fiche d'instructions ou du même cockpit. Notez, cependant, que la fonction peut être exécutée plusieurs fois lors du traitement de la fiche d'instructions.

Conditions préalables

Si vous souhaitez transférer la valeur d'une variable du module fonction à la fiche d'instructions ou au cockpit, celle-ci doit être définie dans la même fiche d'instructions ou le même cockpit. Dans les fiches d'instructions, la variable peut également avoir été définie pour la totalité de l'ordre de process.

Pour plus d'informations sur l'utilisation des variables système et des variables en général, reportez-vous à :

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

·        Utilisation des variables système dans les fiches d'instructions HTML

Activités

Lors de la définition des paramètres d'import, vous spécifiez les informations suivantes dans l'instruction de process :

·        Paramètres d'exportation du module fonction ;

·        Le cas échéant, la caractéristique transfert de paramètre facultatif pour les paramètres facultatifs dont vous ne souhaitez pas transférer la valeur lors de l'exécution de l'appel de fonction ;
Voir aussi : Type 0 : transfert de paramètre facultatif

·        Le nom du paramètre pour chaque paramètre à transférer ;

·        Les variables pour chaque valeur de paramètre à transférer.
Vous pouvez transférer la valeur d'une variable dans un paramètre uniquement si cette variable possède le même type de données que le paramètre du module fonction.

Lorsque le paramètre d'import a été saisi avec référence à un type de table, vous pouvez transférer une table entière de la fiche d'instructions au module function. Dans ce cas, vous devez avoir défini une demande de données répétée (table) pour l'édition. Si vous avez défini une demande de données simple, le système édite seulement la valeur de la première ligne de table. Seules les tables à colonne unique peuvent être traitées.

Paramètres d'import du type Table

Un module fonction peut être doté de paramètres d'import saisis en référence à un type de table. Un module fonction peut, en revanche, avoir également des paramètres de table concrets que vous définissez à l'aide de la caractéristique PPPI_TABLE_PARAMETER.
Voir aussi : Type 0 : définition des paramètres de table.

Les paramètres d'import du type Table sont définis de la même manière que les paramètres d'import simples à l'aide de la caractéristique PPPI_EXPORT_PARAMETER. Le système reconnaît automatiquement que ces paramètres sont saisis en référence à un type de table.

Vous pouvez utiliser les paramètres d'import du type Table pour transférer une variable à une variable de table de la fiche d'instructions. Ceci signifie que la variable à laquelle vous souhaitez transférer la valeur du module fonction doit être définie dans une demande de données répétée (table).

Définition des caractéristiques

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_IMPORT_PARAMETER	Paramètres d'import	Paramètres d'export du module fonction
< PPPI_STRING_VARIABLE ou < PPPI_FLOAT_VARIABLE ou < PPPI_DATE_VARIABLE ou < PPPI_TIME_VARIABLE	Reprise des valeurs dans la variable : < Valeur alphanumérique < Nombre à virgule flottante < Date < Heure	Variable du type de données : < Valeur alphanumérique < Nombre à virgule flottante < Date < Heure
PPPI_OPTIONAL_PARAMETER	Transfert de paramètre facultatif	<Transfert de paramètre non facultatif <Transfert de paramètre facultatif

Si vous souhaitez afficher la valeur de variable dans la fiche d'instructions ou le cockpit, vous devez définir une zone d'édition. Pour plus d'informations, reportez-vous à Type 0 : définition des zones d'édition pour les valeurs de variables.