Abrir Opciones Documentación

1.Propósito #

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.Requisitos previos #

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.Computadoras de mano #

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.Lectores #

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.Otros campos #

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

Cardholders
insignias
Imágenes
Grupos
Access Levels (Legacy)
Access Groups (Global)
Readers>Groups and Levels
Users>Groups and Levels

Additionally, XPressEntry pushes Access events back into DNA Fusion.

5.Habilitar la sincronización #

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

Desde la página principal de XPressEntry, vaya a XPressEntry / Settings (CTRL + S)


xpressentry open options enable synchronization

5.1.Pestaña General #

Desde la página de Configuración, seleccione la pestaña General


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.Ficha de perfil de lector #

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.Pestaña del administrador de datos #

Desde la página Configuración, seleccione la pestaña Administrador de datos


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. Guardar y aplicar configuración: guarda todas las configuraciones del formulario de configuración, las frecuencias de actualización y las opciones de sincronización de la actividad.
  4. Opciones de frecuencia de actualización: establece y borra los intervalos en los que el administrador de datos actualiza XPressEntry.
  5. Funciones de sincronización inmediata: ejecuta una actualización inmediata.
  6. Opciones de sincronización de actividad: se utiliza para enviar actividades de la computadora de mano XPressEntry a 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.

Hay tres tipos diferentes de sincronización para los que puede establecer intervalos.

  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.Configurar 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.usuarios #

Aquí hay una muestra de un usuario correctamente sincronizado:


xpressentry open options users

6.2.Permisos de usuario #

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.Puertas #

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.Lectores #

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.

Más tarde, hay un gran volumen que sale de la puerta B. La puerta B tiene dos lectores asociados: Reader B-Entry y Reader B-Exit. El empleado de la puerta A recibe una llamada para ayudar y trae la computadora de mano A. Pone la puerta de la computadora de mano en la puerta B y el modo en Salir. Cuando comienza a escanear personas que salen por la puerta, la computadora de mano se identifica como Reader B-Exit y envía cada escaneo como una actividad al servidor.

6.6.Actividades #

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.

  • Donde se escaneaba la placa (por ejemplo, Lector de entrada de puerta trasera)
  • Quien fue escaneado
  • Hora en que ocurrió el escaneo
  • Event Index of the scan
    • 72 for Access Granted
    • 73 for Access Denied (level)
    • 55 for Access Denied, Not in Card File
Sugerir Editar