Öppna alternativ Dokumentation

1.Köpa/Sälja/Hyra #

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.Förutsättningar #

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.hand~~POS=TRUNC #

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.Läsare #

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.Andra fält #

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

Cardholders
Märken
Bilder
Gruppresor
Access Levels (Legacy)
Access Groups (Global)
Readers>Groups and Levels
Users>Groups and Levels

Additionally, XPressEntry pushes Access events back into DNA Fusion.

5.Aktivera synkronisering #

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

På huvudsidan i XPressEntry, gå till XPressEntry / Settings (CTRL + S)


xpressentry open options enable synchronization

5.1.Fliken Allmänt #

På fliken Allmänt väljer du fliken Allmänt


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.Läsarprofilfliken #

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.Fliken Data Manager #

På fliken Inställningar väljer du fliken Datahanteraren


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. Spara och tillämpa inställningar - sparar alla inställningar från inställningsformen, uppdateringsfrekvenserna och aktivitetssynkroniseringsalternativen.
  4. Uppdateringsfrekvensalternativ - Ställer in och rensar de intervaller som datahanteraren uppdaterar XPressEntry.
  5. Omedelbara synkroniseringsfunktioner - Kör en omedelbar uppdatering.
  6. Aktivitetssynkroniseringsalternativ - Används för att skicka XPressEntry handhållna aktiviteter till Symmetry.

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

Det finns tre olika typer av synkronisering som du kan ställa in intervaller för.

  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.Installera XPressEntry Data #

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.användare #

Här är ett urval av en korrekt synkroniserad användare:


xpressentry open options users

6.2.Användarbehörigheter #

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.Dörrarna #

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.Läsare #

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.

Senare finns det tung volym som lämnar dörr B. Dörr B har två läsare förknippade med det: Reader B-Entry och Reader B-Exit. Medarbetaren från dörr A kallas för att hjälpa och ger handhållen A. Han ställer dörren på handenheten till dörr B och läget till Avsluta. När han börjar skanna människor som går ut ur dörren identifierar handenheten sig som Reader B-Exit och skickar varje skanning som en aktivitet till servern.

6.6.aktiviteter #

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.

  • Där märket skannades (ex. Back Door Entry Reader)
  • Vem skannades
  • Tid skanningen inträffade
  • Event Index of the scan
    • 72 for Access Granted
    • 73 for Access Denied (level)
    • 55 for Access Denied, Not in Card File
Föreslå Redigera