Bulk Import / Create Cardholders

This documentation applies to version 23.02.03.xx or later, which is scheduled to be released in February 2023.

This process allows you to import/update many cardholders from a CSV file. Before starting this process, you should create a CSV file (presumably by exporting from Banner, PeopleSoft, etc). Here's an example CSV file.

On the CloudCard Admin homepage, click on the "People" button, which takes you to the Person Search page.
On the Person Search page, click on "Bulk Import" at the top.
Click on the large button in the center of the screen, and select a CSV file from your computer.
1. Sample CSV file:
```
email,id
tsmith@foo.edu,L1234
ajones@foo.edu,L2345
mwilson@foo.edu,L3456
njackson@foo.edu,L4567
```
2. Allowed fields
  1. email: The cardholder's email address
  2. identifier: The cardholders ID Number in your system
  3. cardholderGroupName: (optional) the cardholder group that defines which email communication this cardholder will receive. Must exactly match the name of the desired cardholder group.
  4. supportingDocumentsRequired: (optional) determines if this cardholder is required to submit supporting documents (i.e. driver's license)
    1. Options: true or false
    2. Default: true
  5. managerEmail: (optional) the manager who is allowed to approve or deny this cardholder's photo. If no manager exists with that email address, the manager will be created.
  6. sendInvitation: (optional) determines if the cardholder should be sent the Welcome Email.
    1. Options: true or false
    2. Default: true
  7. action: (optional) determine what action should be taken for this cardholder
    1. Options: CREATE or CREATE_OR_UPDATE
    2. Default: user specified
Select the cardholders to who the Welcome Email should be sent
Select the default action to execute for all rows that do not specify an action
Select Yes for "Has header row" if the CSV file has a header row, i.e. the "email,id" row in the first line of above example. Otherwise, select No. A header row is not required.
Select the "Field" for each column of data. If the CSV has a header row, the application will attempt to map the fields for you; if so, make sure all mappings are correct.
Click the import button.
A status page will appear that will display the result of the bulk import.