Baca dalam bahasa Inggris

Bagikan melalui


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).

Lokasi di SDK

<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).

Inventaris File

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.

Penggunaan

Deskripsi yang lebih rinci tentang setiap file disediakan di bagian berikut.

DSDump.exe

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

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

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

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

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

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  

Lihat juga

Utilitas di SDK