Udostępnij za pośrednictwem

Rozwiązywanie problemów z rozwiązaniami programu SharePoint

  • Artykuł

Następujące problemy lub alerty mogą wystąpić podczas debugowania rozwiązań programu SharePoint przy użyciu debugera programu Visual Studio. Aby uzyskać więcej informacji, zobacz Debugowanie rozwiązań przepływu pracy programu SharePoint 2007.

Ograniczenia tokenów w składnikach Web Part wizualizacji w trybie piaskownicy

Składniki Web Part wizualizacji w rozwiązaniach w trybie piaskownicy nie mogą przetwarzać standardowych tokenów, takich jak $SPUrl, które obsługuje środowisko uruchomieniowe programu SharePoint. W związku z tym adres URL nie jest rozpoznawany i nie można wyświetlić podglądu zawartości w widoku projektu w projektancie składników Web Part wizualizacji, jeśli odwołujesz się do niego bezpośrednio w elemecie skryptu, na przykład w poniższym przykładzie:

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

Aby obejść to ograniczenie i rozwiązać ten problem, zapoznaj się z nim 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 znaków w nazwach projektów i elementów projektu

Nazwy projektów i elementów projektu mogą zawierać tylko znaki, które są prawidłowe w ścieżce wdrożenia w programie SharePoint 2010. Żadne inne znaki nie są dozwolone.

Komunikat o błędzie

Komunikat o błędzie "Nieprawidłowe znaki".

Rozwiązanie

W przypadku nazw projektów programu SharePoint i elementów projektu użyj tylko następujących znaków:

  • Znaki alfanumeryczne ASCII

  • Space

  • Kropka (.)

  • Przecinek (,)

  • Podkreślenie (_)

  • Kreska (-)

  • Ukośnik odwrotny (\)

    Gdy projekt jest spakowany, reguła sprawdzania poprawności sprawdza, czy właściwość ścieżki wdrożenia dla każdego wdrażanego pliku zawiera tylko te prawidłowe znaki.

Błędy podczas tworzenia pól niestandardowych

W programie Visual Studio pola niestandardowe są definiowane w formacie XML. Błędy mogą wystąpić, jeśli pole nie jest zdefiniowane lub przywołyne przy użyciu określonego formatu.

Komunikat o błędzie

Komunikat o błędzie "Nieprawidłowe znaki" w czasie pakowania.

Rozwiązanie

Identyfikator definicji pola musi być identyfikatorem GUID otoczonym nawiasami klamrowymi, jak pokazano w poniższym przykładzie:

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

Jak pokazano w poniższym przykładzie, odwołanie do pola w typie zawartości musi być zdefiniowane przy użyciu pustego formatu elementu (FieldRef /), a nie przy użyciu elementów początkowych/końcowych (<<FieldRef></FieldRef>):>

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

Jeśli źródłowy kod XML pola jest źle sformułowany, nie jest prawidłowym plikiem XML lub występuje inny problem, występuje błąd "Nie można przeanalizować pliku".

Nowe definicje witryn innych niż angielski nie są wyświetlane na stronie tworzenia witryny po wdrożeniu

Po utworzeniu i wdrożeniu definicji witryny przy użyciu innej niż angielska wersja programu Visual Studio (tj. wersja z identyfikatorem ustawień regionalnych innych niż 1033) karta Dostosowania programu SharePoint nie jest wyświetlana w polu Wybór szablonu, a nowy szablon witryny nie jest wyświetlany na stronie Nowa witryna programu SharePoint .

Komunikat o błędzie

Brak.

Rozwiązanie

Ten problem występuje z powodu nieprawidłowej wartości we właściwości Path dla pliku konfiguracji definicji witryny webtemp, takiego jak webtemp_SiteDefinitionProject1.xml. We właściwości Path dla pliku webtemp znajdującego się w obszarze Lokalizacja wdrożenia zmień wartość 1033 na odpowiedni identyfikator ustawień regionalnych . Na przykład aby użyć japońskich ustawień regionalnych, zmień wartość na 1041. Aby uzyskać więcej informacji, zobacz Identyfikatory ustawień regionalnych przypisane przez firmę Microsoft.

Błąd pojawia się, gdy projekt przepływu pracy jest wdrażany w czystym systemie

Ten problem występuje, jeśli wdrożysz projekt przepływu pracy w programie Visual Studio w czystym systemie. Czysty system to komputer z nową instalacją programów Visual Studio i SharePoint, ale nie wdrożonych projektów przepływu pracy.

Komunikat o błędzie

Nie można odnaleźć listy programu SharePoint: Historia przepływu pracy.

Rozwiązanie

Ten błąd występuje z powodu brakującej listy historii przepływu pracy. Ponieważ środowisko programistyczne jest czystym systemem, nie są wdrażane żadne przepływy pracy, a lista Historia przepływu pracy nie istnieje jeszcze. Aby rozwiązać ten problem, otwórz ponownie kreatora przepływu pracy, co powoduje utworzenie listy Historia przepływu pracy.

Aby ponownie włączyć kreatora przepływu pracy

  1. W Eksplorator rozwiązań wybierz węzeł przepływu pracy.

  2. W oknie Właściwości wybierz przycisk wielokropka (...) dla dowolnej właściwości, która ma przycisk wielokropka.

Użytkownik musi odświeżyć stronę aplikacji w przeglądarce podczas debugowania, aby wyświetlić zaktualizowany obraz

Jeśli debugujesz rozwiązanie programu SharePoint zawierające stronę aplikacji z kontrolką wyświetlającą obraz, taki jak kontrolka Obraz HTML, musisz odświeżyć stronę w przeglądarce, aby wyświetlić wszelkie zmiany wprowadzone w obrazie.

Błąd: lokalizacja witryny jest nieprawidłowa

Ten problem może wystąpić, jeśli program SharePoint Server nie jest zainstalowany. Może to również wystąpić, jeśli nie masz dostępu administratora do witryny sieci Web programu SharePoint określonej w Kreatorze dostosowywania programu SharePoint.

Komunikat o błędzie

  • Lokalizacja witryny programu SharePoint jest nieprawidłowa.

Rozwiązanie

Zdarzenie sieci Web usuwania witryny nie występuje w projekcie odbiorcy zdarzeń

Po utworzeniu projektu odbiorcy zdarzeń i wybraniu niektórych zdarzeń sieci Web, takich jak "witryna jest usuwana", zdarzenie nigdy nie występuje.

Komunikat o błędzie

Brak.

Rozwiązanie

Ten problem występuje, ponieważ zakres funkcji musi mieć wartość "Witryna", aby obsługiwać zdarzenia na poziomie lokacji, ale domyślnym zakresem funkcji dla projektów odbiorcy zdarzeń jest "Sieć Web". Zdarzenia internetowe, których dotyczy problem:

  • Trwa usuwanie witryny (WebDeleting)

  • Usunięto witrynę (WebDeleted)

  • Trwa przenoszenie witryny (WebMoving)

  • Przeniesiono witrynę (WebMoved)

    Aby rozwiązać ten problem, zmień zakres funkcji odbiornika zdarzeń w następujący sposób.

Aby zmienić zakres funkcji odbiorcy zdarzeń

  1. W Eksplorator rozwiązań otwórz plik funkcji odbiorcy zdarzeń w Projektant funkcji, klikając dwukrotnie plik lub otwierając menu skrótów, a następnie wybierając polecenie Otwórz.

  2. Wybierz strzałkę obok pozycji Zakres, a następnie wybierz pozycję Witryna na wyświetlonej liście.

Błąd wdrażania pojawia się po zmianie nazwy identyfikatora w projekcie modelu łączności danych biznesowych

Ten problem występuje, jeśli zmienisz nazwę identyfikatora jednostki w modelu Połączenie ivity danych biznesowych (BDC), a następnie spróbujesz wdrożyć rozwiązanie.

Komunikaty o błędach

  • <nazwa> modelu zawiera następujące błędy aktywacji typu zawartości zewnętrznej...

  • Obiekt IMetadataObject o nazwie "<nazwa> modelu" ma wartość w polu "name", która jest duplikowana ...

Rozwiązanie

Aby rozwiązać ten problem, usuń model ręcznie, a następnie ponownie wdróż rozwiązanie. Model można usunąć przy użyciu jednego z następujących narzędzi:

  • Program SharePoint 2010 Central Administracja istration. Aby uzyskać więcej informacji, zobacz Zarządzanie modelami usługi BDC w witrynie sieci Web microsoft TechNet.

  • Windows PowerShell. Model można usunąć, wpisując to polecenie w wierszu polecenia: Remove-SPBusinessDataCatalogModel. Aby uzyskać więcej informacji, zobacz Ogólne polecenia cmdlet (SharePoint Server 2010) w witrynie sieci Web firmy Microsoft.

Wystąpił błąd wdrożenia podczas próby odtworzenia puli aplikacji usług IIS na serwerze SharePoint Server

Ten problem występuje, jeśli na maszynie programu SharePoint Server nie zainstalowano funkcji zgodności usług IIS 6 WMI i programu .NET Framework 3.5.

Komunikaty o błędach

  • Wystąpił błąd w kroku wdrażania "Odtwarzanie puli aplikacji usług IIS": Nieprawidłowa przestrzeń nazw
  • Wystąpił błąd w kroku wdrażania "Odtwarzanie puli aplikacji usług IIS": Zadanie zostało anulowane.

Rozwiązanie

Aby rozwiązać ten problem, na maszynie z programem SharePoint Server sprawdź, czy jest zainstalowana zgodność usług IIS 6 WMI funkcji systemu Windows,

  • Windows PowerShell. Aby sprawdzić, czy funkcja jest zainstalowana, uruchom następujące polecenie programu PowerShell: get-windowsfeature -name Web-WMI. Jeśli nie jest wyświetlana jako zainstalowana, możesz ją zainstalować, uruchamiając następujące polecenie programu PowerShell: install-windowsfeature -name Web-WMI. Jeśli nadal występują błędy podczas próby odtworzenia puli aplikacji, upewnij się, że program .NET Framework 3.5 jest również zainstalowany na maszynie, uruchamiając polecenie get-windowsfeature -name NET-Framework-Core i install-windowsfeature -name NET-Framework-Core , jeśli tak nie jest.

Podczas próby wyświetlenia wizualnego składnika Web Part w programie SharePoint pojawia się błąd

Ten problem występuje, gdy właściwość Path kontrolki użytkownika nie zaczyna się od ciągu "CONTROLTEMPLATES\".

Komunikaty o błędach

  • Plik "/_CONTROLTEMPLATES/nazwa projektu Nazwa/><składnika Web Part>/<nazwa> użytkownika.ascx" nie istnieje.<

  • Błąd serwera w aplikacji "/".

Rozwiązanie

Aby rozwiązać ten problem

  1. W Eksplorator rozwiązań wybierz plik kontroli użytkownika, którego rozszerzenie nazwy pliku to .ascx.

  2. Na pasku menu wybierz pozycję Wyświetl>okno właściwości.

  3. W oknie Właściwości rozwiń węzeł Lokalizacja wdrożenia.

  4. Upewnij się, że wartość właściwości Path rozpoczyna się od ciągu "CONTROLTEMPLATES\".

Błąd pojawia się, gdy jest uruchamiany zaimportowany przepływ pracy wielokrotnego użytku zawierający pole formularza zadania

Ten problem występuje, jeśli zaimportujesz przepływ pracy zawierający formularz zadania z polem, a następnie uruchom nowy przepływ pracy w tym samym systemie, z którego został zaimportowany.

Komunikat o błędzie

Wystąpił błąd w kroku wdrażania "Aktywowanie funkcji": pole o identyfikatorze [Guid] zdefiniowanym w funkcji [Guid] zostało znalezione w bieżącym zbiorze witryn lub w podwitrynie.

Rozwiązanie

Ten błąd jest wynikiem kolizji identyfikatora pola, które występują, ponieważ projekt Importuj przepływ pracy wielokrotnego użytku w programie Visual Studio nie zmienia identyfikatorów pól formularza zadania. W przypadku wdrożenia zaimportowanego przepływu pracy na tym samym serwerze, który zawiera oryginalny przepływ pracy, wystąpią kolizje identyfikatora pola.

Aby rozwiązać ten problem, użyj funkcji Znajdź i zamień, aby zmienić wartość atrybutu Identyfikator pola we wszystkich zaimportowanych plikach przepływu pracy.

Błąd pojawia się po uruchomieniu zaimportowanego wystąpienia listy o zmienionej nazwie

Ten problem występuje w przypadku zmiany nazwy zaimportowanego wystąpienia listy, a następnie uruchomienia go w programie Visual Studio.

Komunikat o błędzie

Błąd kompilacji: Wystąpił błąd podczas wdrażania "Aktywuj funkcje": plik Template\Features\[import projectfeaturename]\Files\Lists\[staranazwa listy]\Schema.xml nie istnieje.

Rozwiązanie

Podczas importowania wystąpienia listy atrybut o nazwie CustomSchema jest dodawany do pliku Elements.xml wystąpienia listy. Element Elements.xml zawiera ścieżkę niestandardowego pliku schema.xml dla wystąpienia listy. Zmiana nazwy wystąpienia listy w programie Visual Studio zmienia ścieżkę wdrożenia niestandardowego pliku schema.xml, ale wartość ścieżki atrybutu CustomSchema nie jest aktualizowana. W związku z tym wystąpienie listy nie może odnaleźć pliku schema.xml w starej ścieżce określonej przez atrybut CustomSchema po aktywowaniu funkcji.

Aby rozwiązać ten problem, zaktualizuj ścieżkę lokalizacji wdrożenia pliku schema.xml w atrybucie CustomSchema.

Sesja debugowania programu SharePoint zakończona przez usługi IIS

Ten problem występuje, jeśli ustawisz punkt przerwania w rozwiązaniu programu Visual Studio SharePoint, wybierz klucz F5 , aby go uruchomić, a następnie pozostanie w punkcie przerwania dłuższym niż 90 sekund.

Komunikat o błędzie

Proces serwera sieci Web, który był debugowany, został zakończony przez usługi Internet Information Services (IIS). Ten problem można uniknąć, konfigurując ustawienia ping puli aplikacji w usługach IIS. Aby uzyskać więcej informacji, zobacz pomoc.

Rozwiązanie

Domyślnie pula aplikacji usług IIS czeka 90 sekund, zanim aplikacja odpowie przed zamknięciem aplikacji. Ten proces jest nazywany "pingowaniem" aplikacji. Aby rozwiązać ten problem, możesz zwiększyć czas oczekiwania lub całkowicie wyłączyć polecenie ping aplikacji.

Aby uzyskać dostęp do ustawień puli aplikacji usług IIS

  1. Otwórz Menedżera usług IIS.

  2. W okienku Połączenie ions rozwiń węzeł serwera programu SharePoint, a następnie wybierz węzeł Pule aplikacji.

  3. Na stronie Pule aplikacji wybierz pulę aplikacji programu SharePoint (zazwyczaj "SharePoint — 80"), a następnie w okienku Akcje wybierz link Zaawansowane Ustawienia.

  4. Aby zwiększyć czas oczekiwania przed przekroczeniem limitu czasu usług IIS, zmień wartość maksymalnego czasu odpowiedzi ping (w sekundach) na wartość większą niż 90 sekund.

  5. Aby wyłączyć polecenie ping usług IIS, ustaw wartość Ping włączone na wartość False.

Automatyczne wycofanie pozostawia oddzielone wystąpienie listy w programie SharePoint

Ten problem występuje, jeśli wykonasz następujące kroki.

  1. Utwórz definicję listy z wystąpieniem listy w programie Visual Studio.

  2. Wybierz klucz F5, aby uruchomić rozwiązanie.

  3. Zatrzymaj debugowanie lub zamknij witrynę programu SharePoint.

  4. Otwórz ponownie 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 wycofuje rozwiązanie. Wycofywanie usuwa definicję listy z programu SharePoint, ale nie usuwa wystąpienia listy. Podstawowa definicja listy jest wymagana przez wystąpienie listy.

Aby rozwiązać ten problem, wdróż rozwiązanie według na pasku menu, wybierając pozycję Wdróż kompilację>. (Nie debuguj rozwiązania, wybierając Klawisz F5 ). Następnie usuń wystąpienie listy w programie SharePoint.

Oryginalne rozwiązanie programu SharePoint jest zastępowane wyeksportowaną wersją

W przypadku wyeksportowania rozwiązania programu SharePoint zaimportuj rozwiązanie do programu Visual Studio, a następnie wdróż rozwiązanie z powrotem do tej samej witryny, z której zostało wyeksportowane, oryginalne rozwiązanie programu SharePoint zostanie zastąpione. Ten problem nie występuje w przypadku wdrożenia rozwiązania na serwerze, na którym nie aktywowano oryginalnego rozwiązania.

Komunikat o błędzie

Brak.

Rozwiązanie

Aby uniknąć zastępowania rozwiązania w witrynie, z której został wyeksportowany, zmień identyfikatory GUID identyfikatorów SolutionID i identyfikatorów funkcji wszystkich zaimportowanych funkcji w projekcie programu Visual Studio.

Podczas uruchamiania debugowania pojawia się błąd

Po rozpoczęciu debugowania rozwiązania programu SharePoint w programie Visual Studio błąd wskazuje, że program Visual Studio nie może załadować pliku Web.config, ponieważ dany klucz nie był w słowniku.

Komunikat o błędzie

Nie można załadować pliku konfiguracji Web.config. Sprawdź plik pod kątem wszelkich nieprawidłowo sformułowanych elementów XML i spróbuj ponownie. Wystąpił następujący błąd: Podany klucz nie był obecny w słowniku.

Rozwiązanie

Aby rozwiązać ten problem, upewnij się, że wartość właściwości Adres URL witryny projektu programu SharePoint w programie Visual Studio jest zgodna z adresem URL przypisanym do strefy domyślnej dla mapowań dostępu alternatywnego aplikacji internetowej. Nie można usunąć błędu przy użyciu innej strefy, takiej jak Intranet, dla adresu URL. Adres URL witryny projektu i adres URL w strefie domyślnej muszą być zgodne. Aby uzyskać dostęp do mapowań dostępu alternatywnego, otwórz narzędzie Administracja istration programu SharePoint 2010 Central, wybierz link Zarządzanie aplikacjami, a następnie w obszarze Aplikacje internetowe wybierz link Konfiguruj mapowania dostępu alternatywnego. Aby uzyskać więcej informacji, zobacz Tworzenie stref dla aplikacji internetowych.

Powiązana zawartość