Řešení potíží s řešeními služby SharePoint
Při ladění řešení SharePoint pomocí ladicího programu Visual Studio může dojít k následujícím problémům nebo výstrahám.Další informace naleznete v tématu Debugging SharePoint Workflow Solutions.
Toto téma obsahuje následující oddíly.
- Omezení tokenů ve vizuálních webových částech v izolovaném prostoru
- Znaková omezení v názvech projektů a položek projektů
- Chyby při vytváření vlastních polí
- Nové definice webu v jazyce jiném než angličtina se po nasazení nezobrazují na stránce vytvoření webu.
- Při nasazení projektu pracovního postupu na čistý systém se zobrazuje chyba
- Pro zobrazení aktualizovaného obrázku musí uživatel v prohlížeči obnovit stránku aplikace při ladění.
- Chyba: Umístění webu není platné
- V projektu příjemce události není vyvolávána webová událost odstranění webu
- Po změně názvu identifikátoru v projektu modelu připojení obchodních dat se zobrazuje chyba nasazení
- Při pokusu o zobrazení vizuální webové části ve službě SharePoint se zobrazuje chyba
- Při spuštění importovaného recyklovatelného pracovního postupu obsahujícího pole formuláře úkolu se zobrazuje chyba
- Při spuštění přejmenované importované instance seznamu se zobrazuje chyba
- Relace ladění SharePoint byla ukončena službou IIS
- Automatické odvolání zanechává ve službě SharePoint osamocené instance seznamu
- Původní řešení SharePoint je nahrazeno exportovanou verzí
- Při spuštění ladění se zobrazuje chyba
- Příbuzná témata
Omezení tokenů ve vizuálních webových částech v izolovaném prostoru
Vizuální webové části v řešeních v izolovaných prostorech nemohou zpracovávat běžné tokeny podporované modulem runtime služby SharePoint, například $SPUrl.Důsledkem toho není vyhodnocena adresa URL a stejně jako v následujícím příkladu nelze při přímém odkázání z elementu skriptu zobrazit náhled obsahu v zobrazení Návrh v Návrháři vizuálních webových částí.
<script src=”<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>
Tento problém lze obejít a token vyhodnotit odkázáním pomocí literálů:
<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>" />
Znaková omezení v názvech projektů a položek projektů
Názvy projektů a položek projektů mohou obsahovat pouze znaky platné v cestě nasazení ve službě SharePoint 2010.Žádné další znaky povoleny nejsou.
Chybová zpráva
Chybová zpráva "Neplatné znaky".
Řešení
Pro názvy projektů a položek projektů SharePoint používejte pouze následující znaky:
Alfanumerické znaky ASCII
Mezera
Tečka (.)
Čárka (,)
Podtržítko (_)
Pomlčka (-)
Zpětné lomítko (\)
Po zabalení projektu je ověřovacím pravidlem ověřeno, že vlastnost deployment-path každého nasazovaného souboru obsahuje pouze tyto platné znaky.
Chyby při vytváření vlastních polí
V aplikaci Visual Studio jsou vlastní pole definována v jazyce XML.Není-li pole definováno nebo odkazováno v určitém formátu, může dojít k chybám.
Chybová zpráva
Chybová zpráva "Neplatné znaky" během tvorby balíčku.
Řešení
Jak ukazuje následující příklad, ID definice pole musí být identifikátorem GUID uzavřeném ve složených závorkách:
<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
Type="Note"
Name="PatientName"
DisplayName="Patient Name"
Group="A Custom Group">
</Field>.
Jak ukazuje následující příklad, odkaz na pole v typu obsahu, musí být definovány pomocí formátu prázdný element (<FieldRef />), nikoli pomocí zahájení a ukončení prvků (<FieldRef></FieldRef>):
<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
Name="PatientName"
DisplayName="Patient Name"
Required="TRUE"/>
V případě, že soubor XML je poškozen, není platným souborem XML nebo obsahuje jiné chyby, dojde k chybě "Nelze analyzovat soubor".
Nové definice webu v jazyce jiném než angličtina se po nasazení nezobrazují na stránce vytvoření webu.
Po vytvoření a nasazení definice webu použitím jiné než anglické verze aplikace Visual Studio (tzn. verze s identifikátorem ID národního prostředí jiným než 1033) se v okně Výběr šablony nezobrazuje panel Přizpůsobení služby SharePoint a na stránce Nový web SharePoint se nezobrazuje nová šablona webu.
Chybová zpráva
Žádná.
Řešení
K tomuto problému dochází v důsledku nesprávné hodnoty ve vlastnosti Cesta konfiguračního souboru definic webu webtemp, například webtemp_SiteDefinitionProject1.xml.Ve vlastnosti Cesta souboru webtemp změňte pod uzlem Umístění nasazení hodnotu 1033 na odpovídající identifikátor ID národního prostředí.Chcete-li například použít japonské národní prostředí, zadejte hodnotu 1041.Další informace naleznete v tématu Národního prostředí ID přiřazené společností Microsoft na webu MSDN.
Při nasazení projektu pracovního postupu na čistý systém se zobrazuje chyba
K tomuto problému dochází při nasazování projektu pracovního postupu v aplikaci Visual Studio na čistém systému.Čistý systém je počítač s novou instalací sady Visual Studio a služby SharePoint, ale bez nasazených projektů pracovního postupu.
Chybová zpráva
Nelze najít seznam SharePoint: Historie pracovního postupu.
Řešení
K této chybě dochází kvůli chybějícímu seznamu Historie pracovního postupu.Jelikož je vývojové prostředí čistým systémem, nejsou nasazeny žádné pracovní postupy a seznam Historie pracovního postupu ještě neexistuje.Chcete-li tento problém vyřešit, otevřete znovu průvodce pracovním postupem, čímž bude seznam Historie pracovního postupu vytvořen.
Opětovné otevření průvodce pracovním postupem
V Průzkumníku řešení zvolte uzel pracovního postupu.
V okně Vlastnosti zvolte tlačítko tří teček (...) u libovolné vlastnosti, která toto tlačítko má.
Pro zobrazení aktualizovaného obrázku musí uživatel v prohlížeči obnovit stránku aplikace při ladění.
Ladíte-li řešení SharePoint obsahující stránku aplikace s ovládacím prvkem, který zobrazuje obrázek, například ovládací prvek obrázku HTML, musí být pro zobrazení změn obrázku stránka obnovena v prohlížeči.
Chyba: Umístění webu není platné
Tento problém může nastat, není-li nainstalován server SharePoint Server 2010.Může také nastat v případě, že nemáte k webu SharePoint zadanému v Průvodci přizpůsobením služby SharePoint přístup správce.
Chybová zpráva
- Umístění webu SharePoint není platné.
Řešení
Nainstalujte server SharePoint Server 2010.
Ujistěte se, zda máte k webu SharePoint přístup správce.Další informace naleznete Office Online článku udělení přístupu k portálu.
V projektu příjemce události není vyvolávána webová událost odstranění webu
Po vytvoření projektu přijímače události a zvolení určitých webových událostí, například "web je odstraňován", nedochází k události.
Chybová zpráva
Žádná.
Řešení
K tomuto problému dochází, protože pro zpracování událostí na úrovni webu musí být obor funkcí nastaven na hodnotu "Site", ale výchozí obor funkcí pro projekty přijímačů událostí je "Web".Toto se týká následujících událostí Web:
Web je odstraňován (WebDeleting)
Web byl odstraněn (WebDeleted)
Web je přemisťován (WebMoving)
Web byl přesunut (WebMoved)
Chcete-li tento problém odstranit, změňte obor funkcí přijímače událostí dle následujícího vzoru.
Změna oboru funkcí přijímače událostí
V Průzkumníkovi řešení otevřete soubor .feature daného přijímače události v Návrháři funkcí buď kliknutím dvakrát na soubor nebo otevřením jeho místní nabídky a zvolením příkazu Otevřít.
Klikněte na šipku vedle Oboru a v zobrazeném seznamu klikněte na možnost Web.
Po změně názvu identifikátoru v projektu modelu připojení obchodních dat se zobrazuje chyba nasazení
K tomuto problému dochází při změně názvu identifikátoru entity v modelu Připojení obchodních dat (BDC) a pokusu o nasazení řešení.
Chybové zprávy
<model name>má následující chyby aktivace externího obsahu...
IMetadataObject s názvem "<model name>" do pole "název", který je duplicitní s hodnotou...
Řešení
Chcete-li vyřešit tento problém, odstraňte model ručně a poté řešení znovu nasaďte. Model lze odstranit pomocí kteréhokoliv z následujících nástrojů:
Centrální správa SharePoint 2010.Další informace naleznete v tématu Správy modelu služby BDC na webu Microsoft TechNet webu.
Windows PowerShell.Model lze odstranit zadáním tohoto příkazu v příkazovém řádku: Remove-SPBusinessDataCatalogModel.Další informace naleznete v tématu rutin obecného (SharePoint Server 2010) na webu Microsoft TechNet webu.
Při pokusu o zobrazení vizuální webové části ve službě SharePoint se zobrazuje chyba
K tomuto problému dochází v případě, že vlastnost Cesta uživatelského ovládacího prvku nezačíná řetězcem "CONTROLTEMPLATES\".
Chybové zprávy
Soubor ' /_CONTROLTEMPLATES/<project name>/<Web Part name>/<user control name>ascx ' neexistuje.
Chyba serveru v aplikaci '/'.
Řešení
Řešení problému
V Průzkumníku řešení zvolte soubor uživatelského ovládacího prvku, jehož přípona je .ascx.
V panelu nabídky zvolte Zobrazení, Okno vlastností.
V okně Vlastnosti rozbalte uzel Umístění nasazení.
Ujistěte se, že hodnota vlastnosti Cesta začíná řetězcem "CONTROLTEMPLATES\".
Při spuštění importovaného recyklovatelného pracovního postupu obsahujícího pole formuláře úkolu se zobrazuje chyba
K tomuto problému dochází, je-li importován pracovní postup obsahující formulář úkolu s polem a poté nový pracovní postup spuštěn na stejném systému, z nějž byl importován.
Chybová zpráva
V kroku nasazení "Aktivovat funkce" došlo k chybě: Pole s identifikátorem ID [Guid] definované ve funkci [Guid] bylo nalezeno v aktuální kolekci webu nebo v podřízeném webu.
Řešení
Tato chyba je důsledkem kolize identifikátorů ID polí, ke které dochází, nezmění-li projekt Import recyklovatelného pracovního postupu v aplikaci Visual Studio identifikátory ID polí formulářů úkolů.Nasadíte-li importovaný pracovní postup na stejný server obsahující původní pracovní postup, dojde ke kolizi identifikátoru ID polí.
Chcete-li tento problém vyřešit, změňte hodnotu atributu Field ID ve všech importovaných souborech pracovního postupu pomocí funkce Najít a nahradit.
Při spuštění přejmenované importované instance seznamu se zobrazuje chyba
K tomuto problému dochází, přejmenujete-li importovanou instanci seznamu a poté ji spustíte v aplikaci Visual Studio.
Chybová zpráva
Chyba sestavení: Při kroku nasazení "Aktivovat funkce" došlo k chybě: Soubor Template\Features\[import projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml neexistuje.
Řešení
Při importování instance seznamu je do souboru Elements.xml této instance přidán atribut pojmenovaný CustomSchema.Soubor Elements.xml zahrnuje cestu vlastního souboru schema.xml pro instanci seznamu.Při přejmenování instance seznamu v aplikaci Visual Studio se mění cesta nasazení vlastního souboru schema.xml, ale hodnota cesty atributu CustomSchema není aktualizována.Důsledkem toho nemůže instance seznamu při aktivaci funkce najít soubor schema.xml na původní cestě určené atributem CustomSchema.
Chcete-li tento problém odstranit, aktualizujte cestu umístění nasazení souboru schema.xml v atributu CustomSchema.
Relace ladění SharePoint byla ukončena službou IIS
K tomuto problému dochází, nastavíte-li v řešení SharePoint aplikace Visual Studio zarážku, spustíte řešení klávesou F5 a zůstanete na zarážce po dobu delší než 90 sekund.
Chybová zpráva
Proces laděného webového serveru byl ukončen Internetovou informační službou (IIS).Tomuto problému se lze vyhnout nastavením příkazu ping Fondu aplikací v IIS.Více informací naleznete v nápovědě.
Řešení
Ve výchozím nastavení fond aplikací služby IIS čeká na odpověď aplikace 90 sekund, poté ji ukončí.Tento proces je znám jako ověřování aktivity aplikace.Chcete-li tento problém vyřešit, lze buď zvýšit dobu čekání, nebo zcela vypnout ověřování aktivity aplikace.
Přístup k nastavením fondu aplikací služby IIS
Otevřete Správce služby IIS.
V podokně Připojení rozbalte uzel Server SharePoint a klikněte na uzel Fondy aplikací.
Na stránce Fondy aplikací zvolte Fond aplikací SharePoint (obvykle "SharePoint - 80") a poté v podokně Akce zvolte odkaz Upřesnit nastavení.
Chcete-li zvýšit časový limit služby IIS, změňte hodnotu Maximální prodleva příkazu ping (s) na hodnotu delší než 90 sekund.
Chcete-li ověřování aktivity zakázat, nastavte hodnotu Povolený příkaz ping na False.
Automatické odvolání zanechává ve službě SharePoint osamocené instance seznamu
K tomuto problému dochází, jsou-li učiněny následující kroky.
Vytvoření definice seznamu, která má instanci seznamu v aplikaci Visual Studio.
Spuštění řešení klávesou F5.
Ukončení ladění a uzavření webu SharePoint.
Opětovné otevření webu SharePoint a otevření instance seznamu.
Chybová zpráva
Chyba serveru v aplikaci '/'.
Řešení
Tento problém je způsoben automatickým odvoláním řešení funkcí automatického odvolání po ukončení relace ladění.Odvolání odstraní definice seznamu ze služby SharePoint, ale neodstraní jeho instanci.Instance seznamu však tuto definici požaduje.
Chcete-li tento problém vyřešit, nasaďte řešení zvolením možností Sestavení a Nasadit v panelu nabídek. (Nelaďte řešení zvolením klávesy F5.) Poté odstraňte ve službě SharePoint instanci seznamu.
Původní řešení SharePoint je nahrazeno exportovanou verzí
Pokud exportujete řešení SharePoint, naimportujete jej do aplikace Visual Studio a poté nasadíte řešení zpět na stejný web, z nějž bylo exportováno, je původní řešení SharePoint nahrazeno.K tomuto problému nedochází, je-li řešení nasazeno na serveru, který nemá původní řešení aktivováno.
Chybová zpráva
Žádná.
Řešení
Chcete-li se přepsání řešení na webu, z nějž bylo exportováno, vyhnout, změňte identifikátory GUID identifikátoru SolutionID a identifikátory ID funkcí všech importovaných funkcí v projektu Visual Studio.
Při spuštění ladění se zobrazuje chyba
Při spuštění ladění řešení SharePoint v aplikaci Visual Studio je chybou oznámeno, že aplikace Visual Studio nemohla načíst soubor Web.config, protože daný klíč nebyl ve slovníku.
Chybová zpráva
Nepodařilo se načíst konfigurační soubor Web.config.Zkontrolujte, zda se v souboru nenacházejí poškozené elementy XML, a opakujte akci.Došlo k následující chybě: daný klíč se nenalézal ve slovníku.
Řešení
Chcete-li tento problém vyřešit, ujistěte se, zda se hodnota vlastnosti Adresa URL webu projektu SharePoint v aplikaci Visual Studio shoduje s adresou URL přiřazenou Výchozí zóně pro mapování alternativních adres URL webové aplikace.Tuto chybu nelze vyřešit použitím jiné zóny (například Intranet) pro adresu URL.Adresa URL webu pro projekt a adresa URL výchozí zóny se musí shodovat.Chcete-li přistoupit k mapováním alternativních adres URL, otevřete nástroj SharePoint 2010 Central Administration, zvolte odkaz Správa aplikace a poté v oddílu Webové aplikace zvolte odkaz Konfigurovat mapování alternativních adres URL.Další informace naleznete v tématu vytvořit zóny pro webové aplikace.
Viz také
Koncepty
Řešení potíží s balením a nasazením služby SharePoint