Promowanie projektów REST w środowiskach produkcyjnych

Zalecamy, aby w przypadku projektowania nowych części systemu nie stosować ich bezpośrednio w środowisku produkcyjnym, lecz zaprojektować je w środowisku deweloperskim, dokładnie przetestować, a dopiero potem przenieść do środowiska produkcyjnego. Jest to szczególnie ważne podczas projektowania funkcji, które wykorzystują zachowanie REST.

Informacje na temat projektowania i korzystania z zachowań usług sieci Web REST można znaleźć w sekcji Łączenie obiektów z usługami sieci Web REST.. Więcej szczegółów na temat promowania projektów REST w środowiskach produkcyjnych można znaleźć w witrynie społeczności Community.

Utworzenie projektu za pomocą usługi sieci Web REST spowoduje utworzenie zestawu nowych obiektów po dodaniu zachowania do obiektu. Następnie należy przenieść te obiekty do środowisk produkcyjnych. W tej sekcji opisano kroki potrzebne do promowania projektu ze środowiska nieprodukcyjnego do środowiska produkcyjnego. Można skorzystać z aplikacji Test to Live lub komponentu Przeniesienie projektu.

Aplikacja Test to Live

Aplikacja Test to Live umożliwia promowanie całego projektu, w tym obiektów, okien, ustawień połączenia REST oraz definicji treści żądania.

Treść ładunku REST jest przechowywana w postaci listy odwołań w obiekcie listy odwołań ObjectBody. Aplikacja Test to Live migruje wyłącznie NOWE listy odwołań, więc jeśli zaktualizujesz lub usuniesz którykolwiek z tych elementów, będzie konieczne ich ręczne zaktualizowanie w systemie produkcyjnym. Więcej informacji na temat korzystania z aplikacji Test to Live można znaleźć w sekcji Aplikacja Test to Live.

Przeniesienie projektu

W tej sekcji opisano, jak promować projekt REST do środowiska produkcyjnego za pomocą komponentu Przeniesienie projektu. Więcej informacji na temat przenoszenia projektów można znaleźć w tematach Eksportowanie projektów z bazy danych za pomocą komponentu Przeniesienie projektu oraz Importowanie elementów do bazy danych.

Komponent Przeniesienie projektu nie przenosi danych uwierzytelniania usługi sieci Web REST ani definicji zawartości, dlatego po zakończeniu importu za pomocą tego komponentu należy wprowadzić następujące informacje:

  • Identyfikator URI punktu końcowego
  • Szczegóły uwierzytelniania w przypadku wybrania opcji Podstawowe lub Klucz API (Dostawca)
  • Szczegóły mapowania odpowiedzi, jeśli są wymagane
  • Zawartość treści żądania

Nie należy dodawać projektu obiektu ani okna dla obiektu Treść żądania do pliku komponentu Przeniesienie projektu. Spowoduje to błąd przy próbie uruchomienia importu.

Należy utworzyć dwa pliki eksportu: jeden dla projektu obiektu, a drugi dla danych okna i treści usługi REST.

Aby utworzyć plik eksportu 1, należy utworzyć plik projektu obiektu:

  1. Uruchom komponent Przeniesienie projektu w systemie źródłowym i przejdź do folderu Business Objects.
  2. Rozwiń folder modułu, w którym został utworzony obiekt REST.
  3. Rozwiń folder obiektów najwyższego poziomu: Attributes.
  4. Wybierz kolekcję związaną z obiektem REST i dołącz obiekty zależne.
    Spowoduje to również wybranie obiektu REST do włączenia.
  5. Rozwiń folder Attributes dotyczący obiektu REST i upewnij się, że wszystkie pozostałe atrybuty są zaznaczone.
  6. Na liście Działania kliknij polecenie Eksportuj wybrane elementy, a następnie zapisz plik.

Aby utworzyć plik eksportu 2, należy użyć danych okna i treści usługi REST:

  1. Uruchom ponownie komponent Przeniesienie projektu i przejdź do folderu Reference.
  2. Rozwiń listę odwołań, a następnie folder modułu, w którym znajduje się obiekt REST.
  3. Kliknij folder obiektów prawym przyciskiem myszy, a następnie kliknij przycisk Wybierz.
    Zostaną wybrane wszystkie definicje treści żądania. Można też rozwinąć folder i wybrać żądane definicje.

    4. Przesyłane są wyłącznie nazwy definicji treści żądania. Definicje treści żądania należy dodać po zaimportowaniu plików za pomocą komponentu Przeniesienie projektu.

  4. Przejdź do folderu Windows i rozwiń folder modułu, w którym znajduje się obiekt REST.
  5. Rozwiń folder obiektów REST i wybierz odpowiednie okno. Nie należy uwzględniać obiektów zależnych.
  6. Na liście Działania kliknij polecenie Eksportuj wybrane elementy, a następnie zapisz plik.

Po utworzeniu dwóch plików komponentu Przeniesienie projektu można zaimportować projekt do systemu docelowego.

Aby zaimportować projekt do systemu docelowego:

  1. W systemie docelowym otwórz komponent Przeniesienie projektu i wybierz opcję Importuj.
  2. Na liście Działania kliknij przycisk Otwórz plik importu i wybierz utworzony wcześniej plik 1.
  3. W przypadku ostrzeżenia o braku obiektu odniesienia wybierz opcję Pozostaw wartość nieustawioną, a następnie kliknij przycisk Importuj.
    Plik zostanie wczytany i nastąpi utworzenie obiektu treści usługi REST.
  4. Kliknij przycisk OK.
  5. Na liście Działania kliknij przycisk Otwórz plik importu i wybierz utworzony wcześniej plik 2.
    Po jego wczytaniu pojawia się kilka ostrzeżeń.
  6. W przypadku wszystkich ostrzeżeń dotyczących konfliktu obiektów w systemie należy wybrać opcję Nie twórz nowego...
  7. W przypadku ostrzeżenia o braku obiektu odniesienia wybierz opcję Pozostaw wartość nieustawioną.
  8. Kliknij przycisk Importuj.
    Zostanie utworzone okno wybrane dla głównego obiektu REST, a wybrane pozycje listy odwołań treści usługi REST zostaną wypełnione danymi.
  9. Kliknij przycisk OK.

Zadanie importu związane z plikami zostało zakończone. Teraz należy przeprowadzić ręczne aktualizacje systemu docelowego.

Aby ręcznie zaktualizować dane przeniesienia projektu:

  1. W Projektancie obiektów otwórz obiekt REST.
  2. Wyświetl ustawienia usług sieci Web REST w obiekcie, dodaj szczegóły połączenia, a następnie zapisz zmiany.
  3. W oknie Menedżer okien przejdź do modułu, a następnie do obiektu REST. Kliknij prawym przyciskiem myszy okno i wybierz polecenie Udostępnij w aplikacji Web Access.
  4. Kliknij prawym przyciskiem myszy obiekt treści żądania i utwórz odpowiednie okno dla listy odwołań.
  5. W komponencie Administracja rozwiń drzewo Listy odwołań.
  6. Rozwiń moduł, który zawiera obiekt REST, i zaktualizuj definicje treści żądania zgodnie z wymaganiami. Możesz tu również dodać nowe definicje.
    Obiekt REST i powiązane z nim dane są gotowe do użycia.