Dodawanie komunikatu

Komunikaty stanowią abstrakcyjną definicję przesyłanych danych. Komunikat składa się z części logicznych, z których każda jest powiązana z definicją w określonym systemie typów. Komunikaty WSDL są obiektami najwyższego poziomu, do których można się odwoływać przez elementy wejściowe, wyjściowe i błędów operacji (w ramach typu portu).

Można utworzyć komunikat w widoku Schemat, klikając prawym przyciskiem myszy folder Komunikaty, a następnie klikając opcję Dodaj komunikat.

Aby utworzyć nowy komunikat dla elementu wejściowego, wyjściowego lub błędu, wykonaj następujące czynności:

  1. W widoku Projekt kliknij prawym przyciskiem myszy element wejściowy, wyjściowy lub błędu i kliknij opcje Ustaw komunikat > Nowy komunikat.
  2. W oknie dialogowym wpisz nazwę komunikatu. Musi to być nazwa unikalna w ramach wszystkich komunikatów zdefiniowanych w obejmującym dokumencie WSDL. Kliknij przycisk OK.
  3. Nowy komunikat zostanie wyświetlony w widoku Projekt w typie portu.

Uwaga: Do komunikatów można się odwoływać tylko w ramach typu portu (w szczególności przez obiekty wejścia, wyjścia i błędów operacji). Obiekty wejścia, wyjścia i błędów w powiązaniu nie odwołują się do komunikatów. Dlatego nie można utworzyć nowego komunikatu, klikając prawym przyciskiem myszy obiekt wejścia, wyjścia i błędu w powiązaniu (obiekty te są także zwane odpowiednio wejściem powiązania, wyjściem powiązania i błędem powiązania).

Wskazówka: Nowy komunikat dla elementu wejściowego, wyjściowego lub błędu można także utworzyć w widoku Schemat. W folderze Typy portów kliknij prawym przyciskiem myszy element i wybierz opcje Ustaw komunikat > Dodaj komunikat. Komunikat zostanie wyświetlony w widoku Schemat w folderze Komunikaty.

Aby ponownie wykorzystać komunikat dla elementu wejściowego, wyjściowego lub błędu, wykonaj następujące czynności:

  1. W widoku Projekt kliknij prawym przyciskiem myszy element wejściowy, wyjściowy lub błędu i kliknij opcje Ustaw komunikat > Istniejący komunikat.
  2. W polu Nazwa wpisz łańcuch wyszukiwania, aby odfiltrować listę, lub pozostaw pole puste, aby wyświetlić wszystkie komunikaty.
  3. Można zmienić zasięg listy, wybierając jedną z następujących opcji:
    • Obszar roboczy. Pokazuje komunikaty dostępne w obszarze roboczym.
    • Projekt obejmujący. Pokazuje komunikaty dostępne w projekcie zawierającym dany plik.
    • Bieżący zasób. Pokazuje komunikaty dostępne w bieżącym pliku.
    • Zbiory robocze. Pokazuje komunikaty dostępne w podanym zbiorze plików. Aby określić zbiór roboczy, kliknij przycisk Wybierz. Można wybrać pliki z istniejącego zbioru roboczego lub utworzyć nowy zbiór roboczy. Po wybraniu plików kliknij przycisk OK.
  4. Zostaną wyświetlone istniejące komunikaty. Wybierz jeden i kliknij przycisk OK.

Aby zaimportować istniejący komunikat dla elementu wejściowego, wyjściowego lub błędu, wykonaj następujące czynności:

  1. W widoku Projekt kliknij prawym przyciskiem myszy element wejściowy, wyjściowy lub błędu i kliknij opcje Ustaw komunikat > Istniejący komunikat.
  2. W polu Nazwa wpisz łańcuch wyszukiwania, aby odfiltrować listę, lub pozostaw pole puste, aby wyświetlić wszystkie komunikaty.
  3. Możesz zaimportować komunikat, wybierając jedną z następujących opcji.
    • Obszar roboczy. Pokazuje komunikaty dostępne w obszarze roboczym.
    • Projekt obejmujący. Pokazuje komunikaty dostępne w projekcie zawierającym dany plik.
    • Zbiory robocze. Pokazuje komunikaty dostępne w podanym zbiorze plików. Aby określić zbiór roboczy, kliknij przycisk Wybierz. Można wybrać pliki z istniejącego zbioru roboczego lub utworzyć nowy zbiór roboczy. Po wybraniu plików kliknij przycisk OK.
  4. Zostaną wyświetlone komunikaty. Wybierz jeden i kliknij przycisk OK.

Teraz można dodać części do komunikatu. Części są elastycznym mechanizmem opisu abstrakcyjnej treści logicznej komunikatu.