
19 of 27
5 Advanced Configuration
5.1 Configuring Swipe Card Readers
At the time of this writing, Konica Minolta devices only support the following reader types:
1. RFIDeas pcProx® Plus
Swipe cards contain numbers used to identify users according to the card number
configured in the User Details screen under “Card/Identity” number. Some readers report
information in addition to the number encoded on the card, such as checksums. PaperCut
can treat these cases in three ways:
Card Number Needs No Conversion
A typical case is the checksum being reported after the card number, separated by
an equals sign, such as 5235092385=8. PaperCut can handle this case by default; it
will extract the number before the equal sign as the card number: 5235092385.
Regular Expression Filters
For some cases, a “regular expression” may be required that will filter the card
number from the complete string of characters reported by the card reader.
Documentation on regular expressions can be found on the Internet, e.g. at
www.regular-expressions.info.
oThe regular expression must be fashioned so the card number is returned as
the first match group.
oUsually one regular expression will be used for all the devices managed by
PaperCut. This must be entered in “Config editor (advanced)” which is located
on the “Options” tab under “Actions”. The key is called “ext-device.card-no-
regex”.
oAdditionally, the global setting can be overridden on a per-device basis: The
key “ext-device.card-no-regex” can also be found on the “Advanced Config”
tab in the device details screen. This setting will override the global setting
unless the keyword “GLOBAL” is specified.
oPaperCut developers will gladly assist in producing a regular expression
when supplied with a few sample outputs from your card reader. Please
contact PaperCut support.
oIf you would like to write your own regular expressions, here are some
examples:
Use the first 10 characters (any character): (.{10})
Use the first 19 digits: (\d{19})
Extract the digits from between the two “=” characters in
“123453=292929=1221”: \d*=(\d*)=\d*
Card Number Format Converters
In addition to extracting parts of the card numbers using regular expressions, converting
numbers from one format to another is a common requirement. For example a card reader
may report in hexadecimal format, while the number stored in the source (e.g. Active
Directory) is in a decimal format. PaperCut includes a number of inbuilt converters to assist
Copyright © 2019 KONICA MINOLTA BUSINESS SOLUTIONS U.S.A., INC. All Rights Reserved 06/2019