Aracılığıyla paylaş


SharePoint paketleme ve dağıtım sorunlarını giderme

Bu konu, SharePoint çözümlerini paketleyip dağıtırken karşılaşabileceğiniz çeşitli sorunları kapsar.

Gelişmiş hata ayıklamayı etkinleştirme

Visual Studio, SharePoint ve diğer katmanlar arasında tanılama yapmak için EnableDiagnostics kayıt defteri anahtarını kullanarak yığın izlemesini görüntüleyebilirsiniz. Daha fazla bilgi için bkz . SharePoint çözümlerinde hata ayıklama.

Çözüm paketine proje çıktısı ekleme

Paket Tasarım Aracı aracılığıyla proje çıkışını bir pakete ekleyebilirsiniz. Ancak, proje çıkışını eklediğinizde, proje platformunun SharePoint çözümünün platformuyla eşleştiğinden emin olun. SharePoint sunucusuna dağıtmak istediğiniz derlemeler için Herhangi bir CPU platformu hedefini kullanmanızı öneririz. Daha fazla bilgi için bkz. Derleme Sayfası, Project Tasarım Aracı (Visual Basic) ve Gelişmiş Derleyici Ayarlar İletişim Kutusu (Visual Basic).

Doğrulama uyarıları ve hataları

Visual Studio'daki SharePoint geliştirme araçları, çözüm paketinin doğru biçimlendirilmiş olduğunu doğrulamak için doğrulama adımları gerçekleştirir. Ayrıca Özellikler ve paketleriniz için özel doğrulama adımları da oluşturabilirsiniz. Daha fazla bilgi için bkz . Nasıl yapılır: SharePoint çözümleri için özel özellik ve paket doğrulama kuralları oluşturma.

Dağıtım çakışması çözümü

SharePoint çözümünü dağıttığınızda, sunucudaki bir öğenin adı, URL'si veya kimliği çözüm paketinizdeki bir öğeyle aynı olduğunda çakışmalar görebilirsiniz. Modüller, Web bölümleri, liste örnekleri ve içerik türleri için çakışmaları çözümlemek, raporlamak veya yoksaymak için Dağıtım ÇakışmaSı Çözümü özelliğini değiştirebilirsiniz.

Aşağıdaki tabloda Dağıtım ÇakışmaSı Çözümü özelliğinin ayarları gösterilmektedir.

Value Açıklama
Otomatik Çakışmaları algılar ve çakışmaları otomatik olarak çözer.
İstem Çakışmaları algılar ve çakışmaları çözmeden önce bunları geliştiriciye bildirir.
Hiçbiri Çakışmaları algılamaz.

F5 dağıtımı arasındaki farklar

Test ve hata ayıklama için SharePoint projenizi yerel SharePoint sunucusuna dağıtmak için Visual Studio kullandığınızda, Visual Studio tarafından gerçekleştirilen bazı ek adımlar vardır.

  1. Dağıtım adımı sırasında Internet Information Service'i (IIS) sıfırlayın.

  2. İş akışlarını otomatik olarak ilişkilendirin.

  3. Özellik etkinleştirme sırasını Paket Tasarım Aracı hiyerarşisine göre ayarlayın.

    F5 davranışını daha fazla değiştirmek için özel dağıtım adımları ekleyebilirsiniz. Daha fazla bilgi için bkz . İzlenecek yol: SharePoint projeleri için özel dağıtım adımı oluşturma.

Görsel web bölümü dağıtılırken SharePoint sayfasının görüntülenmesinde gecikme

Windows Vista, Windows 7 veya Windows Server 2008'de Bir Visual Web bölümü Bin klasörüne dağıtılırken SharePoint sayfasının görünmesi uzun zaman alır. Bin dizini gibi bir üst düzey ASP.NET dizinindeki dosyaları değiştirirseniz, Web uygulamasının tamamı yeniden derlenmiş olur. Bu, SharePoint sayfasının işlenmesi için 25 saniyeye kadar gecikmeye neden olabilir.

Hata İletisi

Yok.

Çözüm

Bu sorunu geçici olarak çözmek için aşağıdaki adımları gerçekleştirin:

  1. Düzeltme: Windows Vista ve Windows Server 2008 için IIS 7.0'da ASP.NET'daki iki sorunu düzeltmek için bir düzeltme Microsoft Desteği makalesinde açıklandığı gibi güncelleştirme KB967535 yükleyin.

  2. Web.config dosyasına aşağıdaki satırı ekleyin:

    <compilation batch="false" optimizeCompilations="true">
    

SharePoint proje dağıtımı "Çözümdeki cab dosyası ayıklanamadı" hatasıyla başarısız oluyor

Herhangi bir SharePoint proje öğesinin adı parantez içeriyorsa, çözümü dağıtımda bir hatayla başarısız olur.

Hata İletisi

'Çözüm Ekle' dağıtım adımında hata oluştu: Çözümdeki cab dosyası ayıklanamadı.

Çözüm

Bu sorunu geçici olarak çözmek için, SharePoint proje öğelerinin adlarındaki parantezleri kaldırın.

Görsel web bölümü farklı bir web uygulamasındaki bir siteye dağıtılırken hata görüntüleniyor

Görsel Web bölümünü, o anda dağıtıldığı web uygulaması dışındaki bir Web uygulamasındaki bir siteye ilk kez dağıttığınızda (görsel Web bölümünün SiteUrl özelliğini değiştirerek) bir hata alırsınız.

Hata İletisi

'Çözüm Ekle' dağıtım adımında hata oluştu: [#] kimliğine sahip bir özellik bu grup içinde zaten yüklü. Özelliği açıkça yeniden yüklemek için force özniteliğini kullanın.

Çözüm

Bu hata, görsel Web bölümü özelliklerinin SharePoint'te geri çekilme biçiminden kaynaklanır. Görsel Web bölümünü başarıyla dağıtmak için F5 anahtarını seçerek çözümü yeniden dağıtın.

İç içe kullanıcı denetimleri dağıtılırken uyarı görüntülenir

Bu uyarı, kullanıcı denetimi içeren bir görsel Web bölümü veya görsel web bölümü veya başka bir kullanıcı denetimi içeren bir kullanıcı denetimi gibi iç içe kullanıcı denetimleri olan bir SharePoint çözümü dağıttığınızda oluşur. Bu uyarı, araç kutusundan sürükleyerek veya Kaynak görünümünde yönergesini kullanarak bir tasarımcıya @Register denetim eklediğinizde oluşur.

Hata İletisi

Uyarı 1 Öğesi '[Denetim Adı]' bilinen bir öğe değil. Web sitesinde bir derleme hatası varsa veya web.config dosyası eksikse bu durum oluşabilir.

Çözüm

Visual Studio proje sistemi iç içe kullanıcı denetiminin farkında değilse IntelliSense sağlayamaz ve uyarıyı yayar. Proje oluşturulmamışsa ve tasarımcı kapatılıp yeniden açılmadıysa veya otomatik geri çekme seçeneği etkinse, hata ayıklama işleminden sonra kullanıcı denetiminin SharePoint kovanından geri çekilmesine neden olan proje sistemi iç içe geçmiş bir kullanıcı denetiminin farkında değildir.

Bu uyarıyı kaldırmak için projeyi derleyip tasarımcıyı kapatıp yeniden açın veya proje için otomatik geri çekme seçeneğini devre dışı bırakın. Bunu yapmak için, proje özellikleri iletişim kutusunun SharePoint sekmesindeki Hata ayıklamadan sonra otomatik geri çek onay kutusunu temizleyin.