Niestandardowe komunikaty o błędach

Program PWS umożliwia administratorom dostosowanie zawartości, która jest zwracana klientowi w przypadku wystąpienia błędu HTTP. Zamiast używać komunikatów o błędach HTTP 1.1, które są zwracane domyślnie, administrator witryny sieci Web może wysyłać do klienta inne komunikaty o błędach. Te niestandardowe komunikaty o błędach mogą mieć formę pliku lub adresu URL.

Jeśli zdefiniowany jest skrypt ASP do obsługi niestandardowego błędu, skrypt ten jest wywoływany jako adres URL, który przekazuje kontekst. Na przykład, jeśli zdefiniowany jest plik ASP o nazwie handle404.asp do obsługi błędu HTTP 404, to gdy wystąpi błąd 404 przy próbie dostępu użytkownika do pliku example.htm, plik ASP zostanie wywołany tak, jakby użytkownik wpisał http://example.microsoft.com/handle404.asp?404;http://example.microsoft.com/example.htm w przeglądarce sieci Web.

Notka   Niestandardowe komunikaty o błędach pojawiają się w programie Internet Service Manager w formie listy i lista ta jest traktowana przez program PWS jako pojedyncza właściwość. Na przykład, jeśli zestaw niestandardowych komunikatów o błędach jest skonfigurowany na poziomie witryny sieci Web, wszystkie katalogi obsługiwane przez serwer dziedziczą całą listę niestandardowych komunikatów o błędach. Oznacza to że listy niestandardowych komunikatów o błędach (dla serwera i katalogu) nie są łączone.

Jeśli używane są statyczne pliki niestandardowych komunikatów o błędach (pliki HTML), należy zawsze używać opcji Plik. Podczas projektowania aplikacji (poprzez ISAPI lub ASP) do obsługi błędów użyty zostanie adres URL, ale trzeba pamiętać, że stan błędu jest przekazywany do aplikacji poprzez parametry adresu URL i to aplikacja musi ustawić stan nagłówka HTTP. W przeciwnym razie stanem odpowiedzi HTTP będzie HTTP 1.1 200 OK.

Następujące komunikaty o błędach HTTP mogą zostać dostosowane:

Notka   Kody błędów 401 i 403 mają pod-kody, co umożliwia zwiększenie elastyczności komunikatów niestandardowych.

"400"; Nieprawidłowe żądanie
"401"; Nieuwierzytelniony

1- Logowanie nie powiodło się
2- Logowanie nie powiodło się z powodu konfiguracji serwera
3- Nieuwierzytelniony z powodu listy ACL dla zasobu
4- Uwierzytelnienie nie powiodło się z powodu filtru
5- Uwierzytelnienie nie powiodło się z powodu aplikacji ISAPI/CGI

"403"; Zakazany

1- Dostęp z wykonaniem zakazany
2- Dostęp do odczytu zakazany
3- Dostęp do zapisu zakazany
4- Wymagana warstwa SSL
5- Wymagana warstwa SSL128
6- Adres IP odrzucony
7- Wymagany certyfikat klienta
8- Odmowa dostępu do witryny
9- Zbyt wielu użytkowników
10 - Nieprawidłowa konfiguracja
11 - Zmiana hasła
12 - Odmowa dostępu przez Mapper

"404"; Nie odnaleziono
"405"; Metoda nie jest dopuszczalna
"406"; Nie jest akceptowany
"407"; Wymagane uwierzytelnienie Proxy
"412"; Niespełniony warunek wstępny
"414"; Adres Request-URL jest za długi
"415"; Nieobsługiwany typ nośnika
"500"; Wewnętrzny błąd serwera
"501"; Nie jest zaimplementowany
"502"; Nieprawidłowa brama

Dodawanie niestandardowego komunikatu o błędzie

Niestandardowe komunikaty o błędach mogą mieć formę mapowania na plik lub mapowania na adres URL. Obie te formy można ustawić w arkuszu właściwości Błędy niestandardowe w programie Internet Service Manager. W poniższej procedurze pokazano, jak dostosować błąd HTTP przez mapowanie błędu na adres URL.

Aby dostosować komunikat o błędzie przez mapowanie na adres URL:
  1. Utwórz plik zawierający niestandardowy komunikat o błędzie i umieść go w katalogu wirtualnym.
  2. W programie Internet Service Manager wybierz witrynę sieci Web, katalog wirtualny, katalog lub plik, w którym chcesz dostosować błędy HTTP, a następnie kliknij przycisk Właściwości.
  3. Wybierz arkusz właściwości Błędy niestandardowe.
  4. Wybierz domyślny komunikat o błędzie HTTP, który ma być zmieniony.
  5. Kliknij przycisk Edytuj właściwości.
  6. Wybierz pozycję URL z pola Typ wiadomości
  7. Wpisz adres URL wskazujący na niestandardowy komunikat o błędzie.
  8. Kliknij przycisk OK.

Przyjazne niestandardowe komunikaty o błędach

Program PWS zawiera własny zestaw niestandardowych komunikatów o błędach, które są bardziej szczegółowe i "przyjazne" niż domyślne komunikaty HTTP 1.1 zwracane do przeglądarek klientów. Na przykład, komunikat o błędzie HTTP 1.1 404, który domyślnie brzmi po prostu "Nie odnaleziono obiektu" został rozszerzony do "Odnalezienie żądanego pliku/skrytpu przez serwer sieci Web nie jest możliwe. Sprawdź adres URL, aby upewnić się, że ścieżka jest poprawna. Jeśli problem będzie się powtarzał, skontaktuj się z administratorem serwera". Te przyjazne niestandardowe komunikaty o błędach są ustawiane domyślnie w domyślnej witrynie sieci Web w programie Internet Service Manager.

Aby skonfigurować przyjazne komunikaty o błędach:
  1. W programie Internet Service Manager wybierz witrynę sieci Web, katalog wirtualny, katalog lub plik, w którym chcesz dostosować błędy HTTP, a następnie kliknij przycisk Właściwości.
  2. Wybierz arkusz właściwości Błędy niestandardowe.
  3. Wybierz domyślny komunikat o błędzie HTTP, który ma być zmieniony.
  4. Kliknij przycisk Edytuj właściwości.
  5. Wybierz pozycję URL z pola Typ wiadomości
  6. Wpisz /iisHelp/common/<nazwa pliku>,

gdzie <nazwa pliku> jest nazwą pliku HTML przyjaznego komunikatu o błędzie. Przyjazne komunikaty o błędach są domyślnie instalowane w katalogu: <litera dysku>:\WINNT\Help\common. Nazwami plików są liczby odpowiadające określonym błędom HTTP; na przykład 400.htm, 401-1.htm itd.


© 1998 Microsoft Corporation. Wszelkie prawa zastrzeżone.