Set up PACS demo service

This article is valid for Smart ID 21.04 and later.

This article describes how to configure the Demo service that functions as a PACS simulator with Smart ID Physical Access component in Smart ID Identity Manager.

If Physical Access is being used with the Demo service, all administration of Users, Access Tokens and Entitlements (besides defining them) should be done in Identity Manager.

The Demo service is used to import entitlements (or access groups) from the AccessGroups.json file and export persons, cards and entitlement assignments from Physical Access to the Users.json file. For details on how data can be imported and exported from the demo access control system, see About import and export to Physical Access.

Prerequisites

The following prerequisites apply:

Physical Access and the PACS demo Docker container/service are installed. See Deploy Smart ID.
The message queue server must be running.

Configure Demo service data fields

The Demo service data is configured in the configuration table in the Physical Access database. All configuration is cached when the service starts so any configuration changes will require the service to be restarted in order to take effect.

Configure database

For information about how to connect to a PACS system, see Connect to a PACS system in PACS admin panel.

For information about group: messagingqueue, see Physical Access database - common parameters.

group: export

key

Data type

Required or Optional

Description

userfieldmappings

string

Optional

userfieldmappings is used to export additional data of user to the Demo Service and populate them in Users.json. The value is a combination of table_name.value_of_type_column, additionalFields fieldname in Demo Service. This configuration setting is the mapping between the Physical Access table field and Demo Service field Id.

User column fields can be sent by adding the configuration user.column_name, demo_field_id.

The following table shows sample configuration for userfieldmappings:

system	key	value	group	index
DEMO	userfieldmappings	user.title, additionalFields. title	export	0

group: demo.card.mapping.default

This group defines how to export card numbers by default, when a card’s layout does not have a specific mapping.

key	Data type	Required or Optional	Description
layoutIdentifier	string	Required	The name of the card layout to match (case insensitive) for this mapping. Each layout may only be mapped once.
cardNumberIdentifier	string	Optional	The default identifier type to read card numbers. Default: `mifare`
format	string	Optional	The format that the card number should be converted into before exporting it to the Demo service. Valid values: `Linear` Default: `Linear`
length	int	Optional	The length that the card number should be trimmed (leading digits) or padded (with leading zeroes) to after converting it. Default: 9

group: demo.card.mapping

This group contains compound configuration elements using the config_index column. For each unique config_index value in this group, each key defined below must be defined exactly once. Note that this group is not required as a whole, and should only be used if you have specific requirements for one or more card layouts.

key	Data type	Required or Optional	Description
layout	string	Optional	The name of the card layout to match (case insensitive) for this mapping. Each layout may only be mapped once.
cardNumberIdentifier	string	Optional	This indicates the identifier for card number.
format	string	Optional	The format that the card number should be converted into before exporting it to the Demo Service. Valid values: `Linear, Skip`.
length	int	Optional	The length that the card number should be trimmed (leading digits) or padded (with leading zeroes) to after converting it.

Example

Example configuration for card mapping settings:

system	key	value	group	index
DEMO	layout	Linear	demo.card.mapping	1
DEMO	cardNumberIdentifier	mifare	demo.card.mapping	1
DEMO	length	9	demo.card.mapping	1
DEMO	format	Linear	demo.card.mapping	1
DEMO	layout	skip	demo.card.mapping	2
DEMO	cardNumberIdentifier	mifare	demo.card.mapping	2
DEMO	length	9	demo.card.mapping	2
DEMO	format	skip	demo.card.mapping	2

Restart service

Restart the PACS Demo service:

Restart Physical Access Demo service

CODE

cd <SMARTIDHOME>/compose/physicalaccess
docker-compose restart smartid-pa-demo