Skip to main content
Skip table of contents

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.