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 elementu błędu, wykonaj następujące kroki:

  1. W widoku Projekt kliknij prawym przyciskiem myszy element wejściowy, wyjściowy lub błędu i kliknij opcję Ustaw komunikat > Nowy komunikat.
  2. Wpisz nazwę komunikatu w panelu Ogólne widoku Właściwości. Musi to być nazwa unikalna w ramach wszystkich komunikatów zdefiniowanych w obejmującym dokumencie WSDL.
  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 opcję Ustaw komunikat > Dodaj komunikat. Komunikat zostanie wyświetlony w widoku Schemat w folderze Komunikaty.

Ponowne wykorzystywanie komunikatu

Aby ponownie wykorzystać komunikat dla elementu wejściowego, wyjściowego lub elementu błędu, wykonaj następujące kroki:
  1. W widoku Projekt kliknij prawym przyciskiem myszy element wejściowy, wyjściowy lub błędu i kliknij opcję Ustaw komunikat > Istniejący komunikat.
  2. W polu Nazwa wpisz łańcuch wyszukiwania, aby zastosować filtr względem listy, lub pozostaw to pole puste, aby wyświetlić wszystkie pozycje tej listy.
  3. Możesz zmienić zasięg listy, wybierając jedną z następujących opcji:
    • Obszar roboczy: Zostaną wyświetlone komunikaty dostępne w obszarze roboczym.
    • Projekt obejmujący: Zostaną wyświetlone komunikaty dostępne w projekcie zawierającym dany plik.
    • Bieżący zasób: Zostaną wyświetlone komunikaty dostępne w bieżącym pliku.
    • Zbiory robocze: Zostaną wyświetlone 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.

Importowanie komunikatu

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 opcję Ustaw komunikat > Istniejący komunikat.
  2. W polu Nazwa wpisz łańcuch wyszukiwania, aby zastosować filtr względem listy, lub pozostaw to pole puste, aby wyświetlić wszystkie pozycje tej listy.
  3. Możesz zaimportować komunikat, wybierając jedną z następujących opcji:
    • Obszar roboczy: Zostaną wyświetlone komunikaty dostępne w obszarze roboczym.
    • Projekt obejmujący: Zostaną wyświetlone komunikaty dostępne w projekcie zawierającym dany plik.
    • Zbiory robocze: Zostaną wyświetlone 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. Więcej informacji można znaleźć w sekcji Dodawanie części do komunikatu.