Teilen über

Skripterstellungsfunktoid

  • Artikel

Mit dem Funktoid Skripting können Sie benutzerdefinierte Skripts oder Code zur Laufzeit verwenden, um Funktionen auszuführen, die andernfalls nicht verfügbar sind. Sie können beispielsweise eine .NET-Assembly zur Laufzeit aufrufen, indem Sie das Funktoid Skripting verwenden und Ihre eigenen benutzerdefinierten Funktionen schreiben.

Das Funktoid Skripterstellung unterstützt die folgenden Sprachen:

  • C# .NET

  • JScript .NET

  • Visual Basic .NET

  • Extensible Stylesheet Language Transformations (XSLT)

  • XSLT-Aufrufvorlagen

    Ein weiterer wichtiger Unterschied zwischen dem aktuellen Funktoid Scripting und früheren Versionen besteht darin, dass das Skript nicht mehr erstellt und im Funktoid selbst gespeichert werden muss. Stattdessen können Sie das Skript in einer separaten .NET-Assembly erstellen und über die Script-Eigenschaft auf die Assembly verweisen. Wenn sich Ihre Skripte in einer separaten Assembly befinden, können Sie sie in mehr als nur einer Zuordnung verwenden. Darüber hinaus können Sie möglicherweise Skript-Funktoidassemblys von Drittanbietern erwerben.

    Sie können skriptbasierte Funktoide verwenden, die in früheren Versionen von BizTalk Mapper mit der aktuellen Version von BizTalk Mapper erstellt wurden. Diese Funktoide müssen jedoch zuerst migriert werden. Weitere Informationen zum Migrieren von Skript-Funktoiden finden Sie unter Migrieren von Funktoiden.

    Wenn Sie einer Karte ein Funktoid Skripting hinzufügen, müssen Sie das Skript konfigurieren, das das Funktoid verwendet. Wenn Sie ein Funktoid Skripterstellung auswählen, wird die Script-Eigenschaft im Fenster Eigenschaften aktiviert. Wenn Sie für diese Eigenschaft auf die Schaltfläche mit den Auslassungspunkten (...) klicken, wird das Dialogfeld Funktoid Skripterstellung konfigurieren geöffnet. Alternativ können Sie auf das Funktoid Skripterstellung doppelklicken.

    Die folgende Tabelle enthält die Felder dieses Dialogfelds.

Dialogfeld „Skriptingfunktoid konfigurieren“ BESCHREIBUNG
Skripttyp auswählen Verwenden Sie dieses Feld, um den Typ des Skripts auszuwählen, den Sie in diesem Funktoid Skripterstellung verwenden möchten.

Werte:

- Externe Assembly. Verwenden Sie diesen Wert, wenn Sie das Funktoid Skripterstellung einer Assembly im globalen Assemblycache (GAC) zuordnen möchten. Warnung: Der Code in der externen Assembly muss threadsicher sein. In Situationen mit hoher Last können mehrere Instanzen einer Zuordnung gleichzeitig ausgeführt werden.
- Inline-C#. Verwenden Sie diesen Wert, wenn Sie das Funktoid Skripterstellung dem C#-Code im Inlineskriptpuffer zuordnen möchten.
- Inline JScript .NET. Verwenden Sie diesen Wert, wenn Sie das Funktoid Skripterstellung dem JScript .NET-Skript im Inlineskriptpuffer zuordnen möchten.
- Inline Visual Basic .NET. Verwenden Sie diesen Wert, wenn Sie das Funktoid Skripterstellung dem .NET-Code von Visual Basic im Inlineskriptpuffer zuordnen möchten.
- Inline-XSLT. Verwenden Sie diesen Wert, wenn Sie das Funktoid Skripterstellung XSLT im Inlineskriptpuffer zuordnen möchten.
- Inline-XSLT-Aufrufvorlage. Verwenden Sie diesen Wert, wenn Sie das Funktoid Skripterstellung xslt-Aufrufvorlagen im Inlineskriptpuffer zuordnen möchten.
Skriptassembly Wählen Sie die Assembly aus, die dem Funktoid Skripterstellung zugeordnet werden soll. In dieser Liste werden nur die Assemblys angezeigt, auf die im Projektfenster verwiesen wird. Denken Sie auch daran, dass die Assemblys im globalen Assemblycache registriert werden müssen.

Dieses Feld ist nur verfügbar, wenn Skripttyp auswählen auf Externe Assembly festgelegt ist.
Skriptklasse Wählen Sie die Klasse in der ausgewählten Assembly aus, die dieses Funktoid Skripting verwenden soll.

Dieses Feld ist nur verfügbar, wenn Skripttyp auswählen auf Externe Assembly festgelegt ist.
Skriptmethode Wählen Sie die Methode in der ausgewählten Klasse aus, die von diesem Funktoid Skripting verwendet werden soll. Hinweis: Stellen Sie sicher, dass die anzahl der von der -Methode erwarteten Eingabeparameter mit der Anzahl der Eingabeparameter übereinstimmt, die im Dialogfeld Funktoid Skript konfigurieren angegeben ist.
Inlineskript Schreiben oder kopieren Sie das zu verwendende Inline-Skript in dieses Textfeld. Gültige Sprachen und Skripts sind: C#, JScript .NET, Visual Basic .NET, XSLT und XSLT-Aufrufvorlagen.

Dieses Feld ist nur verfügbar, wenn Skripttyp auswählen auf eine der Inlineeinstellungen festgelegt ist. Vorsicht: Vermeiden Sie es, dieselbe Methodensignatur mehr als einmal zu verwenden. Wenn verschiedene Funktoide vom Typ Skripterstellung die gleiche Methodensignatur verwenden, wählt BizTalk die erste Implementierung aus und ignoriert die anderen.

Die folgende Abbildung zeigt, wie das Funktoid Skripterstellung in einer Karte angezeigt wird, indem das C#-Skript .NET verwendet wird, um eine Telefonnummer neu zu formatieren.

Zuordnen mit C# zum Formatieren einer Telefonnummer.
Zuordnung mit Funktoid "Skripterstellung"

In diesem Abschnitt