Open opties Documentatie

1.Punt #

This document is intended to instruct users on how to synchronize Telaeris’ XPressEntry system with Open Option’s DNA Fusion access control system. In doing so, XPressEntry creates a mobile platform for performing personnel entry/exit, verification, emergency evacuations.

2.Voorwaarden #

Before beginning the integration, the installer should obtain a license for the Flex API from their Open Options provider. Optionally, the installer should obtain a certificate from a certificate authority if they plan on implementing the API over SSL.

This document also assumes the installer has some familiarity with DNA Fusion

3.Flex API Setup #

It is assumed that Flex API is installed and configured to look at the DNA Fusion Database.

3.1.Create a Flex API Key #

xpressentry open options create a flex api key

Create a Flex API Key for the use of the XPressEntry server.

  1. Select the + shown in the square above.
  2. Provide a name and description for the entry.
  3. Copy the API Key to be used in XPressEntry Setup

Additionally, check your bindings for http or https. The port set in bindings will be required by XPressEntry Setup. If the binding that you require does not exist, create one.

4.Configuring DNA Fusion #

4.1.Handhelds #

To properly link XPressEntry handhelds to DNA Fusion, placeholder reader records should be added to DNA Fusion. These placeholder records may be disabled and are only used to logically represent the work that the handhelds perform.

Telaeris handhelds can be added to existing Sites, Channels, and Controllers. For the sake of this documentation, we will walk through the process of adding a handheld, beginning with a new Channel.

4.2.Hardware Channel #

Begin by opening the “Hardware Browser” in DNA Fusion. Right click on the site where your handhelds will be deployed. Select “Add Channel”.


xpressentry open options hardware channel

Give the channel a description that represents it is used for logical Telaeris Handhelds. All other settings are not required as this channel will only represent logical devices.

4.3.Hardware Controller #

Next, add a controller to the logical channel by right clicking on the channel and selecting Add SSP.


xpressentry open options hardware controller

Give the controller a description and set the controller to disabled because there is no physical controller. This controller will be used to add logical handhelds in the system only.

Once the controller has been added, Access Areas and Readers can be added to the system. Readers are created through doors in DNA Fusion.

4.4.Access Areas #

Before configuring readers, the installer should configure the areas each door will lead to.

Right click on the “Access Areas” option under the controller. If access areas are not present in the hardware tree, it can be enabled by navigating to DNA>Administrative> Properties. Select Hardware Tree Behavior and check the box for Access Control Areas.

Next, add zones for each logical area the handhelds will move people between.


xpressentry open options access area

4.5.Lezers #

xpressentry open options door objects

Under “Door Objects”, configure the type of door this will be. If the handhelds will be used to track personnel In AND Out of an area, change the “Type” drop down to “In and Out”. For Entry or Exit only use, select Single.

*Important Note- if a reader is used as an “Exit” reader. It must contain “OUT” in the name in order for it to map to an exit reader in XPressEntry.

If you have configured access areas, navigate to the advanced tab under the door. Select the access areas in the “From” and “To” dropdowns as shown below.


xpressentry open options advanced

4.6.Andere velden #

In addition to Areas and Readers, the following fields are pulled by XPressEntry.

Cardholders
Badges
Afbeeldingen
groepen
Access Levels (Legacy)
Access Groups (Global)
Readers>Groups and Levels
Users>Groups and Levels

Additionally, XPressEntry pushes Access events back into DNA Fusion.

5.Synchronisatie inschakelen #

XPressEntry uses a module called “Data Manager” to access the Flex API.

Ga vanaf de hoofdpagina van XPressEntry naar XPressEntry / Settings (CTRL + S)


xpressentry open options enable synchronization

5.1.Algemeen tabblad #

Selecteer op de pagina Instellingen het tabblad Algemeen


xpressentry open options general tab

When setting up a Data Manager, it is important to set “Log Level” to “SQL”. This will allow you to see all logged entries when you sync. Select “Save Settings” after making this change. After setup is complete and the data synchronization is correct, it is suggested that you set “Log Level” to “Critical”. This will only log any errors that may appear.

5.2.Lezer Profieltab #

The Reader Profile Tab is where you configure the functionality of the handhelds. Please see the XPressEntry manual for further detail about the reader profiles tab.


xpressentry open options reader profile tab

The only important DNA Fusion related change to make on this tab is to set “Door Readers” as the only box that is checked under “Validation Methods”. Select “Save” at the top right when finished.

5.3.Gegevensbeheer Tab #

Selecteer op de pagina Instellingen het tabblad Gegevensbeheer


xpressentry open options data manager tab

  1. Type- This is the integration type. Select Open Options.
  2. Setup Data Manager- Sends you to the setup form for Open Option’s data manager.
  3. Instellingen opslaan en toepassen- Slaat alle instellingen op vanuit het setup-formulier, update frequenties en activiteit Synchronisatieopties.
  4. Frequentie-opties bijwerken: hiermee stelt u in en stelt u de intervallen in waarop de gegevensmanager XPressEntry bijwerkt.
  5. Directe synchronisatiefuncties - voert een onmiddellijke update uit.
  6. Activiteitsynchronisatieopties - Gebruikt om XPressEntry handheld-activiteiten naar Symmetry te verzenden.

Set the Update Frequency to as often as you want the system to update. Note that only one update can run at a time.

Er zijn drie verschillende soorten synchronisatie waarvoor u intervallen kunt instellen.

  1. Full Sync Update- This sync will grab all relevant records from DNA Fusion and update them in XPressEntry. If there is a large number of users in DNA Fusion, this sync option can take some time. It is suggested that large systems use a full sync once a day.
  2. Partial Sync Update- This sync will retrieve records that were updated since the last sync. This is valuable for quick updates throughout the day into the XPressEntry system.
    1. This sync will add or update any table in XPressEntry.
    2. This sync will not delete a user from XPressEntry who was deleted in DNA Fusion.
  3. Activity Sync Update- Use this sync to send XPressEntry Events to DNA Fusion. These events will show up as DNA Fusion Events. The “Activity Synchronizing” section contains two options.
    1. Sync Data Manager Activities with XPressEntry- This setting is not used with this integration. Last scan locations are automatically pulled from the badge record./li>
    2. Sync XPressEntry Activities to Data Manager – If you want the activities from the XPressEntry Handhelds to show up in DNA Fusion, you should check this option.

All of these options can be changed at any time. Changing any option will take effect upon selecting “Save and Apply Settings”.

5.4.Open Options Setup Page #

Press the “Setup Data Manager” button to get the Open Options specific setup screen.

xpressentry open options setup

  1. API Address- This is the server address of the API. Make sure the url prefix and bindings are specified.
  2. API Key- This is the key that was created in the Flex API Setup.
  3. Records Per Thread and Report Records Per-
    1. Downloading pictures is a process that must be done one at a time. Because of this, it can take substantial time to complete. Because of this, we can utilize multiple threads to work on this simultaneously.
      1. Records per Thread: XPressEntry will create enough threads so that each thread is responsible for this many pictures. If DNA Fusion has 1000 users and Records per Thread is set to 100, 10 threads will be created. Be cautious not to create too many threads, as it may impact performance if 100s of threads are created.
      2. Report Records Per: Determines how often the front end is notified about the progress of the picture, groups users, and groups readers downloads

Press “Test Connect” to verify connection to the Flex API. If successful, select “Okay” to exit the setup form. Select “Save And Apply Settings”. Next, select “Full Sync Now” to test your setting changes. The log view at the bottom will display the result of the sync, according to the log level set in the “General” tab.

6.XPressEntry-gegevens instellen #

Once XPressEntry is set up and synchronizing, you will see DNA Fusion data represented in XPressEntry under the Add/Edit Info tab. Data which is imported from Fusion cannot be changed from within XPressEntry and is greyed out.

6.1.Gebruikers #

Hier is een voorbeeld van een correct gesynchroniseerde gebruiker:


xpressentry open options users

6.2.Gebruikersrechten #

Users in XPressEntry have the same access to the Access Groups and Access Levels as they do in DNA Fusion. The example below shows one DNA Access Level and one DNA Access Group that Lisa has access to.


xpressentry open options user permissions

xpressentry open options dna fusion

6.3.Reader Groups #

Each Access Level and Access group is pulled from Fusion to XPressEntry, as well as the readers associated with it. The example below shows the mapping.

xpressentry open options reader groups dna fusion

xpressentry open options reader groups

6.4.Deuren #

Entry/Exit permissions in XPressEntry are set by doors. A door contains one or two readers for exit and entry. If access areas are configured in Fusion, they should also be configured in XPressEntry. The example below shows a door that has been pulled from DNA Fusion.


xpressentry open options doors
xpressentry open options doors dna fusion

6.5.Lezers #

In XPressEntry’s Open Options integration, it is not necessary to associate any reader in the system with a handheld. Instead, handhelds should be set to a door. It will then use the external exit and entry readers to verify access through the door.

A handheld unit can logically represent any reader in the building. For example, imagine that you have handheld A stationed at door A. Door A has two readers associated with it: Reader A-Entry and Reader A-Exit. The employee holding the handheld sets the handheld’s door to Door A. When the employee sees a cardholder walking towards the building, he sets the handheld to Entry mode and scans the cardholder’s badge. The handheld in entry mode identifies itself as reader A-Entry and sends an activity to the server.

Later is er zwaar volume dat deur B verlaat. Deur B heeft twee lezers eraan gekoppeld: Reader B-Entry en Reader B-Exit. De medewerker van deur A wordt geroepen om te helpen en brengt handheld A binnen. Hij zet de deur van zijn handheld op deur B en de modus op Exit. Wanneer hij mensen begint te scannen die de deur uit lopen, identificeert de rekenmachine zichzelf als Reader B-Exit en stuurt elke scan als een activiteit naar de server.

6.6.Activiteiten #

XPressEntry will synchronize activities to DNA Fusion if that option has been set by Data Manager.

Entry/Exit activities will be sent to the Events Manager in DNA Fusion. The user’s badge will be linked to the event record. There will also be, information about the access event.

  • Waar de badge werd gescand (bijv.
  • Wie is gescand
  • Tijd waarop de scan plaatsvond
  • Event Index of the scan
    • 72 for Access Granted
    • 73 for Access Denied (level)
    • 55 for Access Denied, Not in Card File
Stel Bewerken voor