Sử dụng User query để cung cấp dữ liệu tích hợp với ứng dụng khác

Giới thiệu


User Query có thể dùng như công cụ để cung cấp thông tin cho ứng dụng khác. Dữ liệu được định dạng JSON.

Ví dụ các bước thiết lập


Bước 1. Thiết lập một user query.

user có thể dùng nhiều cách để lấy dữ liệu từ hệ thống thông qua Data url. Trong ví dụ ta sẽ dùng cách trích xuất dữ liệu thông qua Report Template. Việc này ít dùng trong thực tế, nhưng là ví dụ cho thấy Phoebus có thể trình bày bất cứ dạng dữ liệu nào để tích hợp.

Tạo UQD có mã TESTTEMPL :

d96ea460-3b1f-4c33-b918-b65ea1b2c122.pbs_bo_inquiry_uqd_phoebusapi

Ở đây, dữ liệu cung cấp lấy từ name range mydata của report template

54541987-9e41-4c23-bfce-97335c9c66f9.pbs_bo_inquiry_uqd_phoebusapi

Sau khi tạo UQD, hãy test nó để thấy dữ liệu xuất ra

Dùng câu lệnh để lấy dữ liệu từ UQD:

pbs.BO.Inquiry.UQD?Code=TESTTEMPL&$action=Run

fef1e515-a59d-4b01-ae42-37a82186038f.pbs_bo_inquiry_uqd_phoebusapi

Chú ý upload template TEST sử dụng trong UQD lên CSDL bằng chức năng Report Templates. Nếu không PhoebusAPI sẽ không có template để chạy.

Template sử dụng bởi PhoebusAPI sẽ download về thư mục gốc của webapp ở sub folder Phoebus.

Bước 2. Cài đặt Phoebus API trên server tích hợp

Xem hướng dẫn cài đặt tại : https://phoebusfiles.blob.core.windows.net/help/setupappserver.html

Chú ý cài PhoebusAPI. Đừng nhầm sang Appserver cho Phoebus hoặc Appserver cho mobile. Cách cài đặt tương tự nhau. Nhưng PhoebusAPI output dữ liệu JSON cho tích hợp. Còn 2 gói kia phục vụ cho desktop và mobile app.

Sau khi cài xong, hãy thiết lập kết nối đến CSDL Phoebus mà API sẽ lấy dữ liệu cung cấp cho tích hợp.

Kết nối sẽ được khai báo trong file web.config ở thư mục gốc của PhoebusAPI.

Tài liệu hướng dẫn Phoebus API

Kết quả bước này là một địa chỉ URL mà Phoebus API cung cấp dịch vụ. Ta gọi là Service EndPoint. Dạng http:// hoặc https::// .....

Bước 3. Mở Postman để kiểm tra kết quả

Postman là chương trình để gửi request lên service và nhận về kết quả tương tự browser. Download postman tại đây : https://www.postman.com/

Login

GET EndPoint/login

Để lấy dữ liệu từ phoebus, đầu tiên ta phải login bằng user account. User Account này tạo từ chức năng Operator Definition

970bb495-3a8c-474c-867d-d4b1fd883c9d.pbs_bo_inquiry_uqd_phoebusapi

Trong hình trên, ServiceEndPointhttp://localhost:54009/PhoebusAPI/ Ta gửi GET request tới địa chỉ này và gọi lệnh login, UserId và Password được cung cấp ở request header.

Sau khi bấm nút Send kết quả trả về là thông tin user và token.

Ta sẽ sử dụng giá trị token này khi truy vấn PhoebusAPI.

Truy vấn

Gửi request yêu cầu dữ liệu từ UQD TESTTEMPL

GET EndPoint/pbs_BO_Inquiry_UQD?Code=TESTTEMPL

b6b758c7-175f-4356-b485-207536f656db.pbs_bo_inquiry_uqd_phoebusapi

Xem thêm



Updated on : 2021-08-15 05:36:54. by : . at T470-01.

Topic : pbs.bo.inquiry.uqd.phoebusapi