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.
Korumalı görsel web bölümlerinde 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 başvurursanız görsel web bölümü tasarımcısında Tasarım görünümünde içeriğin önizlemesini görüntüleyemezsiniz:
<script src="<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>
Bu sınırlamaya geçici bir çözüm bulmak ve belirteci çözmek için değişmez değerleri kullanarak belirteci 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 İletisi
"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
Space
Nokta (.)
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 İletisi
Paketleme zamanı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 İletisi
Yok.
Çözüm
Bu sorun, webtemp site tanımı yapılandırma dosyasının Path özelliğinde webtemp_SiteDefinitionProject1.xml gibi 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 İletisi
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ını yeniden açmak için
Çözüm Gezgini'da iş akışı düğümünü seçin.
Ö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 İletisi
- SharePoint sitesi konumu geçerli değil.
Çözüm
SharePoint Server'ı yükleyin.
SharePoint Web sitesine yönetici erişiminiz olduğundan emin olun. Daha fazla bilgi için SharePoint Server'da hizmet uygulamalarının yöneticilerini atama veya kaldırma başlıklı Office Online makalesine bakın.
Olay alıcı projesinde site silme web olayı 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 İletisi
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
Çözüm Gezgini'da, 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ım Aracı açın.
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ğlan ivity (İ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ında> aşağıdaki Dış İçerik Türü etkinleştirme hataları var...
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 Central Yönetici istration. 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 hata görmeye devam ediyorsanız, get-windowsfeature -name NET-Framework-Core ve install-windowsfeature -name NET-Framework-Core çalıştırarak makinede .NET Framework 3.5'in de yüklü olduğundan emin olun.
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 oluşur.
Hata iletileri
'/_CONTROLTEMPLATES/proje adı<>/Web Bölümü adı>/<kullanıcı denetimi adı.ascx>' dosyası yok.<
'/' Uygulamasında Sunucu Hatası.
Çözüm
Bu sorunu çözmek için
Çözüm Gezgini dosya adı uzantısı .ascx olan kullanıcı denetim dosyasını seçin.
Menü çubuğunda Özellikler Penceresini Görüntüle'yi>seçin.
Özellikler penceresinde Dağıtım Konumu düğümünü genişletin.
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 İletisi
'Ö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 İletisi
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 schema.xml yolunu içerir. Visual Studio'da liste örneğini yeniden adlandırdığınızda, özel schema.xml için dağıtım yolu değişir, ancak CustomSchema özniteliğinin yol değeri güncelleştirilmez. Sonuç olarak, özellik etkinleştirildiğinde liste örneği schema.xml dosyasını CustomSchema özniteliği tarafından belirtilen eski yolda 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 İletisi
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şlem, uygulamaya "ping" 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
IIS Yöneticisi'ni açın.
Bağlan ions bölmesinde SharePoint sunucu düğümünü genişletin ve ardından Uygulama Havuzları düğümünü seçin.
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.
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.
IIS ping'ini devre dışı bırakmak için Ping Etkin ayarını False olarak ayarlayın.
Otomatik geri çekme, SharePoint'te yalnız bırakılmış liste örneğini bırakır
Bu sorun, aşağıdaki adımları uygularsanız oluşur.
Visual Studio'da liste örneği olan bir liste tanımı oluşturun.
Çözümü çalıştırmak için F5 anahtarını seçin.
Hata ayıklamayı durdurun veya SharePoint sitesini kapatın.
SharePoint sitesini yeniden açın ve liste örneğini açın.
Hata İletisi
'/' 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. Temel alınan liste 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. (Çözümün hatalarını ayıklamak için F5 tuşu.) 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 İletisi
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 İletisi
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 Central Yönetici istration 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.