Tài liệu đồng bộ hóa Prowatch XPressEntry

Tài liệu này nhằm hướng dẫn quản trị viên hệ thống cách đồng bộ hệ thống XPressEntry với hệ thống Honeywell Prowatch.

Điều kiện tiên quyết

Giả sử rằng bạn đã cài đặt Honeywell Prowatch và XPressEntry ở những nơi trên mạng mà chúng có thể nói chuyện với nhau (hoặc trên cùng một hộp)

Prowatch phải được cấp phép để sử dụng API Web

Bạn phải là Quản trị viên hoặc người dùng cấp cao trong hệ thống Prowatch.

API chỉ hỗ trợ Honeywell Prowatch v4.5 SP2 trở lên. Chúng tôi giả định rằng đã được cài đặt và sẵn sàng để tích hợp.

Để tích hợp vào các phiên bản Prowatch khác, vui lòng liên hệ với Telaeris để xác nhận khả năng tương thích.

Prowatch yêu cầu bạn phải cài đặt API Prowatch của họ. Liên hệ với đại diện Honeywell của bạn để biết thêm thông tin về cấp phép và cài đặt API Prowatch.

Prowatch 5.0 được hỗ trợ với bản dựng API 5.0.0.510. Đảm bảo rằng .NET framework 4.8 đã được cài đặt và kiểm tra phần Khắc phục sự cố để đảm bảo những dòng đó không có trong tệp .config.

Cài đặt Dịch vụ API Pro-Watch

(phần này được sao chép vô cớ từ tệp Pro-Watch_DTU_Service.pdf)

1. Tạo và sao chép tệp zip API Pro-Watch vào một thư mục bên dưới thư mục cài đặt Pro-Watch

2. Nếu nâng cấp từ phiên bản trước, hãy chạy tệp Uninstall_PW_DTU_Service.bat với tư cách quản trị viên để xóa Dịch vụ Pro-Watch DTU khỏi các dịch vụ Windows. Xóa phiên bản cũ.

3. Trong thư mục DTU Service bên dưới thư mục cài đặt Pro-Watch, hãy giải nén tất cả các tệp vào thư mục hiện tại.

4. Chỉnh sửa tệp PW-DTU-Service.exe.config tệp và đặt điểm cuối và phần ràng buộc. Dịch vụ DTU được mặc định sử dụng liên kết cơ bản HTTP không có bảo mật.

5. Chạy tệp Install_PW_DTU_Service.bat với tư cách quản trị viên. Điều này sẽ thêm một dịch vụ Windows có tên là ProWatch DTU Service.

6. Trong Dịch vụ Windows, nhấp chuột phải vào Dịch vụ Pro-Watch DTU và chọn Thuộc tính.

7. Chọn tab 'Đăng nhập' và thêm tài khoản người dùng vào dịch vụ có quyền truy cập vào máy chủ Pro-Watch và cơ sở dữ liệu Pro-Watch.

Lưu ý: Tài khoản Dịch vụ DTU phải có quyền truy cập vào cơ sở dữ liệu Pro-Watch trong SQL Server, là người dùng hợp lệ trong Pro-Watch và có quyền truy cập Pro-Watch vào máy trạm / máy chủ đó. Tài khoản tương tự được sử dụng cho Pro-Watch có thể và được đề xuất sử dụng cho dịch vụ Pro-Watch DTU. Khi sử dụng tài khoản dịch vụ, vui lòng chạy lệnh sau để đặt trước URL (như được chỉ định trong tệp cấu hình API).

Mẫu: Netsh http thêm urlacl url = http: // tên máy: 8734 / pwapi user = DOMAINaccountname

8. Trong Dịch vụ Windows, khởi động Dịch vụ Pro-Watch DTU.

Định cấu hình API Prowatch

Để Đồng bộ hóa API hoạt động bình thường, chúng tôi cần thiết lập hai API trong Prowatch.

API SOAP và SignalR.

4 khóa sau cần được đặt trong tệp PW-DTU-WinService.exe.config

Lưu ý rằng nếu bạn đang cài đặt XPressEntry trên một máy khác với API, bạn sẽ cần thay đổi “localhost” thành “tên máy của bạn” trong các khóa này.

(phần này cũng được sao chép vô cớ từ tệp Pro-Watch_DTU_Service.pdf)

Cho phép người dùng Pro-Watch

1. Trong Pro-Watch, chọn Cấu hình cơ sở dữ liệu
2. Chọn người dùng hoặc lớp học
3. Chỉnh sửa hoặc tạo người dùng sẽ kết nối với Dịch vụ Pro-Watch DTU.
4. Chọn tab Chương trình
5. Mở rộng cấu hình cơ sở dữ liệu
6. Chọn 'Định nghĩa Người dùng'
7. Nhấp vào nút 'Thêm chức năng'
8. Thêm 'Bật mật khẩu web'
9. Lưu bản ghi Người dùng hoặc Lớp. Bây giờ 'Mật khẩu Web' cho Người dùng sẽ được bật.
10. Nhập 'Mật khẩu Web' và lưu hồ sơ Người dùng.

Quyền Người dùng

Cần có các Quyền tối thiểu sau ở cấp người dùng API trong Prowatch:

Quản trị -> Tiện ích Truyền dữ liệu -> Sự kiện Sự cố chỉ cần thiết nếu chúng tôi đang gửi các hoạt động tới Prowatch

Quản trị -> Tiện ích truyền dữ liệu -> Đăng ký sự kiện chỉ cần thiết nếu chúng tôi đang sử dụng API SignalR

Đồng thời đảm bảo rằng người dùng API có một nhóm định tuyến có thêm Máy trạm Prowatch 'dtuservice'. Điều này là bắt buộc để SignalR hoạt động.

Đây là những yêu cầu bắt buộc vì XPressEntry thực hiện các lệnh gọi sau qua API:

• Số phát hành
• Nhận diện tích người sử dụng
• GetCompiances
• Nhận các loại huy hiệu
• Nhận khu vực
• GetLogDevsByHWClass hoặc GetLogicalDevicesAll
• GetClparentCodes
• GetClparentCodesLD
• Truy vấnHuy hiệuPaging
• GetBadgeBlob hoặc GetBadgePhoto

Nếu bạn muốn gửi sự kiện vào Prowatch, bạn sẽ cần thiết lập Kênh / Bảng điều khiển / Người đọc làm trình giữ chỗ để nhận các sự kiện từ XPressEntry.

Đối với mỗi thiết bị cầm tay vật lý, chúng ta nên thiết lập hai đầu đọc thiết bị logic (IN / OUT) trong Prowatch.

Nếu chúng tôi chỉ làm Mustering, bạn chỉ cần một thiết bị logic cho mỗi thiết bị cầm tay.

Bạn có thể làm điều đó như thế này:

Cấu hình phần cứng -> Thêm kênh

Chọn PW-5000 / PW6000

Đặt tên cho nó, sau đó nhấp vào Tiếp theo, Tiếp theo và sau đó Kết thúc (các tùy chọn không quan trọng vì chúng tôi chỉ sử dụng kênh và bảng này làm trình giữ chỗ cho các sự kiện của người đọc).

Chỉ kiểm tra “Đã cài đặt” ban đầu. Chọn TimeZone ngay bây giờ.

Tiếp theo, chúng tôi sẽ thêm một Bảng điều khiển vào Hệ thống Prowatch.

Trong Cấu hình phần cứng, Nhấp chuột phải vào Bảng và chọn Mới -> Bảng điều khiển

Chọn Trang web và Kênh.

Chọn loại Bộ điều khiển PW-5000 hoặc PW-6000.

Nhấn Tiếp theo và thêm PW5000 2R cho mỗi Thiết bị cầm tay thực hiện Nhập / Thoát.

Sau đó nhấn Kết thúc.

Bây giờ chúng ta cần thêm Trình đọc thiết bị logic vào Bảng điều khiển.

Trong Cấu hình phần cứng, nhấp chuột phải vào Người đọc và chọn Mới -> Thiết bị logic

Chọn đúng Panel mà chúng tôi vừa tạo

Đặt Mẫu phần cứng thành DoorTypical ACR (Access Control Reader) hoặc Entry / Exit Reader Door.

Sau đó, nhấn Tiếp theo và Chọn (các) cổng cho (các) đầu đọc. Nếu bạn đang sử dụng Cửa đầu đọc Entry / Exit, điều này sẽ tự động ghép nối hai thiết bị logic cho Entry / Exit.

Nếu không có, hãy quay lại bảng điều khiển và thêm một cổng đầu đọc.

Sau đó nhấn Kết thúc

Khi bạn hoàn tất, hãy bỏ chọn hộp kiểm Đã cài đặt trong Bảng điều khiển.

Mã thông quan

Thêm người đọc vào Mã thông quan thích hợp nếu chúng tôi đang thực hiện Nhập / Xuất cảnh

Để làm điều đó, hãy chuyển đến Cấu hình cơ sở dữ liệu -> Mã xóa.

Chọn Khoảng trống thích hợp để thêm người đọc vào hoặc thêm người mới

Lưu ý rằng điều này không cần thiết nếu chúng tôi chỉ thực hiện Mustering.

Thêm thiết bị logic vào các khu vực

Tiếp theo, bạn cần đảm bảo rằng trình đọc Prowatch hiện tại và trình đọc XPressEntry của bạn được ánh xạ tới các Khu vực trong Prowatch đúng cách.

Điều này được thực hiện từ Cấu hình cơ sở dữ liệu -> Khu vực

Thêm hoặc Chọn các khu vực bạn muốn người đọc vào / ra. Nhấp vào Thiết bị logic ở bên trái, sau đó nhấp vào Trình đọc ở giữa. Sau đó, sử dụng mũi tên phải để di chuyển thiết bị. Nhấp vào X vào / ra để đặt thiết bị có đưa người dùng vào / ra hay không

Tiếp theo sẽ là thiết lập XPressEntry để đồng bộ hóa dữ liệu từ Prowatch. Tất cả điều này được quản lý từ bên trong ứng dụng máy chủ XPressEntry trong Công cụ -> Cài đặt -> Trình quản lý dữ liệu

Ở trên cùng, hãy chọn Bật trình quản lý dữ liệu rồi đặt Loại thành Prowatch DTU

Xác định tính năng Trình quản lý dữ liệu nào bạn muốn sử dụng với Prowatch

1. Gửi hoạt động
2. Nhận các hoạt động
3. Số người ở
4. Bao gồm các tính năng cụ thể cho trình quản lý dữ liệu

Đây là những gì các tùy chọn làm:

Kéo các Hoạt động của Trình quản lý Dữ liệu vào XPressEntry:

Khi SignalR được bật, điều này sẽ thêm các sự kiện từ Prowatch vào XPressEntry dưới dạng các hoạt động huy hiệu.

Đẩy các hoạt động XPressEntry vào Trình quản lý dữ liệu:

Điều này sẽ sử dụng Kênh / Bảng / Người đọc ở trên để gửi hoạt động vào Prowatch.

Công suất người quản lý dữ liệu kéo

Điều này đồng bộ hóa Người chiếm đóng khu vực từ Prowatch với XPressEntry.

Xem bảng qua sự kiện phần mềm

Điều này cho phép mảnh sự kiện SignalR

Vai trò mặc định

Vai trò mặc định để gán cho Huy hiệu (người dùng) khi đồng bộ hóa người dùng từ Prowatch.

Không đồng bộ hóa

Được sử dụng để đảm bảo chỉ có một đồng bộ hóa (Toàn bộ, Một phần, Chiếm chỗ, Hoạt động) đang chạy tại bất kỳ thời điểm nào. Không cần thiết cho sự tích hợp này.

Đồng bộ hóa hoạt động ngay

Chạy quá trình Đồng bộ hóa hoạt động. Đối với Prowatch, điều này sẽ Kéo tỷ lệ sử dụng VÀ gửi các hoạt động đến người quản lý dữ liệu ngay lập tức. Điều này là không cần thiết, nhưng đã được sử dụng trong các phiên bản trước của Trình quản lý dữ liệu Prowatch.

Đồng bộ hóa công việc ngay

Đồng bộ hóa những người cư ngụ trong khu vực từ Prowatch vào XPressEntry. Cần thiết cho Mustering.

Bạn nên đặt điều này thành 5 phút một lần. Điều này sẽ "bắt kịp" bất kỳ hoạt động nào bị bỏ lỡ nếu một trong hai dịch vụ ngoại tuyến trong một khoảng thời gian đáng kể.

Đồng bộ hóa một phần ngay bây giờ

Điều này đồng bộ hóa tất cả dữ liệu không phải của người dùng. Điều này bao gồm Bảng / Người đọc / Cơ quan / Công ty, v.v.

Đồng bộ hóa hoàn toàn ngay

Điều này chạy Đồng bộ hóa một phần và cũng đồng bộ hóa dữ liệu người dùng

Tùy chọn trình quản lý dữ liệu cụ thể của Prowatch

Tiếp theo, bạn nên nhấn vào nút lớn "Thiết lập Trình quản lý dữ liệu" ở trên cùng bên phải.

Thao tác này sẽ đưa bạn đến các tùy chọn Trình quản lý dữ liệu cụ thể của Prowatch.

Những điều sau đây là bắt buộc:

IP máy chủ (và cổng nếu bạn đã thay đổi), Người dùng và Mật khẩu

Kiểm tra “Sử dụng khu vực Prowatch / LogDevs làm cửa cho người ở” nếu bạn đang thực hiện theo dõi quản lý hoặc chiếm dụng.

Nếu bạn KHÔNG thực hiện Nhập / Thoát, hãy chọn hộp kiểm “Không có Dữ liệu Nhóm”.

Nếu bạn muốn sử dụng SignalR, hãy đặt Người dùng sự kiện (có thể giống với người dùng API) và Máy trạm sự kiện (đây là máy trạm từ Prowatch cho dịch vụ XPressEntry).

Bạn có thể ánh xạ các trường từ Huy hiệu Prowatch đến Người dùng XPressEntry bằng các Cột Nguồn / Đích ở bên trái (đừng quên nhấn vào nút dấu cộng màu xanh lục)

Bạn có thể chọn Khu vực Prowatch mà chúng tôi thực sự đang theo dõi Tỷ lệ chiếm giữ ở dưới cùng bên phải. Lưu ý rằng chúng sẽ chỉ xuất hiện sau khi Đồng bộ hóa một phần đã được thực hiện. Mặt thực tế của điều này có nghĩa là bạn cần phải vào đây, thiết lập mọi thứ, sau đó ra ngoài và nhấn Đồng bộ hóa một phần Bây giờ, sau đó quay lại đây để thiết lập Khu vực sử dụng.

Phần còn lại của các tùy chọn là tự giải thích nhưng tất cả có thể được để trống / bỏ chọn nếu nghi ngờ.

“Kiểm tra kết nối” sẽ cho bạn biết liệu API đã được kết nối (nhưng không phải SignalR)

Nhấn OK khi hoàn tất và sau đó nhấn “Lưu” trên trang Trình quản lý dữ liệu.

Nếu SignalR đang hoạt động, bạn sẽ thấy một cái gì đó như sau:

ĐỘNG TỪ: Không có lỗi trong ProwatchDataManager khi StartWatchingTables

THÔNG TIN: Đã bắt đầu đăng ký sự kiện SignalR

Bạn nên chạy Đồng bộ hóa một phần trước để có được tất cả Người đọc / Khoảng trống / Khu vực được đồng bộ hóa và thiết lập.

Sau khi bạn đã thiết lập dữ liệu đó trong XPressEntry, hãy chạy Đồng bộ hóa đầy đủ.

Trước khi thực hiện việc này, hãy đảm bảo rằng bạn đã thực hiện Đồng bộ hóa một phần với hệ thống Prowatch

Các khu vực Prowatch sẽ được ánh xạ vào bảng XPressEntry Zones.

Đối với mỗi khu vực mà bạn muốn theo dõi công suất sử dụng, bạn cần thực hiện những việc sau.

1. Đảm bảo rằng "Khu vực nằm ngoài" và "Khu vực là một điểm Muster" được bỏ chọn
2. Đảm bảo rằng “Khu vực là Khu vực nguy hiểm” được chọn

Đối với Muster Point, chúng phải ngược lại.

Xử lý sự cố chiếm dụng

Nếu những người cư ngụ không hiển thị trong Khu vực trong XPressEntry, có một số điều cần kiểm tra.

1. Kiểm tra xem Kênh bạn đang sử dụng trong Prowatch đã được thêm vào Nhóm định tuyến cho người dùng chưa
2. Đảm bảo rằng bạn có các thiết bị hợp lý được chỉ định cho các Khu vực trong Prowatch
3. Trong XPressEntry, hãy đảm bảo các vùng được thiết lập và chọn như trên. Nếu cả 3 hộp kiểm được đặt, khu vực này sẽ không theo dõi sức chứa!
4. Đảm bảo rằng các tùy chọn của Trình quản lý dữ liệu cho “Kéo dài vị trí quản lý dữ liệu” và “Bảng xem qua sự kiện phần mềm” được chọn.
5. Đảm bảo Cửa trong XPressEntry được thiết lập đúng cách. (đặc biệt nếu bạn không chọn “Sử dụng các khu vực Prowatch / LogDevs làm cửa cho người ở” trong biểu mẫu Thiết lập trình quản lý dữ liệu Prowatch.

Trước khi thực hiện việc này, hãy đảm bảo rằng bạn đã thực hiện Đồng bộ hóa một phần với hệ thống Prowatch

Doors

Các cửa được ánh xạ trực tiếp từ các khu vực và thiết bị logic trong Prowatch. Chúng chỉ được tạo tự động nếu các thiết bị được gán cho một Khu vực trong Prowatch. Nếu không, bạn CÓ THỂ tạo Cửa cục bộ và tự lập bản đồ cho chúng.

Nếu chúng tôi đã làm mọi thứ một cách chính xác, chúng tôi sẽ không phải làm gì nhiều ở đây. Chỉ cần xác minh rằng các cánh cửa chúng tôi có sẽ di chuyển mọi người Ra / vào các khu vực đúng cách.

Cách đọc những điều này là Vùng bắt đầu sẽ là nơi bạn đến TỪ khi quét Mục nhập trên thiết bị cầm tay và Vùng kết thúc sẽ là nơi bạn sẽ ĐẾN trong quá trình quét Mục nhập. Chúng được đảo ngược đối với các lần quét Thoát.

Các trường Bên ngoài Entry / Exit Reader phải khớp với Thiết bị logic mà chúng tôi đã thiết lập trong Prowatch

Độc giả

Người đọc được ánh xạ trực tiếp từ các thiết bị logic trong Prowatch.

Nếu múi giờ cho các thiết bị và múi giờ cho máy chủ khác nhau, bạn sẽ cần thực hiện một số thiết lập bổ sung.

Đầu tiên, bật tùy chọn “Hiển thị múi giờ của trình đọc” trong Công cụ -> Cài đặt -> Chung -> Thêm / Chỉnh sửa Hiển thị

Sau đó, đặt Múi giờ của người đọc trong phần Thêm / Chỉnh sửa thông tin -> Người đọc -> Thiết bị cầm tay cho từng thiết bị ở một múi giờ khác nhau.

Cuối cùng, nếu bạn đang sử dụng các thiết bị cho Mustering và muốn các hoạt động tập hợp được gửi đến Prowatch, hãy đặt tùy chọn “External Muster Reader” cho từng thiết bị cầm tay.

Tại thời điểm này, bạn sẽ có thể tiếp tục với các tùy chọn Hồ sơ người đọc XPressEntry tiêu chuẩn để thiết lập thiết bị của mình.

Nếu bạn gặp các lỗi sau:

---Exception Message--------------------------
System.ServiceModel.FaultException`1[System.ServiceModel.ExceptionDetail]
The type initializer for 'HoneywellAccess.ProWatch.PWLogger.Log' threw an exception.
---Exception Stack Trace----------------------

Theo dõi ngăn xếp máy chủ:
tại System.ServiceModel.Channels.ServiceChannel.ThrowIfFaultUnd hiểu (Trả lời tin nhắn, lỗi MessageFault, hành động chuỗi, phiên bản MessageVersion, lỗi FaultConverterConverter)
tại System.ServiceModel.Channels.ServiceChannel.HandleReply (hoạt động ProxyOperationRuntime, ProxyRpc & rpc)
tại System.ServiceModel.Channels.ServiceChannel.Call (String action, Boolean oneway, ProxyOperationRuntime operation, Object [] ins, Object [] outs, TimeSpan timeout)
tại System.ServiceModel.Channels.ServiceChannelProxy.InvokeService (IMethodCallMessage methodCall, ProxyOperationRuntime hoạt động)
tại System.ServiceModel.Channels.ServiceChannelProxy.Invoke (tin nhắn IMessage)

Bạn cần truy cập và chỉnh sửa tệp PW-DTU-WinService.exe và nhận xét hai dòng sau:

<add name="Rolling Flat File Trace Listener" />
<add name="Event Log Trace Listener" />

Và bằng cách loại bỏ chúng hoặc bao quanh chúng bằng phần bình luận XML:

<!--<add name="Rolling Flat File Trace Listener" />
<add name="Event Log Trace Listener" /> -->