IBM BPM - Integration Rest Api from Swagger file

I. Giới thiệu

IBM BPM có cơ chế tích hợp Rest api thông qua file swagger (chuẩn đặc tả OpenAPI 2.0). Bài này sẽ hướng dẫn cách tích hợp api vào BPM.

OpenAPI: https://www.openapis.org/

Swagger: https://swagger.io/specification/

Swagger Editor Online: https://editor.swagger.io/

II. Hướng dẫn
1. Chuẩn bị file swagger (.json/.yml) theo chuẩn OpenAPI 2.0

Chú ý: Tên file swagger nên ghi chú rõ ràng ở tab Overview của App/Toolkit vì sau nếu muốn update thêm file swagger thì cần import đúng tên cũ để tránh việc binding lại các service flow đã làm trước đó

2. Vào BPM > App/Toolkit > Services > External Service
3. New External Service > Chọn Java, REST or Web service > Next
4. Chọn REST service from local file

Ở đây có nhiều hình thức import Rest api để tích hợp, trong bài này chỉ hướng dẫn cách tích hợp từ file local

External service name: Nhập tên của external service

File name: Chọn đến file swagger cần tích hợp ở máy local

Bấm NEXT

5. Tick chọn các operation (các api) muốn import từ file swagger

Bấm NEXT

Nếu tạo mới thực hiện bước 6, bỏ qua bước 7

Nếu cập nhật thêm file swagger bỏ qua bước 6, thực hiện bước 7

6. Tạo service và server (Tạo mới)

Crate a new external service

Crate a new server > Server name: Nhập tên của server cho các api cần tích hợp. (Nếu server đã config trước đó thì chọn Select an existing server)

Bấm FINISH

7. Tạo service và server (Update file swagger cũ: thêm/sửa api)

Replace an existing external service: Chọn service cần update

Select an existing server: Chọn server đã config trước đó

Bấm FINISH

8. Tạo Service Flow trên BPM

Services > Service Flow

Kéo Service Task

Implementation: Chọn external service đã tạo ở trên

Operation: Chọn operation của external service đã tạo ở trên

Nhận xét

Bài đăng phổ biến từ blog này

IBM BPM - Date

BPM WebSphere - Create Datasource (Connect to DB via JDBC)

IBM BPM - Error: Save error