1.2. Swagger インターフェイスを使用した Decision Server REST API による要求送信
Decision Server REST API は Swagger web インターフェイスをサポートしています。スタンドアロンの REST クライアントや curl ユーティリティーの代わりのこれを使用すると、Decision Central ユーザーインターフェイスを使わずに Red Hat Decision Manager の KIE コンテナーやビジネスアセット (ビジネスルールやプロセス、ソルバーなど) を操作することができます。
前提条件
- Decision Server をインストールし、実行している。
-
kie-serverユーザーロールで Decision Server にアクセスできる。
手順
-
Web ブラウザーで
http://SERVER:PORT/kie-server/docsを開きます。たとえば、http://localhost:8080/kie-server/docsとなります。kie-serverロールを持つ Decision Server ユーザーのユーザー名とパスワードでログインします。 -
Swagger ページで、要求の送信先となる関連 API エンドポイントを選択します。たとえば、KIE Server :: Core
[GET] /server/containers で KIE コンテナーを Decision Server から取得します。 - Try it out をクリックして、結果のフィルターリングに使用する任意のパラメーターを提供します。
- Response content type ドロップダウンメニューで、サーバー応答のフォーマットを選択します (例: JSON フォーマットでは application/json)。
Execute をクリックし、Decision Server の応答を確認します。
サーバー応答の例 (JSON):
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
この例では、プロジェクトの
group-id、artifact-id、およびversion(GAV) のデータを応答で返されたデプロイ済み KIE コンテナーのいずれかからコピーするか、書き留めます。 -
Swagger ページで KIE Server :: Core
[PUT] /server/containers/{containerId} エンドポイントに移動し、コピーしたプロジェクト GAV データで新規 KIE コンテナーをデプロイするための別の要求を送信します。ご自分のユースケースに合わせて、要求詳細を調整します。 Try it out をクリックして、以下の要求のコンポーネントを入力します。
-
containerId: 新規 KIE コンテナーの ID を入力します (例:
MyContainer)。 - body: Parameter content type を希望の要求のボディ形式 (JSON の場合は application/json など) に設定し、要求のボディに新規 KIE コンテナーの設定アイテムを追加します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
containerId: 新規 KIE コンテナーの ID を入力します (例:
- Response content type ドロップダウンメニューで、サーバー応答のフォーマットを選択します (例: JSON フォーマットでは application/json)。
Execute をクリックし、Decision Server の応答を確認します。
サーバー応答の例 (JSON):
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 要求エラーが発生した場合は、返されたエラーコードメッセージを確認して、それに応じて要求を調整します。