Identicard PremiSys Documentation

1.Punt #

This document is intended to instruct the user on how to synchronize an XPressEntry mobile access control system with a Identicard Premisys access control system.

This integration allows you to add XPressEntry handheld readers to the Premisys system for the purposes of Entry/Exit and Mustering. Access Rights will be used from the Premisys system and mirrored in the XPressEntry system.

1.1.Veronderstellingen #

Dit document maakt een paar veronderstellingen:

  1. The reader is familiar with XPressEntry systems and terminology. Basic setup and usage of XPressEntry can be found in the main XPressEntry manual.
  2. The Identicard Premisys installation is installed and functional. The user understands how to add Cards, Controllers, Readers and Access Groups to the Premisys system.

1.2.Installatie #

We will not cover installation of either XPressEntry or Premisys here. Refer to the appropriate manual for those installations.

2.Premisys Setup #

2.1.Premisys Server Version #

In order for the XPressEntry integration with Premisys to work properly, Premisys needs to be using at least version 2.16.3650

2.2.Is Premisys Running? #

In order for XPressEntry to send events to Premisys, the Premisys Service has to be running. Under Services this is the “IDenticard Windows Service”

2.3.Telaeris XPressEntry Controller and Readers #

On Version 2.16.3650+ of Premisys, you should be able to add a “Telaeris Controller” and at least two “Telaeris Readers” to Premisys. This should be done before continuing with the rest of the installation.

3.XPressEntry Data Manager Synchronisatie instellen #

XPressEntry gets data from Premisys through SQL Server. It pushes activities back into Premisys through an API running in the Premisys service. From the XPressEntry side, this is done by a module called Data Manager. This section will describe how to set up and get the Data Manager running for Premisys.

3.1.XPressEntry Synchronisatie inschakelen #

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

xpressentry synchronization identicard

3.2.SQL Import / Export Tab #

The first thing to do is install the Premisys SQL Import. This is done from the Menu bar on the Settings form. Click Import -> “Load Import Settings”. Select the file, installed by default to “C:\Program Files (x86)\Telaeris\XPressEntry\Imports\PremisysXPEImportSettings.sql”.

You can check that the imports were installed by loading the SQL Import / Export Tab and seeing if Cardholders, Premisys and Premisys Occupancies imports are installed.

You may have to modify the connection string for each import. In particular, you might have to change the Server section of the connection string:
Driver={SQL Server Native Client 10.0};Server=IDENTICARDVM\GCSSQLEXPRESS;

Change the bolded section to the SQL Server location for your installation. You can check that the connection can be established by pressing “Run Test Query”.

3.3.Gegevensbeheer Tab #

From the Settings Page Select the Data Manager Tab.

From the ‘Type’ Combo Box, select “IDENTICARD”.

Check the “Enable Data Manager” checkbox.

Check the “Send XPressEntry Activities to Data Manager” checkbox.

xpressentry settings identicard

Then Press the “Setup Data Manager” button.

There are three Imports to select here. Select each with the appropriate name. You also need to enter the Premisys Password for the Telaeris API in the Premisys system. Press Test Connect.
If Test Connect fails, the specific error message in the Status label should indicate where the test went wrong.

When filled out, the form should look similar to this:

xpressentry data manager set up identicard premisys

3.3.1.Update Frequencies #

Stel de Update Frequency in zo vaak in als u wilt dat het systeem wordt bijgewerkt. Merk op dat slechts één update tegelijk kan worden uitgevoerd en als deze waarde erg laag is, zal het systeem constant proberen bij te werken (dit is niet altijd een probleem).

Only the Activity and Full Sync Updates are available for the Premisys Data Manager. Set the Activity Update to a rather low frequency (I suggest 10 seconds). Set the Full Sync Update to a higher value (1-10 minutes).

3.3.2.Log niveau #

Selecteer het gewenste logniveau. Bij het instellen van het systeem is SQL het voorgestelde logniveau. Zodra het systeem is opgestart en functioneel is zoals gewenst, moet CRITICAL het standaard logniveau zijn.

IMPORTANT: You MUST press the “Save and apply settings” button for any data manager changes to take effect!

After you’ve saved, you can press the “Full Sync Now”button to synchronize XPressEntry with Premisys. Make sure you’ve set the synchronization update frequency on the main Data Manager tab.

When the Data Manager is set up and running, it should look something like this:

xpressentry data manager set up

4.XPressEntry-gegevens instellen #

Once the Premisys System is set up and synchronizing, you will see the Card data represented in XPressEntry under the Add/Edit Info tab. Data which is imported from Premisys cannot be changed by default and is grayed out/read-only.

4.1.Sta het bewerken van externe gegevens toe #

Als u deze gegevens om welke reden dan ook wilt kunnen bewerken nadat deze zijn gesynchroniseerd, kunt u dat doen met de instelling op het tabblad met de hoofdinstellingen:

xpressentry external data

4.2.Lezers #

The list of Readers used for Premisys integration should be pulled during the synchronization. You can set up your readers to have one or many different configurations at a given time. This is done by selecting a Reader Profile for the reader.

Er zijn twee soorten lezers in XPressEntry, fysieke en logische lezers.

4.2.1.Fysieke lezers #

Een fysieke lezer in het XPressEntry-systeem is een handheld of een ander apparaat dat is ingesteld om met de server te communiceren. Het wordt uniek geïdentificeerd door het GUID-veld voor het apparaat.
Heel vaak heeft een fysieke lezer een lange / onzinnige naam zoals: 570069006E00430045000000-00-008703124863. Deze lezers gebruiken de GUID als de standaardnaam voor het apparaat nadat ze zijn gesynchroniseerd.

xpressentry readers identicard

4.2.2.Logische lezers #

Logical readers are readers in the system which are usually placeholders for physical readers. When setting up the system, these will be the readers synchronized by XPressEntry.

xpressentry reader name identicard premisys

4.2.3.Fysieke / logische lezers samenvoegen #

In order for Muster or Verification Activities to be sent to Premisys, we require the logical reader from Premisys to be merged with the physical reader from XPressEntry. All permission checks at this reader will be done using the Premisys permissions for that reader. It is suggested that you merge the “Entry” reader from each pair of Premisys readers with your physical reader.

If a handheld(physical) reader is only going to be used for Mustering or Verification, you can merge the logical and physical readers without any problems.

Opmerking: dit proces is onomkeerbaar!
To merge the logical and physical readers do the following:

  1. Select the Logical Reader(from Premisys) from the Add/Edit Info Readers tab
  2. Under “Merge with Physical Reader”, select the physical reader as identified by its name (typically the GUID) from the drop-down list “Reader Name”. You might consider renaming these to identify which reader you are merging.
  3. Druk op "Samenvoegen uitvoeren".

Opmerking: dit proces is onomkeerbaar!

Als u de GUID van de exacte lezer die u aan het samenvoegen bent niet kent, is de lezer-GUID beschikbaar op het handheld-apparaat op de Setup-pagina onder het tabblad "Meer".

4.3.Lezer Profielen #

All readers in the XPressEntry system need a reader profile set up for them. These can be shared across readers with identical responsibilities. See the main XPressEntry manual for more information. For Premisys installations, there are two main things we want to ensure.

  1. Under General, make sure just the “Readers” Validation methods checkbox is checked.
  2. Check all of the User Modes you want to enable. We suggest a setup like the one below:

reader profiles general tab

4.4.Deuren #

Doors are portals from one zone to a zone. They are a logical way to move from one zone to another. They are primarily used by XPressEntry for handhelds in Entry/Exit mode.

Gebruikers die een deur "binnengaan" gaan vanuit de startzone -> eindzone. Gebruikers die een deur "verlaten" gaan van de eindzone -> startzone

Premisys Readers are created in Pairs. You should ensure that you create a Door for each pair of Entry/Exit readers we have imported from Premisys. These should look similar to the following:

xpressentry doors tab

Note that the “External Entry/Exit Reader” are set to the paired readers from the Premisys system.

4.5.Zones #

XPressEntry heeft twee soorten zones. "Buiten" -zones worden gebruikt voor het verzamelen en representeren van het gebied buiten de locatie die XPressEntry volgt. Alle andere zones worden als onderdeel van het systeem beschouwd. De bezettingsgraad wordt alleen bijgehouden voor gebruikers die zich in niet-buitengebieden bevinden.

There are two default zones in XPressEntry, Building and Outside. These can safely be deleted if you want to just use the Access Areas from Premisys. If you do this, make sure you have a Premisys area to represent “Outside” as this is the area used to muster users.

xpressentry zones tab

Stel Bewerken voor