Ladění řešení služby SharePoint
Řešení služby SharePoint lze ladit pomocí ladícího programu Visual Studio.Po spuštění ladění nasadí Visual Studio soubory projektu na server SharePoint a poté otevře instance webu služby SharePoint ve webovém prohlížeči.Následující části popisují, jak provést ladění aplikací SharePoint pomocí aplikace Visual Studio.
Povolení ladění
F5 ladění a proces zavádění
Funkce projektu služby SharePoint
Ladění pracovních postupů
Ladění příjemce událostí funkce
Povolení rozšířených informací o ladění
Povolení ladění
Při prvním ladění řešení služby SharePoint pomocí Visual Studio, upozorní dialogové okno na absenci konfigurace souboru web.config. (Soubor web.config je vytvořen při instalaci serveru SharePoint.Další informace naleznete v tématu Práce se soubory Web.config.) Dialogové okno poskytuje možnost spuštění projektu bez ladění nebo upravení souboru web.config pro povolení ladění.Je-li zvolena první možnost, bude projekt běžet normálně.Pokud zvolíte druhou možnost, bude soubor web.config nastaven na:
Zapněte zásobník volání (CallStack="true")
Zakažte uživatelské chyby v aplikaci Visual Studio (<customErrors mode="Off" />)
Povolte ladění kompilace (<compilation debug="true">)
Následuje výsledný soubor web.config:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<configuration>
...
<SharePoint>
<SafeMode MaxControls="200"
CallStack="true"
DirectFileDependencies="10"
TotalFileDependencies="50"
AllowPageLevelTrace="false">
...
</SafeMode>
...
</SharePoint>
<system.web>
...
<customErrors mode="Off" />
...
<compilation debug="true">
...
</compilation>
...
</system.web>
...
</configuration>
Pro vrácení změn zpět a pro povolení ladění, změňte v souboru web.config následující XML:
Vypněte zásobník volání (CallStack="false")
Povolte uživatelské chyby v Visual Studio (<customErrors mode="On" />)
Zakažte ladění kompilace (<compilation debug="false">)
F5 ladění a proces zavádění
Při spuštění projektu služby SharePoint v režimu ladění, provede proces nasazení serveru SharePoint následující úlohy:
Spustí přizpůsobitelné příkazy před zavedením.
Vytvoří soubor balíčku webového řešení (.wsp) pomocí příkazů MSBuild.Soubor .wsp zahrnuje všechny potřebné soubory a funkce.Další informace naleznete v tématu Přehled řešení.
Pokud je řešení služby SharePoint řešení farmy, recykluje pro zadanou stránku URL fond aplikací IIS.Tento krok uvolní soubory uzamčené pracovním procesem IIS.
Pokud již existuje předchozí verze balíčku, pak v rámci souboru .wsp odvolá předchozí verzi funkcí a souborů.Tento krok deaktivuje funkce, odinstaluje balíček řešení a následně odstraní balíček řešení na serveru SharePoint.
Nainstaluje aktuální verzi souborů a funkcí do souboru .wsp.Tento krok přidá a nainstaluje řešení na server SharePoint.
Pro pracovní postupy nainstaluje sestavení pracovních postupů.Jeho umístění lze změnit pomocí vlastnosti Assembly Location.
Aktivuje vlastnosti projektu v rámci služby SharePoint, pokud je oborem Site nebo Web.Funkce v rámci oborů Farm a WebApplication nejsou aktivovány.
Pro pracovní postupy, spojí pracovní postup s vybranou knihovnou služby SharePoint, seznamem nebo stránkou v Průvodci přizpůsobení služby SharePoint.
[!POZNÁMKA]
K přidružení dochází, pouze byla-li v průvodci vybrána položka Automaticky přiřadit pracovní postup.
Spustí přizpůsobitelné příkazy po zavedení.
Připojí ladicí program Visual Studio k procesu Windows SharePoint Services (w3wp.exe).Pokud typ projektu umožňuje změnit vlastnost Sandboxed Solution a je její hodnota nastavena na true, dojde k připojení ladicího programu k jinému procesu (SPUCWorkerProcess.exe).Další informace naleznete v tématu Aspekty řešení v izolovaném prostoru.
Spustí ladicí program jazyka JavaScript, pokud je řešení služby SharePoint řešením farmy.
Ve webovém prohlížeči zobrazí příslušnou knihovnu, seznam nebo webovou stránku.
Visual Studio zobrazí v okně pro výstup stavovou zprávu po dokončení každého úkolu.Pokud nemůže být úkol dokončen, zobrazí aplikace Visual Studio chybovou zprávu v okně seznamu chyb.
Funkce projektu služby SharePoint
Funkce je přenosná a modulární jednotka funkčnosti, která usnadňuje úpravy webů pomocí definice webu.Je to také balíček prvků Windows SharePoint Services (WSS), které lze aktivovat pro konkrétní obor a který napomáhá uživatelům dosáhnout určitého cíle nebo úkolu.Šablony jsou nasazeny jako funkce.
Po spuštění projektu v režimu ladění, vytvoří proces nasazení na %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES složku v adresáři funkce.Názvy funkcí mají formát project name_Featurex, například TestProject_Feature1.
Složka řešení v adresáři funkcí obsahuje soubor definice funkce a soubor definice pracovního postupu.Soubor definice funkce (Feature.xml) popisuje soubory ve funkci projektu.Soubor definice projektu (Elements.xml) popisuje šablonu projektu.Elements.xml lze nalézt v Průzkumníku řešení, ale soubor Feature.xml je vygenerován při vytvoření balíčku řešení.Další informace o těchto souborech naleznete v části Šablony projektů a položek projektů služby SharePoint.
Ladění pracovních postupů
Při ladění projektů pracovních postupů přidá aplikace Visual Studio do knihovny nebo do seznamu šablonu pracovního postupu (v závislosti na jeho typu).Následně lze spustit šablonu pracovního postupu ručně, popřípadě přidáním nebo aktualizací položky.Poté je možné použít aplikaci Visual Studio k ladění pracovního postupu.
[!POZNÁMKA]
Po přidání odkazu na ostatní sestavení se je třeba ujistit, zda jsou tato sestavení nainstalována v globální mezipaměti sestavení (GAC) (GAC).Jinak řešení pracovních postupů selže.Informace o instalaci sestavení naleznete v tématu Ruční spuštění pracovního postupu pro dokument nebo položku.
Pomocí procesu nasazení nelze však spustit pracovní postup.Pracovní postup je nutné spustit z webu služby SharePoint.Pracovní postup lze také spustit pomocí klientské aplikace, jako je například aplikace Microsoft Office Word 2010 nebo pomocí samostatného kódu na straně serveru.Použijte jeden z postupů uvedených v Průvodci přizpůsobením webu SharePoint.
Pokud bylo rozhodnuto, že lze pracovní postup spustit ručně, je třeba pracovní postup pustit přímo z položky knihovny nebo seznamu.Další informace o tom, jak ručně spustit pracovní postup naleznete v tématu Ruční spuštění pracovního postupu na položce dokumentu.
Ladění příjemce událostí funkce
Při spuštění aplikace SharePoint Visual Studio jsou pro vás a server sharepoint ve výchozím stavu její funkce automaticky aktivovány.Toto však působí potíže při ladění příjemce událostí funkce, protože, pokud je funkce aktivována pomocí aplikace Visual Studio, běží v jiném procesu než ladicí program.To znamená, že některá funkčnost při ladění, jako jsou například zarážky, nebude pracovat správně.
Pro zakázání automatické aktivaci funkce v rámci služby SharePoint a pro povolení správného ladění příjemce událostí funkce, je třeba před spuštěním ladění nastavit hodnotu vlastnosti projektu Aktivní konfigurace nasazení na Bez aktivace.Poté, co je spuštěno ladění aplikace SharePoint v Visual Studio, je třeba ručně aktivovat funkci ve službě SharePoint.Chcete-li aktivovat funkci, otevřete ve službě SharePoint nabídku Akce webu, zvolte Nastavení webu, zvolte odkaz Spravovat funkce webu a poté klikněte na tlačítko Aktivovat, které se nachází vedle funkce a pokračujte v ladění jako obvykle.
Povolení rozšířených informací o ladění
Z důvodu občasného složitého vzájemného působení mezi procesy Visual Studio (devenv.exe), hostitelským procesem služby SharePoint Visual Studio (vssphost4.exe), a vrstvou WCF, může být provádění diagnostiky chyb, ke které dochází při sestavení, nasazení a tak dále taktéž složité.Pro vyřešení těchto chyb je možné povolit rozšířené informace o ladění.Předchozí krok lze provést přechodem na následující klíč registru v registrech systému Windows:
[HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools]
Pokud hodnota "EnableDiagnostics" REG_DWORD dosud neexistuje, je třeba ji vytvořit ručně.Je třeba nastavit hodnotu "EnableDiagnostics" na 1.
Nastavením této hodnoty klíče na 1 způsobí zobrazení stavu zásobníku v okně pro výstup pokaždé, když dojde k systémové chybě projektu, při spuštění skrze aplikaci Visual Studio.Pro zakázání rozšířených informací o ladění je třeba nastavit EnableDiagnostics zpět na 0 nebo tuto hodnotu odstranit.
Další informace o ostatních klíčích registru služby SharePoint naleznete v tématu Ladění rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio.