Hinzufügen von Funktoiden 'Skripterstellung' zu einer Zuordnung

Mit dem Funktoid Skripterstellung können Sie benutzerdefinierte Skripts oder Code zur Laufzeit verwenden, um Funktionen auszuführen, die andernfalls nicht verfügbar sind. Beispielsweise können Sie ein COM-Objekt zur Laufzeit aufrufen, indem Sie das Skripterstellungs-Funktoid verwenden und Ihr eigenes benutzerdefiniertes Skript schreiben.

Konzeptionelle Informationen zum Skriptfunktions-Funktoid finden Sie unter Skripterstellung funktoid.

So wird das Funktoid 'Skripterstellung' zu einer Zuordnung hinzugefügt und konfiguriert

1. Wenn die Visual Studio-Toolbox aktiv ist, klicken Sie auf die Registerkarte Erweiterte Funktoide , um diese Kategorie von Funktoiden auszuwählen.

   Eine Liste mit erweiterten Funktoiden der ausgewählten Kategorie wird angezeigt.

2. Ziehen Sie das Skript-Funktoid aus der Toolbox an die entsprechende Position auf einer Rasterseite.

   Hinweis

   Das Funktoid wird auf der angezeigten Rasterseite platziert. Wenn Sie das Funktoid auf einer anderen Rasterseite platzieren möchten, müssen Sie diese andere Seite zuerst anzeigen.

   Hinweis

   Wenn Sie eine Karte mit mehreren Funktoiden zusammen erstellen, müssen Sie deren relative Position von links nach rechts berücksichtigen. Funktoide werden von links nach rechts ausgeführt. Die Ausgabe eines Funktoids kann nur in einem weiter rechts befindlichen Funktoid als Eingabe dienen.

3. Wählen Sie das Funktoid Skripterstellung aus, das Sie soeben der angezeigten Rasterseite hinzugefügt haben.

4. Klicken Sie im Visual Studio-Eigenschaftenfenster auf die Schaltfläche mit den Auslassungspunkten (...), die der Script-Eigenschaft zugeordnet ist.

   Hinweis

   Alternativ können Sie mit der rechten Maustaste auf das Funktoid klicken und dann im Kontextmenü auf Funktoidskript konfigurieren klicken. Das Dialogfeld Funktoid "Skripterstellung konfigurieren " wird mit ausgewählter Registerkarte Skript-Funktoidkonfiguration angezeigt.

5. Wählen Sie im Dialogfeld Funktoid Skript konfigurieren in der Dropdownliste Skripttyp auswählen den Typ Ihres Skripts aus.

   Hinweis

   Welche Untergruppen von Feldern in den Dialogfeldern daraufhin aktiviert bzw. deaktiviert werden, hängt vom ausgewählten Skripttyp ab.

6. Wenn Sie externe Assembly als Skripttyp ausgewählt haben, verwenden Sie die Dropdownlisten Skriptassembly, Skriptklasse und Skriptmethode in dieser Reihenfolge, um die Assembly, Klasse und Methode auszuwählen, die diesem Skripterstellungs-Funktoid zugeordnet werden sollen.

   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.

   Hinweis

   Nachdem Sie eine Assembly ausgewählt haben, wird die Dropdownliste Skriptklasse mit den Klassen in dieser Assembly aufgefüllt. Nachdem Sie eine Klasse ausgewählt haben, wird die Dropdownliste Skriptmethode mit den Methoden in dieser Klasse aufgefüllt.

   Hinweis

   Das Textfeld Inlineskript ist deaktiviert, wenn Sie externe Assembly als Skripttyp auswählen.

   Wenn Sie etwas anderes als externe Assembly als Skripttyp (eine der Inlineoptionen) ausgewählt haben, verwenden Sie das Textfeld Inlineskript , um Ihr Skript in der von Ihnen ausgewählten Sprache einzugeben.

   Hinweis

   Die Inlinesprachauswahl für das Skriptfunktions-Funktoid umfasst C# .NET, JScript.NET, Visual Basic .NET, XSLT und XSLT-Aufrufvorlage.

   Bei Skripting mithilfe von C# ist die Verwendung von Anweisungen unzulässig. Wenn das Skript besondere .NET-Klassen verwenden muss, sollten die entsprechenden Assemblys sowie deren abhängige Assemblys den „Verweisen“ im BizTalk-Projekt hinzugefügt werden, und der Skriptcode sollte außerdem vollqualifizierte Namen verwenden. Wenn Sie ein Skript für die Ausführung kulturabhängiger Konvertierung von Kleinbuchstaben schreiben, sollte das entsprechende Codefragment wie unten beschrieben erstellt werden. Ähnliche Einschränkungen gelten für alle unterstützten Skriptingsprachen.

   string x = y.ToLower(System.Globalization.CultureInfo.CurrentCulture);  
   

   Damit im Skript Klassen aus beliebigen Assemblys verwendet werden können, stellen Sie sicher, dass die entsprechende Assembly und deren anhängige Assemblys den „Verweisen“ im BizTalk-Projekt hinzugefügt werden, das Ihre Zuordnung enthält.

   Hinweis

   Sie können Ihr benutzerdefiniertes Skript direkt im Textfeld Inlineskript erstellen oder Ihr Skript an einer anderen Stelle erstellen und in das Textfeld Inlineskript einfügen.

   Hinweis

   Die Dropdownlisten Skriptassembly, Skriptklasse und Skriptmethode sind deaktiviert, wenn Sie eine der Inlineoptionen (etwas anderes als externe Assembly) als Skripttyp auswählen.

   Wichtig

   Wenn Sie ein Skript mit mehreren Funktionen erstellen, wird die erste Funktion als Hauptfunktion angesehen. Die anderen Funktionen werden nur beim Ausführen dieser Hauptfunktion aufgerufen.

   Klicken Sie auf OK.

7. Wenn für das Skript oder die zugeordnete Methode in einer externen Assembly Eingabeparameter erforderlich sind, erstellen Sie die entsprechende Anzahl und Typen von Eingabeverknüpfungen. Verfahren Sie dabei wie bei einem Standardfunktoid.

8. In den meisten Fällen erzeugt Ihr Skriptfunktions-Funktoid einen Ausgabewert, der zum Auffüllen eines Felds im Zielschema oder als Eingabe für ein anderes Funktoid verwendet wird, auf die gleiche Weise wie grundlegende Funktoide.

Weitere Informationen

Hinzufügen von erweiterten Funktoiden zu einer Zuordnung