Ladění řešení SharePointu
Řešení SharePointu můžete ladit pomocí ladicího programu sady Visual Studio. Když spustíte ladění, Visual Studio nasadí soubory projektu na sharepointový server a pak otevře instanci sharepointového webu ve webovém prohlížeči. Následující části vysvětlují, jak ladit aplikace SharePointu v sadě Visual Studio.
Povolení ladění
Při prvním ladění řešení SharePoint v sadě Visual Studio vás dialogové okno upozorní, že soubor web.config není nakonfigurován tak, aby povoloval ladění. (Soubor web.config se vytvoří při instalaci serveru SharePoint. Další informace naleznete v tématu Práce se soubory Web.config.) V dialogovém okně můžete buď spustit projekt bez ladění, nebo upravit soubor web.config tak, aby se povolilo ladění. Pokud zvolíte první možnost, projekt se spustí normálně. Pokud zvolíte druhou možnost, nakonfiguruje se soubor web.config na:
Zapnutí zásobníku volání (
CallStack="true")Zakázání vlastních chyb v sadě Visual Studio (
<customErrors mode="Off" />)Povolení ladění kompilace (
<compilation debug="true">)Výsledný soubor web.config následuje:
<?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>
Pokud chcete změny vrátit zpět a zakázat ladění, změňte v souboru web.config následující kód XML:
Vypnutí zásobníku volání (
CallStack="false")Povolení vlastních chyb v sadě Visual Studio (
<customErrors mode="On" />)Zakázání ladění kompilace (
<compilation debug="false">)
Proces ladění a nasazení F5
Když spustíte projekt SharePointu v režimu ladění, proces nasazení SharePointu provede následující úlohy:
Spustí přizpůsobitelné příkazy před nasazením.
Vytvoří soubor balíčku webového řešení (WSP) pomocí příkazů MSBuild. Soubor .wsp obsahuje všechny potřebné soubory a funkce. Další informace najdete v tématu Přehled řešení.
Pokud je řešení SharePointu řešením farmy, recykluje fond aplikací služby IIS pro zadanou adresu URL webu. Tento krok uvolní soubory uzamčené pracovním procesem služby IIS.
Pokud již existuje předchozí verze balíčku, odvolá předchozí verzi funkcí a souborů v souboru WSP. Tento krok deaktivuje funkce, odinstaluje balíček řešení a potom odstraní balíček řešení na serveru SharePoint.
Nainstaluje aktuální verzi funkcí a souborů do souboru WSP. Tento krok přidá a nainstaluje řešení na sharepointový server.
Pro pracovní postupy nainstaluje sestavení pracovního postupu. Umístění lze změnit pomocí vlastnosti Umístění sestavení.
Aktivuje funkci projektu v SharePointu, pokud je obor web nebo web. Funkce v oborech Farm and WebApplication nejsou aktivované.
U pracovních postupů přidruží pracovní postup k knihovně, seznamu nebo webu sharepointové knihovny, kterou jste vybrali v Průvodci přizpůsobením služby SharePoint.
Poznámka:
K tomuto přidružení dochází pouze v případě, že jste v průvodci vybrali možnost Automaticky přidružit pracovní postup .
Spustí přizpůsobitelné příkazy po nasazení.
Připojí ladicí program sady Visual Studio k procesu windows služba SharePoint Services (w3wp.exe). Pokud typ projektu umožňuje změnit vlastnost řešení v izolovaném prostoru a jeho hodnota je nastavena na hodnotu true, ladicí program se připojí k jinému procesu (SPUCWorkerProcess.exe). Další informace najdete v tématu Aspekty řešení v izolovaném prostoru (sandbox).
Spustí ladicí program JavaScriptu, pokud je řešení sharepointové farmy.
Zobrazí příslušnou knihovnu, seznam nebo stránku webu ve webovém prohlížeči.
Visual Studio po dokončení každého úkolu zobrazí stavovou zprávu v okně Výstup. Pokud úlohu nelze dokončit, sada Visual Studio zobrazí chybovou zprávu v okně Seznam chyb.
Funkce projektu SharePointu
Funkce je přenosná a modulární jednotka funkcí, která zjednodušuje úpravy lokalit pomocí definic webů. Jedná se také o balíček prvků systému Windows služba SharePoint Services (WSS), které lze aktivovat pro konkrétní obor a které uživatelům pomáhají dosáhnout konkrétního cíle nebo úkolu. Šablony se nasazují jako funkce.
Když spustíte projekt v režimu ladění, proces nasazení vytvoří složku v adresáři funkcí v %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES. Názvy funkcí mají název projektu formátu_Featurex, například TestProject_Feature1.
Složka řešení v adresáři funkcí obsahuje soubor definice funkce a soubor definice pracovního postupu. Definiční soubor funkce (Feature.xml) popisuje soubory v souboru Feature projektu.Definiční soubor projektu (Elements.xml) popisuje šablonu projektu. Elements.xml najdete v Průzkumník řešení, ale při vytvoření balíčku řešení se Feature.xml vygeneruje. Další informace o těchtosouborch
Ladění pracovních postupů
Při ladění projektů pracovního postupu visual Studio přidá šablonu pracovního postupu (podle jejího typu) do knihovny nebo do seznamu. Šablonu pracovního postupu pak můžete spustit ručně nebo přidáním nebo aktualizací položky. K ladění pracovního postupu pak můžete použít Visual Studio.
Poznámka:
Pokud přidáte odkazy na jiná sestavení, ujistěte se, že jsou tato sestavení nainstalována v globální mezipaměti sestavení (GAC). Jinak řešení pracovního postupu selže. Informace o tom, jak nainstalovat sestavení, naleznete v tématu Ruční spuštění pracovního postupu u dokumentu nebo položky.
Proces nasazení však nespustí pracovní postup. Pracovní postup je nutné spustit z webu služby SharePoint. Pracovní postup můžete spustit také pomocí klientské aplikace, jako je systém Microsoft Office Word 2010, nebo pomocí samostatného kódu na straně serveru. Použijte jeden z přístupů zadaných v Průvodci přizpůsobením služby SharePoint.
Pokud jste například určili, že pracovní postup lze spustit ručně, spusťte pracovní postup přímo z položky v knihovně nebo seznamu. Další informace o ručním spuštění pracovního postupu najdete v tématu Ruční spuštění pracovního postupu u položky dokumentu.
Přijímače událostí ladění
Ve výchozím nastavení se při spuštění aplikace Visual Studio SharePoint automaticky aktivují její funkce na serveru SharePoint. To ale způsobuje problémy při ladění přijímačů událostí funkce, protože když je funkce aktivována sadou Visual Studio, běží v jiném procesu než ladicí program. To znamená, že některé funkce ladění, například zarážky, nebudou fungovat správně.
Chcete-li zakázat automatickou aktivaci funkce v SharePointu a povolit správné ladění přijímačů událostí funkce, nastavte hodnotu vlastnosti Konfigurace aktivního nasazení projektu na hodnotu Bez aktivace před laděním. Potom po zahájení ladění aplikace SharePoint v sadě Visual Studio ručně aktivujte funkci v SharePointu. Pokud chcete tuto funkci aktivovat, otevřete nabídku Akce webu na SharePointu, zvolte Web Nastavení, zvolte odkaz Spravovat funkce webu a pak zvolte tlačítko Aktivovat vedle funkce. Chcete-li pokračovat v ladění jako obvykle.
Povolení rozšířených informací o ladění
Kvůli někdy složitým interakcím mezi procesem sady Visual Studio (devenv.exe), hostitelským procesem sady Visual Studio SharePoint (vssphost4.exe), SharePointem a vrstvou WCF, diagnostikou chyb, ke kterým dochází při sestavování, nasazování atd., může být problém. Pokud chcete tyto chyby vyřešit, můžete povolit rozšířené informace o ladění. Uděláte to tak, že v registru Windows přejdete na následující klíč registru:
HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools
Pokud hodnota EnableDiagnostics REG_DWORD ještě neexistuje, vytvořte ji ručně. Nastavte hodnotu EnableDiagnostics na hodnotu 1.
Nastavení této hodnoty klíče na 1 způsobí, že se v okně Výstup zobrazí informace o trasování zásobníku při každém výskytu chyb systému projektu při spuštění v sadě Visual Studio. Chcete-li zakázat rozšířené informace o ladění, nastavte enableDiagnostics zpět na hodnotu 0 nebo odstraňte hodnotu.
Další informace o dalších klíčích registru Služby SharePoint naleznete v tématu Ladění rozšíření pro nástroje Služby SharePoint v sadě Visual Studio.