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