Baca dalam bahasa Inggris

Bagikan melalui


Referensi

Elemen Referensi dapat digunakan untuk menambahkan satu atau beberapa hubungan ke aktivitas BAM. Ini berguna saat Anda ingin melampirkan penunjuk seperti kunci utama, ID, atau URL ke pesan terkait. Misalnya, Anda dapat menyimpan referensi ke Batch Pengiriman dalam aktivitas Pesanan Pembelian.

Format

Elemen ini Reference mendukung elemen anak Data dan LongData yang berisi ekspresi yang menentukan data yang akan dilampirkan ke aktivitas BAM. Anda dapat menggunakan kombinasi Data dan LongData apa pun untuk memenuhi persyaratan pelacakan Anda.

Atribut

Nama atribut Deskripsi
Nama Nama hubungan yang akan dilampirkan ke aktivitas BAM.
Jenis String arbitrer yang menentukan jenis hubungan yang akan dilampirkan ke aktivitas BAM. String arbitrer dan jenis BAM yang telah ditentukan sebelumnya berikut didukung:

- BizTalkService
- MessageID
-Aktivitas
- DocumentUrl
- InstanceID

Elemen Anak

Status eksekusi Deskripsi
Data Menentukan cara mengekstrak data string hingga 128 karakter yang akan dilampirkan ke aktivitas BAM.
LongData Menentukan cara mengekstrak data string yang sangat panjang yang akan dilampirkan ke aktivitas BAM.

Catatan

Reference Elemen dapat menggabungkan satu atau beberapa elemen anak Data dan LongData sesuai kebutuhan.

Keterangan

Operasi umum berikut ini tidak diizinkan dalam ekspresi Referensi:

  • Dan

  • Sama dengan

Contoh

Dalam sampel berikut, referensi bernama "Dokumen Terkait" jenis "DocumentUrl" dibuat menggunakan GetUserData untuk alur kerja. Karena panjang data pengguna diperkirakan kurang dari 1024 karakter, Data elemen digunakan untuk berisi Expression elemen .

<ic:Reference Name="Related Document" Type="DocumentUrl">
  <ic:Data>
    <ic:Expression>
      <wf:Operation Name="GetUserData" />
    </ic:Expression>
  </ic:Data>
</ic:Reference>

Elemen Referensi mendukung campuran Data elemen dan LongData . Dalam sampel berikut, bidang nama negara/wilayah dan catatan dari pesanan pembelian diambil dari layanan WCF dan ditulis ke hubungan "Data Panjang dan Pendek" sebagai jenis "MyType". Karena bidang catatan mendukung lebih dari 1024 karakter, ekspresi diapit dalam LongData elemen .

<ic:Reference Name="Long and Short Data" Type="MyType">
  <ic:Data>
    <ic:Expression>
      <ic:Operation Name="Constant">
        <ic:Argument>Country: </ic:Argument>
      </ic:Operation>
      <wcf:Operation Name="XPath">
        <wcf:Argument>//s:Body//po:Country</wcf:Argument>
      </wcf:Operation>
       <ic:Operation Name="Concatenate" />
    </ic:Expression>
  </ic:Data>
  <ic:LongData>
    <ic:Expression>
      <ic:Operation Name="Constant">
        <ic:Argument>Note: </ic:Argument>
      </ic:Operation>
      <wcf:Operation Name="XPath">
        <wcf:Argument>//s:Body//po:Note</wcf:Argument>
      </wcf:Operation>
      <ic:Operation Name="Concatenate" />
    </ic:Expression>
  </ic:LongData>
</ic:Reference>

Lihat juga

Metode Interceptor OnEvent ElementEventStream.AddRelatedActivity