Bagikan melalui

Functoid Kustom (Sampel BizTalk Server)

  • Artikel

Sampel Functoid Kustom menunjukkan cara menulis functoid kustom untuk BizTalk Mapper. Anda dapat menambahkan functoid ke Visual Studio Toolbox. Functoid akan ditampilkan di Kotak Alat ketika BizTalk Mapper sedang fokus.

Functoid kustom harus berada di perakitan BizTalk Mapper untuk mengenalinya. Ini dapat ditulis dalam setiap . Bahasa yang mematuhi NET, seperti C# atau Visual Basic.

Selain itu, functoid kustom harus berasal dari Microsoft.BizTalk.BaseFunctoids kelas , dan harus memberikan implementasi untuk beberapa metode dengan mengambil alihnya. (Kelas BaseFunctoid didefinisikan dalam rakitan Microsoft.BizTalk.BaseFunctoids.dll disertakan dengan BizTalk Server.)

Apa fungsi sampel ini

Sampel Functoid Kustom mengimplementasikan beberapa functoid, masing-masing berasal dari BaseFunctoid kelas dan mengambil alih beberapa metode.

Saat menerapkan functoid kustom, Anda dapat mengekspos kodenya sebaris. Kode sebaris adalah apa yang melakukan komputasi untuk functoid. Pengkompilasi BizTalk Mapper mengekstrak kode sebaris dari functoid dan menyematkannya di XSLT yang dikompilasi saat Anda membangun proyek.

Jika functoid kustom Anda tidak mengekspos kode sebaris apa pun, BizTalk Mapper menghasilkan XSLT yang memanggil ke perakitan tempat functoid kustom berada. Dalam hal ini, Anda harus yakin rakitan functoid kustom Anda tersedia di cache perakitan global (GAC) sehingga mesin XSLT dapat menemukannya. Functoid kustom juga harus memiliki atribut GUID yang unik. BizTalk Mapper menggunakan GUID untuk mengidentifikasi rakitan mana yang akan dimuat.

Penting

Jika Anda menggunakan kembali kode sampel Functoid Kustom untuk mengimplementasikan functoid Anda sendiri, Anda harus memastikan untuk mengubah atribut GUID menjadi atribut unik.

Tempat Menemukan Sampel Ini

<Samples Path>\XmlTools\CustomFunctoid

Tabel berikut ini memperlihatkan file dalam sampel ini dan menjelaskan tujuannya.

File Deskripsi
AssemblyInfo.cs Informasi rakitan kode sumber C#.
CBuildArray.bmp Bitmap kotak alat.
CConcat.bmp Bitmap kotak alat.
CExtractArray.bmp Bitmap kotak alat.
Cleanup.bat Digunakan untuk membatalkan penyebaran rakitan dan menghapusnya dari cache perakitan global (GAC) dan untuk menghapus CustomFunctoid.dll.
CLongestString.bmp Bitmap kotak alat.
CMultiply.bmp Bitmap kotak alat.
CustomFunctoid.cs Kode sumber functoid C# kustom.
CustomFunctoid.csproj Proyek functoid C# kustom.
CustomFunctoid.sln Solusi functoid kustom.
CustomFunctoidResources.resx Sumber daya functoid kustom.
Setup.bat Digunakan untuk membangun, menyebarkan, dan memulai sampel.

Membangun dan Menginisialisasi Sampel Ini

Gunakan prosedur berikut untuk membangun dan menginisialisasi sampel Functoid Kustom.

Untuk membangun dan menginisialisasi sampel ini

  1. Di jendela perintah, ubah direktori (cd) ke folder berikut:

    < Jalur> Sampel\XmlTools\CustomFunctoid

  2. Jalankan Setup.bat file, yang melakukan tindakan berikut:

    • Membangun proyek sampel.

    • Menyalin rakitan yang dihasilkan ke direktori Developer Tools\Mapper Extensions.

    • Menambahkan rakitan yang dihasilkan ke GAC.

      Catatan

      Anda harus mengonfirmasi bahwa tidak ada kesalahan yang dilaporkan selama proses build dan inisialisasi sebelum mencoba menjalankan sampel ini.

Menjalankan sampel ini

Gunakan prosedur berikut untuk menjalankan sampel Functoid Kustom.

Untuk menjalankan sampel ini

  1. Dari proyek Visual Studio BizTalk, klik menu Alat , dan pilih Pilih Item Kotak Alat.

  2. Dalam kotak dialog Pilih item Kotak Alat , pilih tab BizTalk Mapper Functoids .

  3. Klik Reset, lalu klik OK.

    Catatan

    Jika functoid kustom Anda tidak mengekspos kode sebaris apa pun, pastikan rakitannya tersedia di GAC.

  4. Dari menu File , pilih Keluar untuk menutup Visual Studio.

  5. Mulai Perintah Visual Studio.

  6. Pada prompt perintah, ketik devenv /setup.

  7. Mulai Microsoft Visual Studio.

    Functoid kustom (Functoid gabungan kustom, String Terpanjang, Functoid array build, dan Functoid ekstrak array ekstrak) muncul pada tab Functoids String dari Kotak Alat, dan functoid Multiply Kumulatif muncul pada tab Functoids Kumulatif .

Menghapus sampel ini

Gunakan prosedur berikut untuk menghapus sampel Functoid Kustom.

Untuk menghapus sampel ini

  1. Hapus functoid dari Kotak Alat Visual Studio.

    Peringatan

    Jika setelah menjalankan Cleanup.bat, Anda masih melihat functoid kustom kedaluarsa di kotak alat (mungkin karena penembolokan internal oleh Visual Studio), lalu ikuti prosedur di bawah ini:

    1. Dari proyek Visual Studio BizTalk, klik menu Alat , dan pilih Pilih Item Kotak Alat.

    2. Dalam kotak dialog Pilih item Kotak Alat , pilih tab BizTalk Mapper Functoids .

    3. Temukan functoid kustom (Functoid gabungan kustom, String Terpanjang, Functoid array build, Ekstrak functoid array, dan Perkalian Kumulatif) dalam daftar. Klik kotak centang masing-masing untuk menghapus functoid, lalu klik OK.

      Jika prosedur di atas tidak berfungsi, ikuti prosedur di bawah ini.

    4. Dari proyek Visual Studio BizTalk, klik tab Kotak Alat saat mengedit peta untuk memunculkan Palet Kotak Alat.

    5. Klik kanan kotak alat dan pilih Pilih Item.

    6. Dalam kotak dialog Pilih Item, klik Reset, lalu klik OK.

    7. Tutup semua instans Visual Studio.

      Jika prosedur di atas tidak berfungsi, ikuti prosedur di bawah ini.

    8. Mulai Perintah Visual Studio sebagai administrator.

    9. Tutup semua instans Visual Studio yang sedang berjalan.

    10. Berikan perintah berikut:

      devenv /resetsettings

      devenv /setup

    11. Anda dapat memilih functoid yang tidak diinginkan secara manual dari kotak alat. Kemudian, klik kanan functoid, dan klik Hapus.

      Jika prosedur di atas tidak berfungsi, ikuti prosedur di bawah ini.

    12. Dari proyek Visual Studio BizTalk, klik tab Kotak Alat saat mengedit peta untuk memunculkan Palet Kotak Alat.

    13. Klik grup Functoids Kumulatif .

    14. Klik kanan functoid yang ingin Anda hapus lalu pilih Hapus atau tekan tombol hapus.

    15. Klik grup Functoids String .

    16. Klik kanan functoid yang ingin Anda hapus lalu pilih Hapus atau tekan tombol hapus.

  2. Di jendela perintah, ubah direktori (cd) ke folder berikut:

    < Jalur> Sampel\XmlTools\CustomFunctoid

  3. Jalankan file Cleanup.bat, yang melakukan tindakan berikut:

    • Menghapus rakitan dari direktori Developer Tools\Mapper Extensions.

    • Menghapus rakitan dari GAC.

Kelas atau Metode yang Digunakan dalam Sampel Ini

Microsoft.BizTalk.BaseFunctoids.BaseFunctoid

Lihat juga

Menggunakan BaseFunctoid
Alat XML (Folder Sampel Server BizTalk)