Skip to main content
Service REST メソッドは、エクスポートされたファイルを Pega の Case に受け取ります。設定は、サービスパッケージ、アクセスロール、サービス自体の 3 つの部分から成ります。

​
サービスパッケージを作成する

1

新しいサービスパッケージを開始する

左側の Records タブをクリックし、Integration Resources を展開して Service Package を右クリックし、ショートカットメニューから Create を選択します。
2

パッケージに名前を付ける

Create Service Package フォームで、Service Package Name フィールドに customapi と入力します。Short description フィールドにパッケージの説明を入力し、Create and open をクリックします。
3

アクセスグループを指定する

Edit Service Package フォームで、Service access group フィールドにアクセスグループを指定します。グループの形式は <Application_name>:<Access group> です。利用可能なアクセスグループの一覧を表示するには、左側の Records タブをクリックし、Security → Access Group に移動します。
4

パッケージを保存する

Save をクリックします。

​
アクセスグループへの Web API ロールの追加

このロールを追加すると、ユーザーが Web API にアクセスできるようになります。
1

アクセスグループを開く

Records → Security → Access Group → ABBYYFC:Administrators/ABBYYFC:Users をクリックします。
2

ロールを追加する

Available roles フィールドに PegaRULES:PegaAPI ロールを追加します。

​
サービスの作成

1

新しい Service REST の作成を開始する

左側の Records タブをクリックし、Integration-Services を展開して Service REST を右クリックし、ショートカットメニューから Create を選択します。
2

サービスの詳細を指定する

表示されるフォームで以下の値を指定し、Create and open をクリックします。
3

URL パスパラメーターをマッピングする

Service タブをクリックし、Pega class フィールドに Pega-API-CaseManagement と入力します。URL path parameters セクションで、Id パラメーターの Map to Key 列に Param.CaseId と入力し、name パラメーターには Param.FileName と入力します。
4

POST リクエストを設定する

Methods タブをクリックします。POST メソッドを展開し、Request タブで Message data のフィールドに以下を指定します。
5

レスポンス条件を作成する

Response タブをクリックし、レスポンス条件 で説明されている 3 つの条件を作成します。

​
レスポンス条件

Response タブで、次の 3 つの条件を作成します。

​
pxIsInternalError

Parameter の値:
  • Condition: When
  • When name: pxIsInternalError
  • Content type: application/json
  • Status code: Param.StatusCode
この condition では、header field も message data も設定しません。

​
pxIsErrorResponse

Parameter の値:
  • Condition: When
  • When name: pxIsErrorResponse
  • Content type: application/json
  • Status code: Param.StatusCode
Message data:
  • Description: Response
  • Map from: Clipboard
  • Map from key: Param.Response
この condition では header field を設定しません。

​
成功レスポンス

Parameter値:
  • Condition: Default
  • Content type: application/json
  • Status code: Param.StatusCode
Header フィールド:
  • Name location (Map from に Clipboard、Map from key に Param.Location を設定)
  • Name etag (Map from に Clipboard、Map from key に Param.eTag を設定)
Message data:
  • Description: Response
  • Map from: Clipboard
  • Map from key: Param.Response

​
サービスメソッドのURL

サービスメソッドのURLは、必ず次のとおりにしてください:
そうでない場合、ユーザーがファイルをPegaにエクスポートしようとすると、コネクタはエラーを返します。