Rozwiązywanie problemów z rozwiązaniami SharePoint
Następujące problemy lub ostrzeżenia mogą wystąpić podczas debugowania rozwiązań programu SharePoint przy użyciu debugera Visual Studio.Aby uzyskać więcej informacji, zobacz Debugging SharePoint Workflow Solutions.
Ten temat zawiera następujące sekcje.
- Ograniczenia tokenu w składnikach Visual Web Parts w trybie Sandbox
- Ograniczenia znakowe w nazwach projektów i elementach projektu
- Błędy podczas tworzenia pól niestandardowych
- Nowe definicje witryn innych niż angielskie nie pojawiają się na stronie tworzenia witryn po wdrożeniu
- Błędy pojawiają się, kiedy projekt przepływu pracy jest wdrażany do wyczyszczonego systemu
- Użytkownik musi odświeżyć stronę aplikacji w przeglądarce podczas debugowania, aby zobaczyć zaktualizowany obraz.
- Błąd: Lokalizacja witryny jest nieprawidłowa.
- Zdarzenie sieci web usuwające witrynę, nie występuje w projekcie odbiornika zdarzeń
- Błąd podczas wdrażania, pojawiający się po zmianie nazwy identyfikatora w projekcie Modelu Usług Łączności Danych Biznesowych.
- Błąd pojawia się podczas próby wyświetlenia wizualnego składnika Web Part w programie SharePoint.
- Błędy pojawiające się podczas uruchamiania importowanego przepływu pracy wielokrotnego użytku, który zawiera pole formularza zadania.
- Błędy pojawiające się podczas uruchamiana importowanego wystąpienia listy ze zmienioną nazwą.
- Sesja debugowania programu SharePoint przerwana przez usługę IIS
- Automatyczne wycofywanie oddzielonych wystąpień list w programie SharePoint
- Oryginalne rozwiązanie programu SharePoint jest zastąpione przez wersję wyeksportowaną
- Błąd pojawia się podczas rozpoczynania debugowania.
- Tematy pokrewne
Ograniczenia tokenu w składnikach Visual Web Parts w trybie Sandbox
Wizualne części sieci Web w rozwiązaniu w piaskownicy nie przetwarzają standardowych tokenów, takich jak $SPUrl, które środowisko uruchomieniowe programu SharePoint obsługuje.W rezultacie, adres URL nie zostanie rozwiązany, i nie będzie możliwości przeglądania zawartości widoku projektu w projektancie wizualnych części sieci Web, jeżeli odnoszą się do niego bezpośrednio z elementu skryptu, tak jak w poniższym przykładzie:
<script src=”<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>
Aby ominąć to ograniczenie i rozpoznać token, należy odwołać się do niego przy użyciu literałów:
<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>" />
Ograniczenia znakowe w nazwach projektów i elementach projektu
Nazwy projektów i elementów projektu mogą zawierać tylko znaki, które są prawidłowe w ścieżce wdrożeniowej programu SharePoint 2010.Inne znaki nie są dozwolone.
Komunikat o błędzie
Komunikat o błędzie "Nieprawidłowe znaki"
Rozwiązanie
Dla nazw projektów i elementów projektu programu SharePoint, należy używać tylko następujących znaków:
Alfanumerycznych znaków ASCII
Odstęp
Kropka (.)
Przecinek (,)
Podkreślenie (_)
Kreska (-)
Kreska ułamkowa odwrócona (\)
Kiedy projekt jest pakowany, reguła poprawności weryfikuje, czy właściwość ścieżki dopasowania dla każdego wdrażanego pliku, zawiera tylko prawidłowe znaki.
Błędy podczas tworzenia pól niestandardowych
W Visual Studio, pola niestandardowe są definiowane w XML.Jeżeli pole nie jest zdefiniowane lub odwołuje się używając określonego formatu, mogą wystąpić błędy.
Komunikat o błędzie
Komunikat o błędzie w czasie pakowania "Nieprawidłowe znaki"
Rozwiązanie
Identyfikator dla definicji pola musi być identyfikatorem GUID ujętym w nawiasy klamrowe, jak pokazuje poniższy przykład:
<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
Type="Note"
Name="PatientName"
DisplayName="Patient Name"
Group="A Custom Group">
</Field>.
Jak pokazano na poniższym przykładzie, przy użyciu formatu pustego elementu należy zdefiniować odwołanie do pola w typie zawartości (<FieldRef />), nie używając rozpoczęcia i zakończenia elementów (<FieldRef></FieldRef>):
<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
Name="PatientName"
DisplayName="Patient Name"
Required="TRUE"/>
Jeżeli źródło XML dla pola ma nieprawidłową postać lub nie jest prawidłowym plikiem XML lub wykazuje inny problem, wystąpi błąd "Nie można przeanalizować pliku".
Nowe definicje witryn innych niż angielskie nie pojawiają się na stronie tworzenia witryn po wdrożeniu
Po utworzeniu i wdrożeniu definicji witryny przy użyciu wersji Visual Studio innej niż angielska (wersja z ustawieniami regionalnymi Identyfikator inna niż 1033), karta Dostosowywanie programu SharePoint nie będzie widoczna w karcie Wybieranie szablonu i nowy szablon strony nie pojawi się na stronie Nowa witryna programu SharePoint.
Komunikat o błędzie
Brak.
Rozwiązanie
Problem ten występuje z powodu niepoprawnej wartości właściwości Ścieżka dla pliku konfiguracji definicji witryny webtemp, na przykład takiej jak webtemp_SiteDefinitionProject1.xml.Właściwość Ścieżka dla pliku webtemp, znajdującego się w Lokalizacji wdrożenia, zmienia 1033 do odpowiednich ustawień lokalnych Identyfikator.Na przykład aby użyć Japońskich ustawień regionalnych zmień wartość na 1041.Aby uzyskać więcej informacji, zobacz Locale ID przypisana przez firmę Microsoft w witrynie MSDN w sieci Web.
Błędy pojawiają się, kiedy projekt przepływu pracy jest wdrażany do wyczyszczonego systemu
Problem ten pojawi się podczas wdrażania projektu przepływu pracy w Visual Studio w czystym systemie.Czystym systemem nazywamy program komputerowy po pierwszej instalacji Visual Studio i programu SharePoint ale bez wdrożonych projektów przepływu pracy.
Komunikat o błędzie
Nie można odnaleźć listy programu SharePoint: Historia przepływu pracy.
Rozwiązanie
Błąd ten wystąpił z powodu brakującej listy Historii przepływu pracy.Ponieważ środowisko deweloperskie jest czystym systemem, nie istnieją jeszcze wdrożone przepływy pracy i lista Historii przepływu pracy nie istnieje.Aby rozwiązać ten problem, otwórz ponownie kreatora przepływu pracy, który powoduje utworzenie listy Historia przepływu pracy.
Aby ponownie otworzyć kreatora przepływu pracy
W Eksploratorze rozwiązań, wybierz węzeł przepływu pracy.
W oknie Właściwości, wybierz przycisk wielokropka (...) przy dowolnej właściwości, która go posiada.
Użytkownik musi odświeżyć stronę aplikacji w przeglądarce podczas debugowania, aby zobaczyć zaktualizowany obraz.
Jeżeli debugowane jest rozwiązanie programu SharePoint, które zawiera stronę aplikacji z kontrolką wyświetlającą obraz, taki jak obraz kontrolki HTML, należy odświeżyć witrynę w przeglądarce, aby wyświetlić zmiany wprowadzone do obrazu.
Błąd: Lokalizacja witryny jest nieprawidłowa.
Problem ten może wystąpić jeżeli SharePoint Server 2010 nie jest zainstalowany.Może również wystąpić jeżeli użytkownik nie posiada uprawnień dostępu administratora do witryny sieci web programu SharePoint, która jest określona w Kreatorze dostosowywania programu SharePoint.
Komunikat o błędzie
- Lokalizacja witryny programu SharePoint jest nieprawidłowa.
Rozwiązanie
Zainstaluj SharePoint Server 2010.
Należy upewnić się że posiadamy dostęp administratora do witryny sieci Web programu SharePoint.Aby uzyskać więcej informacji, zobacz Office Online artykułu Udziel dostępu do witryny portalu.
Zdarzenie sieci web usuwające witrynę, nie występuje w projekcie odbiornika zdarzeń
Kiedy tworzony jest projekt odbiornika zdarzeń i wybrane zostaną niektóre zdarzenia sieci web takie jak "witryna jest usuwana", zdarzenie nigdy nie wystąpi.
Komunikat o błędzie
Brak.
Rozwiązanie
Problem ten występuje ponieważ zakresem funkcji musi być "Witryna" aby obsługiwać zdarzenia z poziomu witryny, jednak domyślnym zakresem funkcji dla projektów odbioru zdarzeń jest "sieć Web".Zdarzenia dotyczące sieci Web:
Witryna jest usuwana (WebDeleting)
Witryna została usunięta (WebDeleted)
Witryna jest przenoszona (WebMoving)
Witryna została przeniesiona (WebMoved)
Aby naprawić ten problem, należy zmienić zakres funkcji odbiornika zdarzeń, w następujący sposób.
Aby zmienić zakres funkcji odbiornika zdarzeń.
W Eksploratorze rozwiązań, otwórz plik .feature odbiornika zdarzeń w Projektancie funkcji przez dwukrotne kliknięcie na plik lub otwierając menu skrótów i wybierając Otwórz.
Wybierz strzałkę obok Zakres, a następnie wybierz Witryna na liście, która się pojawi.
Błąd podczas wdrażania, pojawiający się po zmianie nazwy identyfikatora w projekcie Modelu Usług Łączności Danych Biznesowych.
Problem ten pojawi się jeżeli zostanie zmieniona nazwa identyfikatora obiektu Modelu Łączności Danych Biznesowych (BDC) i nastąpi próba wdrożenia rozwiązania.
Komunikaty o błędach
<model name>wystąpiły następujące błędy aktywacji typu zawartości zewnętrznej...
IMetadataObject o nazwie "<model name>" ma wartość w polu "Nazwa" zduplikowanych...
Rozwiązanie
Aby rozwiązać ten problem, należy ręcznie usunąć model i wdrożyć rozwiązanie ponownie. Można usunąć model przy użyciu jednego z następujących narzędzi:
Administracja centralna programu SharePoint 2010.Aby uzyskać więcej informacji, zobacz Zarządzania modelu usługi BDC w witrynie Microsoft TechNet Web.
Windows PowerShell.Można usunąć model, wpisując w wierszu polecenia komendę: Remove-SPBusinessDataCatalogModel.Aby uzyskać więcej informacji, zobacz Ogólne polecenia cmdlet (SharePoint Server 2010) w witrynie Microsoft TechNet Web.
Błąd pojawia się podczas próby wyświetlenia wizualnego składnika Web Part w programie SharePoint.
Problem ten występuje kiedy właściwość kontrolki użytkownika Ścieżka nie zaczyna się od ciągu "CONTROLTEMPLATES\".
Komunikaty o błędach
Plik "/_CONTROLTEMPLATES/<project name>/<Web Part name>/<user control name>.ascx' nie istnieje.
Błąd serwera w aplikacji '/'.
Rozwiązanie
Aby rozwiązać ten problem
W Eksploratorze rozwiązań, wybierz plik kontrolki użytkownika, którego rozszerzeniem nazwy pliku jest .ascx.
Na pasku menu wybierz Widok, Okno właściwości.
W oknie Właściwości rozwiń węzeł Lokalizacja Wdrożenia.
Upewnij się ze wartość właściwości Ścieżka zaczyna się od ciągu "CONTROLTEMPLATES\".
Błędy pojawiające się podczas uruchamiania importowanego przepływu pracy wielokrotnego użytku, który zawiera pole formularza zadania.
Błąd ten występuje, jeśli importowany jest przepływ pracy zawierający formularz zadania, który ma pole, a następnie uruchomiony jest nowy przepływ pracy w tym samym systemie, z którego został zaimportowany.
Komunikat o błędzie
Wystąpił błąd podczas etapu wdrażania "Uaktywnić funkcje": pole o identyfikatorze [Guid] zdefiniowane w funkcji [Guid] zostało znalezione w bieżącym zbiorze witryn lub w podwitrynie.
Rozwiązanie
Ten błąd jest wynikiem kolizji identyfikatorów pól, które występują ponieważ importowane projekty przepływu pracy wielokrotnego użytku w Visual Studio nie zmieniają identyfikatora pola formularza zadania.W przypadku wdrażania importowanych przepływów pracy na tym samym serwerze, który zawiera oryginalny przepływ pracy, występują kolizje identyfikatorów pól.
Aby rozwiązać ten problem, użyj funkcji Znajdź i Zamień aby zmienić wartość atrybutu identyfikatora pola we wszystkich plikach z importowanymi przepływami pracy.
Błędy pojawiające się podczas uruchamiana importowanego wystąpienia listy ze zmienioną nazwą.
Ten problem występuje podczas zmiany nazwy wystąpienia importowanej listy, a następnie uruchomienia w Visual Studio.
Komunikat o błędzie
Błąd kompilacji: Wystąpił błąd podczas etapu wdrażania "Uaktywnić funkcje": plik Template\Features\[import projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml nie istnieje.
Rozwiązanie
Po zaimportowaniu wystąpień list, atrybut o nazwie CustomSchema jest dodawany do pliku Elements.xml wystąpienia listy.Elements.XML zawiera ścieżkę niestandardową schema.xml dla wystąpienia listy.Podczas zmiany nazwy wystąpienia listy w Visual Studio, ścieżka wdrożeniowa dla niestandardowych plików schema.xml zmienia się, ale wartość ścieżki atrybutu CustomSchema nie jest aktualizowana.W rezultacie wystąpienie listy nie może odnaleźć pliku schema.xml w starej ścieżce, która jest określona przez atrybut CustomSchema, gdy funkcja jest aktywna.
Aby rozwiązać ten problem, należy zaktualizować ścieżkę lokalizacji wdrożenia pliku schema.xml w atrybucie CustomSchema.
Sesja debugowania programu SharePoint przerwana przez usługę IIS
Ten problem występuje, jeśli ustawisz punkt przerwania w rozwiązaniu Visual Studio programu SharePoint, wybierzesz klawisz F5, aby uruchomić rozwiązanie, a następnie pozostaniesz w punkcie przerwania dłużej niż 90 sekund.
Komunikat o błędzie
Proces serwera sieci Web, który był debugowany, został przerwany przez Internetowe usługi informacyjne (IIS).Można uniknąć tego problemu, konfigurując ustawienia pingu puli aplikacji w usłudze IIS.Zobacz Pomoc, aby uzyskać więcej szczegółów.
Rozwiązanie
Domyślnie pula aplikacji usług IIS oczekuje 90 sekund na odpowiedz aplikacji przed jej zamknięciem aplikacji.Proces ten jest znany jako "pingowanie" aplikacji.Aby rozwiązać ten problem, możesz zwiększyć czas oczekiwania lub całkowicie wyłączyć pingowanie aplikacji.
Aby uzyskać dostęp do ustawień puli aplikacji usług IIS
Otwórz Menedżera usług IIS.
W okienku Połączenia, rozwiń węzeł SharePoint Server, a następnie wybierz węzeł Pule aplikacji.
Na stronie Pule aplikacji, wybierz Pule aplikacji programu SharePoint (zazwyczaj "SharePoint - 80"), a następnie w okienku Akcje, wybierz łącze Ustawienia zaawansowane.
Aby zwiększyć czas oczekiwania przed upływem limitu czasu usług IIS, należy zmienić wartość Maksymalny czas odpowiedzi polecenia ping (sekundy) na większą niż 90 sekund.
Aby wyłączyć pingowanie usług IIS, należy ustawić Pingowanie włączone na Fałsz.
Automatyczne wycofywanie oddzielonych wystąpień list w programie SharePoint
Ten problem występuje po wykonaniu następujących kroków.
Utwórz listę definicji, która ma wystąpienie listy w Visual Studio.
Wybierz klawisz F5 , aby uruchomić rozwiązanie.
Zatrzymaj debugowanie lub zamknij witrynę programu SharePoint.
Ponownie otwórz witrynę programu SharePoint i otwórz wystąpienie listy.
Komunikat o błędzie
Błąd serwera w aplikacji '/'.
Rozwiązanie
Dzieje się tak, ponieważ po zamknięciu sesji debugowania rozwiązania programu SharePoint, funkcja automatycznego wycofywania wycofuje rozwiązanie.Wycofywanie rozwiązania powoduje usunięcie definicji listy z programu SharePoint, ale nie powoduje usunięcia wystąpienia listy.Bazowa definicja listy jest wymagana przez wystąpienie listy.
Aby rozwiązać ten problem, należy wdrożyć rozwiązanie wybierając na pasku menu Kompilacja, Wdrażanie. (Nie należy debugować rozwiązania, wybierając klawisz F5.) Następnie można usunąć wystąpienie listy w programie SharePoint.
Oryginalne rozwiązanie programu SharePoint jest zastąpione przez wersję wyeksportowaną
Jeżeli nastąpiło wyeksportowane rozwiązania programu SharePoint, należy zaimportować rozwiązanie do Visual Studio, a następnie ponownie wdrożyć rozwiązanie do tej samej witryny, z której zostało wyeksportowane, oryginalne rozwiązanie programu SharePoint zostanie zamienione.Ten problem nie występuje, jeśli rozwiązanie zostanie wdrożone na serwerze, na którym nie zostało aktywowane oryginalne rozwiązanie.
Komunikat o błędzie
Brak.
Rozwiązanie
Aby uniknąć zastąpienia rozwiązania w witrynie, z którego została wyeksportowana, należy zmienić identyfikator GUID SolutionID i identyfikator funkcji dla wszystkich zaimportowanych funkcji w projekcie Visual Studio.
Błąd pojawia się podczas rozpoczynania debugowania.
Po rozpoczęciu debugowania rozwiązania programu SharePoint w Visual Studio, błąd wskazuje, że Visual Studio nie mógł załadować pliku Web.config, ponieważ dany klucz nie znajduje się w słowniku.
Komunikat o błędzie
Nie można załadować pliku konfiguracji Web.config.Sprawdź plik dla uszkodzonych elementów kodu XML i spróbuj ponownie.Wystąpił następujący błąd: Dany klucz nie był obecny w słowniku.
Rozwiązanie
Aby rozwiązać ten problem, upewnij się, że wartość właściwości adresu URL witryny projektu programu SharePoint w Visual Studio odpowiada adresowi URL, który jest przypisany do strefy domyślnej dla mapowania dostępu alternatywnego aplikacji sieci Web.Nie można rozwiązać błędu przy użyciu innej strefy, takiej jak Intranet, dla adresu URL.Adres ULR witryny projektu i adres URL w strefie domyślnej musza do siebie odpowiadać.Aby uzyskać dostęp do mapowania dostępu alternatywnego, otwórz narzędzie Administracja centralna programu SharePoint 2010, wybierz łącze Zarządzanie aplikacjami, a następnie w obszarze Aplikacje sieci Web, wybierz łącze Konfiguruj mapowania dostępu alternatywnego.Aby uzyskać więcej informacji, zobacz Tworzenie stref dla aplikacji sieci Web.
Zobacz też
Koncepcje
Rozwiązywanie problemów związanych z pakowaniem i wdrażaniem SharePoint