Step 1. Set up the Employees

All employees must be configured with badging information and imported via Employee Import. Therefore, set up an Employee Import that includes the column:

• Badge - Employee's Badge ID.

For more details, see Understanding the Employee Import Data.

Step 2. Set up the Badge Readers in SpaceIQ

Badge Readers must be configured on the Floor Map in SpaceIQ and each Badge Reader must be configured with a unique code. This will identify the location where a person entered the building and left the building. The same code will be reported by the Badge Reader at the customer’s buildings.

Add a Device icon and set it up as a Badge Reader

1. Navigate to the Floor Map  icon.
2. Select the building and floor you are working on.
3. Click the Map Editor  icon. The Map Editor displays.
4. Click the ADD SPACE icon. The space drawer displays.
   
5. Click the Device  icon and drop it at the precise location on the map where the physical Badge Reader is located. Note: Click Esc to leave the Add Space mode.
6. On the Floor Map, click the Device icon. The data drawer displays.
7. If you just added a device, the default Device Type will be a meeting room. From the Device Type drop-down, select Badge Reader.
   
8. In the Badge Reader ID field, enter the unique code to identify this Badge Reader.
9. Repeat steps 6 to 8 for the other Badge Readers on the floor map.

Any changes you make in the Data Drawer are saved automatically.

Step 3. Set up the Badging File

Set up a data file in a CSV format and include the following:

• Badge - Employee's Badge ID.
• Device Info - Device ID set up on the floor map in SpaceIQ.
• Admitted at - Date and time the employee used the badge reader.
• Status - Status of the employee's reading (Accepted or Denied).

For example:

Step 4. Activate Badging Integration in SpaceIQ

From the SpaceIQ application, complete the following steps:

1. In the top-right corner, click on your Profile Name, and then click on Settings.
   
2. From the left menu, click Integrations.
   
    
3. From the Third Party Integrations area, click the READ MORE link.
   
   The Integrations screen displays.

You can search for Badging and IoT in the Search field or navigate to Badging and IoT tile. To navigate, complete the following:

1. From the left menu, click Sensor Systems.
2. For Badging and IoT, click the Activate button.

The Badging and IoT dialog displays an Import (Password) tab and an Import (SSH Public Key) tab.

Depending on the authentication method you want to use, select either:

• Import (Password) tab
• Import (SSH Public Key) tab

In both cases, SpaceIQ will provide connection details (e.g. hostname, port) that you will use to configure your SFTP client. 

SpaceIQ will perform the following actions based on your selection:

• Import (Password) - SpaceIQ will generate a unique username and password for you to use with your SFTP client.
• Import (SSH Public Key) - SpaceIQ will generate a unique username and expect you to supply the SSH Public key you would like to use. You will need to configure your SFTP client with both. Steps to generate Public Key are listed in the section below.

Also, you can customize your mapping if you need to or use the same one that SpaceIQ uses. That completes the setup.

In the Badging Import mapping field, enter the mapping code. For example:

{"badge_info":"badge_info","device_info":"device_info","admitted_at":"admitted_at","status":"status"}

Import (Password) tab

Import (SSH Public Key) tab

Click the Activate button to complete the process.