Tutoriel sur les fonctions FPScript personnalisées

23.08.2021

FlexPro vous offre la possibilité de programmer vos propres fonctions en FPScript, de les enregistrer dans une base de données modèle et de les utiliser ensuite dans des formules FPScript. Une fonction FPScript est une formule qui utilise au moins un argument et qui est écrite en FPScript. Vous pouvez déclarer des arguments individuels ou multiples avec l'instruction Arguments.

Dans l'exemple suivant, vous apprendrez à programmer une fonction pour normaliser un ensemble de données, à l'enregistrer en tant que fonction FPScript, puis à l'utiliser.

Remarque :   L'exemple se limite à la mise en œuvre d'une fonction personnalisée dans le langage FPScript. Si vous souhaitez accéder à des bibliothèques externes (DLL) pour développer la fonction ou pour mettre des algorithmes existants à la disposition de FlexPro, vous devez implémenter la fonction FPScript personnalisée en VBA ou dans un autre langage de programmation compatible avec l'automatisation. Voir Une fonction FPScript personnalisée.

Enregistrement d'une fonction FPScript personnalisée

1.Créez une formule avec le code FPScript suivant :
 
Arguments Data, NormalizeTo
Si NormalizeTo == Empty Alors
  NormalizeTo = 1.
Fin
NormalizeTo * Données / Maximum(Données)
 
L'instruction Arguments transforme la formule en une fonction, qui doit recevoir une liste d'arguments lorsqu'elle est appelée.

2.Sélectionnez la formule dans la liste des objets et cliquez sur Accueil [Objets sélectionnés] > Enregistrer comme modèle.

3.Dans le premier écran de l'assistant de modèle, choisissez la fonction FPScript comme type de modèle, entrez Normalize comme nom et entrez Normalizes a data set for the comment.

Remarque :   Vous ne pouvez sélectionner le type de modèle de fonction FPScript que si une seule formule a été sélectionnée. En outre, la formule de la première ligne doit contenir le mot-clé Arguments et ne doit pas comporter d'erreurs de syntaxe.

4.Cliquez sur Suivant. Dans la description de l'argument Données, entrez L'ensemble de données à normaliser. Sélectionnez les types de données autorisés: entier de 16 bits à valeur à virgule flottante de 64 bits. Sélectionnez comme structures de données autorisées Série de données et Signal.

5.Cliquez sur Suivant. Dans la description de l'argument NormalizeTo, entrez la valeur à laquelle l'ensemble de données sera normalisé. Comme types de données autorisés, sélectionnez les valeurs entières de 16 bits à 64 bits à virgule flottante. Sélectionnez comme structures de données autorisées la valeur Scalar. Activez l'option Valeur par défaut et entrez 1.

6.Cliquez sur Suivant. Vérifiez les paramètres sur le dernier écran de l'assistant et enregistrez le modèle dans la base de données des modèles personnels. Fermez l'assistant.

7.La fonction Normaliser est maintenant stockée dans la base de données des modèles. Vous pouvez maintenant le supprimer de la base de données de votre projet. Pour ce faire, sélectionnez la fonction dans la liste des objets et appuyez sur la touche DELETE de votre clavier.

Utilisation d'une fonction FPScript personnalisée

1.Sélectionnez Insert [Data] > Signal > Sine pour créer un signal sinusoïdal synthétique.

2.Ensuite, cliquez sur Insertion [Données] > Formule pour créer une formule vide, puis cliquez sur Outils de formule/Conception [Insérer FPScript] > Fonction. Sélectionnez la catégorie Personnalisé, puis choisissez la fonction Normaliser.

3.Pour l'argument Data, entrez l'ensemble de données Signal à normaliser, et pour l'argument NormalizeTo, entrez la valeur 10.
Le code devrait maintenant ressembler à ceci : Normaliser(Signal, 10)

4.Cliquez maintenant sur le nom de la formule dans la liste des objets. La courbe sinusoïdale est maintenant affichée dans l'aperçu avec les valeurs extrêmes +-10.

Fournir une fonction FPScript personnalisée sur le réseau de l'entreprise

Remarque :   Cette option est uniquement disponible dans FlexPro Professional et Developer Suite.

1.Créez une nouvelle base de données projet et enregistrez-la sous le nom de bibliothèque FPScript dans un dossier quelconque du réseau.

2.Cliquez sur Fichier > Info > Organisateur et sélectionnez l'onglet Modèles dans la boîte de dialogue Organisateur .

3.Cliquez sur Bases de données de modèles partagés pour ouvrir la boîte de dialogue du même nom.

4.Cliquez sur Coller, puis sur le bouton situé à droite du champ nouvellement créé dans la liste.

5.Sélectionnez la base de données précédemment enregistrée, puis fermez les deux boîtes de dialogue en cliquant sur OK.

6.Dans la boîte de dialogue Organiser, sélectionnez le type de modèle Fonction FPScript.

7.Dans la partie gauche, sous Items available in, sélectionnez la bibliothèque FPScript . S'il n'est pas affiché dans la liste, cliquez sur Fermer la base de données du projet, puis sur Ouvrir la base de données du projet et sélectionnez le fichier.

8.Sur le côté droit, sous Items available in, sélectionnez la base de données des modèles personnels.

9.À droite dans la zone de liste, sélectionnez la fonction Normaliser, puis cliquez sur Copier pour la copier dans la base de données de modèles partagée.

10.Cliquez maintenant sur Supprimer pour supprimer la fonction de la base de données des modèles personnels.

Remarques :
Pour permettre à vos collègues d'utiliser les fonctions FPScript stockées dans la base de données des modèles de la bibliothèque FPScript, vous devez les saisir dans la liste des bases de données des modèles partagés, comme décrit aux étapes 2 à 5.
 
Les fonctions portant le même nom dans différentes bases de données de modèles sont chargées à partir de la base de données de modèles ayant la priorité la plus élevée. L'ordre suivant s'applique :
1) Base de données personnelle de modèles
2) Bases de données de modèles partagés dans l'ordre dans lequel elles sont saisies dans la section Bases de données de modèles partagésdans la liste.

Partager l’article ou envoyer par mail :

Vous serez probablement intéressé par les articles suivants :