Rozwiązywanie problemów z pakowaniem i wdrażaniem programu SharePoint
W tym temacie opisano różne problemy, które mogą wystąpić podczas tworzenia pakietów i wdrażania rozwiązań programu SharePoint.
Włączanie rozszerzonego debugowania
Aby zdiagnozować między programem Visual Studio, programem SharePoint i innymi warstwami, możesz użyć klucza rejestru EnableDiagnostics, aby wyświetlić ślad stosu. Aby uzyskać więcej informacji, zobacz Debugowanie rozwiązań programu SharePoint.
Dodawanie danych wyjściowych projektu do pakietu rozwiązania
Dane wyjściowe projektu można dodać do pakietu za pomocą Projektant pakietu. Jednak podczas dodawania danych wyjściowych projektu upewnij się, że platforma projektu jest zgodna z platformą rozwiązania programu SharePoint. Zalecamy użycie elementu docelowego dowolnej platformy procesora CPU dla zestawów, które chcesz wdrożyć na serwerze programu SharePoint. Aby uzyskać więcej informacji, zobacz Kompilowanie strony, Projektant projektu (Visual Basic) i zaawansowanego kompilatora Ustawienia okno dialogowe (Visual Basic).
Ostrzeżenia i błędy walidacji
Narzędzia programistyczne programu SharePoint w programie Visual Studio wykonują kroki weryfikacji, aby sprawdzić, czy pakiet rozwiązania jest poprawnie sformułowany. Można również utworzyć niestandardowe kroki weryfikacji dla funkcji i pakietów. Aby uzyskać więcej informacji, zobacz How to: Create custom feature and package validation rules for SharePoint solutions (Instrukcje: tworzenie niestandardowych reguł weryfikacji funkcji i pakietów dla rozwiązań programu SharePoint).
Rozwiązywanie konfliktów wdrażania
Podczas wdrażania rozwiązania programu SharePoint mogą wystąpić kolizje, gdy element na serwerze ma taką samą nazwę, adres URL lub identyfikator jak element w pakiecie rozwiązania. Właściwość Rozwiązywanie konfliktów wdrażania można zmienić, aby rozwiązywać, zgłaszać lub ignorować kolizje dla modułów, składników Web Part, wystąpień listy i typów zawartości.
W poniższej tabeli przedstawiono ustawienia właściwości Rozwiązywanie konfliktów wdrożeń.
Wartość | Opis |
---|---|
Automatyczne | Wykrywa kolizje i automatycznie rozwiązuje konflikty. |
Monit | Wykrywa kolizje i zgłasza je deweloperowi przed rozwiązaniem konfliktów. |
Brak | Nie wykrywa kolizji. |
Różnice między wdrożeniem F5
Jeśli używasz programu Visual Studio do wdrażania projektu programu SharePoint na lokalnym serwerze sharePoint na potrzeby testowania i debugowania, istnieją dodatkowe kroki wykonywane przez program Visual Studio.
Zresetuj usługę Internet Information Service (IIS) podczas kroku wdrażania.
Automatyczne kojarzenie przepływów pracy.
Ustaw kolejność aktywacji funkcji zgodnie z hierarchią w Projektant pakietu.
Możesz dodać niestandardowe kroki wdrażania, aby jeszcze bardziej zmienić zachowanie F5 . Aby uzyskać więcej informacji, zobacz Przewodnik: tworzenie niestandardowego kroku wdrażania dla projektów programu SharePoint.
Opóźnienie wyświetlania strony programu SharePoint podczas wdrażania składnika Web Part wizualizacji
Wyświetlenie strony programu SharePoint w folderze Bin w systemie Windows Vista, Windows 7 lub Windows Server 2008 trwa długo. Jeśli zmienisz jakiekolwiek pliki w katalogu ASP.NET najwyższego poziomu, takim jak katalog Bin, cała aplikacja internetowa ponownie skompiluje. Może to spowodować opóźnienie do 25 sekund renderowania strony programu SharePoint.
Komunikat o błędzie
Brak.
Rozwiązanie
Aby obejść ten problem, wykonaj następujące kroki:
Zainstaluj KB967535 aktualizacji zgodnie z opisem w artykule pomoc techniczna firmy Microsoft FIX: Poprawka jest dostępna, aby rozwiązać dwa problemy w ASP.NET w usługach 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">
Wdrażanie projektu programu SharePoint kończy się niepowodzeniem z powodu błędu "Nie można wyodrębnić pliku cab w rozwiązaniu"
Jeśli nazwa dowolnego elementu projektu programu SharePoint zawiera nawiasy, jego rozwiązanie kończy się niepowodzeniem we wdrożeniu z błędem.
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, usuń wszelkie nawiasy w nazwach elementów projektu programu SharePoint.
Podczas wdrażania składnika Web Part wizualizacji w witrynie w innej aplikacji internetowej pojawia się błąd
Przy pierwszym wdrożeniu składnika Web Part wizualizacji w witrynie w aplikacji sieci Web innej niż ta, w której jest ona aktualnie wdrożona (zmieniając właściwość SiteUrl składnika Web Part wizualizacji), występuje błąd.
Komunikat o błędzie
Wystąpił błąd w kroku wdrażania "Dodawanie rozwiązania": funkcja o identyfikatorze [#] została już zainstalowana w tej farmie. Użyj atrybutu force, aby jawnie ponownie zainstalować funkcję.
Rozwiązanie
Ten błąd występuje z powodu sposobu, w jaki funkcje składnika Web Part wizualizacji są wycofane w programie SharePoint. Aby pomyślnie wdrożyć składnik Web Part wizualizacji, ponownie wdróż rozwiązanie, wybierając klucz F5 .
Ostrzeżenie jest wyświetlane podczas wdrażania zagnieżdżonych kontrolek użytkownika
To ostrzeżenie występuje podczas wdrażania rozwiązania programu SharePoint, które ma zagnieżdżone kontrolki użytkownika, takie jak wizualny składnik Web Part zawierający kontrolkę użytkownika lub kontrolkę użytkownika zawierającą wizualny składnik Web Part lub inną kontrolkę użytkownika. To ostrzeżenie występuje niezależnie od tego, czy dodasz kontrolkę do projektanta, przeciągając ją z przybornika, czy używając @Register dyrektywy w widoku źródłowym.
Komunikat o błędzie
Ostrzeżenie 1, element "[Nazwa kontrolki]" nie jest znanym elementem. Taka sytuacja może wystąpić, jeśli w witrynie sieci Web występuje błąd kompilacji lub brakuje pliku web.config.
Rozwiązanie
Jeśli system projektu programu Visual Studio nie zna zagnieżdżonej kontrolki użytkownika, nie może zapewnić funkcji IntelliSense i emituje ostrzeżenie. System projektu nie jest świadomy zagnieżdżonej kontrolki użytkownika, jeśli projekt nie został skompilowany, a projektant nie został zamknięty i ponownie otwarty lub jeśli opcja automatycznego wycofania jest włączona, co powoduje wycofanie kontrolki użytkownika z programu SharePoint hive po debugowaniu.
Aby usunąć to ostrzeżenie, skompiluj projekt, a następnie zamknij, a następnie otwórz ponownie projektanta lub wyłącz opcję automatycznego odejmowania dla projektu. Aby to zrobić, wyczyść pole wyboru Automatycznie wycofaj po debugowaniu na karcie SharePoint okna dialogowego właściwości projektu.