Synchronisatie en integraties

Synchronisatie neemt mensen uit je andere systemen automatisch over in Users, zodat deurtoegang de gegevens van externe bronnen volgt zonder handmatige invoer. Deze pagina behandelt de drie synchronisatiebronnen, de synchronisatie van Performance Hub-medewerkers, identificatoren, Access Time Windows die eigendom zijn van de bron, actualiteit en bereiktoewijzing, verwijderingen, het oplossen van duplicaten, het paneel met synchronisatieactiviteit, uitnodigingen en bulkverwijdering. Je stelt alles in onder Settings → Sync settings.

Synchronisatie van Performance Hub staff staat standaard aan. Synchronisatie vanuit integraties en Computer Vision staat standaard uit, zodat bestaande faciliteiten hun handmatig beheerde lijst behouden; er wordt niets uit die bronnen gesynchroniseerd totdat je de bron inschakelt.

Synchronisatiebronnen

Afbeelding 1: Sync settings

Elk blok heeft een eigen schakelaar om het in te schakelen en toont het tijdstip van de laatste uitvoering en de aantallen (of Never run).

Voor de bron Integrations kun je ook afzonderlijke integraties in- of uitschakelen onder Sync from these integrations: "Turn off an integration to stop mirroring its people. People already synced stay until you remove them." Show all integrations klapt de volledige lijst uit.

Identificator vereisen

Mensen melden zich aan bij de mobiele app met een eenmalige code die naar hun telefoon of e-mail wordt gestuurd, dus een record zonder een van beide is onbruikbaar voor deurtoegang. De vervolgkeuzelijst Require identifier bepaalt welke records worden gesynchroniseerd:

Records die niet aan de vereiste voldoen, worden overgeslagen (en verschijnen in het paneel met synchronisatieactiviteit als overgeslagen wegens een ontbrekende identificator).

Toewijzing van Access Time Windows en actualiteit van de bron

Elke integratie die Access Time Windows levert, heeft eigen instellingen:

• Access Time Window mapping: "Map each partner scope key to facility doors or Access Scopes. Unknown and unmapped keys fail closed." Elke integratie kan maximaal 50 toewijzingen hebben, inclusief de sleutel default. Voeg een sleutel toe onder Add partner scope key.
• Source freshness policy: een veiligheidsinstelling: "Choose how old a partner snapshot may be before all of its windows fail closed." Stel deze in op hoe vaak de integratie belooft updates te sturen, zodat vensters van een integratie die niet meer bijwerkt geen toegang blijven verlenen.

Zie Snapshots van Access Time Windows voor hoe vensters van integraties worden bijgewerkt.

Performance Hub-medewerkers

Afbeelding 2: De bron Performance Hub staff

"Anyone whose Performance Hub roles cover this facility is added to Users automatically and kept in step with Performance Hub IAM." Zo krijgen de winkelmedewerkers van een winkelketen toegang tot de deur van het magazijn zonder dat iemand ze handmatig toevoegt.

• Medewerkers (Performance Hub-gebruikers) worden gesynchroniseerd met de tags Performance Hub staff, Role: … (één per rol) en, voor organisatiebeheerders, Organisation admin.
• Per faciliteit wordt eenmalig een bewerkbare Access Policy Performance Hub staff aangemaakt, die die tag op elk moment door elke deur toelaat. De kaart toont of het beleid actief is, met Edit policy. Bewerk of schakel het uit zoals elke Access Policy.
• Roles toont welke rollen zijn opgenomen. Welke rollen worden opgenomen of uitgesloten, stelt een organisatiebeheerder in via Organisation Settings; andere beheerders zien "Ask an organisation admin to change this in Organisation Settings."
• Bij het uitschakelen van de synchronisatie wordt om bevestiging gevraagd ("Turn off Performance Hub staff sync?").

Gegevens van medewerkers worden beheerd in Performance Hub IAM en zijn alleen-lezen in Users. Zie Users → Performance Hub staff om de deurtoegang van een medewerker te beëindigen.

Wanneer synchronisatie wordt uitgevoerd

Wat synchronisatie bijwerkt, en wat nooit wordt aangeraakt

Bij elke ronde worden gesynchroniseerde rijen vanuit de bron vernieuwd:

Je kunt een gesynchroniseerde gebruiker dus veilig uitschakelen, machtigingen geven of taggen: synchronisatie maakt dat niet ongedaan.

Ontkoppelen: als je Track source updates uitschakelt in het paneel van een gebruiker, slaat de synchronisatie die rij volledig over. Wijzigingen in naam en contactgegevens blijven behouden, en verwijderingen bij de bron hebben geen invloed meer. Zie Users.

Voor een bron die Access Time Windows levert, wist ontkoppelen ook de vensters van die bron, na een uitdrukkelijke bevestiging. Opnieuw koppelen herstelt ze bij de volgende geslaagde volledige snapshot; vensters uit de cache van een mislukte ophaalactie worden niet hersteld.

Verwijderingen

Wanneer een lid in de integratie wordt verwijderd, wordt de deurtoegang van die persoon ingetrokken (Removed by integration). De rij in Users wordt niet verwijderd, zodat de geschiedenis behouden blijft.

Als een synchronisatie in één keer ongewoon veel mensen zou verwijderen, worden die verwijderingen in plaats daarvan tegengehouden voor controle (N removals held back for review). Verwijderingen door een integratie boven een veiligheidsgrens wachten tot een beheerder ze heeft gecontroleerd voordat ze worden toegepast, zodat een foutieve ophaalactie van een integratie niet in één keer bij iedereen de toegang kan intrekken.

Snapshots van Access Time Windows

Elke integratie werkt alleen haar eigen bronpartitie bij. De ledenupdate is een volledige snapshot van vensters met monotoon oplopende revisies:

• Ontbrekende venstergegevens laten de huidige bronsnapshot ongewijzigd.
• Een nieuwere snapshot vervangt de volledige lijst van die bron.
• Dezelfde revisie met dezelfde genormaliseerde payload is een idempotente herhaling.
• Dezelfde revisie met andere gegevens is een conflict; een oudere revisie wordt als verouderd overgeslagen.
• Een nieuwere lege snapshot trekt de vensters van die bron uitdrukkelijk in.
• Een mislukte of onvolledige ophaalactie bij de bron mag geen snapshot sturen, nooit een lege of gedeeltelijke.

Elke stabiele scope_key van de bron (inclusief default) wordt onder Access Time Window mapping toegewezen aan doelen voor de hele faciliteit, een deur of een Access Scope. Onbekende of uitgeschakelde toewijzingen geven geen toegang. De instellingen tonen ook de leeftijd van de bron en het actualiteitsbeleid van de integratie.

Duplicaten oplossen

Afbeelding 3: Duplicaten oplossen

"Wanneer twee personen een e-mailadres of telefoonnummer delen, kan er slechts één worden gesynchroniseerd naar Gebruikers. Kies wie de plek behoudt; de andere wordt gemarkeerd als conflict en niet gesynchroniseerd."

• 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: wordt gebruikt wanneer de status geen winnaar bepaalt, bijvoorbeeld Oldest By Date Of Birth, Then Earliest Start Date.

Het andere record toont Not synced – duplicate in Users en wordt meegeteld in de tegel Not synced. Een zorgkliniek kan zo bijvoorbeeld één record behouden wanneer een behandelaar zowel medewerker als lid-patiënt is.

Automatische app-uitnodigingen

Onder App invitations stuurt Auto-send app invitations een e-mail naar in aanmerking komende gesynchroniseerde gebruikers die nog geen uitnodiging hebben ontvangen, en met Advanced recipient rules kun je beperken wie ze ontvangt. Send invitations… verstuurt uitnodigingen in bulk naar bestaande gebruikers nadat je de lijst met ontvangers hebt gecontroleerd. Alle details staan in Uitnodigingen.

Synchronisatieactiviteit en probleemoplossing

Klap Sync activity & troubleshooting uit om te "see why recent records did or did not sync." Je kunt zoeken op naam, ID of reden, en de lijst vernieuwen met Refresh. Elke vermelding heeft een label met het resultaat:

Redenen voor overslaan die je kunt zien:

Als je op een vermelding klikt, wordt Sync activity detail geopend met het volledige record: naam, externe ID, bron, integratie, reden en ID's voor escalatie naar support.

Gesynchroniseerde gebruikers in bulk verwijderen

Gebruik Bulk delete synced users om gebruikers op te ruimen die uit een integratie kwamen (bijvoorbeeld nadat je die hebt losgekoppeld). Je controleert de exacte lijst voordat er iets wordt verwijderd.

1. Klik onder Bulk delete synced users op Bulk delete…
2. Kies het bereik: All integration-synced users of één integratie. Klik op Preview.
3. Controleer: het dialoogvenster toont precies hoeveel gebruikers worden verwijderd (met een voorbeeldlijst). Let op de waarschuwing: This cannot be undone, en alle aanpassingen van beheerders aan die rijen (machtigingen, aangepaste tags, notities) gaan verloren. De geschiedenis in de toegangslogboeken van de gebruikers blijft behouden.
4. Also turn off syncing from this integration (recommended) is standaard aangevinkt. Laat dit aan staan, anders worden dezelfde gebruikers bij de volgende synchronisatieronde opnieuw aangemaakt (zonder hun eerdere aanpassingen).
5. Vink I understand this is permanent and customisations will be lost aan en klik daarna op Delete N.

Als de onderliggende set gebruikers tussen het voorbeeld en de bevestiging is gewijzigd, wordt je gevraagd het voorbeeld opnieuw uit te voeren. Zo verwijder je gegarandeerd precies wat je hebt gecontroleerd.

Gerelateerde pagina's

• Users: bronnen, ontkoppelen, het gebruikerspaneel
• Schema’s voor Access Policies: schema's en de instellingen voor Access Time Windows
• Uitnodigingen
• Problemen oplossen: stappenplannen voor "gebruiker ontbreekt / is verouderd"