Tabel ModuleConfiguration

Tabel ModuleConfiguration mengidentifikasi atribut modul yang dapat dikonfigurasi. Tabel ini tidak digabungkan ke dalam database.

Tabel ModuleConfiguration memiliki kolom berikut.

Kolom Jenis Kunci Dapat diubah ke null
Nama Pengidentifikasi Y N
Format Bilangan bulat N N
Jenis Teks N Y
ContextData Teks N Y
DefaultValue Teks N Y
Atribut Bilangan bulat N Y
DisplayName Teks N Y
Deskripsi Teks N Y
HelpLocation Teks N Y
HelpKeyword Teks N Y

 

Kolom

Nama

Bidang ini menentukan nama item yang dapat dikonfigurasi. Nama ini dirujuk dalam templat pemformatan di kolom Nilai dari tabel ModuleSubstitution.

Format

Kolom ini menentukan format data yang diubah.

Format Nilai
Teks 0
Kunci 1
Bilangan bulat 2
Bitfield Format 3

 

Jenis

Kolom ini menentukan jenis untuk data yang diubah. Jenis ini digunakan untuk menyediakan konteks untuk antarmuka pengguna apa pun dan tidak digunakan dalam proses penggabungan. Nilai yang valid untuk kolom ini bergantung pada nilai di kolom Format.

ContextData

Kolom ini menentukan konteks semantik untuk data yang diminta. Jenis ini digunakan untuk memberikan konteks untuk antarmuka pengguna apa pun dan tidak digunakan dalam proses penggabungan. Nilai yang valid untuk kolom ini bergantung pada nilai dalam kolom Format dan Jenis.

DefaultValue

Kolom ini menentukan nilai default untuk item dalam rekaman ini jika alat penggabungan menolak untuk memberikan nilai. Nilai ini harus memiliki format, jenis, dan konteks item. Jika ini adalah item format "Kunci", kunci asing harus menjadi kunci yang valid ke dalam tabel modul. Null mungkin merupakan nilai yang valid untuk kolom ini tergantung pada item. Untuk item format "Kunci", nilai ini dalam format khusus CMSM. Untuk semua jenis lainnya, nilai diperlakukan secara harfiah.

Penulis modul harus memastikan bahwa modul valid dalam status defaultnya. Ini memastikan bahwa versi Mergemod.dll yang lebih lama dari versi 2.0 masih dapat menggunakan modul dalam status defaultnya.

Atribut

Kolom ini adalah bidang bit yang berisi atribut untuk item yang dapat dikonfigurasi ini. Null setara dengan 0. Semua bit lain dalam kolom ini dicadangkan untuk digunakan di masa mendatang dan harus 0.

Nama Desimal Heksadesimal Deskripsi
msmConfigurableOptionKeyNoOrphan 1 0x00000001 Atribut ini hanya berlaku untuk rekaman yang mencantumkan kunci asing ke tabel modul di bidang DefaultValue mereka. Alat penggabungan mengabaikan atribut untuk format apa pun selain Jenis Format Kunci. Item yang tidak tercantum dalam tabel ModuleSubstitution dikecualikan dari pemeriksaan berikut. Alat penggabungan tidak menggabungkan baris yang direferensikan oleh kolom DefaultValue ke database target jika kondisi berikut terpenuhi setelah menyelesaikan semua opsi konfigurasi.
Setiap baris dalam tabel ModuleConfiguration dengan DefaultValue yang sama memiliki set msmConfigurationItemsKeyNoOrphan.
Tidak ada baris yang menggunakan DefaultValue karena alat penulisan menolak untuk memberikan nilai.
Alat penggabungan menggabungkan baris jika salah satu kondisi berikut terpenuhi.
Alat penggabungan menemukan baris apa pun yang tidak memiliki set msmConfigItemsKeyNoOrphan.
Jika alat penggabungan menemukan baris apa pun menggunakan DefaultValue karena alat penulisan menolak untuk memberikan nilai.
msmConfigurableOptionNonNullable 2 0x00000002 Ketika atribut ini diatur, null bukan respons yang valid untuk item ini. Atribut ini tidak berpengaruh untuk Jenis Format Bilangan Bulat atau Jenis Format Bitfield.

 

Displayname

Kolom ini memberikan deskripsi singkat tentang item ini yang dapat digunakan alat penulisan di antarmuka pengguna. Kolom ini mungkin tidak dilokalkan. Atur kolom ini ke null agar modul meminta agar alat penulisan tidak mengekspos properti ini di UI. Alat ini dapat mengalihkan nilai dalam bidang ini.

Deskripsi

Kolom ini menyediakan deskripsi item ini yang dapat digunakan alat penulisan dalam elemen UI. String ini dapat dilokalkan oleh transformasi bahasa modul. Kolom ini mungkin null.

HelpLocation

Kolom ini menyediakan nama file bantuan (tanpa ekstensi .chm) atau daftar namespace bantuan yang dibatasi titik koma. Kolom ini bisa null jika tidak ada bantuan yang tersedia. Kolom ini bisa null hanya jika kolom HelpKeyword null.

HelpKeyword

Kolom ini menyediakan kata kunci ke dalam file bantuan atau namespace layanan dari kolom HelpLocation. Interpretasi kata kunci ini tergantung pada kolom HelpLocation. Kolom ini mungkin null.

Keterangan

Tabel ModuleConfiguration digunakan oleh Modul Penggabungan yang Dapat Dikonfigurasi. Mergemod.dll 2.0 atau yang lebih baru diperlukan untuk membuat modul penggabungan yang dapat dikonfigurasi.

Untuk memastikan kompatibilitas dengan versi Mergemod.dll yang lebih lama, tabel ModuleConfiguration dan tabel ModuleSubstitution harus ditambahkan ke tabel ModuleIgnoreTable dari setiap modul.

Validasi

ICE03
ICE06
ICE25
ICE45