Type 0 : définition des paramètres
d'export 
Utilisation
Notez que, par paramètres d'export, vous devez comprendre paramètres d'export de la fiche d'instructions ou du cockpit (PPPI_EXPORT_PARAMETER) ; c'est-à-dire, les valeurs transférées de la fiche d'instructions ou du cockpit au module fonction. Du point de vue du module fonction, il s'agit de paramètres d'import.
Vous définissez les paramètres d'export (paramètres d'import du module fonction) dans les appels dynamiques de fonction et les validations des entrées qui sont exécutées via une fonction de contrôle.
Conditions préalables
Si vous souhaitez transférer la valeur d'une variable au module fonction, 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’export, vous spécifiez les informations suivantes dans l'instruction de process :
·
Tous les paramètres
d'import obligatoires du module
fonction ;
Les paramètres d'import sont obligatoires lorsque le code Facultatif n'est pas activé. Ils doivent être spécifiés dans l'instruction de
process.
·
Les paramètres
d'import facultatifs du module
fonction pour lequel vous ne souhaitez pas utiliser la valeur par défaut
définie dans le module fonction ;
Les paramètres d'import sont facultatifs lorsque le code Facultatif est activé. Il n'est pas nécessaire de les spécifier dans
l'instruction de process.
·
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 ;
·
La variable, la
constante ou la caractéristique du message pour chaque valeur de paramètre à transférer.
Vous pouvez transférer la valeur d'une variable ou d'une constante dans un
paramètre uniquement si la variable ou la constante possède le même type de
données que le paramètre du module fonction.
Notes sur la valorisation des paramètres
· Si la valeur est disponible dans l'ordre de process, saisissez-la en tant que valeur fixe sous la forme suivante :
-
Constante
La caractéristique que vous utilisez pour définir la constante détermine
également le type de données de la constante.
-
Caractéristique de message
Si vous souhaitez utiliser une caractéristique de message, la caractéristique
doit posséder le même type de données que le paramètre du module
fonction. Il peut s'avérer utile d'utiliser une
caractéristique de message si la valeur de caractéristique est affectée dans
l'ordre.
· Si la valeur est disponible uniquement dans la fiche d'instructions, vous pouvez la transférer d'une instruction de process précédente via une variable. La variable possède le même type de données que la valeur à laquelle elle se réfère. Dans l'instruction de process, vous devez affecter la variable à la caractéristique appropriée en fonction du type de données.
Lorsque le paramètre d'export 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.
· Dans les validations des entrées, utilisez la variable SY_VALUE ou X pour transférer la valeur de saisie à vérifier. La variable se réfère toujours à la dernière valeur saisie.
Paramètres d'export du type Table
Un module
fonction peut être doté de paramètres d'export 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'export du type Table sont définis de la même manière que les paramètres d'export 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'export du type Table pour transférer une variable de table de la fiche d'instructions à un module fonction. Ceci signifie que la variable que vous souhaitez transférer au 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_EXPORT_PARAMETER |
Paramètres d'export |
Paramètres d'import du module fonction |
|
< PPPI_STRING_CONSTANT ou < PPPI_STRING_VARIABLE ou
|
Transfert de la valeur dans la constante : < Valeur alphanumérique Reprise des
valeurs dans la variable : Pour la
valorisation via la caractéristique de message : |
Toute valeur fixe du type de données : < Valeur alphanumérique Variable
existante du type :
|
|
PPPI_OPTIONAL_PARAMETER |
Transfert de paramètre facultatif |
<Transfert de paramètre non facultatif |