Alat Alur
Alat alur yang disediakan dengan Kit Pengembangan Perangkat Lunak (SDK) Microsoft BizTalk Server memungkinkan Anda memverifikasi bahwa alur berfungsi dengan benar tanpa harus mengonfigurasi lingkungan BizTalk Server, seperti port kirim/terima. Anda juga dapat menggunakan alat alur untuk:
Debug komponen alur pihak ketiga di luar lingkungan server.
Mendiagnosis pesan kesalahan mesin penguraian.
Bereksperimenlah dengan skema yang berbeda tanpa beban mengkompilasi, menyebarkan, membatalkan penyebaran, dan kompilasi ulang.
Jelajahi file datar dan perilaku perakitan/pembakar XML.
Lihat output pemisah dan temukan properti konteks pesan mana yang dipromosikan dan nilainya.
Jalankan alur kirim/terima tanpa komponen pembongkar dan perakitan (misalnya, Anda dapat melihat output dekoder S/MIME).
Buat pengukuran performa halus dari alur saja (bukan seluruh subsistem olahpesan).
<Jalur >Penginstalan\SDK\Utilities\PipelineTools
Anda menggunakan alat alur untuk menjalankan, men-debug, dan membuat profil alur, dan komponen alur (yaitu, file datar dan komponen perakit/pembongkar XML).
Tabel berikut mencantumkan file alat alur dan menjelaskan tujuannya.
File | Deskripsi |
---|---|
DSDump.exe | Memungkinkan Anda untuk membuang struktur skema dokumen, yang merupakan representasi ringan dalam memori dari satu atau beberapa skema XSD, dengan atau tanpa anotasi file datar. Alat ini dapat membantu ketika Anda mendapatkan kesalahan mesin penguraian seperti $Root $ 0 $ 3 $ 2 dan Anda perlu mendekodenya. Angka setelah $ rata-rata indeks atau rekaman berbasis 0 saat muncul dalam skema dokumen. |
FFAsm.exe | Menjalankan komponen perakit file datar, langsung memanggilnya dengan meniru alur kirim untuk memungkinkan Anda melihat bagaimana ia menserialisasikan atau merakit dokumen XML pengguna ke dalam dokumen file datar. |
FFDasm.exe | Menjalankan komponen pembongkar file datar, langsung memanggilnya dengan meniru alur penerima untuk memungkinkan Anda melihat bagaimana ia mengurai atau membongkar dokumen file datar pengguna ke dalam satu atau beberapa dokumen XML. |
Pipeline.exe | Menjalankan alur kirim atau terima; menerima satu atau beberapa dokumen input dan bagiannya, skema XSD, dan informasi terkait; dan menghasilkan dokumen output setelah alur berjalan. Pipeline.exe tidak mengakses database BizTalk Server, sehingga alur yang berisi perakitan Kerangka Kerja BizTalk dan komponen pembongkar yang mengakses database BizTalk Server selama eksekusi mungkin tidak didukung. |
XMLAsm.exe | Menjalankan komponen perakit XML, langsung memanggilnya dengan meniru alur kirim untuk memungkinkan Anda melihat bagaimana ia membuat serialisasi, merakit, atau menyelimuti dokumen XML pengguna ke dalam dokumen XML output. |
XMLDasm.exe | Menjalankan komponen pembongkar XML, langsung memanggilnya dengan meniru alur penerima untuk memungkinkan Anda melihat cara penguraian, pembongkaran, atau pembongkaran dokumen XML pengguna ke dalam satu atau beberapa dokumen XML. |
Deskripsi yang lebih rinci tentang setiap file disediakan di bagian berikut.
DSDump.exe memungkinkan Anda untuk membuang struktur skema dokumen, yang merupakan representasi ringan dalam memori dari satu atau beberapa skema XSD, dengan atau tanpa anotasi file datar.
DSDump.exe (alat dump skema dokumen) mendukung parameter baris perintah berikut:
DSDump.exe schemaFileName
Jika berhasil, DSDump mencetak skema dokumen ke konsol.
FFAsm.exe (perakitan file datar) mendukung parameter baris perintah berikut:
usage: ffasm document... [-dm documentMask...]-bs bodySchema [ -hs headerSchema ] [ -ts trailerSchema ] [ -c ] [ -d ] [ -sb ] [ -m filenamemask ] [ -en encoding ] [ -v ]
where:
document XML document(s)
documentMask XML document(s) file mask, e.g., c:\\documents\\*.xml
bodySchema Flat File body schema
headerSchema Flat File header schema
trailerSchema Flat File trailer schema
-c Display assembled FF message on the console
-d Demote properties
-sb Set body schema(s) as design-time property
-m Output file name mask (default is %MessageID%)
encoding Output message encoding name (e.g. windows-1252) or
code page (e.g. 936)
-v Verbose mode
file name macros:
%MessageID% FF message identifier (Guid)
%MessagePartID% FF message part identifier (Guid)
Misalnya, jika Anda ingin merakit tiga dokumen XML input ke dalam satu dokumen file datar dengan demosi header dan properti, gunakan perintah berikut:
FFAsm.exe file_in1.xml file_in2.xml file_in3.xml –hs myHeaderSchema.xsd –bs myBodySchema.xsd -d
FFDasm.exe (pembbongkar file datar) mendukung parameter baris perintah berikut:
usage: ffdasm document -bs bodySchema [ -hs headerSchema ] [ -ts trailerSchema ] [ -s ] [ -c ] [ -p ] [ -m filenamemask ] [ -en encoding ] [ -v ]
where:
document Flat File document
bodySchema Flat File body schema
headerSchema Flat File header schema
trailerSchema Flat File trailer schema
-s Validate document structure
-c Display disassembled XML message on the console
-p Display promoted properties on the console
encoding Input message body part encoding name (e.g. windows-1252) or code page (e.g., 396)
-m Output file name mask (default is %MessageID%)
-v Verbous mode
file name macros:
%MessageID% XML message identifier (Guid)
%MessagePartID% XML message part identifier (Guid)
Misalnya, jika Anda ingin membongkar dokumen file datar yang memiliki header, isi, dan trailer, dan menampilkan hasilnya ke konsol, gunakan perintah berikut:
FFDasm.exe file_in.txt –hs myHeaderSchema.xsd –bs myBodySchema.xsd –ts myTrailerSchema.xsd –c
Pipeline.exe (alat Alur) mendukung parameter baris perintah berikut:
usage: pipeline ( pipeline[.btp] | -pt pipelineTypeName [ -an assemblyName ] ) -d document... [ -part part... ] [ -s schema[.xsd][:namespace.type]... ] [ -proj project[.btproj] ] [ -p ] [ -c ] [ -t ] [ -m filenamemask ] [ -pm partfilenamemask ] [ -en encoding ] [ -v ]
where:
pipeline Pipeline file name
pipelineTypeName Compiled pipeline assembly qualified type name (e.g.
"MyPipelines.ReceivePipeline, MyPipelines,
Version=1.0.0.0, Culture=neutral,
PublicKeyToken=e03965cb5971ad66" or full name (e.g.
"MyPipelines.ReceivePipeline") if assembly name is
specified
assemblyName Compiled pipeline assembly file name (e.g.
MyPipelines.dll) or name (e.g. "MyPipelines,
Version=1.0.0.0, Culture=neutral,
PublicKeyToken=e03965cb5971ad66")
document Input document(s)
part Input document's part
schema Schema file name
namespace Schema namespace (as in BizTalk project system)
type Schema type (as in BizTalk project system)
project BizTalk project file
-p Display promoted context properties for receive and
send pipelines, and promote context properties for
send pipelines
-c Display output document on the console
-t Display elapsed time of components execution
filenamemask Output message file name mask (default is
Message_%MessageID%.out)
partfilenamemask Output part file name mask (default is
Part_%MessagePartID%.out)
encoding Output message encoding name (e.g. windows-1252)
or code page (e.g. 936)
-v Verbous mode
note:
You can specify namespace and type for schemas either using namespace.type notation in schema file reference or by using BizTalk project file.
file name macros:
%MessageID% Message identifier (Guid)
%MessagePartID% Message part identifier (Guid)
%MessageNumber% Message number
Misalnya, jika Anda ingin menjalankan alur penerima dari file ReceivePipeline.btp (yang memiliki komponen pemisah XML dan validator XML) menggunakan mySchema.xsd dan menampilkan hasilnya ke konsol, gunakan perintah berikut:
Pipeline.exe ReceivePipeline.btp –d file_in.xml –s MySchema.xsd:MyProject.MySchema -c
-Atau-
Pipeline.exe ReceivePipeline.btp –d file_in.xml –s MySchema.xsd –proj MyProject.btproj -c
Dalam contoh pertama, nama jenis yang memenuhi syarat (MyProject.MySchema) untuk skema disertakan sebagai argumen baris perintah. Dalam contoh kedua, skema diperoleh dari file proyek BizTalk yang ditentukan.
Anda juga dapat menjalankan alur dari file proyek BizTalk Server yang dikompilasi, seperti dalam contoh berikut (alur dirujuk oleh nama jenis yang memenuhi syarat perakitannya):
Pipeline.exe -pt "TestBtsProject.ReceivePipeline, TestBtsProject, Version=1.0.0.0, Culture=neutral, PublicKeyToken=e03965cb5971ad66" -d in.xml -s PO.xsd -proj TestBtsProject.btproj –c
Dalam contoh berikut, alur dirujuk oleh nama jenis dan nama file rakitannya secara terpisah:
Pipeline.exe -pt TestBtsProject.ReceivePipeline –an TestBtsProject.dll -d in.xml -s PO.xsd -proj TestBtsProject.btproj –c
Contoh berikut menunjukkan alur yang dirujuk oleh nama rakitannya:
Pipeline.exe -pt TestBtsProject.ReceivePipeline –an "TestBtsProject, Version=1.0.0.0, Culture=neutral, PublicKeyToken=e03965cb5971ad66" -d in.xml -s PO.xsd -proj TestBtsProject.btproj –c
Pipeline.exe berjalan dengan kredensial apa pun yang telah Anda gunakan untuk meluncurkannya. Ini tidak menggunakan akun yang dijalankan instans host BizTalk Server normal, sehingga Anda mungkin tidak dapat menjalankan alur yang berisi komponen yang memerlukan akses database. Pastikan Anda menjalankan Pipeline.exe di bawah akun yang memiliki semua hak istimewa yang diperlukan.
Anda hanya boleh menggunakan Pipeline.exe untuk memverifikasi alur kustom tanpa komponen kustom pihak ketiga. Jika Anda menggunakan pipeline.exe untuk memverifikasi alur kustom dengan komponen kustom pihak ketiga, Pipeline.exe akan menghasilkan output yang diinginkan. Namun, jika Anda menyebarkan alur kustom yang sama dengan komponen kustom pihak ketiga, gunakan alur dalam port terima atau kirim, lalu gunakan Pipeline.exe untuk mengirimkan pesan ke alur, alur akan gagal dan BizTalk Server akan mengembalikan kesalahan.
XMLAsm.exe (alat Xml Assembler) mendukung parameter baris perintah berikut:
usage: xmlasm document...[-dm documentmask...] -ds documentSchema... [ -es envelopeSchema... ] [ -c ] [ -d ] [ -sd ] [ -m filenamemask ] [ -v ]
where:
document XML document(s)
documentMask XML document(s) file mask, e.g., c:\\documents\\*.xml
documentSchema XML document schema(s)
envelopeSchema XML envelope schema(s)
-c Display assembled XML message on the console
-d Demote properties
-sd Set document schema(s) as design-time property
-d Demote properties
-m Output file name mask (default is %MessageID%)
-v Verbous mode
file name macros:
%MessageID% XML message identifier (Guid)
%MessagePartID% XML message part identifier (Guid)
Misalnya, jika Anda ingin merakit dua dokumen XML input ke dalam satu dokumen XML dengan amplop dan menampilkan hasilnya ke konsol, gunakan perintah berikut:
FFAsm.exe file_in1.xml file_in2.xml–es myEnvelopeSchema.xsd –ds myBodySchema.xsd –c
XMLDasm.exe mendukung parameter baris perintah berikut:
usage: xmldasm document -ds documentSchema... [ -es envelopeSchema... ] [ -s ] [ -c ] [ -p ] [ -sd ] [ -se ] [ -m filenamemask ] [ -en encoding ] [ -v ]
where:
document XML document
documentSchema XML document schema(s)
envelopeSchema XML envelope schema(s)
-s Validate document structure
-c Display disassembled XML message on the console
-p Display promoted properties on the console
-sd Set document schema(s) as design-time property
-se Set envelope schema(s) as design-time property
-m Output file name mask (default is %MessageID%)
encoding Input message body part encoding name (e.g., windows-1252) or code page (e.g., 936)
-v Verbous mode
file name macros:
%MessageID% XML message identifier (Guid)
%MessagePartID% XML message part identifier (Guid)
%MessageNumber% XML message number
Misalnya, jika Anda ingin membongkar dokumen XML dengan dua amplop berlapis dan menampilkan hasilnya ke konsol, gunakan perintah berikut:
XmlDasm.exe file_in.txt –ds myDocumentSchema.xsd –es myEnvelopeSchema1.xsd –es myEnvelopeSchema2.xsd –c