Pinnacle Data Exchange
User’s Guide
Sielox
170 East Ninth Avenue
Runnemede, NJ 08078
800-424-2126 Toll Free
856-939-9300 Phone
856-939-9309 Fax
www.sielox.com
© 2006-2010 – Sielox, LLC
Sielox and Pinnacle are trademarks of Sielox, LLC.
Certain product names mentioned herein may be
trade names and/or registered trademarks of other companies.
Sielox reserves the right to change product specifications.
Rev 3.1 – 05/21/2010
Pinnacle Data Exchange
Table of Contents
Overview......................................................................................................................................3
Pinnacle Data Exchange Functions: ......................................................................................3
Requirements..............................................................................................................................4
Installation...................................................................................................................................5
Pinnacle Data Exchange Files ...................................................................................................7
Configuration File ....................................................................................................................7
Header File ...............................................................................................................................9
Wildcards .................................................................................................................................9
List of Standard Fields: ......................................................................................................11
Data File..................................................................................................................................14
Output File..............................................................................................................................14
Manual Mode .............................................................................................................................16
Configuration Tab..................................................................................................................16
Results Tab ............................................................................................................................19
Scheduled Mode .......................................................................................................................23
Windows Scheduler...............................................................................................................23
Pinnacle Scheduler...................................................................................................................28
Command Line Parameters .....................................................................................................31
Use Cases .................................................................................................................................32
Appendix A – Result / Error Codes .........................................................................................34
User’s Guide
Pinnacle Data Exchange
Overview
Pinnacle Data Exchange is an application that allows third party systems to update the Pinnacle
cardholder database.
Basically, a third party system that can output a text file in the specified format and, in the
specified location, will make changes to the Pinnacle cardholder database. A transaction log file
will be created.
Such changes can be automatic, via Pinnacle Scheduler or Windows Scheduler.
You can also run Pinnacle Data Exchange Manually and perform the changes on the GUI.
Changes can be made to fields such as Name (Last , First and MI), Access Levels, Card Type,
Expiration and Activation Dates, Card Code, PIN, Hot Stamp, Image, Signature, and Custom
Fields.(See function table below)
Pinnacle
Database
3
3
Pinnacle
Data Exchange
Third Party
System
Database
2
1
Transactions
Log File
Text Delimited
Cardholder
Data File
Pinnacle Data Exchange Functions:
Add Creates a new cardholder or modifies the cardholder if it already exists. Assigns an
Access Level and issues a Card if such data is provided.
Delete Deletes the specified cardholder. No action if the cardholder does not exist.
Modify Updates the specified cardholder. Creates a new cardholder if it doesn’t already exist.
Sets all fields to the specified values but does not assign/revoke Access Levels nor
issue/return cards.
Assign Assigns a new Access Level to the specified cardholder; no action if the cardholder
does not exist. No other cardholder modifications are made.
Revoke Revokes an Access Level from the specified cardholder; no action if the cardholder
does not exist. No other cardholder modifications are made.
Issue Issues a Card to the specified cardholder; no action if the cardholder does not exist.
No other cardholder modifications are made.
Return Returns a Card for the specified cardholder; no action if the cardholder does not exist.
No other cardholder modifications are made.
Lost Lost Card for the specified cardholder; no action if the cardholder does not exist. No
other cardholder modifications are made.
User’s Guide
Page 3 of 35
Pinnacle Data Exchange
Requirements
Pinnacle Data Exchange requires Pinnacle version 6.1.85 or later. It does not work with versions
of Pinnacle prior to 6.1.85
Before you install and use the Pinnacle Data Exchange you need the following:
• Pinnacle Data Exchange is not compatible with Pinnacle version 5 or Pinnacle version
6.1.76. Pinnacle version 6.1.85 or later is required. (See Note)
• Have Installed and configured Pinnacle 6.1.85 or later.
• Make a backup of the Pinnacle Database!
• Purchased and install the Pinnacle Data Exchange license.
Note: To find out which version of Pinnacle you have installed, in Pinnacle go to Help->About.
User’s Guide
Page 4 of 35
Pinnacle Data Exchange
Installation
1. Locate the “Pinnacle Data Exchange.msi” on the Pinnacle 6 CD1 from the installation CD
set.
2. Double click on the “Pinnacle Data Exchange.msi” to start the installation and follow the
screen prompts.
3. Click “Next”.
4. Click “Next” to accept the destination folder, do not change the destination folder.
User’s Guide
Page 5 of 35
Pinnacle Data Exchange
5. Click “Next”
6. Click “Finish” to close the installation program
User’s Guide
Page 6 of 35
Pinnacle Data Exchange
Pinnacle Data Exchange Files
Pinnacle Data Exchange uses the following files:
•
•
•
•
Configuration File
Header File
Data File
Output File
Note: Before you begin using the Pinnacle Data Exchange make sure you backup your
Pinnacle data. Perform test runs on smaller data files to ensure they are imported
correctly in the Pinnacle database.
Configuration File
The configuration file is located in the “\Program Files\Pinnacle” subdirectory. It is a plain text file
with a “.cfg” extension. It includes the path of the Header, Data and Output File and other
information as described below.
The following items are included in the configuration file:
Pinnacle Data Exchange Configuration
Version 1.0
ConfigFilename=C:\Program Files\Pinnacle\PinnacleDataExchange\PDESample.CFG
DataFilename= C:\Program Files\Pinnacle\PinnacleDataExchange\PDESample.DAT
OutputDirectory= C:\Program Files\Pinnacle\PinnacleDataExchange
Username=MyUser
Password=621A9C99324FDE25
VerboseMode=True
ModifyAndAdd=True
ModifyActAndExp=True
ErrorColor=255
ModifyColor=12632256
NoneColor=65535
InformationColor=16777215
SuccessColor=65280
User’s Guide
Page 7 of 35
Pinnacle Data Exchange
Breakdown of the Configuration File:
Pinnacle Data Exchange Configuration – Title of File
Version 1.0 – Configuration File Version
ConfigFilename=C:\Program Files\Pinnacle\
PinnacleDataExchange\PDESample.CFG - Configuration Filename and Path
DataFilename= C:\Program Files\Pinnacle\
PinnacleDataExchange\PDESample.DAT – Data Filename and Path
OutputFilename= C:\Program Files\Pinnacle\DataFiles – Output Path
Username= MyUser – Pinnacle Username
Password=621A9C99324FDE25 – Encrypted Pinnacle Password
SilentMode=True – Suppress Output File
SilentMode=False– Create Output File
ModifyAndAdd=True – If a cardholder is NOT found in the Pinnacle database when
doing a Modify action, add the cardholder
ModifyAndAdd=False - If a cardholder is NOT found in the Pinnacle database
when doing a Modify action, DO NOT add the cardholder
ModifyActAndExp=True – Override the cardholder access level activation and
expiration dates
ModifyActAndExp=False – Do NOT override the cardholder access level activation
and expiration dates
Below are the RGB values for the colors that appear in the grid on the Results tab, when
running Pinnacle Data Exchange in Manual mode.
ErrorColor=255
ModifyColor=12632256
NoneColor=65535
InformationColor=16777215
SuccessColor=65280
User’s Guide
Page 8 of 35
Pinnacle Data Exchange
Header File
The header file is located in the “\Program Files\Pinnacle” subdirectory. It is a plain text file with
a “.hdr” extension that lists the field headers terminated by CR/LF (Carriage Return and Line
Feed). Field headers are not case sensitive. Pinnacle Data Exchange expects the header file
name to be the same as the data file name, except for the extension.
The following lines are included in a typical header file:
Pinnacle Data Exchange Header
Version 1.0
Lname|Fname|MI|Dorm|{CollegeID}|Action|ACL|ACLActivation|ACLExpiration
Title of the File: Pinnacle Data Exchange Header
Software Version: Version 1.0
Field Headers: Lname|Fname|MI|Dorm|{CollegeID}|Action|ACL|ACLActivation|ACLExpiration
All the fields are delimited by pipe “|”. Fields with curly braces “{ }” are used to determine the
selection criteria, in the example above we are selecting a specific custom field {CollegeID}.
Curly braces can only be used with cardholder custom fields* and they are optional.
Note: The data in the data file has to match the order of the fields in this header file, other
wise the wrong data will inserted in the wrong field!
* Note : The Custom Fields here are the same cardholder custom fields in Pinnacle and
have to be spelled out the same way they were defined in Pinnacle.
A “Custom Field” field header contained within curly braces (e.g. {EmployeeID}) will be
interpreted as the one used to select one or more cardholder records to be modified. If no
unique Custom Field is identified, the cardholder uniqueness will be determined by combining
FName, MI, and LName.
Wildcards
A percent (%) can be used as a wildcard; all cardholder records that fulfill the selection criteria
will be modified. The wildcard character ‘%’ is used to select a group of cardholders to act
upon. There are four fields where a percent sign can be used: LName, FName, MI, or Custom
Field.
User’s Guide
Page 9 of 35
Pinnacle Data Exchange
For example, if the header file is as follows:
Pinnacle Data Exchange Header
Version 1.0
Lname|Fname|MI|{Dorm}|Expiration|Action
And the data file looks like this:
|||L%|12/31/2010|Modify
Then all cardholders who have a ‘Dorm’ custom field value that begins with an ‘L’ will have their
expiration date on the General tab in the Cardholder Screen modified to become ‘December 31,
2010’.
Note: Only one custom field can be assigned the wildcard (%). If a custom field is not defined
via curly braces, the cardholder uniqueness will be determined by combining the FName, MI,
and LName. One or a combination of all three of these fields can contain a percent sign (%) or
a partial wildcard such as (L%).
For example, if the header file is as follows:
Pinnacle Data Exchange Header
Version 1.0
FName|MI|LName|ACL|ACLActivation|ACLExpiration|Action
And the data file looks like this:
L%|%|L%|Engineering|01/01/2007|12/31/2017|Modify
This row, when executed, will assign the Engineering Access Level with the given dates to
anyone in the system whose first AND last name begins with the letter L.
User’s Guide
Page 10 of 35
Pinnacle Data Exchange
List of Standard Fields:
Here is a description of the standard fields used in the creation of the header file. They
correspond to the standard fields in Pinnacle.
LName char(35) required, non-null
The cardholder last name is a required field of up to 35 characters in length and
cannot be null. If this field is not provided or if the value is NULL, the application
will generate an error and no cardholder record will be updated.
FName char(25)
The cardholder first name is an optional field of up to 25 characters in length.
MI char(1)
The cardholder middle initial is an optional field of one single character.
ACL char(50)
The Access Level assigned to the cardholder is an optional field of up to 50
characters in length. Only one Access Level can be assigned to or revoked from
the specified cardholder per entry in the data file.
ACLActivation char(10) MM/DD/YYYY default = TODAY
The Access Level activation date for the specified Access Level, it is an optional
field of up to 10 characters in length.
ACLExpiration char(10) MM/DD/YYYY default = ACLActivation + 5 yr
The Access Level expiration date for the specified Access Level, it is an optional
field of up to 10 characters in length.
CardType Int [0..6] default = 0
The Card Type is an optional field of one single character in length. The value
range is from 0 to 4. This is the type of card issued to the current cardholder:
0 = 26 - bit standard Wiegand or Sielox 33 bit Wiegand – 1 Access Level
1 = 26 - bit standard Wiegand or Sielox 33 bit Wiegand – 3 Access Levels
2 = 26 - bit standard Wiegand + PIN or Sielox 33 bit Wiegand + PIN
3 = ANSI Mag/Custom Wiegand
4 = HID Corp 1000 – 1 Access Level
5 = HID Corp 1000 – 3 Access Levels
User’s Guide
Page 11 of 35
Pinnacle Data Exchange
6 = HID Corp 1000 + PIN
CardCode char(12)
The Card Code ID is an optional field up to 12 characters in length, and it is
assigned to the cardholder. The card code ID field must be entered in hexadecimal
format.
PIN char(6)
The Personal Identification Number is an optional field up to 6 characters in length,
it is the cardholder PIN.
HotStamp char(50)
The Hot Stamp is an optional field up to 50 characters in length, it is the number
printed on the card by the card manufacturer.
Active char(1) Y/N default = Y
The Active is an optional field of one single character in length, it is the
cardholder’s status and the vales are:
Y = Yes (active).
N = No (not active).
Class char(50) default = Employee
The Class is an optional field of up to 50 characters in length.
Image char(260)
Image is an optional field of up to 260 characters in length.
Signature char(260)
Signature is an optional field of up to 260 characters in length.
Activation char(10) MM/DD/YYYY default = TODAY
The Activation is an optional field of up to 10 characters in length; the cardholder’s
activation date will be set as provided.
Expiration char(10) MM/DD/YYYY default = TODAY + 5yr
The Expiration is an optional field of up to 10 characters in length; the cardholder’s
deactivation date will be set as provided.
User’s Guide
Page 12 of 35
Pinnacle Data Exchange
Action Add/Delete/Modify/Assign/Revoke/Issue/Return default = Add
The Action field determines the action that will be performed by the Pinnacle Data
Exchange application. The Actions can be performed on Cardholders, Access Levels
or Cards.
Cardholder
•
•
•
Add – Creates a new cardholder; modifies the cardholder if it already exists.
Assigns an Access Level and issues a Card if such data is provided.
Delete – Deletes the specified cardholder; no action if the cardholder does not
exist.
Modify – Updates the specified cardholder; creates a new cardholder if it
doesn’t already exist. Sets all fields to the specified values but does not
assign/revoke Access Levels nor Issue, Return, or mark cards as Lost.
Access Levels
•
•
Assign – Assigns a new Access Level to the specified cardholder; no action if
the cardholder does not exist. No other cardholder modifications are made.
Revoke – Revokes an Access Level from the specified cardholder; no action if
the cardholder does not exist. No other cardholder modifications are made.
Cards
•
•
•
Issue – Issues a Card to the specified cardholder; no action if the cardholder
does not exist. No other cardholder modifications are made.
Return – Returns a Card for the specified cardholder; no action if the
cardholder does not exist. No other cardholder modifications are made.
Lost – Lost Card for the specified cardholder; no action if the cardholder does
not exist. No other cardholder modifications are made.
Note: Actions are mutually exclusive; for example, cards cannot be both assigned and
returned using a single entry line in the data file. Similarly, a single entry in the data file
cannot be used to modify the record and assign an Access Level.
All other field names will be processed as Custom Fields. If a header file contains a
custom field that is not defined in Pinnacle the entire execution is aborted and the data
file isn’t even opened.
User’s Guide
Page 13 of 35
Pinnacle Data Exchange
Data File
The data file is located in the “\Program Files\Pinnacle\DataFiles” subdirectory. The data file is a
plain text file with a “.dat” extension that contains the data in the order presented in the header
file. The lines in the data file typically correspond to a single cardholder and are terminated by a
CR/LF. All fields (header and data) will be pipe (|) delimited. Pinnacle Data Exchange expects
the data file name to be the same as the header file name.
The following lines are included in a typical data file.
Abdallah|Shadi|A|McKinley|G001|Add|Marketing|01/10/2007|12/25/2007
Abdallah|Shadi|A|McKinley|G001|Assign|Sales|07/02/2007|12/25/2007
The first line of the data above will create the cardholder if it doesn’t exist and then assigns the
Marketing Access Level with the respective ACL activation and expiration dates.
The second line will assign the Sales Access Level with the respective ACL activation and ACL
expiration dates to the Cardholder created by the first line shown above.
Output File
The output file logs the results from every line processed from the data file and from the
Pinnacle Data Exchange. The results information in this file is also displayed in the application
results tab when running interactively, manual mode.
The following lines are included in a typical output file:
7
8
9
SUCCESS
SUCCESS
SUCCESS
Header Row Loaded
Pinnacle Data Exchange Header
Version Row Loaded
Version 1.0
Column Header Row Loaded
Lname|Fname|MI|Class
Here is a screen shot from the Pinnacle Data Exchange GUI.
User’s Guide
Page 14 of 35
Pinnacle Data Exchange
Note: When Pinnacle Data Exchange finishes processing the data file, it will rename the
data file appending the date and time to the file name and will change the
extension to “.bak”.
For example, PDESample.dat will become PDESample_12-15-2007_15-17-33.BAK
User’s Guide
Page 15 of 35
Pinnacle Data Exchange
Manual Mode
Double click on the “Pinnacle Data Exchange.exe” under C:\Program Files\Pinnacle.
The login screen will be displayed.
Enter a valid Pinnacle User Name and Password and click “OK”.
Note: This user has to have privileges of performing changes to the Pinnacle Database.
For Example: To assign an access level to a Cardholder - the user logging in has to have
permission to the Access Level tab on the Cardholder Screen or the Cardholder tab on
the Access Level Screen.
The Pinnacle Data Exchange window will be displayed. It contains 2 tabs:
1. Configuration
2. Results
Configuration Tab
The Configuration tab allows you load an existing configuration file, modify it and save.
You can also enter the Data Filename, Output File Directory, User Name, Password, change the
behavior of a cardholder Add and Modify and override the Access Level activation and
expiration dates.
User’s Guide
Page 16 of 35
Pinnacle Data Exchange
Data Filename
Enter the location of the Data file, for instance:
C:\Program Files\Pinnacle\Pinnacle\DataFiles\PDESample.dat
Output File Directory
Enter the location where Pinnacle Data Exchange will write the log file, for instance:
C:\Program Files\Pinnacle\DataFiles
User Name
Enter a valid Pinnacle User Name that has the rights to execute the changes in the
Pinnacle Database. For instance: MyUser
Password
Enter the Password
Cardholder Add/Modify
Yes: Will Add a cardholder if not found in the Pinnacle Database.
No : Will Modify a cardholder if it is found in the Pinnacle Database. If NOT found, no
modifications will be made.
User’s Guide
Page 17 of 35
Pinnacle Data Exchange
Access Level Modify
Yes : Overrides the cardholder Access Level Activation and Expiration Dates.
No : Will not override the cardholder Access Level Activation and Expiration Dates.
Load Config File button: Click this button and choose the PDE configuration file. It will populate
the fields in the configuration tab and set the colors on the results tab.
Save Config File button: Click this button to save changes you made to an existing configuration
file or if you want to create a new configuration file. It will save the PDE configuration file with
the parameter entered in the configuration and the color changes in the results tabs.
User’s Guide
Page 18 of 35
Pinnacle Data Exchange
Run button: Runs Pinnacle Data Exchange and performs the changes to the Pinnacle
Database. It automatically switches to the results tab and displays the results of every line
processed. The results will be saved to the output file after you Exit the application.
Exit button: Closes the application.
Results Tab
The results tab displays the results log of the actions performed by the Pinnacle Data Exchange.
User’s Guide
Page 19 of 35
Pinnacle Data Exchange
Color Config button:
Click this button to change the Event Colors displayed in the Results Log.
After changing the color of any specific event, the close button changes to “save”.
Click “Save” to save the changes you made.
View Radio Buttons: If “All Results” is selected, it will display all the events. If “Errors” is selected
it will display errors if they occur.
User’s Guide
Page 20 of 35
Pinnacle Data Exchange
Auto Scroll: If checked will cause the Results Log to scroll up as the data file is processed. If it
is unchecked it will display the last events.
Print Button: Will print the Results Log to a printer. Select the printer and click the Print button.
User’s Guide
Page 21 of 35
Pinnacle Data Exchange
Results Column
Valid results that can appear in the Results column are: ERROR, MODIFY, NONE,
INFORMATION, SUCCESS, and MULTIPLE RESULTS.
All of these results can have different colors assigned except for MULTIPLE RESULTS, which
follows the color of SUCCESS.
MULTIPLE RESULTS is used to indicate that many cardholders were modified from just one
input data row. Take for example the Header file shown below:
Pinnacle Data Exchange Header
Version 1.0
Lname|Expiration|Action
And then use the data file:
%|12/31/2029|Modify
The results will look something like this:
See how there are MULTIPLE RESULTS rows for the Cardholders that were changed, which
each Cardholder being shown.
User’s Guide
Page 22 of 35
Pinnacle Data Exchange
Scheduled Mode
If you make changes to your system and want to automatically update the Pinnacle database
you can use the Windows Scheduler or Pinnacle Scheduler to run Pinnacle Data Exchange
every so often.
Windows Scheduler
Instructions are for Windows XP Pro it may vary slightly for other OS versions.
1. From the Start Menu select the Control Panel.
2. Select Performance and Maintenance.
User’s Guide
Page 23 of 35
Pinnacle Data Exchange
3. Select Scheduled Tasks.
4. Double Click "Add Scheduled Task"
5. Click Next.
User’s Guide
Page 24 of 35
Pinnacle Data Exchange
6. Click Browse.
7. Browse to the Pinnacle Install Directory C:\Program Files\Pinnacle, select "Pinnacle Data
Exchange.exe" and press Open.
8. Select Daily and Press Next
User’s Guide
Page 25 of 35
Pinnacle Data Exchange
9. Set the time you wish the Pinnacle Data Exchange to run. If you only want to run on
Weekdays, select Weekdays. Click Next.
10. Enter the User Name login and Password for the job to run under. Click Next.
11. Click Finish.
User’s Guide
Page 26 of 35
Pinnacle Data Exchange
12. Make sure the Run text field reads:
"C:\Program Files\Pinnacle\Pinnacle Data Exchange.exe" -c "C:\Program
Files\Pinnacle\ExchangeConfig.cfg"
With the correct name of the configuration file you generated from Pinnacle Data Exchange.
13. Click OK. You will need to confirm again the User login and password to run the process
under.
User’s Guide
Page 27 of 35
Pinnacle Data Exchange
Pinnacle Scheduler
1. Select Schedules from the Pinnacle Configuration
2. Select the Custom tab
User’s Guide
Page 28 of 35
Pinnacle Data Exchange
3. Click the “New” button, enter the schedule name and click OK.
4.
5. Set the Schedule Options that meet your needs, select the Pinnacle Data Exchange.exe
And the computer in the Executable Recipient
6. Click Save.
User’s Guide
Page 29 of 35
Pinnacle Data Exchange
7. Click OK.
User’s Guide
Page 30 of 35
Pinnacle Data Exchange
Command Line Parameters
Command line parameters are designated by either a dash (-) or slash (/), and are case
insensitive.
Parameter
Description
-c filename
The name of the Pinnacle Data Exchange configuration
file.
-?
Help, displays the acceptable parameters shown here.
Example:
Pinnacle Data Exchange.exe –c students.dat
Runs the update utility using students.cfg located in the current working directory. The
corresponding output file will be “students _Output_12-15-2007_15-17-33.PDE” , also located
in the current working directory.
User’s Guide
Page 31 of 35
Pinnacle Data Exchange
Use Cases
1. Adding new cardholders
Header->
Data ->
Data ->
Data ->
Lname
Abdallah
Abelin
Abera
Fname
Shadi
Jennifer
Mahlet
MI
ACL
I
Dorm-A
G Milner
B General
CardType
2
2
2
CardCode Dorm
61734012 AP79
61221010 MILN
56632015 CAMP
{CollegeID}
G00390920
G00487508
G00460872
Action
Add
Add
Add
Each of the three cardholders is created, their associated Access Levels are assigned, and their
Card is issued.
An alternate means of adding a cardholder and issuing a Card
Lname
Fname
Abdallah Shadi
Abdallah Shadi
MI
ACL
I
Dorm-A
I
Dorm-A
CardType CardCode
2
61734012
Dorm
AP79
AP79
{CollegeID} Action
G00390920 Add
G00390920 Issue
An alternate means of adding a cardholder and assigning an Access Level
Lname
Fname
Abdallah Shadi
Abdallah Shadi
MI
ACL
I
I
Dorm-A
CardType CardCode Dorm
2
61734012 AP79
{CollegeID} Action
G00390920 Add
G00390920 Assign
Adding a cardholder and assigning an Image and a Signature file to the cardholder.
Lname
Fname MI
Image
Signature
Action
Abdallah Shadi
I
C:\Images\ShadiA.JPG
C:\Signatures\ShadiA.JPG
Add
Abelin
Jennifer GI C:\Images\JenniferA.JPG C:\Signatures\JenniferA.JPG Add
User’s Guide
Page 32 of 35
Pinnacle Data Exchange
Assigning multiple Access Levels to a cardholder
Lname Fname MI
ACL
Abdallah Shadi
I
Dorm-B
Abdallah Shadi
I
Dorm-C
CardType CardCode
Dorm
{CollegeID} Action
G00390920 Assign
G00390920 Assign
2. Returning a Card and issuing a new one
Lname
Abdallah
Abdallah
Fname
Shadi
Shadi
MI
I
I
ACL
CardType
2
2
CardCode
61734012
61735489
Dorm
{CollegeID}
G00390920
G00390920
Action
Return
Issue
{CollegeID}
Action
3. Revoking an Access Level and assigning a new one
Lname
Fname MI
Abdallah Shadi
I
Abdallah Shadi
I
ACL
DormC
DormD
CardType CardCode Dorm
G00390920 Revoke
G00390920 Assign
4. Deactivating multiple cardholders
Lname
Abdallah
Abelin
Abera
Fname
Shadi
Jennifer
Mahlet
MI Active
I
N
G N
B N
CardType
CardCode
Dorm
{CollegeID}
G00390920
G00487508
G00460872
Action
Modify
Modify
Modify
5. Deactivating multiple cardholders using a search criteria: Dorm = “AP79”
Lname
Fname
MI
Active
N
CardType
CardCode
{Dorm}
AP79
CardCode
Dorm
CollegeID
Action
Modify
{CollegeID}
G00390920
G00487508
G00460872
Action
Delete
Delete
Delete
6. Deleting multiple cardholders
Lname
Abdallah
Abelin
Abera
Fname
Shadi
Jennifer
Mahlet
MI
I
G
B
ACL
CardType
7. Deleting multiple cardholders using a search criteria: Dorm = “AP79”
Lname
Fname
User’s Guide
MI
ACL
CardType
CardCode
{Dorm}
AP79
CollegeID
Action
Delete
Page 33 of 35
Pinnacle Data Exchange
Appendix A – Result / Error Codes
Number
Text
-101
-102
-103
-104
-105
-106
-107
-108
-109
-110
-111
-112
-113
-114
-115
-116
-117
-118
-119
-120
-121
-122
-123
-124
-125
-126
-127
-128
-129
-130
-131
-132
-133
-134
-135
-136
-137
-138
-139
-140
-141
-142
-143
The Access Level is already assigned.
The Access Level failed to be assigned.
The Access Level wasn't found.
Error saving configuration file.
Error reading configuration file.
Application not Licensed.
Required parameters missing. Closing.
is not authorized to use this program.
Permission to access the Cardholder Screen is required.
A valid data file wasn't provided.
File not found or is corrupt. Filename =
Process cannot continue. Aborting execution.
File is not a valid configuration file: the header is invalid. Filename =
Unknown version number:
Error! More than one index column (column with curly braces).
The Action column cannot be the Unique Custom Field indicator.
Too many columns in the row. Row
Error adding Custom Field in BreakdownColumnHeaders.
Error Getting Custom Field Index.
Error Getting Column Header Name.
Error Adding Custom Field.
User does not have access to the Cardholder Screen.
Successfully saved output file.
Error saving output file.
file/location doesn't exist.
BulkCHUpdate.exe -? for more information.
Too few columns in the row. Row
Unknown version number:
Column header value not recognized.
Cannot reset database. Another computername appears in the Misc_T table.
There was an error loading the configuration file.
CardType provided and CardCode was not.
Zero cardholders found.
Multiple cardholders found.
Operation successful.
Cardholder Library Startup call failed.
Custom Field Library Startup call failed.
Considered sucessful operation.
Failed to get CardholderName from CardholderID.
Failed to get AccessLevelID.
Can't assign Access Level.
Can't revoke Access Level.
Can't issue card.
User’s Guide
Page 34 of 35
Pinnacle Data Exchange
Appendix A Continued – Result / Error Codes
Number
Text
-144
-145
-146
-147
-148
-149
-150
-151
-152
-153
-154
-155
-156
-157
-158
-159
-160
-161
-162
-163
-164
-165
-166
-167
-168
-1010
-1013
-1014
-1500
Can't return card.
Can't indicate card as lost.
There aren't any issued cards.
Can't locate Cardholder's issued cards.
Card isn't issued to this Cardholder.
Cardholder has an ID of 0.
Total number of issued cards exceeded.
A valid header file wasn't provided.
Zero Cardholders to modify.
Invalid ACLActivation date.
Invalid ACLExpiration date.
Invalid Activation date.
Invalid Expiration date.
Expiration Date cannot precede Activation Date.
ACLExpiration Date cannot precede ACLActivation Date.
ACL dates provided but no ACL(s) to assign/modify.
Invalid value provided:
This row cannot be processed.
Cardholder was saved but a card was NOT issued because there was an
The header (.HDR) file contained a column title value of
The data (.DAT) file did not contain a value for this column.
Custom Field Pulldown List value doesn't exist.
Error Getting Custom Field Type.
Custom Field ID was not resolved from the Custom Field Name.
Custom Field Calendar value isn't a date.
Invalid PIN - PIN cannot be blank.
Invalid Cardcode - Card is currently issued.
Database Library Startup call failed.
Logged in user is not authorized to perform the action
- END User’s Guide
Page 35 of 35