Bagikan melalui


HelloWorld (Sampel BizTalk Server)

Sampel HelloWorld menunjukkan cara menggunakan orkestrasi BizTalk untuk mengonversi pesan XML (pesanan pembelian) menjadi jenis pesan terkait, tetapi berbeda (faktur).

Apa fungsi sampel ini

Sampel ini mengonfigurasi folder Masuk sebagai lokasi penerima. Saat Anda menempatkan file, seperti file sampel SamplePOInput.xml, ke dalam folder ini, BizTalk Server memproses pesan menggunakan langkah-langkah berikut:

  1. BizTalk Server mengambil pesan pesanan pembelian XML dari folder lokasi penerima.

  2. Orkestrasi menggunakan file peta untuk membuat faktur XML dari pesanan pembelian XML.

  3. BizTalk Server menempatkan pesan faktur XML yang dihasilkan ke dalam folder keluar adaptor pengirim.

Bagaimana Sampel Ini Dirancang dan Mengapa

Dalam skenario pertukaran pesan antarkompansi, sering kali perlu untuk mengonversi pesan masuk yang diterima dari mitra dagang menjadi format yang dapat dikenali oleh aplikasi internal. Sampel ini menggunakan bentuk Terima , bentuk Transformasi , dan bentuk Kirim untuk mencapai hasil ini. Bentuk Transformasi memainkan peran penting dalam sampel ini karena merupakan tempat konversi format pesan terjadi. Anda menyeret bentuk Transformasi ke orkestrasi Anda dan mengonfigurasi pesan sumber, nama peta, dan pesan tujuan untuknya. Selama durasi, pesan sumber dipetakan ke pesan tujuan dengan menggunakan peta yang Anda tentukan.

Untuk informasi selengkapnya tentang bentuk Transformasi , lihat Cara Mengonfigurasi Bentuk Transformasi. Untuk informasi selengkapnya tentang membuat peta, lihat Membuat Peta Menggunakan BizTalk Mapper.

Tempat Menemukan Sampel Ini

< Jalur> Sampel\Orkestrasi\HelloWorld\

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

File Deskripsi
Cleanup.bat Digunakan untuk membatalkan penyebaran rakitan dan menghapusnya dari cache perakitan global. Menghapus port kirim dan terima. Menghapus direktori virtual Microsoft Internet Information Services (IIS) sesuai kebutuhan.
HelloOrchestration.odx Orkestrasi yang mengoordinasikan konversi pesanan pembelian menjadi faktur.
HelloWorld.btproj, HelloWorld.sln File proyek dan solusi untuk sampel ini.
HelloWorldBinding.xml Digunakan untuk penyiapan otomatis seperti pengikatan port.
InvoiceSchema.xsd, POSchema.xsd Skema untuk faktur dan pesanan pembelian, masing-masing.
POToInvoice.btm Peta untuk mengonversi pesanan pembelian menjadi faktur.
SamplePOInput.xml Contoh file input.
Setup.bat Digunakan untuk membangun dan menginisialisasi sampel ini.

Membangun dan Menginisialisasi Sampel Ini

Untuk membangun dan menginisialisasi sampel HelloWorld

  1. Di jendela perintah, navigasikan ke folder berikut:

    < Jalur> Sampel\Orkestrasi\HelloWorld

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

    • Membuat folder input (Masuk) dan output (Keluar) untuk sampel ini di folder berikut:

      < Jalur> Sampel\Orkestrasi\HelloWorld

    • Mengkompilasi proyek Visual Studio untuk sampel ini.

    • Membuat dan mengikat lokasi penerimaan BizTalk Server, dan port kirim dan terima ke orkestrasi.

    • Mengaktifkan lokasi terima, dan memulai port kirim. Mendaftarkan dan memulai orkestrasi.

Catatan

Anda harus mengonfirmasi bahwa BizTalk Server tidak melaporkan kesalahan selama proses build dan inisialisasi sebelum mencoba menjalankan sampel ini. Anda dapat mengonfirmasi ini dengan melihat log peristiwa Anda.

Menjalankan sampel ini

Untuk menjalankan sampel HelloWorld

  1. Tempelkan salinan file SamplePOInput.xml ke folder Dalam .

  2. Amati file .xml yang dibuat di folder Keluar . File ini berisi faktur XML yang dibangun dari file input SamplePOInput.xml. Format nama file ini adalah <MessageID>.xml, di mana <MessageID> adalah GUID yang dihasilkan untuk mengidentifikasi pesan secara unik.

Menghapus instalan Sampel Ini

Untuk menghapus instalan sampel HelloWorld

  1. Di jendela perintah, navigasikan ke folder berikut:

    < Jalur> Sampel\Orkestrasi\HelloWorld\

  2. Jalankan Cleanup.bat.

Lihat juga

Orkestrasi (Folder Sampel BizTalk Server)