Memecahkan masalah pengemasan dan penyebaran SharePoint
Topik ini mencakup berbagai masalah yang mungkin Anda temui saat mengemas dan menyebarkan solusi SharePoint.
Aktifkan penelusuran kesalahan yang disempurnakan
Untuk mendiagnosis antara Visual Studio, SharePoint, dan lapisan lainnya, Anda dapat menggunakan kunci registri EnableDiagnostics untuk melihat jejak tumpukan. Untuk informasi selengkapnya, lihat men-debug solusi SharePoint.
Menambahkan output proyek ke paket solusi
Anda dapat menambahkan output proyek ke paket melalui Perancang Paket. Namun, ketika Anda menambahkan output proyek, pastikan bahwa platform proyek cocok dengan platform solusi SharePoint. Kami menyarankan agar Anda menggunakan target platform CPU apa pun untuk rakitan yang ingin Anda sebarkan ke server SharePoint. Untuk informasi selengkapnya, lihat Halaman Kompilasi, Perancang Proyek (Visual Basic) dan Kotak Dialog Pengaturan Pengkompilasi Tingkat Lanjut (Visual Basic).
Peringatan dan kesalahan validasi
Alat pengembangan SharePoint di Visual Studio melakukan langkah-langkah validasi untuk memverifikasi bahwa paket solusi terbentuk dengan benar. Anda juga dapat membuat langkah-langkah validasi kustom untuk Fitur dan paket Anda. Untuk informasi selengkapnya, lihat Cara: Membuat fitur kustom dan aturan validasi paket untuk solusi SharePoint.
Penyelesaian konflik penyebaran
Saat Anda menyebarkan solusi SharePoint, Anda mungkin menemukan tabrakan saat item di server memiliki nama, URL, atau ID yang sama dengan item dalam paket solusi Anda. Anda dapat mengubah properti Resolusi Konflik Penyebaran untuk mengatasi, melaporkan, atau mengabaikan tabrakan untuk modul, komponen Web, instans daftar, dan tipe isi.
Tabel berikut menunjukkan pengaturan untuk properti Resolusi Konflik Penyebaran.
| Nilai | Deskripsi |
|---|---|
| Otomatis | Mendeteksi tabrakan dan menyelesaikan konflik secara otomatis. |
| Prompt | Mendeteksi tabrakan dan melaporkannya ke pengembang sebelum menyelesaikan konflik. |
| Tidak | Tidak mendeteksi tabrakan. |
Perbedaan antara penyebaran F5
Saat Anda menggunakan Visual Studio untuk menyebarkan proyek SharePoint Anda ke server SharePoint lokal untuk pengujian dan penelusuran kesalahan, ada beberapa langkah tambahan yang dilakukan oleh Visual Studio.
Reset Layanan Informasi Internet (IIS) selama langkah penyebaran.
Mengaitkan alur kerja secara otomatis.
Atur urutan aktivasi fitur sesuai dengan hierarki di Perancang Paket.
Anda dapat menambahkan langkah-langkah penyebaran kustom untuk mengubah perilaku F5 lebih lanjut. Untuk informasi selengkapnya, lihat Panduan: Membuat langkah penyebaran kustom untuk proyek SharePoint.
Penundaan menampilkan halaman SharePoint saat Menyebarkan bagian web visual
Halaman SharePoint membutuhkan waktu lama untuk muncul saat menyebarkan bagian Visual Web ke folder Bin di Windows Vista, Windows 7, atau Windows Server 2008. Jika Anda mengubah file apa pun di direktori ASP.NET tingkat atas, seperti direktori Bin, seluruh aplikasi Web dikombinasi ulang. Ini dapat menyebabkan penundaan hingga 25 detik agar halaman SharePoint dirender.
Pesan kesalahan
Tidak ada.
Resolusi
Untuk mengatasi masalah ini, lakukan langkah-langkah berikut:
Instal pembaruan KB967535 seperti yang diuraikan dalam artikel Dukungan Microsoft MEMPERBAIKI: Perbaikan tersedia untuk memperbaiki dua masalah dalam ASP.NET pada IIS 7.0 untuk Windows Vista dan Windows Server 2008.
Tambahkan baris berikut ke file Web.config:
<compilation batch="false" optimizeCompilations="true">
SharePoint penyebaran proyek gagal dengan kesalahan "Gagal mengekstrak file kabin dalam solusi"
Jika nama item proyek SharePoint berisi tanda kurung, solusinya gagal pada penyebaran dengan kesalahan.
Pesan kesalahan
Terjadi kesalahan dalam langkah penyebaran 'Tambahkan Solusi': Gagal mengekstrak file kabin dalam solusi.
Resolusi
Untuk mengatasi masalah ini, hapus tanda kurung apa pun dalam nama item proyek SharePoint.
Kesalahan muncul saat menyebarkan bagian web visual ke situs pada aplikasi web lain
Pertama kali Anda menyebarkan bagian Web visual ke situs pada aplikasi Web selain yang saat ini disebarkan (dengan mengubah properti SiteUrl bagian Web visual), Anda mengalami masalah.
Pesan kesalahan
Terjadi kesalahan dalam langkah penyebaran 'Tambahkan Solusi': Fitur dengan ID [#] telah diinstal di farm ini. Gunakan atribut force untuk menginstal ulang fitur secara eksplisit.
Resolusi
Kesalahan ini terjadi karena cara fitur bagian Web visual dicabut dalam SharePoint. Agar berhasil menyebarkan bagian Web visual, sebarkan solusi lagi dengan memilih kunci F5.
Peringatan muncul saat menyebarkan kontrol pengguna berlapis
Peringatan ini terjadi ketika Anda menyebarkan solusi SharePoint yang memiliki kontrol pengguna berlapis, seperti bagian Web visual yang berisi kontrol pengguna atau kontrol pengguna yang berisi bagian Web visual atau kontrol pengguna lain. Peringatan ini terjadi apakah Anda menambahkan kontrol ke perancang dengan menyeretnya dari Kotak Alat atau dengan menggunakan arahan @Register dalam tampilan Sumber.
Pesan kesalahan
Elemen Peringatan 1 '[Nama Kontrol]' bukan elemen yang diketahui. Ini dapat terjadi jika ada kesalahan kompilasi di situs Web, atau file web.config hilang.
Resolusi
Jika sistem proyek Visual Studio tidak mengetahui kontrol pengguna berlapis, sistem tersebut tidak dapat memberikan IntelliSense dan memancarkan peringatan. Sistem proyek tidak menyadari kontrol pengguna berlapis jika proyek tidak dibangun dan perancang tidak ditutup dan dibuka kembali, atau jika opsi pencabutan otomatis diaktifkan, yang menyebabkan kontrol pengguna dicabut dari sarang SharePoint setelah penelusuran kesalahan.
Untuk menghapus peringatan ini, buat proyek lalu tutup lalu buka kembali perancang, atau nonaktifkan opsi cabut otomatis untuk proyek. Untuk melakukan ini, kosongkan kotak centang Cabut otomatis setelah penelusuran kesalahan pada tab SharePoint dari kotak dialog properti proyek.