Korzystanie z interfejsu REST API serwera Rule Execution Server

Aby wdrożyć usługę decyzyjną na serwerze docelowym Decision Server, należy pobrać odpowiedni pakiet RuleApp i jego model XOM ze źródłowego środowiska chmury, a następnie użyć interfejsu REST API w celu umieszczenia plików binarnych RuleApp i XOM na docelowym serwerze Decision Server. Następnie usługę decyzyjną można uruchomić na tym Decision Server.

Zanim rozpoczniesz

Użytkownik musi mieć dostęp do środowiska chmury i wdrożyć usługę decyzyjną.

O tym zadaniu

Przykładowe komendy, które są udostępniane w poniższej procedurze, używają produktu cURL do uwierzytelniania w serwerze w chmurze i przesyłania plików archiwum z serwera w chmurze do innego serwera Decision Server. Można użyć innego programu w celu wysłania informacji autoryzacyjnych do serwerów, uzyskania dostępu do interfejsu REST API i pobrania plików z serwera w chmurze.

Procedura

  1. Pobierz plik RuleApp ze środowiska chmury.

    Komenda ta zawiera podstawowe referencje uwierzytelniające oraz ścieżkę do pakietu reguł RuleApp. Zastąp zmienne nazwy użytkownika i hasła podstawowymi informacjami autoryzacyjnymi uwierzytelniania. Podaj adres URL hosta klienta w chmurze i podaj poprawną nazwę RuleApp w ścieżce:

    curl -k -u username@company_name.com:password server_URL/odm/cloud_env/res/api/v1/ruleapps/ruleapp_name/1.0/archive --output ruleapp_name.jar
  2. Pobierz model XOM:
    1. W właściwości ruleset.managedxom.uris w danych wyjściowych poprzedniej komendy poszukaj identyfikatora URI zarządzanego modelu XOM. Ta właściwość pobiera szczegóły obiektu RuleApp .
    2. Jeśli właściwość wskazuje na zasób modelu XOM (resuri), należy pominąć ten krok. Jeśli wskazuje ona na bibliotekę (reslib), należy sprawdzić właściwość content w danych wyjściowych poprzedniej komendy dla identyfikatora URI modelu XOM. Właściwość content pobiera szczegóły biblioteki. Użyj nazwy i wersji biblioteki, która jest zwracana w poprzedniej komendzie.
      curl -k -u username@company_name.com:password server_URL/odm/cloud_env/res/api/libraries/library_name/1.0
    3. Pobierz model XOM. Użyj nazwy i wersji zasobu zwróconego w poprzedniej komendzie.
      curl -k -u username@company_name.com:password server_URL/odm/cloud_env/res/api/xoms/xom_name/1.0/bytecode --output xom_name.zip
  3. Prześlij model XOM.
    curl -X POST -k -u admin_username:admin_password server_URL/res/api/v1/xoms/xom_name.zip --data-binary @xom_name.zip  -H "Content-Type:application/octet-stream"
    Jeśli RuleApp odwołuje się do biblioteki, a nie do modelu XOM, utwórz ponownie bibliotekę i określ zasób modelu XOM, który ma zawierać.
    curl -X POST -k -u admin_username:admin_password server_URL/res/api/v1/libraries/library_name1.0 -d "resuri://xom_name.zip/1.0"  -H "Content-Type:text/plain"
    Uwaga: Nazwy zasobów należy przechowywać podczas pobierania i przesyłania ich.
  4. Prześlij RuleApp do innego serwera Decision Server.

    Komenda ta zawiera nazwę użytkownika, hasło i adres URL w celu uzyskania dostępu do konsoli Serwer Rule Execution Server na drugim serwerze Decision Server.

    curl -X POST -k -u admin_username:admin_password server_URL/res/api/v1/ruleapps --data-binary @ruleapp_name.jar  -H "Content-Type:application/octet-stream"
  5. Sprawdź wykonanie zestawu reguł (usługa decyzyjna) przy użyciu interfejsu REST API. 
    curl -X POST -k -u username@company_name.com:password server_URL/DecisionService/rest/v1/ruleappname/ruleappversion/rulesetname/rulesetversion -d jsonpayload -H "Content-Type:application/json"