Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le fonctoid Scripting vous permet d’utiliser un script personnalisé ou du code au moment de l’exécution pour exécuter des fonctions qui ne sont pas disponibles. Par exemple, vous pouvez appeler un objet COM au moment de l’exécution à l’aide du fonctoid Scripting et écrire votre propre script personnalisé.
Pour obtenir des informations conceptuelles sur le fonctoid Scripting, consultez le Scripting Fonctoid.
Pour ajouter le fonctoid Scripting à une carte et le configurer
Avec la boîte à outils Visual Studio active, cliquez sur l’onglet Fonctoids avancés pour sélectionner cette catégorie de fonctoids.
La liste des fonctoids avancés dans la catégorie choisie s’affiche.
Faites glisser la fonction Scripting représentée par l'image
de la boîte à outils à l’emplacement approprié sur une page de grille.Remarque
Le fonctoid sera placé sur la page de grille affichée. Si vous souhaitez placer le fonctoid sur une autre page de grille, vous devez d’abord afficher cette autre page de grille.
Remarque
Si vous construisez une carte à l’aide de plusieurs fonctoids ensemble, vous devez prendre en compte leur placement relatif de gauche à droite. Les fonctoids sont exécutés de gauche à droite. La sortie d’un fonctoid ne peut être utilisée comme entrée qu’à un autre fonctoid placé plus à droite.
Sélectionnez le fonctoid Scripting que vous venez d’ajouter à la page de grille affichée.
Dans la fenêtre Propriétés de Visual Studio, cliquez sur le bouton des points de suspension (...) associé à la propriété Script.
Remarque
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 de script sélectionné.
Dans la boîte de dialogue Configurer le fonctoid de script, dans la liste déroulante Sélectionner le type de script, sélectionnez le type de votre script.
Remarque
Selon votre sélection de type de script, différents sous-ensembles des champs de boîte de dialogue restants sont activés et désactivés.
Si vous avez sélectionné l’assembly externe comme type de script, utilisez les listes déroulantes d’assembly de script, de classe script et de méthode script , dans cet ordre, pour sélectionner l’assembly, la classe et la méthode, respectivement, pour l’associer à ce fonctoid Scripting .
Avertissement
Le code de l’assembly externe doit être sécurisé pour les threads. Dans des conditions de contrainte, plusieurs instances d’une carte peuvent s’exécuter simultanément.
Remarque
Une fois que vous avez sélectionné un assembly, la liste déroulante de classes 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 de méthode script est remplie avec les méthodes de cette classe.
Remarque
La zone de texte du 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 de script inline pour entrer votre script dans la langue que vous avez sélectionnée.
Remarque
Les choix de langage inline pour le fonctoid Scripting incluent C# .NET, JScript.NET, Visual Basic .NET, XSLT et XSLT Call Template.
L’écriture de scripts à l’aide de C# n’autorise pas les instructions « using ». Si le script doit utiliser des classes .Net spéciales, les assemblys correspondants et leurs assemblys dépendants doivent être ajoutés à « Références » dans le projet BizTalk, et le code de script doit utiliser des noms complets. Si vous écrivez un script pour effectuer une conversion en minuscules sensibles à la culture, le fragment de code correspondant doit être écrit comme indiqué ci-dessous. Les limitations similaires s’appliquent à toutes les langues de script prises en charge.
string x = y.ToLower(System.Globalization.CultureInfo.CurrentCulture);Dans le script, pour utiliser des classes de n’importe quel assembly, veillez à ajouter l’assembly correspondant et ses assemblys dépendants à « Références » dans le projet BizTalk contenant votre carte.
Remarque
Vous pouvez créer votre script personnalisé directement dans la zone de texte du script inline , ou vous pouvez créer votre script ailleurs et le coller dans la zone de texte du script inline .
Remarque
Les listes déroulantes pour l’assembly du script, la classe du script, et la méthode du script sont désactivées lorsque vous sélectionnez l’un des choix intégrés (autre que l’assembly externe) comme type de script.
Important
Si vous créez un script contenant plusieurs fonctions, la première fonction sera traitée comme la fonction principale ou principale ; Les autres fonctions sont appelées uniquement si elles sont appelées dans l’exécution de la fonction principale.
Cliquez sur OK.
Si votre script ou la méthode associée dans un assembly externe nécessite des paramètres d’entrée, créez le nombre approprié et le type de liens d’entrée comme vous le feriez 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 comme entrée à un autre fonctoid, de la même façon que les fonctoids de base.