Atribut XML

Topik ini tidak terkini. Untuk informasi terbaru, lihat Spesifikasi Skema Cetak.

Ada sejumlah atribut XML yang muncul dalam beberapa jenis elemen yang ditentukan dalam Kerangka Kerja Skema Cetak. Atribut XML dengan nama yang sama umumnya memiliki arti yang sama dan mematuhi aturan yang sama terlepas dari jenis elemen tempat mereka berada. Oleh karena itu, atribut XML tercantum di sini berdasarkan nama dan bukan berdasarkan jenis elemen host mereka. Atribut XML yang ditentukan secara privat tidak diizinkan. Hanya atribut XML yang ditentukan di sini yang dapat digunakan dalam dokumen PrintCapabilities atau PrintTicket, lalu hanya dalam konteks yang ditentukan.

Meskipun pihak swasta tidak diizinkan untuk memperkenalkan definisi baru ke dalam namespace pihak lain, mereka diizinkan menggunakan nama yang ada dari namespace layanan privat lain selama penggunaannya konsisten dengan penggunaan yang ditetapkan oleh pihak lain. Dengan demikian Opsi dapat berisi elemen ScoredProperty yang ditentukan oleh beberapa pihak yang berbeda, masing-masing berada di namespace yang berbeda.

Nama Atribut Jenis dan Nilai Data Kegunaan Catatan
Nama
XML QName
Atribut XML ini mengidentifikasi instans elemen. Ini membedakan satu elemen dari elemen lain dari jenis elemen yang sama. Atribut XML ini sangat banyak digunakan sehingga disebut sebagai atribut nama.
Pembatasan berikut berkaitan dengan atribut nama.
  • Atribut nama harus dalam bentuk QName yang ditentukan XML yang valid. Artinya, harus memenuhi syarat oleh namespace XML yang valid. QName yang muncul sebagai nilai atribut nama harus secara eksplisit memenuhi syarat namespace meskipun namespace default didefinisikan.
  • Konten karakter haruslah dari QName yang ditentukan XML yang valid.
  • Nama yang ditentukan secara privat harus memenuhi syarat dengan namespace layanan yang secara unik dikaitkan dengan pihak yang memperkenalkan atribut nama.
  • Persyaratan Keunikan Saudara: Tidak ada dua elemen saudara kandung yang termasuk dalam jenis elemen yang sama mungkin memiliki atribut nama yang sama. Satu-satunya pengecualian adalah elemen Opsi, di mana atribut nama dapat digunakan untuk menentukan Opsi. Dengan demikian elemen Opsi multi-saudara mungkin memiliki atribut nama yang sama.
  • Jenis elemen berikut mungkin berisi atribut nama: Properti, ScoredProperty, ParameterDef, Option, dan Feature.
  • atribut nama diperlukan untuk muncul di setiap jenis elemen yang berisinya, kecuali dalam kasus beberapa elemen Opsi Skema Cetak publik yang ditentukan sebelumnya, seperti DocumentNUp.
Contoh berikut menunjukkan cara mengidentifikasi instans Option menggunakan atribut 'nama'. Ini adalah cara yang benar untuk menentukan elemen Opsi. Penyedia tidak boleh memiliki Opsi yang tidak disebutkan namanya, kecuali ditentukan secara publik dalam Skema Cetak, seperti DocumentNUp.
  <psf:Option name="psk:StapleBottomRight">
    \<psf:ScoredProperty name="psk:Angle">
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    </psf:ScoredProperty>
    <psf:ScoredProperty name="psk:SheetCapacity" >
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    <psf:ScoredProperty>
  </psf:Option>
Menyebarkan
Enumeration
Tidak ada nilai yang saat ini ditentukan.
Atribut penyebaran tidak digunakan dalam versi awal Kerangka Kerja Skema Cetak. Ini didokumentasikan di sini sehingga kode validasi PrintCapabilities atau PrintTicket yang diterapkan untuk versi awal Print Schema Framework dapat memproses versi skema berikutnya tanpa kesalahan.
Dibatasi
Enumeration
Nilai yang diizinkan:
  • Tidak
  • PrintTicket Pengaturan
  • Admin Pengaturan
  • Perangkat Pengaturan
Menunjukkan apakah Opsi tersedia untuk pilihan atau untuk digunakan.
Nilai yang diizinkan dari atribut yang dibatasi memiliki arti berikut. Perhatikan bahwa nilai-nilai ini tercantum secara berurutan, dari yang paling tidak ketat (Tidak Ada) hingga yang paling ketat (Perangkat Pengaturan).
Tidak
  • Opsi tidak dibatasi.
PrintTicket Pengaturan
  • Opsi dibatasi oleh pengaturan PrintTicket. Ini menyiratkan bahwa mengubah konfigurasi dapat menghapus batasan.
Admin Pengaturan
  • Opsi dibatasi oleh pengaturan administrator; Opsi tidak dapat diaktifkan oleh pengguna.
Perangkat Pengaturan
  • Opsi dibatasi oleh pengaturan perangkat atau opsi perangkat yang diinstal secara fisik; Opsi tidak dapat diaktifkan oleh pengguna atau administrator.
Ketika penyedia PrintCapabilities melaporkan nilai atribut yang dibatasi, batasan paling ketat yang ditemukan harus dilaporkan. Misalnya, jika Opsi dibatasi oleh pengaturan administrator dan pengaturan perangkat, penyedia PrintCapabilities harus melaporkan Perangkat Pengaturan.
xmlns
URI
Atribut XML ini membuat tautan antara pengidentifikasi sumber daya seragam namespace (URI) dan awalan namespace yang muncul di XML QName. Anda harus membuat tautan seperti itu ke namespace URI yang ditentukan untuk Kerangka Kerja Skema Cetak sebelum Anda dapat menggunakan salah satu tag elemen yang ditentukan Kerangka Kerja, Atribut, atribut nama, dan sebagainya. Anda dapat menyatakan namespace layanan ini sebagai default untuk menghindari benar-benar memenuhi syarat tag elemen dengan awalan namespace layanan, meskipun semua QName lainnya harus memenuhi syarat secara eksplisit. Namespace standar harus didefinisikan dalam elemen akar yang sesuai. Amati semua aturan dan konvensi XML mengenai penggunaan atribut xmlns.
URI untuk Kerangka Kerja Skema Cetak adalah http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
URI untuk Kata Kunci Skema Cetak adalah 'https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords'.

Spesifikasi Skema Cetak