Custom Inventory Importer
Custom Inventory Importer
Custom Inventory Importer is a command-line interface (CLI) tool that allows you to upload custom inventory data into Flexera One IT Visibility for processing, just like any other data source. This tool allows you to test out ideas or demonstrate the platform's capabilities.
How to use the Custom Inventory Importer
To use Custom Inventory Importer, you'll need:
-
Access to the Flexera One organization that you intend to import custom inventory into
-
A valid Flexera IAM Refresh Token for API authentication and authorization
-
A custom inventory file that conforms to Flexera One common ingest format
-
A Windows or Linux machine that can connect to your Flexera One organization UI
Obtain a Flexera IAM Refresh token for use with the CLI
-
Log into Flexera One and navigate to User Settings / API Credentials.
-
Select the Create API Refresh Token button.
-
Copy the token and note it for later use.
Get a copy of the Custom Inventory Importer
- For Windows, see attachment ciImporterSigned-2025-08-05.zip
- For Linux, see attachment ciImporter4Linux-2025-08-05.zip
You'll use a different executable depending on your environment, but the same parameters are supported in both. For example, the following two commands will do the same thing, but you'll need to substitute the path parameters for those in your chosen environment.
- Windows
ciImporterSigned.exe import template --out c:\imports\template - Linux
./ciImporter4Linux import template --out ./imports/template
Get a CSV Template to populate
You can use the tool to build a CSV template that the importer supports to convert from. Execute the tool with the following CLI parameters:
import template --out <folder or new zip file to create>
Depending on what you specify, this action will either create a folder, populate an empty folder, or create a zip file. The folder will contain a series of expected CSV files, with the first row in each specifying the type of data it expects.
- See the attached file SampleCSVs-2025-08-05.zip for some examples of the expected CSV files.
- For the description and data format of each CSV field, see the attached file CSV Fields Description-2025-08-05.pdf.
IMPORTANT: Including the following file types is essential when preparing the CSV files. However, only the "Computer" related CSV files require mandatory data. In contrast, non-computer-related CSV files do not need data but must contain their respective field headers.
-
BusinessService
-
Computer
-
InstallerEvidence
-
OSEvidence
-
Virtualization
Convert the CSV to the Common Ingest format
Converting the CSV to the Common Ingest format requires a folder or zip file with the CSV files prepared. Execute the tool with the following CLI parameters:
/path/to/importer import convert --in <zip or folder where CSV files are> --connectionName <name of this source> --orgId <your org id> --out <new zip file to create>
Your files will be in the destination zip file you specified, ready for import.
Upload the generated package
Execute the tool with the following CLI parameters:
/path/to/importer upload --connectionName <connectionName> --file <CommonIngest zip file> --orgId <org id> --refreshToken "<my-token>" --region <the region your account is in>
Parameters supported:
| Parameter | Value | Description |
| connectionName | string | The name of this datasource |
| file | string | The relative path to the file source being uploaded |
| orgid | integer | The Flexera assigned Organization ID for your account |
| refreshToken | string | The generated Refresh IAM token to authenticate the upload |
| region | EU/US/AP | The environment to connect to |
Current Limitations
It's recommended to use the same connectionName for the same org so that the newer uploads overwrite the old.
Upcoming Features
- Upload straight from CSV source (avoid conversion step)
- Simpler CLI