Ajout de fonctoids Script à un mappage
Le fonctoid Scripting vous permet d’utiliser un script ou du code personnalisé au moment de l’exécution pour effectuer des fonctions autrement non disponibles. Par exemple, vous pouvez appeler un objet COM au moment de l’exécution en utilisant le fonctoid Scripting et en écrivant votre propre script personnalisé.
Pour plus d’informations conceptuelles sur le fonctoid Scripting , consultez Scripting Fonctoid.
Pour ajouter le fonctoid Script à un mappage et le configurer
Une fois la boîte à outils Visual Studio active, cliquez sur l’onglet Fonctoids avancés pour sélectionner cette catégorie de fonctoids.
La liste de fonctoids de la catégorie choisie s'affiche.
Faites glisser l’image du fonctoid Scripting
de la boîte à outils à l’emplacement approprié dans une page de grille.Notes
Le fonctoid sera placé sur la page de grille affichée. Si vous voulez le placer sur une autre page de grille, vous devez d'abord afficher cette page.
Notes
Si vous construisez une carte à l’aide de plusieurs fonctoids, vous devez tenir compte de leur emplacement relatif de gauche à droite. Les fonctoids sont exécutés de la gauche vers la droite. La sortie d'un fonctoid ne peut être placée qu'en entrée d'un autre fonctoid qui se trouve à sa droite.
Sélectionnez le fonctoid Scripting que vous venez d’ajouter à la page de grille affichée.
Dans le Fenêtre Propriétés Visual Studio, cliquez sur le bouton de sélection (...) associé à la propriété Script.
Notes
Vous pouvez également cliquer avec le bouton droit sur le fonctoid, puis cliquer sur Configurer le script fonctoid dans le menu contextuel. La boîte de dialogue Configurer le fonctoid de script s’affiche avec l’onglet Configuration du fonctoid du script sélectionné.
Dans la boîte de dialogue Configurer le fonctoid de script, dans la liste déroulante Sélectionner un type de script , sélectionnez le type de votre script.
Notes
Selon votre sélection, différents sous-ensembles des autres champs de la boîte de dialogue seront activés et désactivés.
Si vous avez sélectionné Assembly externe comme type de script, utilisez les listes déroulantes Assembly de script, Classe de script et Méthode script , dans cet ordre, pour sélectionner respectivement l’assembly, la classe et la méthode à associer à ce fonctoid Scripting .
Avertissement
Le code contenu dans l’assembly externe doit être exempt de tout thread. Dans les situations de forte charge, il est possible d’exécuter plusieurs instances d’un mappage en même temps.
Notes
Une fois que vous avez sélectionné un assembly, la liste déroulante Classe de script est remplie avec les classes de cet assembly. De même, une fois que vous avez sélectionné une classe, la liste déroulante Méthode de script est remplie avec les méthodes de cette classe.
Notes
La zone de texte Script inline est désactivée lorsque vous sélectionnez Assembly externe comme type de script.
Si vous avez sélectionné autre chose que l’assembly externe comme type de script (l’un des choix inline), utilisez la zone de texte Script inline pour entrer votre script dans la langue que vous avez sélectionnée.
Notes
Les choix de langage inline pour le fonctoid Scripting incluent C# .NET, JScript.NET, Visual Basic .NET, XSLT et modèle d’appel XSLT.
La création de scripts à l'aide du langage C# n'autorise pas les instructions « using ». Si le script doit utiliser des classes .Net spéciales, les assemblys correspondants et leurs dépendances doivent être ajoutés aux « Références » du projet BizTalk ; en outre, le code de script doit utiliser des noms complets. Si vous écrivez un script pour effectuer une conversion en minuscules sensible à la culture, le fragment de code correspondant doit être écrit comme suit. Des restrictions similaires s'appliquent à tous les langages de création de scripts pris en charge.
string x = y.ToLower(System.Globalization.CultureInfo.CurrentCulture);Pour utiliser les classes d'un assembly dans le script, assurez-vous d'ajouter l'assembly correspondant et ses dépendances aux « Références » du projet BizTalk contenant votre mappage.
Notes
Vous pouvez créer votre script personnalisé directement dans la zone de texte Script inline , ou vous pouvez créer votre script ailleurs et le coller dans la zone de texte Script inline .
Notes
Les listes déroulantes Assembly de script, Classe de script et Méthode script sont désactivées lorsque vous sélectionnez l’un des choix inline (autre que l’assembly externe) comme type de script.
Important
Si vous créez un script contenant plusieurs fonctions, la première fonction sera considérée comme fonction principale, tandis que les autres sont uniquement appelées dans l’exécution de la fonction principale.
Cliquez sur OK.
Si votre script ou la méthode associée d’un assembly externe requiert des paramètres d’entrée, créez le nombre et le type appropriés de liens d’entrée comme pour un fonctoid de base.
Dans la plupart des cas, votre fonctoid scripting produit une valeur de sortie utilisée pour remplir un champ dans le schéma de destination ou en tant qu’entrée dans un autre fonctoid, de la même manière que les fonctoids de base.