Definisi Komponen oleh Penulis

Komponen didefinisikan oleh dan dibuat oleh penulis dalam Dokumen Metadata Penulis mereka sebagai respons terhadap peristiwa Identifikasi di awal operasi pencadangan (lihat Gambaran Umum Inisialisasi Cadangan) saat Dokumen Metadata Penulis diisi.

Saat membuat komponen dalam Dokumen Metadata Penulisnya, menggunakan IVssCreateWriterMetadata dan IVssCreateWriterMetadata::AddComponent, penulis harus menentukan:

• Apakah komponen dapat dipilih untuk pencadangan
• Jenis komponen
• Nama komponen (yang harus unik tidak hanya dalam instans penulis tertentu tetapi di semua instans penulis)
• Apakah komponen memiliki metadata khusus penulis yang terkait dengannya
• Apakah penulis memerlukan pemberitahuan setelah pencadangan berhasil

Penulis dapat secara opsional menentukan:

• Jalur logis komponen (yang harus unik tidak hanya dalam instans penulis tertentu tetapi di semua instans penulis)
• Deskripsi komponen (atau caption)
• Ikon yang akan digunakan dengan GUI untuk menunjukkan komponen

Komponen tidak perlu benar-benar berisi file apa pun. Komponen kosong atau "dummy" ini dapat berguna dalam mengatur komponen. Komponen tersebut dapat digunakan untuk menentukan set komponen dan komponen penulis (lihat Jalur Logis Komponen).

Menyiapkan Organisasi Komponen

Mengatur keterpilihan komponen ( keterpilihannya untuk pencadangan, dan keterpilihannya untuk pemulihan) dan jalur logisnya memungkinkan penulis untuk mengamanatkan atau membuat opsional penyertaan komponen tertentu dalam operasi pencadangan atau pemulihan, dan untuk mengelompokkan komponen ke dalam set komponen dengan satu komponen yang dapat dipilih bertindak sebagai titik masuk ke seluruh grup.

Keanggotaan dalam pengelompokan ini menentukan komponen mana yang akan digunakan selama operasi pencadangan dan pemulihan. Menggunakan "dapat dipilih" berarti dapat dipilih kembali untuk operasi pencadangan, dan dapat dipilih untuk pemulihan untuk operasi pemulihan, pengembang harus memahami bahwa:

• Jika ada komponen yang dikelola oleh penulis tertentu yang dicadangkan, maka pemohon harus secara eksplisit menyertakan semua komponen yang tidak dapat dipilih tanpa leluhur yang dapat dipilih di jalur logis mereka ke Dokumen Komponen Cadangan dan mencadangkan dan memulihkan komponen tersebut sebagai grup.
• Pemohon memiliki opsi untuk secara eksplisit menambahkan komponen yang dapat dipilih ke Dokumen Komponen Cadangan selama operasi pencadangan dan pemulihan; setelah ditambahkan, komponen harus dicadangkan atau dipulihkan.
• Jika komponen dapat dipilih, komponen dan semua subkomponennya (sebagaimana didefinisikan oleh jalur logis) membentuk set komponen, yang dapat diperlakukan sebagai satu unit yang dapat secara opsional berpartisipasi dalam operasi pencadangan dan pemulihan.
• Pemohon tidak pernah secara eksplisit menambahkan komponen yang tidak dapat dipilih dengan leluhur yang dapat dipilih, subkomponen dalam set komponen, ke Dokumen Komponen Cadangannya selama operasi pencadangan dan pemulihan. Komponen-komponen ini harus disertakan secara implisit jika leluhur yang dapat dipilih ditambahkan secara eksplisit, dalam hal ini mereka harus dicadangkan atau dipulihkan (lihat Penggunaan Komponen oleh Pemohon).
• Komponen yang dapat dipilih dengan leluhur yang dapat dipilih masih merupakan subkomponen (anggota set komponen) dan dapat secara implisit disertakan jika leluhur yang dapat dipilih secara eksplisit disertakan dalam operasi. Dalam hal ini, informasinya tidak ditambahkan ke Dokumen Komponen Cadangan. Jika leluhur yang dapat dipilih tidak disertakan dalam operasi, komponen dapat dipilih secara eksplisit untuk dimasukkan dalam operasi, dalam hal ini informasinya disertakan dalam Dokumen Komponen Cadangan.
• Subkomponen yang disertakan secara implisit dalam cadangan dapat secara eksplisit disertakan dalam operasi pemulihan, terlepas dari status leluhur yang dapat dipilih, jika dapat dipilih untuk pemulihan. Setiap yang dapat dipilih untuk memulihkan subkomponen yang disertakan selama operasi pemulihan harus menambahkan informasinya ke Dokumen Komponen Cadangan.
• Penulis yang tidak memiliki komponen yang secara eksplisit ditambahkan ke Dokumen Komponen Cadangan sebelum pembuatan peristiwa PrepareForBackup dan PreRestore tidak akan menerima peristiwa VSS lebih lanjut.

Untuk informasi selengkapnya, lihat Bekerja dengan Jalur Pemilih dan Logis.

Menambahkan File ke Komponen

Komponen berisi informasi file dalam bentuk kumpulan file yang berisi:

• Direktori akar file dalam komponen.
• Spesifikasi file untuk file dalam komponen.
• Bendera yang menunjukkan apakah spesifikasi komponen rekursif.

Bergantung pada jenis komponen, yang dapat menjadi database atau grup file, dan (dalam kasus komponen database) apakah file yang akan dimuat adalah file data atau log, penulis memanggil IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles, atau IVssCreateWriterMetadata::AddDatabaseLogFiles untuk menambahkan kumpulan file.

Saat menggunakan fungsi-fungsi ini, Anda harus menentukan file yang akan ditambahkan ke kumpulan file sebagai berikut:

• wszPath: Ini adalah jalur ke direktori yang berisi file yang akan ditambahkan ke set file. Jika parameter bRecursive diatur ke true, parameter wszPath menentukan hierarki direktori yang akan dilalui secara rekursif, dan semua direktori harus dibuat ulang, termasuk direktori kosong.
• wszFilespec: String ini menentukan file di setiap direktori yang akan ditambahkan ke set file.

Misalnya, struktur direktori berikut ada:

C:\\Directory1\\File1.txt C:\\Directory1\\File2.txt C:\\Directory1\\Directory2\\File1.txt C:\\Directory1\\Directory2\\File2.txt C:\\Directory1\\Directory3\\

Jika penulis menentukan "C:\Directory1" untuk wszPath, "File1.*" untuk wszFilespec, dan true untuk bRecursive, pemohon harus menyertakan file-file ini:

C:\\Directory1\\File1.txt C:\\Directory1\\Directory2\\File1.txt

Jika penulis menentukan "C:\Directory1" untuk wszPath, "*" untuk wszFilespec, dan true untuk bRecursive, pemohon harus menyertakan file-file ini:

C:\\Directory1\\File1.txt C:\\Directory1\\File2.txt C:\\Directory1\\Directory2\\File1.txt C:\\Directory1\\Directory2\\File2.txt

Jika penulis menentukan "C:\Directory1" untuk wszPath, "*" untuk wszFilespec, dan false untuk bRecursive, pemohon harus menyertakan file-file ini:

C:\\Directory1\\File1.txt C:\\Directory1\\File2.txt

Dalam semua contoh sebelumnya, setiap kali penulis menentukan true untuk bRecursive, direktori kosong C:\Directory1\Directory3\ harus dibuat ulang.

Untuk set file yang ditambahkan ke komponen grup file, dalam kasus di mana file yang saat ini berada di disk tidak berada dalam apa yang penulis akan pertimbangkan lokasi yang sesuai atau default, penulis memiliki opsi untuk menambahkan jalur alternatif. Dalam kasus ini, definisi set file dari jalur berisi lokasi normal file dan ke tempat file harus dipulihkan, sementara jalur alternatif berisi lokasi file saat ini yang akan dicadangkan.

Semua file dalam set file harus ada pada saat pencadangan. Pemohon harus mengasumsikan bahwa semua file yang tercantum dalam kumpulan file diperlukan untuk cadangan dan akan gagal pencadangan jika ada file yang hilang. Perhatikan bahwa ketika "*" ditentukan untuk parameter wszFilespec , itu dapat mencocokkan nol atau lebih file.

Perhatikan bahwa atribut Dokumen Metadata Penulis seperti pemetaan lokasi alternatif, file yang disertakan dan dikecualikan secara eksplisit, dan metode pemulihan diatur pada tingkat penulis, bukan tingkat komponen. (Untuk informasi selengkapnya, lihat Bekerja dengan Dokumen Metadata Penulis.)

Definisi Komponen untuk Operasi Pencadangan dan Pemulihan

Operasi pemulihan dan pencadangan selalu menghasilkan peristiwa Identifikasi, dan untuk pencadangan dan pemulihan, operasi tersebut akan ditangani oleh metode CVssWriter::OnIdentify yang sama.

Selama operasi pencadangan, pemohon menggunakan informasi yang dikembalikan oleh metode CVssWriter::OnIdentify penulis untuk menentukan penulis mana yang ada di sistem dan kemudian untuk menentukan file mana yang akan dicadangkan.

Selama operasi pemulihan, informasi yang dikembalikan oleh peristiwa CVssWriter::OnIdentify penulis hanya digunakan untuk menetapkan identitas dan status penulis yang saat ini ada di sistem; informasi spesifikasi file yang dihasilkan selama pemulihan tidak digunakan. Sebagai gantinya, Dokumen Metadata Penulis yang disimpan pada waktu pencadangan digunakan untuk mendapatkan data ini.

Setelah dihasilkan selama operasi pencadangan, informasi komponen penulis, bersama dengan informasi penulis lainnya, disimpan untuk diambil untuk mendukung operasi pemulihan. Biasanya pemohon bertanggung jawab untuk menyimpan informasi ini.