Cara Menambahkan Functoid Scripting ke Peta

Functoid Scripting memungkinkan Anda menggunakan skrip atau kode kustom saat runtime untuk menjalankan fungsi yang biasanya tidak tersedia. Misalnya, Anda dapat memanggil objek COM pada waktu proses dengan menggunakan functoid Scripting dan menulis skrip kustom Anda sendiri.

Untuk informasi konseptual tentang Scripting Functoid, lihat Scripting Functoid.

Untuk menambahkan functoid Scripting ke peta dan mengonfigurasinya

1. Dengan Kotak Alat Visual Studio aktif, klik tab Functoids Tingkat Lanjut untuk memilih kategori functoid tersebut.

   Daftar functoid tingkat lanjut dalam kategori yang dipilih muncul.

2. Seret Gambar functoid Scripting dari Kotak Alat ke lokasi yang sesuai di halaman kisi.

   Nota

   Functoid akan ditempatkan di halaman kisi yang ditampilkan. Jika Anda ingin meletakkan functoid ke halaman kisi yang berbeda, Anda perlu menampilkan halaman kisi lain terlebih dahulu.

   Nota

   Jika Anda membuat peta dengan menggunakan lebih dari satu functoid sekaligus, Anda perlu mempertimbangkan urutan penempatan mereka dari kiri ke kanan. Functoids dijalankan dari kiri ke kanan. Keluaran dari sebuah functoid hanya dapat dimasukkan ke functoid lain yang posisinya lebih jauh ke kanan.

3. Pilih functoid Scripting yang baru saja Anda tambahkan ke halaman kisi yang ditampilkan.

4. Di jendela Properti Visual Studio, klik tombol elipsis (...) yang terkait dengan properti Skrip .

   Nota

   Atau, Anda dapat mengklik kanan functoid, lalu klik Konfigurasikan Skrip Functoid di menu konteks. Kotak dialog Pengaturan Functoid Skrip muncul dengan tab Pengaturan Functoid Skrip dipilih.

5. Dalam kotak dialog Konfigurasi Scripting Functoid , di daftar drop-down Pilih jenis skrip , pilih jenis skrip Anda.

   Nota

   Bergantung pada pilihan jenis skrip Anda, subset yang berbeda dari bidang kotak dialog yang tersisa akan diaktifkan dan dinonaktifkan.

6. Jika Anda memilih Rakitan Eksternal sebagai jenis skrip, gunakan daftar drop-down Skrip, kelas Skrip, dan metode Skrip , dalam urutan tersebut, untuk memilih rakitan, kelas, dan metode, untuk mengaitkan dengan functoid Scripting ini.

   Peringatan

   Kode dalam rakitan eksternal harus aman untuk utas. Dalam kondisi stres, beberapa instans peta mungkin berjalan bersamaan.

   Nota

   Setelah Anda memilih rakitan, daftar drop-down kelas Skrip akan diisi dengan kelas di rakitan tersebut. Demikian juga, setelah Anda memilih kelas, daftar drop-down metode Skrip akan diisi dengan metode di kelas tersebut.

   Nota

   Kotak teks Skrip Sebaris akan dinonaktifkan saat Anda memilih Rakitan Eksternal sebagai jenis skrip.

   Jika Anda memilih sesuatu selain Rakitan Eksternal sebagai jenis skrip (salah satu pilihan sebaris), gunakan kotak teks Skrip sebaris untuk memasukkan skrip Anda dalam bahasa yang Anda pilih.

   Nota

   Pilihan bahasa sebaris untuk functoid Scripting termasuk C# .NET, JScript.NET, Visual Basic .NET, XSLT, dan XSLT Call Template.

   Pembuatan skrip menggunakan C# tidak mengizinkan pernyataan "using". Jika skrip perlu menggunakan kelas .Net khusus, maka rakitan yang sesuai dan rakitan dependennya harus ditambahkan ke "Referensi" dalam proyek BizTalk, dan kode skrip harus menggunakan nama yang sepenuhnya memenuhi syarat. Jika Anda menulis skrip untuk melakukan konversi huruf kecil yang sensitif terhadap budaya, fragmen kode yang sesuai harus ditulis seperti di bawah ini. Batasan serupa berlaku untuk semua bahasa skrip yang didukung.

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

   Dalam skrip, untuk menggunakan kelas dari rakitan apa pun, pastikan Anda menambahkan rakitan yang sesuai dan rakitan dependennya ke "Referensi" dalam proyek BizTalk yang berisi peta Anda.

   Nota

   Anda dapat membuat skrip kustom langsung di kotak teks Skrip sebaris , atau Anda bisa membuat skrip di tempat lain, dan menempelkannya ke dalam kotak teks skrip sebaris .

   Nota

   Daftar drop-down Skrip, kelas Skrip, dan metode Skrip dinonaktifkan saat Anda memilih salah satu pilihan sebaris (sesuatu selain Rakitan Eksternal) sebagai jenis skrip.

   Penting

   Jika Anda membuat skrip yang berisi beberapa fungsi, fungsi pertama akan diperlakukan sebagai fungsi utama atau utama; fungsi lain hanya dipanggil jika dipanggil dalam eksekusi fungsi utama.

   Klik OK.

7. Jika skrip Anda atau metode terkait dalam rakitan eksternal memerlukan parameter input, buat jumlah dan jenis tautan input yang sesuai seperti yang Anda lakukan untuk functoid dasar.

8. Dalam kebanyakan keadaan, functoid Scripting Anda akan menghasilkan nilai output yang digunakan untuk mengisi bidang dalam skema tujuan, atau sebagai input ke functoid lain, dengan cara yang sama seperti functoid dasar.

Lihat Juga

Menambahkan Functoid yang Canggih ke dalam Peta