Hinzufügen und Entfernen benutzerdefinierter Funktoide in der Visual Studio-Toolbox

Artikel
07/21/2023

In diesem Thema wird beschrieben, wie Sie benutzerdefinierte Funktoide hinzufügen und benutzerdefinierte Funktoide aus der Visual Studio-Toolbox entfernen.

Hinzufügen benutzerdefinierter Funktoide zu Visual Studio

Benutzerdefinierte Funktoide müssen der Visual Studio-Toolbox hinzugefügt werden, bevor sie in einer Zuordnung verwendet werden können. Gehen Sie zum Hinzufügen von benutzerdefinierten Funktoiden wie folgt vor.

So fügen Sie ein benutzerdefiniertes Funktoid hinzu

Fügen Sie das Funktoid der Visual Studio-Toolbox hinzu.
1. Suchen Sie mithilfe von Windows-Explorer nach der Assembly, die Ihre benutzerdefinierten Funktoide implementiert.
2. Kopieren Sie die Assembly in das < Verzeichnis BizTalk Server Installationsordner>\Entwicklertools\Mapper-Erweiterungen. Hier sucht BizTalk-Mapper nach benutzerdefinierten Funktoiden.
3. Klicken Sie in einem Visual Studio BizTalk-Projekt im Menü Extras auf Toolboxelemente auswählen.
4. Klicken Sie im Dialogfeld Toolboxelemente auswählen auf die Registerkarte Funktoide BizTalk Mapper .
5. Klicken Sie auf Zurücksetzen und dann auf OK. Dieser Vorgang kann einige Sekunden in Anspruch nehmen.
  
  Die benutzerdefinierten Funktoide sollten nun in der Toolbox unter den Registerkarten angezeigt werden, die der jeweiligen Kategorie entsprechen.
  
  -ODER-
6. Klicken Sie in einem Visual Studio BizTalk-Projekt im Menü Extras auf Toolboxelemente auswählen.
7. Klicken Sie im Dialogfeld Toolboxelemente auswählen auf die Registerkarte Funktoide BizTalk Mapper .
8. Klicken Sie auf Zurücksetzen und dann auf OK.
  
  Hinweis
  
  Wenn das benutzerdefinierte Funktoid keinen Inlinecode bereitstellt, müssen Sie sicherstellen, dass die zugehörige Assembly im globalen Assemblycache zur Verfügung gestellt wird.
9. Klicken Sie im Menü Datei auf Beenden , um Visual Studio zu schließen.
10. Starten Sie die Visual Studio-Eingabeaufforderung.
11. Geben Sie an der Eingabeaufforderung devenv /setup ein.
12. Starten Sie Microsoft Visual Studio.
  
  Die benutzerdefinierten Funktoide werden auf der entsprechenden Registerkarte angezeigt.
Fügen Sie die Assembly zum globalen Assemblycache hinzu. Wenn die Assembly nur Inlinefunktoide enthält, können Sie diesen Schritt überspringen.
1. Starten Sie die Visual Studio-Eingabeaufforderung.
2. Wechseln Sie zu dem Ordner, der die Assembly enthält.
3. Geben Sie an der Eingabeaufforderung gacutil /if <assembly_path >ein. Wenn der Assemblyname beispielsweise FunctoidLibrary.dll ist, geben Sie gacutil /if FunctoidLibrary.dllein.
4. Wenn Sie fertig sind, geben Sie exit ein.

Entfernen von benutzerdefinierten Funktoiden aus Visual Studio

Gehen Sie zum Entfernen von benutzerdefinierten Funktoiden wie folgt vor.

So entfernen Sie ein benutzerdefiniertes Funktoid

Entfernen Sie das Funktoid aus der Visual Studio-Toolbox.
1. Klicken Sie in einem Visual Studio BizTalk-Projekt im Menü Extras auf Toolboxelemente auswählen.
2. Klicken Sie im Dialogfeld Toolboxelemente auswählen auf die Registerkarte Funktoide BizTalk Mapper .
3. Suchen Sie das benutzerdefinierte Funktoid in der Liste, aktivieren Sie das Kontrollkästchen Entfernen , und klicken Sie dann auf OK.
  
  -ODER-
4. Klicken Sie beim Bearbeiten einer Karte in einem Visual Studio BizTalk-Projekt auf die Registerkarte Toolbox , um die Toolboxpalette aufzurufen.
5. Klicken Sie auf die Funktoidgruppe, die das benutzerdefinierte Funktoid enthält.
6. Klicken Sie mit der rechten Maustaste auf das Funktoid, das Sie entfernen möchten, und klicken Sie dann auf Löschen , oder drücken Sie die Löschtaste.
Entfernen Sie die Funktoidassembly aus dem Verzeichnis Developer Tools\Mapper Extensions .

Achtung

Wenn eine Assembly aktive Funktoide enthält, dürfen Sie sie nicht entfernen. Andernfalls werden andere Zuordnungen unterbrochen.
1. Starten Sie Windows Explorer, und navigieren Sie zum Verzeichnis Entwicklertools\Mapper Extensions von BizTalk Server.
2. Klicken Sie mit der rechten Maustaste auf die Assembly, die das entfernte Funktoid enthält, und klicken Sie dann auf Löschen , um die Datei zu entfernen.
Entfernen Sie die Funktoidassembly aus dem globalen Assemblycache. Wenn die Assembly nur Inlinefunktoide enthält, können Sie diesen Schritt überspringen.

Achtung

Wenn eine Assembly aktive Funktoide enthält, dürfen Sie sie nicht aus dem globalen Assemblycache entfernen. Andernfalls werden andere Zuordnungen unterbrochen.
1. Starten Sie die Visual Studio-Eingabeaufforderung.
2. Geben Sie an der Eingabeaufforderung gacutil /u <assembly_display_name> ein. Wenn der Assemblyname beispielsweise FunctoidLibrary.dll ist, geben Sie gacutil /if FunctoidLibrary ein.
3. Wenn Sie fertig sind, geben Sie exit ein.

Weitere Informationen

Entwickeln benutzerdefinierter Funktoide

Teilen über