Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...


Info

This article is valid for Smart ID 21.04 and later.

...

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

keyData typeRequired or OptionalDescription
userfieldmappings stringOptional

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:

systemkeyvaluegroupindex
DEMOuserfieldmappingsuser.title, additionalFields. titleexport0

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.

keyData typeRequired or OptionalDescription
layoutIdentifierstringRequiredThe name of the card layout to match (case insensitive) for this mapping. Each layout may only be mapped once.

cardNumberIdentifier 

stringOptional

The default identifier type to read card numbers.

Default: mifare

format

stringOptional

The format that the card number should be converted into before exporting it to the Demo service.

Valid values: Linear

Default: Linear

length

intOptional

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.

keyData typeRequired or OptionalDescription

layout

stringOptionalThe name of the card layout to match (case insensitive) for this mapping. Each layout may only be mapped once.

cardNumberIdentifier

stringOptionalThis indicates the identifier for card number.

format

stringOptional

The format that the card number should be converted into before exporting it to the Demo Service.

Valid values: Linear, Skip.

lengthintOptionalThe 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

keyvaluegroupindex
DEMOlayoutLinear

demo.card.mapping

1
DEMOcardNumberIdentifiermifare

demo.card.mapping

1
DEMOlength9demo.card.mapping1
DEMOformatLineardemo.card.mapping1
DEMOlayoutskipdemo.card.mapping2
DEMOcardNumberIdentifiermifaredemo.card.mapping2
DEMOlength9demo.card.mapping2
DEMOformatskipdemo.card.mapping2

...

Restart service

...



Restart service

Restart the PACS Demo service:

Code Block
titleRestart Physical Access Demo service
cd <SMARTIDHOME>/compose/physicalaccess
docker-compose restart smartid-pa-demo