Felsöka SharePoint-lösningar

Du kan felsöka SharePoint-lösningar med hjälp av Visual Studio-felsökningsprogrammet. När du börjar felsöka distribuerar Visual Studio projektfilerna till SharePoint-servern och öppnar sedan en instans av SharePoint-webbplatsen i webbläsaren. I följande avsnitt beskrivs hur du felsöker SharePoint-program i Visual Studio.

• Aktivera felsökning

• Felsöknings- och distributionsprocess för F5

• SharePoint-projektfunktioner

• Felsöka arbetsflöden

• Felsöka händelsemottagare för funktioner

• Aktivera förbättrad felsökningsinformation

Aktivera felsökning

När du först felsöker en SharePoint-lösning i Visual Studio visas en dialogruta som varnar dig om att web.config-filen inte har konfigurerats för att aktivera felsökning. (Filen web.config skapas när du installerar SharePoint-servern. Mer information finns i Arbeta med Web.config-filer.) Dialogrutan ger dig möjlighet att antingen köra projektet utan att felsöka eller ändra web.config-filen för att aktivera felsökning. Om du väljer det första alternativet körs projektet normalt. Om du väljer det andra alternativet är web.config-filen konfigurerad för att:

• Aktivera anropsstacken (CallStack="true")

• Inaktivera anpassade fel i Visual Studio (<customErrors mode="Off" />)

• Aktivera kompileringsfelsökning (<compilation debug="true">)

  Den resulterande web.config filen följer:

<?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>

Om du vill ångra ändringarna och inaktivera felsökning ändrar du följande XML i filen web.config:

• Inaktivera anropsstacken (CallStack="false")

• Aktivera anpassade fel i Visual Studio (<customErrors mode="On" />)

• Inaktivera kompileringsfelsökning (<compilation debug="false">)

Felsöknings- och distributionsprocess för F5

När du kör SharePoint-projektet i felsökningsläge utför SharePoint-distributionsprocessen följande uppgifter:

1. Kör de anpassningsbara fördistributionskommandona.

2. Skapar en webblösningspaketfil (.wsp) med hjälp av MSBuild-kommandon. .wsp-filen innehåller alla nödvändiga filer och funktioner. Mer information finns i Översikt över lösningar.

3. Om SharePoint-lösningen är en servergruppslösning återanvänder du IIS-programpoolen för den angivna webbplats-URL:en. Det här steget släpper filer som är låsta av IIS-arbetsprocessen.

4. Om det redan finns en tidigare version av paketet återkallas den tidigare versionen av funktionerna och filerna i .wsp-filen. Det här steget inaktiverar funktionerna, avinstallerar lösningspaketet och tar sedan bort lösningspaketet på SharePoint-servern.

5. Installerar den aktuella versionen av funktionerna och filerna i .wsp-filen. Det här steget lägger till och installerar lösningen på SharePoint-servern.

6. För arbetsflöden installerar du arbetsflödessammansättningen. Du kan ändra dess plats med hjälp av egenskapen Sammansättningsplats .

7. Aktiverar projektets funktion i SharePoint om omfånget är webbplats eller webb. Funktionerna i Servergrupp- och Webbapplikationsområdena är inte aktiverade.

8. För arbetsflöden associerar du arbetsflödet med SharePoint-biblioteket, listan eller webbplatsen som du valde i guiden Anpassning av SharePoint.

   Anmärkning

   Den här associationen sker bara om du har valt Associera arbetsflödet automatiskt i guiden.

9. Kör de anpassningsbara kommandona efter distributionen.

10. Kopplar Visual Studio-felsökningsprogrammet till Windows SharePoint Services-processen (w3wp.exe). Om projekttypen låter dig ändra egenskapen Sandboxed Solution och dess värde är inställt på true kopplas felsökningsprogrammet till en annan process (SPUCWorkerProcess.exe). Mer information finns i Överväganden för sandbox-lösning.

11. Startar JavaScript-felsökningsprogrammet om SharePoint-lösningen är en servergruppslösning.

12. Visar lämplig biblioteks-, list- eller webbplatssida i webbläsaren.

    Visual Studio visar ett statusmeddelande i utdatafönstret när varje uppgift har slutförts. Om en uppgift inte kan slutföras visar Visual Studio ett felmeddelande i fönstret Fellista.

SharePoint-projektfunktioner

En funktion är en bärbar och modulär funktionsenhet som förenklar ändringar av platser med hjälp av webbplatsdefinitioner. Det är också ett paket med WSS-element (Windows SharePoint Services) som kan aktiveras för ett visst omfång och som hjälper användarna att uppnå ett visst mål eller en viss uppgift. Mallar distribueras som funktioner.

När du kör ett projekt i felsökningsläge skapar distributionsprocessen en mapp i funktionskatalogen på%COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES. Funktionsnamn har formatet projektnamn_Featurex, till exempel TestProject_Feature1.

Lösningens mapp i funktionskatalogen innehåller en funktionsdefinitionsfil och en arbetsflödesdefinitionsfil . Funktionsdefinitionsfilen (Feature.xml) beskriver filerna i projektets funktion. Projektdefinitionsfilen (Elements.xml) beskriver projektmallen. Elements.xml finns i Solution Explorer, men Feature.xml genereras när lösningspaketet skapas. Mer information om dessa filer finns i SharePoint-projekt- och projektobjektmallar.

Felsöka arbetsflöden

När du felsöker arbetsflödesprojekt lägger Visual Studio till arbetsflödesmallen (beroende på typ) i ett bibliotek eller i en lista. Du kan sedan starta arbetsflödesmallen manuellt eller genom att lägga till eller uppdatera ett objekt. Du kan sedan använda Visual Studio för att felsöka arbetsflödet.

Distributionsprocessen startar dock inte arbetsflödet. Du måste starta arbetsflödet från SharePoint-webbplatsen. Du kan också starta arbetsflödet med hjälp av ett klientprogram som Microsoft Office Word 2010 eller med hjälp av separat kod på serversidan. Använd någon av de metoder som anges i guiden För anpassning av SharePoint.

Om du till exempel har angett att arbetsflödet kan startas manuellt startar du arbetsflödet direkt från objektet i biblioteket eller listan. Mer information om hur du startar ett arbetsflöde manuellt finns i Starta ett arbetsflöde manuellt för ett dokumentobjekt.

Felsöka funktionens händelsemottagare

När du kör ett Visual Studio SharePoint-program aktiveras som standard dess funktioner automatiskt åt dig på SharePoint-servern. Detta orsakar dock problem när du felsöker händelsemottagare för funktioner, eftersom när en funktion aktiveras av Visual Studio körs den i en annan process än felsökningsprogrammet. Det innebär att vissa felsökningsfunktioner, till exempel brytpunkter, inte fungerar korrekt.

Om du vill inaktivera automatisk aktivering av funktionen i SharePoint och tillåta korrekt felsökning av funktionshändelsemottagare anger du värdet för projektets active deployment configuration-egenskap till Ingen aktivering innan du felsöker. När du har börjat felsöka SharePoint-programmet i Visual Studio aktiverar du sedan funktionen manuellt i SharePoint. Om du vill aktivera funktionen öppnar du menyn Webbplatsåtgärder i SharePoint, väljer Webbplatsinställningar, väljer länken Hantera webbplatsfunktioner och väljer sedan knappen Aktivera bredvid funktionen för att fortsätta felsökningen som vanligt.

Aktivera förbättrad felsökningsinformation

På grund av de ibland komplexa interaktionerna mellan Visual Studio-processen (devenv.exe), Visual Studio SharePoint-värdprocessen (vssphost4.exe), SharePoint och WCF-lagret kan det vara en utmaning att diagnostisera fel som uppstår när du skapar, distribuerar och så vidare. För att hjälpa dig att lösa sådana fel kan du aktivera förbättrad felsökningsinformation. Det gör du genom att gå till följande registernyckel i Windows-registret:

HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools

Om värdet "EnableDiagnostics" REG_DWORD inte redan finns skapar du det manuellt. Ange värdet "EnableDiagnostics" till "1".

Om du anger det här nyckelvärdet till 1 visas stackspårningsinformation i utdatafönstret när projektsystemfel inträffar när du kör i Visual Studio. Om du vill inaktivera förbättrad felsökningsinformation anger du EnableDiagnostics tillbaka till 0 eller tar bort värdet.

Mer information om andra SharePoint-registernycklar finns i Felsöka tillägg för SharePoint-verktygen i Visual Studio.

Relaterat innehåll

• Felsöka SharePoint-lösningar