Skip to main content

Import Installation Requests

Prerequisites
  • Admin or Multi-Account (admin role) access
  • At least one Location configured in the platform
  • A properly formatted CSV file (see CSV Format below)

Overview​

The Import Installation Requests page enables bulk creation and bulk deletion of installation requests through CSV file uploads. Instead of creating tickets one by one through the Installation Requests page, administrators can import up to 3,000 installation requests in a single operation — essential for large-scale device deployments across multiple buildings or locations.

Key Capabilities:

  • Bulk import — Create hundreds or thousands of installation requests from a single CSV file
  • Bulk deletion — Remove installation requests in mass using an exported CSV file
  • Import history — Track all past import operations with status, file details, and ticket counts
  • Deletion reports — Track all past deletion operations with the same detail
  • Detailed reports — View individual ticket results after each import or deletion operation

Import Installation Requests Overview Import Installation Requests page showing import history and deletion reports sections

To access Import Installation Requests:

  1. Expand "Resources" in the left sidebar menu
  2. Click "Import installation requests" from the submenu

Features​

Page Structure​

The page is organized into two sections, each with its own action button and history table:

  • Previous Installation Request Imports — Click "Import installation requests" to start a new bulk import. The table below shows all past import operations.
  • Installation Request Deletion Reports — Click "Delete installation requests using CSV" to start a bulk deletion. The table below shows all past deletion operations.

Both history tables share the same column structure:

  • Creation Date (sortable) — When the operation was initiated
  • Status — Processing result: Finished, Processing, or Failed
  • File Name (sortable) — Name of the uploaded CSV file
  • Uploaded By (sortable) — Email of the administrator who initiated the operation
  • Amount of Tickets (sortable) — Number of installation requests processed

Clicking a row opens a detailed report showing the result for each individual ticket.

CSV Format for Import​

The import wizard uses a 3-step process: Configure common fields → Choose import file → Confirm data.

The CSV file contains per-ticket details. Each row represents one installation request. The required column structure is:

doorId,doorName,floor,category,additionalInfo,message

Common fields shared across all tickets in the import — such as location, resource type, device details, and installer — are configured in Step 1 of the wizard (not in the CSV file).

CSV Requirements
  • Maximum 3,000 rows per import file
  • Use double quotes around fields containing special characters (commas, periods, semicolons)
  • A downloadable example file is available in the wizard's information panel
Preparing Your CSV

The CSV file only contains door-specific data (ID, name, floor, category, info, message). Shared details like location, hardware type, manufacturer, and installer are set once in the "Configure common fields" step and applied to all tickets in the import.

Import Workflow​

  1. Click "Import installation requests" to open the wizard
  2. Step 1 — Configure common fields: Set the location, resource type, device details, and installer for all tickets in this batch
  3. Step 2 — Choose import file: Upload your CSV file
  4. Step 3 — Confirm data: Review the validated tickets and click "Start" to execute the import

After completion, the operation appears in the import history table. Click the row to view a detailed report showing the import status of each individual ticket.

No Modification After Submission

Once an import operation is submitted, it cannot be modified or cancelled. Verify your CSV file and common field settings before confirming.

Bulk Deletion​

To delete installation requests in bulk:

  1. Export the current installation requests from the Installation Requests page (using "Export CSV")
  2. Edit the exported file to include only the tickets you want to delete
  3. Click "Delete installation requests using CSV" to open the deletion wizard
  4. Step 1 — Choose import file: Upload the deletion CSV file
  5. Step 2 — Confirm data: Review and confirm the deletion

The deletion CSV requires the following columns:

id,doorId,name

After completion, a deletion report shows the status of each individual ticket removal.

Permanent Deletion

Bulk deletion is irreversible. The deletion CSV can be prepared from the export of the Installation Requests page — review it carefully before uploading.

Pagination​

Both history tables support configurable pagination with rows per page (default: 50), page navigation controls, and result count indicators.

External CSV Resources

Need help creating CSV files? See the Microsoft Excel CSV Guide or Google Sheets CSV Guide. These are external resources not provided by Bitwards.

  • Installation Requests — Individual ticket creation, search, export, and management
  • Resources — Device management after installation is complete
  • Resource Groups — Group-based device organization
  • Locations — Location setup required before creating import requests
Last updated on