Dil

SharePoint çözümleriyle ilgili sorunları giderme

Visual Studio hata ayıklayıcısını kullanarak SharePoint çözümlerinde hata ayıkladığınızda aşağıdaki sorunlar veya uyarılar oluşabilir. Daha fazla bilgi için bkz. SharePoint 2007 İş Akışı Çözümlerinde Hata Ayıklama.

Kumlanmış görsel web parçalarındaki belirteç kısıtlamaları

Korumalı çözümlerdeki görsel web bölümleri, SharePoint çalışma zamanının desteklediği $SPUrl gibi standart belirteçleri işleyemez. Sonuç olarak, URL çözümlenmez ve aşağıdaki örnekte olduğu gibi doğrudan bir betik öğesinde ona başvurursanız, Tasarım görünümünde, görsel web bölümü tasarımcısında içeriği önizleyemezsiniz.

<script src="<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>

Bu sınırlamaya geçici bir çözüm bulmak ve belirteci çözmek için, sabitleri kullanarak belirtece başvurun.

<asp:literal ID="Literal1" runat="server" Text="<script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' ></script>" />

Proje ve proje öğelerinin adlarındaki karakter kısıtlamaları

Projelerin ve proje öğelerinin adları yalnızca SharePoint 2010'daki bir dağıtım yolunda geçerli karakterler içerebilir. Başka karaktere izin verilmez.

Hata mesajı

"Geçersiz karakterler" hata iletisi.

Çözüm

SharePoint projelerinin ve proje öğelerinin adları için yalnızca aşağıdaki karakterleri kullanın:

  • Alfasayısal ASCII karakterleri

  • Uzay

  • Dönem (.)

  • Virgül (,)

  • Alt çizgi (_)

  • Tire (-)

  • Ters eğik çizgi (\)

    Bir proje paketlendiğinde, doğrulama kuralı dağıttığınız her dosya için dağıtım yolu özelliğinin yalnızca bu geçerli karakterleri içerdiğini doğrular.

Özel alanlar oluştururken oluşan hatalar

Visual Studio'da özel alanlar XML'de tanımlanır. Belirli bir biçim kullanılarak bir alan tanımlanmadıysa veya buna başvurulmazsa hatalar oluşabilir.

Hata mesajı

Paketleme sırasında "Geçersiz karakterler" hata iletisi.

Çözüm

Aşağıdaki örnekte gösterildiği gibi, alan tanımının kimliği küme ayraçlarıyla çevrili bir GUID olmalıdır:

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
    Type="Note"
    Name="PatientName"
    DisplayName="Patient Name"
    Group="A Custom Group">
</Field>.

Aşağıdaki örnekte gösterildiği gibi, bir içerik türündeki alan başvurusu, başlangıç/bitiş öğeleri (FieldRef/FieldRef<) kullanılarak değil, boş öğe biçimi (><FieldRef /><) kullanılarak tanımlanmalıdır:>

<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
    Name="PatientName"
    DisplayName="Patient Name"
    Required="TRUE"/>

Alanın kaynak XML'i yanlış biçimlendirilmişse, geçerli bir XML dosyası değilse veya başka bir sorun sergilerse, "Dosya ayrıştırılamıyor" hatası oluşur.

Dağıtımdan sonra yeni İngilizce olmayan site tanımları site oluşturma sayfasında görünmüyor

Visual Studio'nun İngilizce olmayan bir sürümünü (yani 1033 dışında bir yerel ayar kimliğine sahip bir sürüm) kullanarak site tanımı oluşturup dağıttığınızda, SharePoint Özelleştirmeleri sekmesi Şablon Seçimi kutusunda görünmez ve yeni site şablonu Yeni SharePoint Sitesi sayfasında görünmez.

Hata mesajı

Yok.

Çözüm

Bu sorun, webtemp site tanımı yapılandırma dosyasının Path özelliğinde webtemp_SiteDefinitionProject1.xmlgibi yanlış bir değer nedeniyle oluşur. Webtemp dosyasının Dağıtım Konumu altında yer alan Path özelliğinde, 1033 değerini uygun yerel ayar kimliğiyle değiştirin. Örneğin, Japonca yerel ayar kullanmak için değeri 1041 olarak değiştirin. Daha fazla bilgi için bkz. Microsoft tarafından atanan Yerel Kimlikler.

Temiz bir sistemde bir iş akışı projesi dağıtıldığında hata görüntülenir

Bu sorun, Visual Studio'da temiz bir sistemde bir iş akışı projesi dağıtırsanız oluşur. Temiz sistem, Visual Studio ve SharePoint'in yeni bir yüklemesine sahip olan ancak dağıtılan iş akışı projesi olmayan bir bilgisayardır.

Hata mesajı

SharePoint listesi bulunamıyor: İş Akışı Geçmişi.

Çözüm

Bu hata, eksik bir İş Akışı Geçmişi listesi nedeniyle oluşur. Geliştirme ortamı temiz bir sistem olduğundan, hiçbir iş akışı dağıtılmaz ve İş Akışı Geçmişi listesi henüz mevcut değildir. Bu sorunu çözmek için, İş Akışı Geçmişi listesinin oluşturulmasına neden olan iş akışı sihirbazını yeniden açın.

İş akışı sihirbazına yeniden girmek için

  1. Çözüm Gezgini'nde iş akışı düğümünü seçin.

  2. Özellikler penceresinde, üç nokta düğmesi olan herhangi bir özellikte üç nokta (...) düğmesini seçin.

Kullanıcının güncelleştirilmiş görüntüyü görüntülemek için hata ayıklarken tarayıcıda uygulama sayfasını yenilemesi gerekir

HTML Görüntüsü denetimi gibi bir görüntü görüntüleyen denetime sahip bir uygulama sayfası içeren bir SharePoint çözümünde hata ayıklarsanız, görüntüde yapılan değişiklikleri görüntülemek için tarayıcıdaki sayfayı yenilemeniz gerekir.

Hata: Site konumu geçerli değil

SharePoint Server yüklü değilse bu sorun oluşabilir. Ayrıca, SharePoint Özelleştirme Sihirbazı'nda belirtilen SharePoint Web sitesine yönetici erişiminiz yoksa da oluşabilir.

Hata mesajı

  • SharePoint sitesi konumu geçerli değil.

Çözüm

Olay dinleyicisi projesinde site silme olayı web üzerinde oluşmuyor

Olay alıcısı projesi oluşturduğunuzda ve "site siliniyor" gibi belirli Web olaylarını seçtiğinizde olay hiçbir zaman gerçekleşmez.

Hata mesajı

Yok.

Çözüm

Bu sorun, özellik kapsamının site düzeyindeki olayları işlemek için "Site" olması gerektiği, ancak olay alıcısı projeleri için varsayılan özellik kapsamının "Web" olması nedeniyle oluşur. Etkilenen Web olayları şunlardır:

  • Bir site siliniyor (WebDeleting)

  • Site silindi (WebDeleted)

  • Bir site taşınıyor (WebMoving)

  • Bir site taşındı (WebMoved)

    Sorunu çözmek için olay alıcısının özellik kapsamını aşağıdaki gibi değiştirin.

Olay alıcısının özellik kapsamını değiştirmek için

  1. Çözüm Gezgini'nde, dosyaya çift tıklayarak veya kısayol menüsünü açıp Aç'ı seçerek olay alıcısının .feature dosyasını Özellik Tasarımcısı'nda açın.

  2. Kapsam'ın yanındaki oku seçin ve ardından görüntülenen listeden Site'yi seçin.

Bir iş verileri bağlantı modeli projesindeki tanımlayıcının adı değiştirildikten sonra dağıtım hatası görüntülenir

İş Verileri Bağlantısı (İVB) modelindeki bir varlığın tanımlayıcı adını değiştirip çözümü dağıtmayı denediğinizde bu sorun oluşur.

Hata iletileri

  • < model adı> aşağıdaki Dış İçerik Türü etkinleştirme hatalarını içeriyor...

  • Adı '<model adı>' olan IMetadataObject, 'name' alanında yinelenen bir değere sahip ...

Çözüm

Bu sorunu çözmek için modeli el ile silin ve çözümü yeniden dağıtın. Aşağıdaki araçlardan birini kullanarak modeli silebilirsiniz:

  • SharePoint 2010 Yönetim Merkezi. Daha fazla bilgi için bkz. Microsoft TechNet Web sitesindeki İVB Model Yönetimi .

  • Windows PowerShell. Şu komutu komut istemine yazarak modeli silebilirsiniz: Remove-SPBusinessDataCatalogModel. Daha fazla bilgi için Microsoft TechNet Web sitesindeki Genel cmdlet'ler (SharePoint Server 2010) bölümüne bakın.

SharePoint Server'da IIS Uygulama Havuzu geri dönüştürülmeye çalışılırken dağıtım hatası oluştu

Iis 6 WMI Uyumluluğu özelliği ve .NET Framework 3.5 SharePoint Server makinesinde yüklü değilse bu sorun oluşur.

Hata iletileri

  • 'IIS Uygulama Havuzunu Geri Dönüştür' dağıtım adımında hata oluştu: Geçersiz ad alanı
  • 'IIS Uygulama Havuzunu Geri Dönüştür' dağıtım adımında hata oluştu: Bir görev iptal edildi.

Çözüm

Bu sorunu çözmek için SharePoint Server makinesinde Iis 6 WMI Uyumluluğu Windows özelliğinin yüklü olup olmadığını denetleyin,

  • Windows PowerShell. Özelliğin yüklü olup olmadığını denetlemek için şu PowerShell komutunu çalıştırabilirsiniz: get-windowsfeature -name Web-WMI. Yüklü olarak gösterilmiyorsa, şu PowerShell komutunu çalıştırarak yükleyebilirsiniz: install-windowsfeature -name Web-WMI. Uygulama Havuzunu geri dönüştürmeye çalışırken hala hata görüyorsanız, get-windowsfeature -name NET-Framework-Core komutunu çalıştırarak bilgisayarda .NET Framework 3.5'in de yüklü olduğundan emin olun. Eğer yüklü değilse, install-windowsfeature -name NET-Framework-Core komutunu kullanarak yükleyin.

SharePoint'te görsel web bölümünü görüntülemeye çalıştığınızda bir hata görüntülenir

Bu sorun, kullanıcı denetiminin Path özelliği "CONTROLTEMPLATES\" dizesiyle başlamadığında ortaya çıkar.

Hata iletileri

  • '/_CONTROLTEMPLATES/<proje adı>/<Web Bölümü adı>/<kullanıcı denetimi adı>.ascx' mevcut değil.

  • '/' Uygulamasında Sunucu Hatası.

Çözüm

Bu sorunu çözmek için

  1. Çözüm Gezgini'nde, dosya adı uzantısı .ascx olan kullanıcı denetim dosyasını seçin.

  2. Menü çubuğundaÖzellikler Penceresini> seçin.

  3. Özellikler penceresinde Dağıtım Konumu düğümünü genişletin.

  4. Path özelliğinin değerinin "CONTROLTEMPLATES\" dizesiyle başladığından emin olun.

Görev formu alanı içeren içeri aktarılmış yeniden kullanılabilir bir iş akışı çalıştırıldığında hata görüntülenir

Bu sorun, alanı olan bir görev formu içeren bir iş akışını içeri aktarır ve ardından yeni iş akışını içeri aktardığınız sistemde çalıştırırsanız oluşur.

Hata mesajı

'Özellikleri Etkinleştir' dağıtım adımında hata oluştu: [Guid] özelliğinde tanımlanan [Guid] kimliğine sahip alan geçerli site koleksiyonunda veya bir alt sitede bulundu.

Çözüm

Bu hata, Visual Studio'daki Yeniden Kullanılabilir İş Akışını İçeri Aktar projesi görev formu alan kimliklerini değiştirmediğinden oluşan alan kimliği çakışmalarının sonucudur. İçeri aktarılan bir iş akışını özgün iş akışını içeren aynı sunucuya dağıtırsanız, alan kimliği çakışmaları oluşur.

Bu sorunu çözmek için, içeri aktarılan iş akışı dosyalarının tamamında Alan Kimliği özniteliğinin değerini değiştirmek için Bul ve Değiştir özelliğini kullanın.

Yeniden adlandırılmış bir içeri aktarılan liste örneği çalıştırıldığında hata görüntülenir

Bu sorun, içeri aktarılan bir liste örneğini yeniden adlandırıp Visual Studio'da çalıştırdığınızda oluşur.

Hata mesajı

Derleme hatası: 'Özellikleri Etkinleştir' dağıtım adımında hata oluştu: Template\Features\[import projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml dosyası yok.

Çözüm

Bir liste örneğini içeri aktardığınızda, liste örneğinin Elements.xml dosyasına CustomSchema adlı bir öznitelik eklenir. Elements.xml, liste örneği için özel bir schema.xml yolunu içerir. Visual Studio'da liste örneğini yeniden adlandırdığınızda, özel schema.xml dağıtım yolu değişir, ancak CustomSchema özniteliğinin yol değeri güncelleştirilmez. Sonuç olarak, liste örneği özellik etkinleştirildiğinde CustomSchema özniteliği tarafından belirtilen eski yolda schema.xml dosyasını bulamıyor.

Bu sorunu çözmek için CustomSchema özniteliğindeki schema.xml dosyasının dağıtım konumunun yolunu güncelleştirin.

SharePoint hata ayıklama oturumu IIS tarafından sonlandırıldı

Bir Visual Studio SharePoint çözümünde kesme noktası ayarlar, çalıştırmak için F5 anahtarını seçer ve ardından 90 saniyeden uzun bir kesme noktasında kalırsanız bu sorun oluşur.

Hata mesajı

Hata ayıklanan Web sunucusu işlemi Internet Information Services (IIS) tarafından sonlandırıldı. IIS'de Uygulama Havuzu ping ayarlarını yapılandırarak bu sorundan kaçınabilirsiniz. Diğer ayrıntılar için yardım bölümüne bakın.

Çözüm

Varsayılan olarak, IIS uygulama havuzu bir uygulamanın uygulamayı kapatmadan önce yanıt vermesi için 90 saniye bekler. Bu işleme, uygulamaya "ping" gönderme işlemi olarak bilinir. Bu sorunu çözmek için bekleme süresini artırabilir veya uygulama ping'ini tamamen devre dışı bırakabilirsiniz.

IIS uygulama havuzu ayarlarına erişmek için

  1. IIS Yöneticisi'ne tıklayın.

  2. Bağlantılar bölmesinde SharePoint sunucu düğümünü genişletin ve ardından Uygulama Havuzları düğümünü seçin.

  3. Uygulama Havuzları sayfasında, SharePoint uygulama havuzunu ("SharePoint - 80") seçin ve ardından Eylemler bölmesinde Gelişmiş Ayarlar bağlantısını seçin.

  4. IIS zaman aşımından önceki bekleme süresini artırmak için En Fazla Yanıt Süresine Ping (saniye) değerini 90 saniyeden büyük bir değerle değiştirin.

  5. IIS ping'ini devre dışı bırakmak için Ping Etkin ayarını False olarak ayarlayın.

Otomatik geri çekilme, SharePoint'te sahipsiz bir liste örneği bırakır.

Bu sorun, aşağıdaki adımları uygularsanız oluşur.

  1. Visual Studio'da liste örneği olan bir liste tanımı oluşturun.

  2. Çözümü çalıştırmak için F5 anahtarını seçin.

  3. Hata ayıklamayı durdurun veya SharePoint sitesini kapatın.

  4. SharePoint sitesini yeniden açın ve liste örneğini açın.

Hata mesajı

'/' Uygulamasında Sunucu Hatası.

Çözüm

Bunun nedeni, SharePoint çözümünün hata ayıklama oturumunu kapattıktan sonra otomatik geri çekme özelliğinin çözümü geri çekmesidir. Geri çekme işlemi liste tanımını SharePoint'ten siler ancak listenin örneğini silmez. Listenin altında yatan tanım, liste örneği için gereklidir.

Bu sorunu çözmek için menü çubuğunda Derle> Dağıt'ı seçerek çözümüdağıtın. ( F5 anahtarını seçerek çözümde hata ayıklamayın.) Ardından SharePoint'teki liste örneğini silin.

Özgün SharePoint çözümünün yerini dışarı aktarılan bir sürüm aldı

Bir SharePoint çözümünü dışarı aktarır, çözümü Visual Studio'ya aktarır ve ardından çözümü dışarı aktarıldığı siteye geri dağıtırsanız, özgün SharePoint çözümü değiştirilir. Çözümü, üzerinde özgün çözümün etkinleştirilmediği bir sunucuya dağıtırsanız bu sorun oluşmaz.

Hata mesajı

Yok.

Çözüm

Dışarı aktarıldığı sitedeki bir çözümün üzerine yazılmasını önlemek için, Visual Studio projesindeki içeri aktarılan tüm özelliklerin SolutionID guid'lerini ve Özellik Kimliklerini değiştirin.

Hata ayıklama başlatıldığında hata görüntüleniyor

Visual Studio'da bir SharePoint çözümünde hata ayıklamaya başladığınızda, verilen anahtar sözlükte olmadığından Visual Studio'nun Web.config dosyasını yükleyemeyeceğini belirten bir hata oluştu.

Hata mesajı

Web.config yapılandırma dosyası yüklenemedi. Dosyada hatalı biçimlendirilmiş XML öğeleri olup olmadığını denetleyin ve yeniden deneyin. Aşağıdaki hata oluştu: Verilen anahtar sözlükte yoktu.

Çözüm

Bu sorunu çözmek için, Visual Studio'daki SharePoint projesinin Site URL özellik değerinin, web uygulamasının alternatif erişim eşlemeleri için Varsayılan Bölgeye atanan URL ile eşleştiğinden emin olun. URL için Intranet gibi başka bir bölge kullanarak hatayı çözemezsiniz. Projenin site URL'si ve varsayılan bölgedeki URL eşleşmelidir. Alternatif erişim eşlemelerine erişmek için SharePoint 2010 Yönetim Merkezi yardımcı programını açın, Uygulama Yönetimi bağlantısını seçin ve ardından Web Uygulamaları'nın altında Alternatif erişim eşlemelerini yapılandır bağlantısını seçin. Daha fazla bilgi için bkz. Web uygulamaları için bölge oluşturma.