Rozwiązywanie problemów związanych z pakowaniem i wdrażaniem SharePoint
W tym temacie omówiono różne problemy, które mogą wystąpić podczas pakowania i wdrażania rozwiązań programu SharePoint.
Ten temat zawiera następujące sekcje.
- Włączanie ulepszonego debugowania
- Dodawanie wyjścia projektu do pakietu rozwiązań
- Walidacja ostrzeżeń i błędów
- Rozwiązywanie konfliktów wdrożenia
- Różnice między wdrożeniem F5
- Opóźnienie wyświetlania strony programu SharePoint podczas wdrażania wizualnego składnika Web Part
- Wdrożenie projektu programu SharePoint nie powiodło się z powodu błędu „Nie można wyodrębnić pliku cab w rozwiązaniu”
- Błąd pojawia się podczas wdrażania wizualnego składnika Web Part do witryny innej aplikacji sieci Web
- Podczas wdrażania zagnieżdżonych formantów użytkownika pojawia się ostrzeżenie
- Tematy pokrewne
Włączanie ulepszonego debugowania
Aby zdiagnozować między programem Visual Studio, SharePoint i innymi warstwami, możesz użyć klucza rejestru EnableDiagnostics do wyświetlania śladu stosu.Aby uzyskać więcej informacji, zobacz Debugowanie rozwiązań SharePoint.
Dodawanie wyjścia projektu do pakietu rozwiązań
Dane wyjściowe projektu można dodać do pakietu za pomocą Projektanta pakietu.Jednak podczas dodawania danych wyjściowych projektu upewnij się, że platforma projektu odpowiada platformie rozwiązania SharePoint.Firma Microsoft zaleca użycie Dowolnego procesora platformy docelowej dla zespołów, które mają zostać wdrożone na serwerze programu SharePoint.Aby uzyskać więcej informacji, zobacz Strona kompilowania, Projektant projektu (Visual Basic) i Zaawansowane ustawienia kompilatora (Visual Basic) — Okno dialogowe.
Walidacja ostrzeżeń i błędów
Narzędzia projektowania programu SharePoint w programie Visual Studio wykonują czynności sprawdzania poprawności, aby sprawdzić, czy pakiet rozwiązania jest poprawnie uformowany.Można również utworzyć niestandardowe kroki sprawdzania poprawności dla pakietów i funkcji.Aby uzyskać więcej informacji, zobacz Porady: tworzenie funkcji niestandardowej oraz zasady sprawdzania poprawności pakietu dla Rozwiązań SharePoint.
Rozwiązywanie konfliktów wdrożenia
Podczas wdrażania rozwiązania programu SharePoint może wystąpić kolizja, gdy element na serwerze ma tę samą nazwę, adres URL lub identyfikator co element z pakietu rozwiązania.Można zmienić właściwość Rozwiązywanie konfliktów wdrażania, aby rozwiązać, zaraportować lub zignorować kolizje dla modułów, składników Web Part, listy wystąpień i typów zawartości.
Poniższa tabela przedstawia ustawienia dla właściwości Rozwiązywanie konfliktów wdrażania.
Wartość |
Opis |
|---|---|
Automatycznie |
Wykrywa kolizje i automatycznie rozwiązuje konflikty. |
Monit |
Wykrywa kolizje i raportuje je do dewelopera przed rozwiązaniem konfliktów. |
Brak |
Nie wykrywa kolizji. |
Różnice między wdrożeniem F5
Gdy używasz Visual Studio do wdrożenia projektu programu SharePoint dla lokalnego serwera programu SharePoint do testowania i debugowania, istnieje kilka dodatkowych kroków, które są wykonywane przez Visual Studio.
Zresetuj internetowe usługi informacyjne (IIS) podczas wykonywania kroku wdrażania.
Automatycznie kojarzy przepływy pracy.
Ustaw kolejność aktywacji funkcji zgodnie z hierarchią w projektancie pakietu.
Można dodać kroki wdrażania niestandardowego w celu dalszej zmiany zachowania F5.Aby uzyskać więcej informacji, zobacz Wskazówki: Tworzenie niestandardowego kroku wdrożenia dla projektów SharePoint.
Opóźnienie wyświetlania strony programu SharePoint podczas wdrażania wizualnego składnika Web Part
Wyświetlenie strony programu SharePoint wymaga dużo czasu w przypadku wdrażania wizualnego składnika Web Part do folderu Bin na Windows Vista, Windows 7 lub Windows Server 2008.Jeśli zostaną zmienione pliki w katalogu najwyższego poziomu ASP.NET, na przykład w katalogu kosza, następuje rekompilacja całej aplikacji sieci Web.Może to spowodować opóźnienie maksymalnie 25 sekund dla strony programu SharePoint do renderowania.
Komunikat o błędzie
Brak.
Rozwiązanie
Aby obejść ten problem, wykonaj następujące czynności:
Zainstaluj aktualizację KB967535, jak wskazano w artykule Pomocy technicznej firmy Microsoft POPRAWKA: Dostępna jest poprawka, która rozwiązuje dwa problemy w programie ASP.NET przez usługi IIS 7.0 dla systemu Windows Vista i Windows Server 2008.
Dodaj następujący wiersz do pliku Web.config:
<compilation batch="false" optimizeCompilations="true">
Wdrożenie projektu programu SharePoint nie powiodło się z powodu błędu „Nie można wyodrębnić pliku cab w rozwiązaniu”
Jeśli nazwa dowolnego elementu projektu programu SharePoint zawiera nawiasy, wdrażanie jego rozwiązanie nie powiedzie się z powodu błędu.
Komunikat o błędzie
Wystąpił błąd w kroku wdrażania „Dodaj rozwiązanie”: Nie można wyodrębnić pliku cab w rozwiązaniu.
Rozwiązanie
Aby obejść ten problem, należy usunąć wszelkie nawiasy w nazwach elementów projektu programu SharePoint.
Błąd pojawia się podczas wdrażania wizualnego składnika Web Part do witryny innej aplikacji sieci Web
Przy pierwszym wdrażaniu wizualnego składnika Web Part w witrynie w aplikacji sieci Web innej niż ta, w której jest aktualnie wdrożony (przez zmianę właściwości SiteUrl wizualnego składnika Web Part), wystąpi błąd.
Komunikat o błędzie
Wystąpił błąd podczas kroku wdrażania „Dodaj rozwiązanie”: funkcja o identyfikatorze [#] była już zainstalowana w tej farmie.Użyj atrybutu force, aby jawnie ponownie zainstalować tę funkcję.
Rozwiązanie
Ten błąd występuje ze względu na sposób, w jaki funkcje składników Web Part są wycofywane w programie SharePoint.Aby pomyślnie wdrożyć wizualny składnik Web Part, należy ponownie wdrożyć rozwiązanie, wybierając klawisz F5.
Podczas wdrażania zagnieżdżonych formantów użytkownika pojawia się ostrzeżenie
Ostrzeżenie to pojawia się podczas wdrażania rozwiązania programu SharePoint, które ma zagnieżdżone formanty użytkownika, takie jak wizualny składnik Web Part, który zawiera formant użytkownika lub formant użytkownika, który zawiera składnik wizualny Web Part lub inny formant użytkownika.Ostrzeżenie to pojawia się niezależnie od tego, czy dodajesz formant do projektanta, przeciągając go z przybornika lub przy użyciu dyrektywy @Register w widoku źródła.
Komunikat o błędzie
Ostrzeżenie 1 Element '[Control Name]' nie jest znanym elementem.Może to występować, jeśli istnieje błąd kompilacji w witrynie sieci Web lub brakuje pliku web.config.
Rozwiązanie
Jeśli system projektu Visual Studio nie jest świadomy zagnieżdżonego formantu użytkownika, nie może dostarczyć Intellisense i emituje ostrzeżenie.System projektu nie rozpoznaje zagnieżdżonego formantu użytkownika, jeśli projekt nie jest zbudowany, a projektant nie jest zamknięty i ponownie otwarty lub jeśli jest włączona opcja automatycznego wycofywania, co powoduje, że formant użytkownika ma zostać wycofany z gałęzi programu SharePoint po zdebugowaniu.
Aby usunąć to ostrzeżenie, skompiluj projekt, a następnie zamknij i ponownie otwórz projektanta lub wyłącz automatyczne wycofanie opcji dla projektu.W tym celu należy wyczyścić pole wyboru Automatycznie wycofaj po debugowaniu na karcie SharePoint okna dialogowego właściwości projektu.