このトピックでは、カスタム Functoid を Visual Studio ツールボックスに追加する方法と、カスタム Functoid を Visual Studio ツールボックスから削除する方法について説明します。
Visual Studio へのカスタム Functoid の追加
カスタム Functoid は、マップで使用する前に Visual Studio ツールボックスに追加する必要があります。 カスタム Functoid を追加するには、次の手順に従います。
カスタム Functoid を追加するには
Functoid を Visual Studio ツールボックスに追加します。
Windows エクスプローラーを使用して、カスタム Functoid を実装するアセンブリを見つけます。
アセンブリを <BizTalk Server インストール フォルダー>\Developer Tools\Mapper Extensions ディレクトリに コピーします。 これは、BizTalk マッパーがカスタム Functoid を検索する場所です。
Visual Studio BizTalk プロジェクトの [ツール ] メニューの [ ツールボックス項目の選択] をクリックします。
[ ツールボックス項目の選択 ] ダイアログ ボックスで、[ BizTalk マッパー Functoids ] タブをクリックします。
[ リセット] をクリックし、[OK] をクリック します。 このプロセスには、しばらく時間がかかる場合があります。
これで、カスタム Functoid がツールボックスのカテゴリに一致するタブの下に表示されます。
- または -
Visual Studio BizTalk プロジェクトの [ツール ] メニューの [ ツールボックス項目の選択] をクリックします。
[ ツールボックス項目の選択 ] ダイアログ ボックスで、BizTalk マッパー Functoids タブをクリックします。
[ リセット] をクリックし、[OK] をクリック します。
注
カスタム Functoid でインライン コードが公開されていない場合は、そのアセンブリがグローバル アセンブリ キャッシュで使用できることを確認します。
[ ファイル ] メニューの [ 終了 ] をクリックして Visual Studio を閉じます。
Visual Studio コマンド プロンプトを起動します。
コマンド プロンプトで、「 devenv /setup」と入力します。
Microsoft Visual Studio を起動します。
カスタム Functoid は、適切なタブに表示される必要があります。
アセンブリをグローバル アセンブリ キャッシュに追加します。 アセンブリにインライン Functoid のみが含まれている場合は、この手順をスキップできます。
Visual Studio コマンド プロンプトを起動します。
アセンブリを含むフォルダーに切り替えます。
コマンド プロンプトで、「gacutil /if <assembly_path >」 と入力します。 たとえば、アセンブリ名が FunctoidLibrary.dllの場合は、「 gacutil /if FunctoidLibrary.dll」 と入力します。
完了したら、「exit」と入力 します。
Visual Studio からのカスタム Functoid の削除
カスタム Functoid を削除するには、次の手順に従います。
カスタム Functoid を削除するには
Visual Studio ツールボックスから Functoid を削除します。
Visual Studio BizTalk プロジェクトの [ツール ] メニューの [ ツールボックス項目の選択] をクリックします。
[ ツールボックス項目の選択 ] ダイアログ ボックスで、[ BizTalk マッパー Functoids ] タブをクリックします。
カスタム Functoid を一覧から探し、[ 削除 ] チェック ボックスをオンにして、[OK] をクリック します。
- または -
Visual Studio BizTalk プロジェクトでマップを編集しているときに、[ ツールボックス ] タブをクリックしてツールボックス パレットを表示します。
カスタム Functoid を含む Functoid グループをクリックします。
削除する Functoid を右クリックし、[ 削除 ] をクリックするか、削除キーを押します。
Developer Tools\Mapper Extensions ディレクトリから Functoid アセンブリを削除します。
注意事項
アセンブリにアクティブな Functoid が含まれている場合は、削除しないでください。 そうすると、他のマップが壊れます。
Windows エクスプローラーを起動し、BizTalk Server の Developer Tools\Mapper Extensions ディレクトリに移動します。
削除した Functoid を含むアセンブリを右クリックし、[ 削除 ] をクリックしてファイルを削除します。
グローバル アセンブリ キャッシュから Functoid アセンブリを削除します。 アセンブリにインライン Functoid のみが含まれている場合は、この手順をスキップできます。
注意事項
アセンブリにアクティブな Functoid が含まれている場合は、グローバル アセンブリ キャッシュから削除しないでください。 そうすると、他のマップが壊れます。
Visual Studio コマンド プロンプトを起動します。
コマンド プロンプトで、「 gacutil /u <assembly_display_name>」と入力します。 たとえば、アセンブリ名が FunctoidLibrary.dll場合は、「 gacutil /if FunctoidLibrary」と入力します。
完了したら、「exit」と入力 します。