Đồng bộ và tích hợp
Trên trang này
Tính năng đồng bộ tự động sao chép người từ các hệ thống khác của bạn vào Users, nhờ đó quyền truy cập cửa luôn khớp với dữ liệu từ nguồn bên ngoài mà không cần nhập thủ công. Trang này đề cập đến ba nguồn đồng bộ, đồng bộ nhân viên Performance Hub, thông tin định danh, Access Time Windows do nguồn sở hữu, độ mới của dữ liệu và ánh xạ phạm vi, việc gỡ bỏ, xử lý trùng lặp, bảng hoạt động đồng bộ, lời mời và xóa hàng loạt. Mọi cấu hình đều nằm trong Settings → Sync settings.
Đồng bộ Performance Hub staff được bật theo mặc định. Đồng bộ từ tích hợp và Computer Vision tắt theo mặc định để các cơ sở hiện có giữ nguyên danh sách được quản lý thủ công; không có gì được đồng bộ từ các nguồn này cho đến khi bạn bật nguồn đó.
Các nguồn đồng bộ


Hình 1: Sync settings
| Nguồn | Nội dung được sao chép | Huy hiệu nguồn của người dùng |
|---|---|---|
| Performance Hub staff | Người dùng Performance Hub có vai trò bao gồm cơ sở này | Performance Hub staff |
| Integrations | Hội viên và, khi được hỗ trợ, các Access Time Windows do nguồn sở hữu từ các tích hợp đã kết nối | Integration / tên của đối tác |
| Performance Hub features (CCTV/Computer Vision) | Những người đã được nhận dạng từ mô-đun CCTV | CCTV/Computer Vision |
Mỗi khối có công tắc bật riêng và hiển thị thời điểm chạy gần nhất cùng các số liệu (hoặc Never run).
Đối với nguồn Integrations, bạn cũng có thể chọn bật hoặc tắt từng tích hợp trong Sync from these integrations — "Turn off an integration to stop mirroring its people. People already synced stay until you remove them." Show all integrations mở rộng toàn bộ danh sách.
Yêu cầu thông tin định danh
Người dùng đăng nhập vào ứng dụng di động bằng mã dùng một lần được gửi đến điện thoại hoặc email của họ, vì vậy một bản ghi không có cả hai thông tin này sẽ vô dụng đối với việc truy cập cửa. Danh sách thả xuống Require identifier kiểm soát những bản ghi nào được đồng bộ:
| Tùy chọn | Bản ghi được đồng bộ |
|---|---|
| Email OR phone (mặc định) | Có email hoặc số điện thoại |
| Email required | Có email |
| Phone required | Có số điện thoại |
| Both required | Có cả hai |
Những bản ghi không đáp ứng yêu cầu sẽ bị bỏ qua (và hiển thị trong bảng hoạt động đồng bộ là bị bỏ qua do thiếu thông tin định danh).
Ánh xạ Access Time Window và độ mới của nguồn
Mỗi tích hợp cung cấp Access Time Windows có các cài đặt riêng:
- Access Time Window mapping — "Map each partner scope key to facility doors or Access Scopes. Unknown and unmapped keys fail closed." Mỗi tích hợp có thể có tối đa 50 ánh xạ, bao gồm khóa
default. Thêm khóa trong Add partner scope key. - Source freshness policy — một cài đặt an toàn: "Choose how old a partner snapshot may be before all of its windows fail closed." Hãy đặt giá trị này khớp với tần suất mà tích hợp cam kết gửi bản cập nhật, để các khung thời gian từ một tích hợp đã ngừng cập nhật không tiếp tục cấp quyền truy cập.
Xem Ảnh chụp nhanh Access Time Window để biết cách các khung thời gian từ tích hợp được cập nhật.
Nhân viên Performance Hub


Hình 2: Nguồn Performance Hub staff
"Anyone whose Performance Hub roles cover this facility is added to Users automatically and kept in step with Performance Hub IAM." Ví dụ: nhân viên cửa hàng của một chuỗi bán lẻ được quyền vào cửa khu vực hậu cần mà không cần ai thêm họ thủ công.
- Nhân viên (người dùng Performance Hub) được đồng bộ với các thẻ Performance Hub staff, Role: … (mỗi vai trò một thẻ) và, đối với quản trị viên tổ chức, Organisation admin.
- Một Access Policy Performance Hub staff có thể chỉnh sửa được tạo một lần cho mỗi cơ sở và cho phép thẻ đó đi qua mọi cửa vào bất kỳ lúc nào. Thẻ thông tin cho biết chính sách có đang hoạt động hay không, kèm Edit policy. Chỉnh sửa hoặc tắt chính sách này như mọi Access Policy khác.
- Vai trò cho biết những vai trò nào được bao gồm. Các vai trò cần bao gồm hoặc loại trừ do quản trị viên tổ chức đặt trong Organisation Settings; các quản trị viên khác sẽ thấy "Ask an organisation admin to change this in Organisation Settings."
- Khi tắt đồng bộ, hệ thống sẽ yêu cầu xác nhận ("Turn off Performance Hub staff sync?").
Thông tin chi tiết của nhân viên được quản lý trong Performance Hub IAM và chỉ có thể xem trong Users. Để chấm dứt quyền truy cập cửa của một nhân viên, hãy xem Users → Performance Hub staff.
Thời điểm đồng bộ chạy
| Trình kích hoạt | Thời điểm |
|---|---|
| Continuous | Các thay đổi về nhân viên Performance Hub và các thay đổi được đẩy từ những tích hợp đã kết nối thường được đồng bộ theo thời gian thực |
| Daily full sync | "A full reconcile also runs automatically every day to catch any inconsistencies." Next full sync cho biết thời điểm lần tiếp theo sẽ chạy |
| Sync now | Nút trên trang này lấy dữ liệu mới nhất từ các tích hợp của bạn, sau đó đối chiếu vào Users — nút hiển thị Running… rồi Sync complete (hoặc Sync failed) |
Những gì đồng bộ cập nhật — và những gì đồng bộ không bao giờ thay đổi
Ở mỗi lượt, các hàng được đồng bộ sẽ được làm mới từ nguồn:
| Bị ghi đè sau mỗi lần đồng bộ | Được giữ nguyên (do quản trị viên sở hữu) |
|---|---|
| Tên, họ | Công tắc Access enabled |
| Số điện thoại di động, email | Additional permanent access |
| Loại người, trạng thái hội viên | Custom tags |
| Các thẻ được đồng bộ | Notes |
| Dấu thời gian đồng bộ gần nhất | Trạng thái tách rời, tin nhắn trong ứng dụng |
| Access Time Windows do nguồn sở hữu của nguồn đó | Quyền cấp vĩnh viễn và Access Time Windows do quản trị viên sở hữu |
Vì vậy, bạn có thể yên tâm vô hiệu hóa một người dùng được đồng bộ, cấp quyền cho họ hoặc gắn thẻ cho họ — đồng bộ sẽ không hoàn tác những thay đổi đó.
Tách rời: khi tắt Track source updates trên bảng của một người dùng, đồng bộ sẽ bỏ qua hoàn toàn hàng đó — các chỉnh sửa về tên/thông tin liên hệ được giữ nguyên và việc gỡ bỏ từ nguồn không còn ảnh hưởng đến họ. Xem Người dùng.
Đối với nguồn cung cấp Access Time Windows, việc tách rời cũng xóa các khung thời gian của nguồn đó sau khi bạn xác nhận rõ ràng. Việc liên kết lại sẽ khôi phục chúng ở lần ảnh chụp nhanh đầy đủ thành công tiếp theo; việc này không khôi phục các khung thời gian được lưu trong bộ nhớ đệm từ một lần tải thất bại.
Gỡ bỏ
Khi một hội viên bị xóa trong tích hợp, quyền truy cập cửa của họ sẽ bị gỡ bỏ (Removed by integration). Hàng của họ trong Users không bị xóa, vì vậy lịch sử của họ được giữ lại.
Nếu một lần đồng bộ sắp gỡ bỏ số lượng người lớn bất thường cùng lúc, các lượt gỡ bỏ đó sẽ được tạm giữ để xem xét (N removals held back for review). Các lượt gỡ bỏ do tích hợp thực hiện vượt quá giới hạn an toàn sẽ chờ quản trị viên xem xét trước khi áp dụng, vì vậy một lần lấy dữ liệu lỗi từ tích hợp không thể gỡ bỏ quyền truy cập của tất cả mọi người cùng lúc.
Ảnh chụp nhanh Access Time Window
Mỗi tích hợp chỉ cập nhật phân vùng nguồn của riêng mình. Bản cập nhật hội viên của tích hợp là một ảnh chụp nhanh khung thời gian đầy đủ, có số phiên bản tăng dần đơn điệu:
- Dữ liệu khung thời gian bị bỏ trống sẽ giữ nguyên ảnh chụp nhanh hiện tại của nguồn.
- Ảnh chụp nhanh mới hơn sẽ thay thế toàn bộ danh sách của nguồn đó.
- Cùng phiên bản và cùng nội dung đã chuẩn hóa được coi là phát lại lũy đẳng.
- Cùng phiên bản nhưng dữ liệu khác nhau là xung đột; phiên bản cũ hơn bị bỏ qua vì đã lỗi thời.
- Ảnh chụp nhanh trống mới hơn sẽ thu hồi rõ ràng các khung thời gian của nguồn đó.
- Một lần tải từ hệ thống nguồn bị thất bại hoặc không đầy đủ phải không gửi ảnh chụp nhanh nào, tuyệt đối không gửi ảnh chụp nhanh trống hoặc chỉ có một phần.
Mỗi scope_key ổn định của nguồn (bao gồm default) được ánh xạ tới các mục tiêu là toàn cơ sở, cửa hoặc Access Scope trong Ánh xạ Access Time Window. Với các ánh xạ không xác định hoặc đã bị tắt, quyền truy cập sẽ bị từ chối. Phần cài đặt cũng hiển thị tuổi của dữ liệu nguồn và chính sách độ mới nguồn của tích hợp.
Xử lý trùng lặp


Hình 3: Xử lý trùng lặp
"Khi hai người dùng chung một địa chỉ email hoặc số điện thoại, chỉ một người có thể đồng bộ hóa vào phần Người dùng. Hãy chọn người giữ vị trí; người còn lại sẽ được đánh dấu là xung đột và không được đồng bộ hóa."
- Prefer the active person — "A person with an active status always wins over an expired one. Turn off to apply the tiebreaker regardless of status."
- Tiebreaker — được dùng khi trạng thái không xác định được người được ưu tiên, ví dụ Oldest By Date Of Birth, Then Earliest Start Date.
Bản ghi còn lại hiển thị Not synced – duplicate trong Users và được tính vào ô Not synced. Ví dụ: một phòng khám có thể giữ một bản ghi duy nhất khi một bác sĩ vừa là nhân viên vừa là hội viên bệnh nhân.
Lời mời sử dụng ứng dụng tự động
Trong App invitations, Auto-send app invitations gửi email cho những người dùng được đồng bộ đủ điều kiện chưa nhận lời mời, và Advanced recipient rules có thể giới hạn những ai nhận được lời mời. Send invitations… gửi hàng loạt cho người dùng hiện có sau khi bạn xem lại danh sách người nhận. Xem chi tiết đầy đủ trong Lời mời sử dụng ứng dụng.
Hoạt động đồng bộ và khắc phục sự cố
Mở rộng Sync activity & troubleshooting để "see why recent records did or did not sync." Bạn có thể tìm kiếm theo tên, ID hoặc lý do, và nhấn Refresh để làm mới danh sách. Mỗi mục có một huy hiệu kết quả:
| Kết quả | Ý nghĩa |
|---|---|
| Added | Một hàng mới đã được tạo trong Users |
| Updated | Một hàng hiện có đã được làm mới từ nguồn |
| Skipped | Bản ghi không được đồng bộ — mục này cho biết lý do (bên dưới) |
| Disabled | Người này đã bị gỡ bỏ tại nguồn, vì vậy quyền truy cập của họ đã bị tắt |
| Processed | Bản ghi đã được xử lý mà không có thay đổi nào hiển thị |
| Stale snapshot | Một phiên bản Access Time Window cũ hơn đã bị bỏ qua để không ghi đè trạng thái mới hơn |
Các lý do bỏ qua bạn có thể gặp:
| Lý do bỏ qua | Cách khắc phục |
|---|---|
| Integration sync is turned off for this facility | Bật công tắc nguồn trên trang này |
| This integration is turned off in sync settings | Bật tích hợp đó trong "Sync from these integrations" |
| No phone or email on the record (a phone or email is required to log in) | Thêm thông tin liên hệ trong hệ thống nguồn hoặc nới lỏng Require identifier |
| Record is decoupled and managed manually | Đúng như dự kiến — liên kết lại bằng công tắc Track source updates của người dùng nếu bạn muốn đồng bộ trở lại |
| No facility on the source record | Bản ghi nguồn chưa được liên kết với cơ sở này trong hệ thống nguồn |
| No matching Users record | Thay đổi tham chiếu đến một người không có hàng nào ở đây (ví dụ: đã bị gỡ bỏ trước lần đồng bộ đầu tiên) |
| Unknown or unmapped scope key | Cấu hình ánh xạ scope_key của tích hợp; khung thời gian bị ảnh hưởng sẽ không cấp quyền truy cập |
| Access Time Window source is stale | Khôi phục việc gửi dữ liệu thành công từ nguồn và xem lại ngưỡng độ mới đã cấu hình; không xóa dựa trên một lần tải chưa được xác minh |
Nhấp vào một mục sẽ mở Sync activity detail với bản ghi đầy đủ: tên, ID bên ngoài, nguồn, tích hợp, lý do và các ID để chuyển lên bộ phận hỗ trợ.
Xóa hàng loạt người dùng được đồng bộ
Để xóa những người dùng đến từ một tích hợp (ví dụ: sau khi ngắt kết nối tích hợp đó), hãy sử dụng Bulk delete synced users. Bạn xem lại chính xác danh sách trước khi bất cứ thứ gì bị xóa.
- Trong Bulk delete synced users, nhấp vào Bulk delete…
- Chọn phạm vi: All integration-synced users hoặc một tích hợp duy nhất. Nhấp vào Preview.
- Xem lại: hộp thoại cho biết chính xác số người dùng sẽ bị gỡ bỏ (kèm danh sách mẫu). Lưu ý cảnh báo — This cannot be undone, và mọi tùy chỉnh của quản trị viên trên các hàng đó (quyền cấp, thẻ tùy chỉnh, ghi chú) sẽ bị mất. Lịch sử nhật ký truy cập của người dùng được giữ lại.
- Also turn off syncing from this integration (recommended) được chọn theo mặc định — hãy giữ nguyên, nếu không chính những người dùng đó sẽ được tạo lại ở lượt đồng bộ tiếp theo (mà không có các tùy chỉnh cũ).
- Đánh dấu I understand this is permanent and customisations will be lost, sau đó nhấp vào Delete N.
Nếu tập người dùng bên dưới thay đổi giữa lúc xem trước và lúc xác nhận, bạn sẽ được yêu cầu chạy lại bước xem trước — điều này đảm bảo bạn xóa đúng những gì bạn đã xem lại.
Trang liên quan
- Người dùng — nguồn, tách rời, bảng người dùng
- Lịch của Access Policy — lịch và các cài đặt Access Time Windows
- Lời mời sử dụng ứng dụng
- Khắc phục sự cố — hướng dẫn từng bước cho trường hợp "người dùng bị thiếu / không cập nhật"