Identicard PremiSys Documentation

1.Tujuan #

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

Dokumen ini membuat beberapa asumsi:

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

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 Synchronizer Setup #

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 Aktifkan Sinkronisasi #

Dari halaman utama XPressEntry, masuk ke 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;
Database=Cardholders;Trusted_Connection=yes;

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.Tab Pengelola Data #

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 #

Atur Frekuensi Pembaruan ke sesering yang Anda inginkan agar sistem memperbarui. Perhatikan bahwa hanya satu pembaruan dapat berjalan pada satu waktu dan jika nilai ini sangat rendah, sistem akan terus mencoba memperbarui (ini tidak selalu menjadi masalah).

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.Tingkat Log #

Pilih Tingkat Log yang diinginkan. Saat mengatur sistem, SQL adalah Tingkat Log yang disarankan. Setelah sistem selesai dan berfungsi sesuai keinginan, KRITIS harus menjadi Level Log default.

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

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.Izinkan Pengeditan Data Eksternal #

Jika Anda ingin dapat mengedit data ini untuk alasan apa pun setelah disinkronkan, Anda dapat melakukannya dengan pengaturan pada tab pengaturan utama:

xpressentry external data

4.2.Pembaca #

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.

Ada dua tipe pembaca di XPressEntry, pembaca fisik dan logis.

4.2.1.Pembaca Fisik #

Pembaca fisik dalam sistem XPressEntry adalah perangkat genggam atau perangkat lain yang diatur untuk berkomunikasi dengan server. Ini secara unik diidentifikasi oleh bidang GUID untuk perangkat.
Sangat sering seorang pembaca fisik akan memiliki nama yang panjang / tidak masuk akal seperti: 570069006E00430045000000-00-008703124863. Pembaca ini menggunakan GUID sebagai nama default untuk perangkat setelah mereka disinkronkan.


xpressentry readers identicard

4.2.2.Pembaca logis #

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.Menggabungkan Pembaca Fisik / Logika #

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.

Catatan: Proses ini tidak dapat diubah!
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. Tekan "Lakukan Merge".

Catatan: Proses ini tidak dapat diubah!

Jika Anda tidak tahu GUID dari pembaca yang Anda gabungkan, pembaca GUID tersedia di perangkat genggam pada halaman Setup di bawah tab "More".

4.3.Profil Pembaca #

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

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.

Pengguna "Memasuki" pintu dari Zona Awal -> End Zone. Pengguna "Keluar" pintu dari Zona Akhir -> Mulai Zona

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

XPressEntry memiliki dua jenis zona. Zona “luar” digunakan untuk menghimpun dan mewakili area di luar lokasi XPressEntry sedang melacak. Semua zona lain dianggap sebagai bagian dari sistem. Penghapusan hanya dilacak untuk pengguna yang berada di zona non-luar.

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

Sarankan Sunting