Konica Minolta bizhub 28e bizhub 28e PaperCut IU Embedded Manual - Page 20

Advanced Configuration

Page 20 highlights

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. o The regular expression must be fashioned so the card number is returned as the first match group. o Usually 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-noregex". o Additionally, 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. o PaperCut developers will gladly assist in producing a regular expression when supplied with a few sample outputs from your card reader. Please contact PaperCut support. o If 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 19 of 27 Copyright © 2019 KONICA MINOLTA BUSINESS SOLUTIONS U.S.A., INC. All Rights Reserved 06/2019

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28

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
.
o
The regular expression must be fashioned so the card number is returned as
the first match group.
o
Usually 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”.
o
Additionally, 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.
o
PaperCut developers will gladly assist in producing a regular expression
when supplied with a few sample outputs from your card reader. Please
contact PaperCut support.
o
If 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 © 201
9
KONICA MINOLTA BUSINESS SOLUTIONS U.S.A., INC. All Rights Reserved
06/2019