Configure Digital Signage

Configuration files ..\parameter\client\dcc.properties

Images for item entry and item information

It is possible to display item images in the item entry and item information. Digital Signage is responsible for loading these images.

Use the following file name convention:

<Item number/Main EAN>.<Image format>

The file dcc.properties is used for configuration of the image formats.

Displaying images

To display item images, set the configuration of Digital Signage in the file dcc.properties accordingly:

DccConfig.itemImageLoadingStrategy=MainPosItemId
 DccConfig.multipleItemImagesLoadingStrategy=DirectoryName;FileName
 DccConfig.server.url=http://192.168.100.62:8080/app-dsg/content/iep/
DccConfig.server.endpointItem=iep/
DccConfig.server.endpointDirectory=dep/
DccConfig.server.timeoutConnection=30000
DccConfig.server.timeoutSocket=30000
DccConfig.client.active=true
DccConfig.client.lifoQueue=true
DccConfig.client.corePoolSize=3
DccConfig.client.maximumPoolSize=5
DccConfig.cache.root=./media
DccConfig.cache.repository.item=image/item
DccConfig.cache.repository.itemExtension=jpg
DccConfig.cache.repository.location.0=./media/image/item
 DccConfig.cache.repository.location.1=./media/image/slide_show
DccConfig.cache.repository.location.2=./media/video
DccConfig.cache.repository.location.3=./media/image/customer
DccConfig.cache.repository.location.4=./media/image/icon
DccConfig.cache.repository.location.5=./media/dynamic_help
 DccConfig.cache.repository.location.6=./media/image/advices/promotions
 DccConfig.cache.repository.location.7=./media/image/advices/hints
DccConfig.cache.repository.location.8=./media/image/currency
DccConfig.cache.repository.expirationTime.0=24
...
DccConfig.cache.repository.canClear.0=true

The following table contains the descriptions of the parameters:

Parameter Description
DccConfig.itemImageLoadingStrategy Defines how an image of an item will be loaded.

Therefore, the parameter contains a list of loading strategies to be used to load the item image. The following loading strategies are supported:

  • MainPosItemId - file name must match the main pos item id
  • ItemId - file name must match the item id

The loading strategies are separated by a semicolon and they are processed in the given order. If no corresponding item image is found then it will take the next one from the list.

DccConfig.multipleItemImagesLoadingStrategy Defines how multiple item images (e.g. in item info) will be loaded.

Therefor the parameter contains a list of loading strategies that should be used to load the item images. The following loading strategies are supported:

  • DirectoryName - it loads the complete directory the name of which corresponds to MainPosItemId/ItemId (depends on the parameter itemImageLoadingStrategy)
  • FileName - it loads the image the name of which corresponds to MainPosItemId / ItemId (depends on the parameter itemImageLoadingStrategy)

The loading strategies are separated by a semicolon and they are processed in the given order. If no corresponding directory / item image is found then it will take the next one from the list.

The parameter will only be considered by OneX clients. In addition, it requires ItemInfoConfigs.Default.condensed=true to be considered in the item info process.

DccConfig.server.url Defines the URL for HTTP communication with the Digital Signage Server (DSG).
DccConfig.server.endpointItem Fetching service of DC Resource.
DccConfig.server.endpointDirectory Query service for determination of the directory.
DccConfig.server.timeoutConnection Maximum time interval for receiving the return value corresponding to the server query (in milliseconds).
DccConfig.server.timeoutSocket Socket timeout
DccConfig.client.active Enabling the Digital Signage Client. If the value is set to false, Digital Signage Client will not be used on the POS Client.
DccConfig.client.corePoolSize Number of threads kept in the pool even if free.
DccConfig.client.maximumPoolSize Maximum number of threads.
DccConfig.cache.repository.item Relative path of the path configured in <DccConfig.cache.root>.
DccConfig.cache.repository.itemExtension

File extension of item image files. The following image formats are allowed: JPG, GIF, PNG

A separate directory is configured for each type of media files. Each directory has its own configuration.

DccConfig.cache.repository.location.x Relative/absolute path on local hard disk.
DccConfig.cache.repository.expirationTime.x Time in h after which the files/directories on the POS are considered as obsolete. If new ones exist on the DSG, the old files/directories on the POS are replaced by the current ones from the DSG.
DccConfig.cache.repository.canClear.x All directories are checked after POS Client startup. If this parameter is true, any files/directories considered as obsolete will be deleted.
Note:
The media files must be located in the WebDAV of the DSG. Access is possible at http://[IP]:8070/dcs-server/webdav.