MÔ HÌNH LIÊN THÔNG TRỤC LGSP TPHCM DỊCH VỤ TÍCH HỢP DỊCH VỤ ĐỒNG BỘ THỐNG KẾ TỔNG HỢP

SỞ THƠNG TIN VÀ TRUYỀN THƠNG THÀNH PHỐ HỒ CHÍ MINH MÔ HÌNH LIÊN THƠNG TRỤC LGSP TPHCM DỊCH VỤ TÍCH HỢP DỊCH VỤ ĐỒNG BỘ THỐNG KẾ TỔNG HỢP TP.HCM, 4/2019 MỤC LỤC I Giải pháp thực Mơ hình gói tin Quy trình trao đổi gói tin Thông tin kết nối 4 API đồng thống kê tổng hợp 5 Định dạng gói tin 5.1 Gói tin trả 5.2 Gói tin thống kê tổng hợp .6 II Code example .9 Code mẫu Net Code mẫu java 10 I GIẢI PHÁP THỰC HIỆN Mơ hình gói tin CSDL DÙNG CHUNG CSDL TepTin CSDL MCDT Kiểm tra trả kết theo yêu cầu LGSP Trục tích hợp dịch vụ (LGSP) Kết trả từ LGSP API Đồng Thông kê tổng hợp ĐƠN VỊ Trang DVC ISO Các đơn đơn vị Phần mềm CN khác - CSDL Dùng chung nơi tập trung toàn kho liệu dùng chung TPHCM Cơ quan, tổ chức thực việc khai thác đồng liệu CSDL Dùng chung Thành phố thông qua trục LGSP - Trục LGSP đảm nhiệm vai trị việc cung cấp thơng tin kết nối đến phần mềm đơn vị, khai thác đồng liệu từ CSDL tập trung thành phố - APIDongBoThongKeTongHop hỗ trợ phần mềm đơn vị kết nối vào trục LGSP Đồng liệu Thống kê tổng hợp từ đơn vị CSDL dùng chung Thành phố Quy trình trao đổi gói tin - Bước 1: Phần mềm đơn vị đóng gói liệu dạng JSON - Bước 2: Phần mềm đơn vị gọi đến trục LGSP thông qua api kèm theo access token - Bước 3: Trục LGSP kiểm tra access token đơn vị Nếu thất bại trả gói tin JSON lỗi cho phần mềm đơn vị - Bước 4: Trục LGSP xử lý liệu trả gói tin JSON kết cho phần mềm đơn vị Thông tin kết nối Kiểu Diễn giãi Ví dụ Địa adapter trục Địa cổng dịch vụ dự kiến thức https://hcmesb.tphcm.gov.vn Địa adapter trục thử nghiệm Địa cổng dịch vụ thử nghiệm https://hcmesb.tphcm.gov.vn AccessKey Khóa rTkhYCBwHM SecretKey Khóa bí mật DWkQgY1YSS AppName Đơn vị kết nối TPHCM Authorization/ Token Khai báo Header, Là chuỗi gồm tham số dạng json mã hóa thành StringBase64 eyJhcHAiOiJRTkkiLCJzZWNyZXQiOiJEV2tR Z1kxWVNTIiwia2V5IjoiclRraFlDQndITSJ9 stringbase64 từ: { “AccessKey”= “rTkhYCBwHM”, “SecretKey”= “DWkQgY1YSS”, “AppName”= “TPHCM” } API đồng thống kê tổng hợp - - Đường dẫn: /DongBoThongKeTongHop Method: POST Input: o Header: Authorization o Body: chuỗi json chứa thông tin truyền vào 5.2, Ouput: chuỗi json chứa thông tin trả mục 5.1, resultObject true false Định dạng gói tin 1.1 Gói tin trả STT Tên trường StatusCode Định dạng Int Mô tả Mã trạng thái gói tin - 200: Request tiếp nhận xử lý thành công - 400: Request bị lỗi xử lý - 404: Tài ngun khơng tồn - 500: Lỗi q trình xử lý description String Nội dung lỗi trả resultObject JSON Chuỗi json trả resultType String Type gói tin trả Mặc định “JSON” 5 status String Trạng thái gói tin“Success” “FAIL” throwException bool Có lỗi xảy hay khơng Ví dụ: { "StatusCode": 500, "description": "Tham số đầu vào không đúng", "resultObject": null, "resultType": null, "status": "FAIL", "throwException": true } Ví dụ khác: { "StatusCode": 200, "description": null, "resultObject": true, "resultType": "JSON", "status": "SUCCESS", "throwException": false } 1.2 Gói tin thống kê tổng hợp ST T Tên trường Định dạng Mô tả Yêu cầu Thang Int Tháng lấy số liệu Bắt buộc Nam Int Năm lấy số liệu Bắt buộc IsThang Giá trị xác định số liệu thống kê theo tháng năm Bắt buộc NhanTrongKy Int64 Số hồ sơ nhận kỳ Bắt buộc TonKyTruoc Int64 Số hồ sơ tồn kỳ trước chuyển sang Bắt buộc Boolea n 6 TongXuLy Int64 Tổng số hồ sơ xử lý kỳ Bắt buộc TongDaXuLy Int64 Tổng số hồ sơ xử lý kỳ Bắt buộc DaXuLyDungHen Int64 Tổng số hồ sơ xử lý hẹn Bắt buộc PhanTramDaXuLyDungHen 10 DaXuLyTreHen 11 PhanTramDaXuLyTreHen 12 TongChuaXuLy Int64 Tổng số hồ sơ chưa xử lý kỳ Bắt buộc 13 ChuaXuLyTrongHan Int64 Tổng số hồ sơ chưa xử lý hạn Bắt buộc 14 PhanTramChuaXuLyTrongHa n 15 ChuaXuLyQuaHan 16 PhanTramChuaXuLyQuaHan 17 GhiChu String Ghi Không bắt buộc 18 MaDonViC1 String - Mã cấp quan, tổ chức đầu mối (Bộ, tỉnh ) kết nối với Cổng DVCQG Bắt buộc Decima Phần trăm hồ sơ xử lý hẹn l Int64 Số hồ sơ xử lý trễ hẹn Decima Phần trăm hồ sơ xử lý trễ hẹn l Decima Phần trăm hồ sơ chưa xử lý hạn l Int64 Số hồ sơ chưa xử lý hạn Decima Phần trăm hồ sơ chưa xử lý hạn l Bắt buộc Bắt buộc Bắt buộc Bắt buộc Bắt buộc Bắt buộc - Đối với Bộ, tỉnh: sử dụng mã cấp theo QCVN 102:2016/BTTTT 19 TenDonViC1 String Tên quan, tổ chức đầu mối kết nối với Cổng DVCQG (Bộ, tỉnh) Bắt buộc 20 MaDonViC2 String - Mã cấp II quan, tổ chức sở, ngành, quận, huyện TpHCM Bắt buộc 21 TenDonViC2 String Tên quan, tổ chức sở, ngành, quận, huyện TpHCM Bắt buộc 22 MaDonViC3 String - Mã cấp III quan, tổ chức UBND phường, xã, thị trấn TpHCM Bắt buộc 23 TenDonViC3 String Tên quan, tổ chức UBND phường, xã, thị trấn TpHCM Bắt buộc 24 Version String Phiên chuẩn gói tin Bắt buộc Ví dụ: { "Thang": 1, "Nam":2019, "IsThang":true, "NhanTrongKy":10, "TonKyTruoc":5, "TongXuLy":11, "TongDaXuLy":6, "DaXuLyDungHen":3, "PhanTramDaXuLyDungHen":50, "DaXuLyTreHen": 0, "PhanTramDaXuLyTreHen": 0.0, "ChuaXuLy": 0, "PhanTramChuaXuLy": 0.0, "ChuaXuLyQuaHan": 0, "PhanTramChuaXuLyQuaHan": 0.0, TongChuaXuLy": 0, "GhiChu": "", "MaDonViC1":"03.99.H29", "TenDonViC1": "", "MaDonViC2": "", "TenDonViC2": "", "MaDonViC3": "", "TenDonViC3": "", "Version": "v2.0" } II.CODE EXAMPLE Code mẫu Net - API Method Get - API Method POST Code mẫu java - API Method Get - API Method POST 10 11 ... CSDL DÙNG CHUNG CSDL TepTin CSDL MCDT Kiểm tra trả kết theo yêu cầu LGSP Trục tích hợp dịch vụ (LGSP) Kết trả từ LGSP API Đồng Thông kê tổng hợp ĐƠN VỊ Trang DVC ISO Các đơn đơn vị Phần mềm CN... JSON kết cho phần mềm đơn vị Thông tin kết nối Kiểu Diễn giãi Ví dụ Địa adapter trục Địa cổng dịch vụ dự kiến thức https://hcmesb .tphcm. gov.vn Địa adapter trục thử nghiệm Địa cổng dịch vụ thử... đến phần mềm đơn vị, khai thác đồng liệu từ CSDL tập trung thành phố - APIDongBoThongKeTongHop hỗ trợ phần mềm đơn vị kết nối vào trục LGSP Đồng liệu Thống kê tổng hợp từ đơn vị CSDL dùng chung