Dela via

Felsöka SharePoint-lösningar

Följande problem eller aviseringar kan uppstå när du felsöker SharePoint-lösningar med hjälp av Visual Studio-felsökningsprogrammet. Mer information finns i Felsökning av SharePoint 2007-arbetsflödeslösningar.

Tokenbegränsningar i sandboxade visuella webbdelar

Visuella webbdelar i lösningar i begränsat läge kan inte bearbeta standardtoken, till exempel $SPUrl, som SharePoint-körningen stöder. Det innebär att URL:en inte har lösts och du kan inte förhandsgranska innehållet i designvyn i den visuella webbdelsdesignern om du refererar till den direkt i ett skriptelement, till exempel i följande exempel:

<script src="<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>

Om du vill kringgå den här begränsningen och lösa token, hänvisa till den med hjälp av literaler.

<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>" />

Teckenbegränsningar i namn på projekt och projektobjekt

Namn på projekt och projektobjekt kan bara innehålla tecken som är giltiga i en distributionssökväg i SharePoint 2010. Inga andra tecken tillåts.

Felmeddelande

Felmeddelandet "Ogiltiga tecken".

Lösning / Beslut

För namn på SharePoint-projekt och projektobjekt använder du endast följande tecken:

  • Alfanumeriska ASCII-tecken

  • Rymd

  • Period (.)

  • Kommatecken (,)

  • Understreck (_)

  • Streck (-)

  • Omvänt snedstreck (\)

    När ett projekt paketeras verifierar en verifieringsregel att egenskapen deployment-path för varje fil som du distribuerar endast innehåller dessa giltiga tecken.

Fel vid skapande av anpassade fält

I Visual Studio definieras anpassade fält i XML. Fel kan inträffa om ett fält inte definieras eller refereras med ett visst format.

Felmeddelande

Felmeddelandet "Ogiltiga tecken" visas vid paketeringstillfället.

Lösning / Beslut

ID:t för en fältdefinition måste vara ett GUID omgivet av klammerparenteser, vilket visas i följande exempel:

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
    Type="Note"
    Name="PatientName"
    DisplayName="Patient Name"
    Group="A Custom Group">
</Field>.

Som följande exempel visar måste en fältreferens i en innehållstyp definieras med hjälp av det tomma elementformatet (<FieldRef />), inte genom att använda start-/slutelement (<FieldRef></FieldRef>):

<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
    Name="PatientName"
    DisplayName="Patient Name"
    Required="TRUE"/>

Om käll-XML:en för fältet är felaktigt formaterad, inte är en giltig XML-fil eller uppvisar något annat problem uppstår felet "Det går inte att parsa filen".

Nya icke-engelska webbplatsdefinitioner visas inte på sidan för att skapa webbplatser efter distributionen

När du har skapat och distribuerat en webbplatsdefinition med hjälp av en icke-engelsk version av Visual Studio (dvs. en version med ett annat språk-ID än 1033) visas inte fliken Anpassningar av SharePoint i rutan Mallval och den nya webbplatsmallen visas inte på sidan Ny SharePoint-webbplats .

Felmeddelande

Ingen.

Lösning / Beslut

Det här problemet uppstår på grund av ett felaktigt värde i egenskapen Sökväg för konfigurationsfilen för webbplatsdefinitionen för webtemp, till exempel webtemp_SiteDefinitionProject1.xml. I egenskapen Sökväg för webtemp-filen, som finns under distributionsplatsen, ändrar du 1033 till lämpligt språk-ID . Om du till exempel vill använda en japansk landsspecifik inställning ändrar du värdet till 1041. För mer information, se Språkvariant-ID tilldelade av Microsoft.

Felet visas när ett arbetsflödesprojekt distribueras i ett rent system

Det här problemet uppstår om du distribuerar ett arbetsflödesprojekt i Visual Studio i ett rent system. Ett rent system är en dator som har en ny installation av Visual Studio och SharePoint men inga distribuerade arbetsflödesprojekt.

Felmeddelande

Det går inte att hitta SharePoint-listan: Arbetsflödeshistorik.

Lösning / Beslut

Det här felet uppstår på grund av att en lista över arbetsflödeshistorik saknas. Eftersom utvecklingsmiljön är ett rent system distribueras inga arbetsflöden och listan Arbetsflödeshistorik finns inte ännu. Lös problemet genom att öppna arbetsflödesguiden igen, vilket gör att listan arbetsflödeshistorik skapas.

För att återgå till arbetsflödesassistenten

  1. I Solution Explorer väljer du arbetsflödesnoden.

  2. I fönstret Egenskaper väljer du knappen ellips (...) på alla egenskaper som har en ellipsknapp.

Användaren måste uppdatera programsidan i webbläsaren vid felsökning för att visa uppdaterad bild

Om du felsöker en SharePoint-lösning som innehåller en programsida med en kontroll som visar en bild, till exempel en HTML-bildkontroll, måste du uppdatera sidan i webbläsaren för att visa eventuella ändringar som gjorts i bilden.

Fel: Platsens plats är inte giltig

Det här problemet kan inträffa om SharePoint Server inte är installerat. Det kan också inträffa om du inte har administratörsåtkomst till SharePoint-webbplatsen som anges i guiden För anpassning av SharePoint.

Felmeddelande

  • Platsen för SharePoint-webbplatsen är inte giltig.

Lösning / Beslut

Webbhändelse för borttagning av webbplats inträffar inte i händelsemottagarprojekt.

När du skapar ett händelsemottagareprojekt och väljer vissa webbhändelser, till exempel "en webbplats tas bort", inträffar händelsen aldrig.

Felmeddelande

Ingen.

Lösning / Beslut

Det här problemet beror på att funktionsomfånget måste vara "Webbplats" för att hantera händelser på platsnivå, men standardfunktionsomfånget för händelsemottagareprojekt är "Web". De webbhändelser som påverkas är:

  • En webbplats tas bort (WebDeleting)

  • En webbplats har tagits bort (WebDeleted)

  • En webbplats flyttas (WebMoving)

  • En webbplats har flyttats (WebMoved)

    Åtgärda problemet genom att ändra händelsemottagarens funktionsomfång enligt följande.

Så här ändrar du händelsemottagarens funktionsomfång

  1. Öppna händelsemottagarens .funktionsfil i Funktionsdesignern i Solution Explorer genom att antingen dubbelklicka på filen eller öppna snabbmenyn och sedan välja Öppna.

  2. Välj pilen bredvid Omfång och välj sedan Webbplats i listan som visas.

Distributionsfel visas när namnet på en identifierare i ett affärsdataanslutningsmodellprojekt har ändrats

Det här problemet uppstår om du ändrar identifierarnamnet för en entitet i en BDC-modell (Business Data Connectivity) och sedan försöker distribuera lösningen.

Felmeddelanden

  • < modellnamn> har följande aktiveringsfel för extern innehållstyp ...

  • IMetadataObject med namnet "<modellnamn>" har ett värde i fältet "namn" som dupliceras ...

Lösning / Beslut

Lös problemet genom att ta bort modellen manuellt och sedan distribuera lösningen igen. Du kan ta bort modellen med något av följande verktyg:

  • Central administration för SharePoint 2010. Mer information finns i BDC Model Management på Microsoft TechNet-webbplatsen.

  • Windows PowerShell. Du kan ta bort modellen genom att skriva det här kommandot i kommandotolken: Remove-SPBusinessDataCatalogModel. Mer information finns i Allmänna cmdletar (SharePoint Server 2010) på Microsoft TechNet-webbplatsen.

Distributionsfel uppstod vid försök att återanvända IIS-programpoolen på SharePoint-servern

Det här problemet uppstår om IIS 6 WMI-kompatibilitetsfunktionen och .NET Framework 3.5 inte är installerade på SharePoint Server-datorn.

Felmeddelanden

  • Ett fel uppstod i distributionssteget ”Återvinning av IIS-applikationspoolen”: Ogiltigt namnområde
  • Ett fel uppstod i distributionssteget "Återställ IIS-programpool": En uppgift avbröts.

Lösning / Beslut

Lös problemet genom att på SharePoint Server-datorn kontrollera om Windows-funktionen IIS 6 WMI-kompatibilitet är installerad.

  • Windows PowerShell. Du kan kontrollera om funktionen är installerad genom att köra det här PowerShell-kommandot: get-windowsfeature -name Web-WMI. Om det inte visas som Installerat kan du installera det genom att köra följande PowerShell-kommando: install-windowsfeature -name Web-WMI. Om du fortfarande upptäcker fel när du försöker återstarta appliktionspoolen kontrollerar du att .NET Framework 3.5 också är installerat på datorn genom att köra get-windowsfeature -name NET-Framework-Core och install-windowsfeature -name NET-Framework-Core om det inte är installerat.

Ett fel visas när du försöker visa en visuell webbdel i SharePoint

Det här problemet uppstår när egenskapen sökväg för användarkontrollen inte inleds med strängen "CONTROLTEMPLATES\".

Felmeddelanden

  • Filen '/_CONTROLTEMPLATES/<project name>/<Web Part name>/<user control name.ascx>' finns inte.

  • Serverfel i "/"-programmet.

Lösning / Beslut

Så här löser du problemet

  1. I Solution Explorer väljer du användarkontrollfilen, vars filnamnstillägg är .ascx.

  2. På menyraden väljer du Visa egenskapsfönster>.

  3. I fönstret Egenskaper expanderar du noden Distributionsplats .

  4. Kontrollera att värdet för egenskapen Path börjar med strängen "CONTROLTEMPLATES\".

Felet visas när ett importerat återanvändbart arbetsflöde som innehåller ett aktivitetsformulärfält körs

Det här problemet uppstår om du importerar ett arbetsflöde som innehåller ett uppgiftsformulär som har ett fält och sedan kör det nya arbetsflödet i samma system som du importerade det från.

Felmeddelande

Ett fel uppstod i distributionssteget "Aktivera funktioner": Fältet med ID [Guid] som definierats i funktionen [Guid] hittades i den aktuella webbplatssamlingen eller på en underwebbplats.

Lösning / Beslut

Det här felet är resultatet av fält-ID-kollisioner som inträffar eftersom projektet Importera återanvändbart arbetsflöde i Visual Studio inte ändrar fält-ID:n för aktivitetsformulär. Om du distribuerar ett importerat arbetsflöde på samma server som innehåller det ursprungliga arbetsflödet uppstår fält-ID-kollisioner.

Lös problemet genom att använda funktionen Sök och ersätt för att ändra värdet för attributet Fält-ID i alla importerade arbetsflödesfiler.

Felet visas när en importerad listinstans som har bytt namn körs

Det här problemet uppstår om du byter namn på en importerad listinstans och sedan kör den i Visual Studio.

Felmeddelande

Build-fel: Det uppstod ett fel i distributionssteget "Aktivera funktioner": Filen Template\Features\[import projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml finns inte.

Lösning / Beslut

När du importerar en listinstans läggs ett attribut med namnet CustomSchema till i Elements.xml fil i listinstansen. Elements.xml innehåller sökvägen till en anpassad schema.xml för listinstansen. När du byter namn på listinstansen i Visual Studio ändras distributionssökvägen för den anpassade schema.xml, men sökvägsvärdet för attributet CustomSchema uppdateras inte. Som ett resultat kan listinstansen inte hitta schema.xml-filen i den gamla sökvägen som specificeras av attributet CustomSchema när funktionen aktiveras.

Lös problemet genom att uppdatera sökvägen till distributionsplatsen för schema.xml-filen i attributet CustomSchema.

SharePoint-felsökningssession avslutad av IIS

Det här problemet uppstår om du anger en brytpunkt i en Visual Studio SharePoint-lösning, väljer F5-nyckeln för att köra den och sedan förblir vid en brytpunkt längre än 90 sekunder.

Felmeddelande

Webbserverprocessen som debuggades har avslutats av IIS (Internet Information Services). Du kan undvika det här problemet genom att konfigurera pinginställningar för programpooler i IIS. Mer information finns i hjälpen.

Lösning / Beslut

Som standard väntar IIS-programpoolen 90 sekunder på att ett program ska svara innan programmet stängs. Den här processen kallas att "pinga" applikationen. För att lösa det här problemet kan du antingen öka väntetiden eller inaktivera program pingning helt.

Så här kommer du åt inställningarna för IIS-apppoolen

  1. Öppna IIS Manager.

  2. I fönstret Anslutningar expanderar du SharePoint-servernoden och väljer sedan noden Programpooler .

  3. På sidan Programpooler väljer du SharePoint-programpoolen (vanligtvis "SharePoint - 80") och väljer sedan länken Avancerade inställningar i fönstret Åtgärder.

  4. Om du vill öka väntetiden före IIS-tidsgränsen ändrar du värdet för Pinga maximal svarstid (sekunder) till ett värde som är större än 90 sekunder.

  5. Om du vill inaktivera IIS-pingning anger du Ping aktiverad till Falskt.

Automatisk indragning lämnar överblivna listinstanser i SharePoint

Det här problemet uppstår om du utför följande steg.

  1. Skapa en listdefinition som har en listinstans i Visual Studio.

  2. Välj F5-nyckeln för att köra lösningen.

  3. Sluta felsöka eller stäng SharePoint-webbplatsen.

  4. Öppna SharePoint-webbplatsen igen och öppna listinstansen.

Felmeddelande

Serverfel i "/"-programmet.

Lösning / Beslut

Detta beror på att när du har stängt en felsökningssession för en SharePoint-lösning återkallas lösningen automatiskt. Återtagandet tar bort listdefinitionen från SharePoint men tar inte bort instansen av listan. Den underliggande listdefinitionen krävs av listinstansen.

Lös problemet genom att distribuera lösningen genom att välja Skapa>distribuera på menyraden. (Felsök inte lösningen genom att välja F5-nyckeln .) Ta sedan bort listinstansen i SharePoint.

Den ursprungliga SharePoint-lösningen ersätts av en exporterad version

Om du exporterar en SharePoint-lösning importerar du lösningen till Visual Studio och distribuerar lösningen tillbaka till samma plats som den exporterades från, ersätts den ursprungliga SharePoint-lösningen. Det här problemet uppstår inte om du distribuerar lösningen till en server som inte har den ursprungliga lösningen aktiverad på den.

Felmeddelande

Ingen.

Lösning / Beslut

Om du vill undvika att skriva över en lösning på den plats som den exporterades från ändrar du GUID:erna för SolutionID och funktions-ID:t för alla importerade funktioner i Visual Studio-projektet.

Felet visas när felsökningen startar

När du börjar felsöka en SharePoint-lösning i Visual Studio indikerar ett fel att Visual Studio inte kunde läsa in Web.config-filen eftersom den angivna nyckeln inte fanns i ordlistan.

Felmeddelande

Det gick inte att läsa in konfigurationsfilen för Web.config. Kontrollera om det finns felaktiga XML-element i filen och försök igen. Följande fel uppstod: Den angivna nyckeln fanns inte i ordlistan.

Lösning / Beslut

Lös problemet genom att kontrollera att egenskapsvärdet för webbplats-URL för SharePoint-projektet i Visual Studio matchar url:en som har tilldelats standardzonen för de alternativa åtkomstmappningarna för webbprogrammet. Du kan inte lösa felet med hjälp av en annan zon, till exempel intranät, för URL:en. Webbplats-URL:en för projektet och URL:en i standardzonen måste matcha. Om du vill komma åt alternativa åtkomstmappningar öppnar du verktyget Central administration i SharePoint 2010, väljer länken Programhantering och väljer sedan länken Konfigurera alternativa åtkomstmappningar under Webbprogram. Mer information finns i Skapa zoner för webbprogram.

Relaterat innehåll