Zengain beta open for customers sign up now:
click here
Documentation
SupportNalpeiron.comGithubFree TrialFeedback
  • Documentation
  • Zentitle2 Docs
  • Zengain Docs
  • Zentitle I (V10)
  • Education & Training
  • Welcome
    • Zentitle2 documentation: License Management Software
    • Introduction to Zentitle2
  • Latest UI Changes
  • Zentitle Overview
    • Zentitle Quick Overview
      • Zentitle2 Features & Benefits
      • A single source of truth: 1 platform
      • Zentitle Architecture
      • Zentitle supports every platform
      • Zentitle business models
      • Critical differences for secure site/offline/dark site management
      • Zentitle for SaaS Licensing
  • Quick Start
    • Onboarding Zentitle2
    • Integrating is easy
    • Pricing & Packaging with Zentitle
  • Using the Platform UI
    • Introduction
    • New User Setup
    • Getting around
      • Search
      • Using reports
      • Providing feedback
    • Getting started
  • UI: ADMINISTRATION
    • Introduction
    • Users
      • Managing Users
      • Resending user invites
      • User permissions
      • Lost password
    • API Credentials
      • Package Registry
    • Webhooks
      • Logs
      • Workflow automation software
    • Integrations
      • FastSpring
      • SalesForce Sample Integration
        • Sample Integration Installation
        • Post-Installation Configuration
        • Connecting Salesforce to Zentitle
        • Creating a Zentitle Customer in SalesForce
        • Creating a Zentitle Entitlement in SalesForce
        • Editing Zentitle Entitlements in SalesForce
        • Managing Software Activations in SalesForce
    • Configuration
      • Import customers
      • Account Based Licensing (Identity-based licensing)
        • Setup Account Based Licensing with OpenID tokens.
        • Setup Account Based Licensing with username/password
        • Branding the user experience
      • End User Portal
        • End User Portal User Access
        • End user - Use of the portal
        • End User Offline Activation
      • Custom Fields
      • Security (2FA)
    • "Hard" Delete
  • UI: Dashboard
    • The Dashboard
  • UI: Customers
    • Customers and contacts
    • Customers
      • Adding (managing) contacts
      • The contact page
      • Setting up End User Portal (EUP) access
      • Inviting contacts to EUP
      • Disabling Customers
      • Managing Entitlements (from the Customer page)
  • UI: Entitlements
    • Entitlements
      • Using Entitlements
      • Maintenance options
    • Working with Entitlements
      • Activation Codes
      • Contacts (ABL)
      • Activations
      • Activity log
      • Notes
    • Managing Entitlements
      • Allocating entitlements
      • Change the offering (upgrade/downgrade)
      • Entitlements with overrides/changes
      • Renewing an entitlement
      • Resetting the usage count
      • Disabling Entitlements
      • Entitlements in overdraft (seats)
  • UI: Product Catalog
    • Product paradigm
    • Products
      • Product Features
      • Overdraft option (feature usage)
      • Feature Control
      • Product Attributes
      • Product Editions
      • Edition Setup
    • Offerings
      • Overdraft option (seats)
      • Managing offerings
      • Maintenance options
      • Change offering (upgrade/downgrade)
      • Custom Fields
    • Plans
      • Trial plans
    • Global Features (and attributes)
  • UI: Local License Server
    • Local License Server (LLS)
      • Local License Server Installation
      • LLS License End-User Management
      • Entitlements to be used on LLS instances
      • LLS Licensing API
      • LLS Release Notes
  • UI: Help
    • Support
  • Developers
    • Licensing & Management APIs
      • API docs
      • API Rate limits
      • Collecting credentials for integration
      • API Versioning
    • The Licensing Client (.NET)
      • Configure NuGet Source
      • Configuring the Activation
      • Configuring the SharedActivation
      • Working with SharedActivation
      • Licensing API Nonce
      • IActivation interface
      • Zentitle2Core Library
      • Exceptions
      • FAQ
      • Release Notes
    • The Licensing Client (C++)
      • Configuring the Activation
      • Licensing API Nonce
      • IActivation interface
      • Zentitle2Core Library
      • Exceptions
      • Release Notes
    • The Licensing Client (Java)
      • Configure JAR Source
      • Configuring the Activation
      • Licensing API Nonce
      • IActivation interface
      • Zentitle2Core Library
      • Exceptions
      • FAQ
      • Release Notes
    • The Zentitle2Core Library (C++)
      • Security
      • Offline Activation
      • Generating Device Fingerprint
      • Using the Zentitle2Core Library
      • Troubleshooting and FAQs
    • Platform Summary
      • Turboscale architecture
      • SaaS Application Licensing
      • On-Premise Licensing
        • 1-Step Offline Deactivation: On-Premise
        • 2-Step Offline Activation: On-Premise
    • Offline Activation
    • Virtual Machine Control
    • No-code Test Application
      • Creating a Product and Entitlement
      • Download the demo files
      • OnPremDemo.dll.config setup
      • Test the demo application
        • Install Desktop Runtime
    • No-code SaaS Example
      • Creating a Product and Entitlement
      • Download the demo files
      • Collecting the serverside parameters
      • Edit appsettings.json file for IDE based Testing
      • Edit docker-compose.yml file for Docker-based Testing
      • Test the demo application
        • Using docker to test
    • Naming conventions/Glossary
  • Premium Features
    • Overdraft Tracker (Basic)
      • API references (Overdraft)
      • Overdraft Tracker on the dashboard
      • Reporting with the Overdraft Tracker
    • Network Licensing
    • Change log feature
  • Use Cases
    • Dark Site Local License Server (Network-based licensing)
    • Renewals (Customer Success) Management
    • Subscription grace periods
    • Self-service - End-user portal
    • Virtualized Environments
    • Usage-Based Licensing
    • Trial Management
    • Identity Based Licensing: Understanding IDP
    • Single Tenant Option
    • Entitlements with ERP & billing systems
    • Entitlements with Subscriptions
    • Entitlements with a CRM
    • E-commerce Integration
    • IoT and hardware licensing
    • SaaS Applications
    • Overuse tracking (overdrafts)
    • Order Fulfillment
  • Zentitle and M&A deals
  • Other
    • Zentitle2 Changelog
      • Terms and Conditions Changelog
Powered by GitBook
LogoLogo

Nalpeiron Privacy Policy

  • Privacy and Cookie Policy

Nalpeiron Growth Platform Terms

  • Nalpeiron ELTC

Get a FREE Trial

  • Click here for FREE Trial

© Copyright - Nalpeiron, all rights reserved. Nalpeiron, The Nalpeiron Growth Platform, Zentitle and Zengain are trademarks of Nalpeiron Inc. All use subject to our Terms above.

On this page
  • Importing Customers
  • Bulk update customers
  • Troubleshooting

Was this helpful?

Export as PDF
  1. UI: ADMINISTRATION
  2. Configuration

Import customers

PreviousConfigurationNextAccount Based Licensing (Identity-based licensing)

Last updated 1 month ago

Was this helpful?

Importing Customers

Before you import your Customers into Zentitle, add the custom fields (in the settings section) you need to prevent the hassles of later re-importing, issues with duplicates, and poor data hygiene.

This importing function is designed for importing up to 10,000 customers and not large bulk imports—if you have a lot of users to import, please contact support.

The maximum upload file size is 1 MB.

In addition to adding customers to Zentitle2, you may wish to update the data already in the database—to do that, you must use a unique account reference ID for each customer when importing for the first time.

Adding customers in bulk can effectively add your customers to the system, saving time. To import customers, click the vertical ellipsis next to the "Add Customer" button to begin the process.

You can add them via the Customers page or the Admin section.

The import customers page is located under the "Administration" > "Configuration" > "Import customers" on the top menu.

From the next screen, download the template file as a CSV file.

Open the CSV file in the appropriate application (typically MS Excel).

The AccountReferenceID field references an ID in an external system (for example, your CRM). If the import process finds a different customer in the system with the same AccountReferenceID, it will update the customer and not create a new customer. So be careful to have unique IDs in the data you import unless you wish to update what you already have in Zentitle2.

Fill in the worksheet with applicable data.

Once the worksheet is created with the appropriate data, click "Upload customers from CSV file".

To avoid painful data cleanup, we recommend first uploading a smaller sample of a few customers and checking to ensure no errors.

NOTE: the file requirements

  • Header row with column names is required

  • Use the correct input format for each field type

  • CSV file must be in UTF-8 encoding

  • Column separator “,” (comma)

Once you have successfully uploaded your file, you will get an alert in the UI.

The import process is a batch function and may take a while in the background, depending on the size of the imported data file.

Once the data has been successfully imported, you can review what happened and if it was successful or failed in the Customers Import page at the bottom in the import status box.

As with all forms of data imports, if the data is not clean, has odd characters, spaces, etc., it can cause an issue with the import process, so be careful to ensure the CSV you import is in good shape before you start this process. Always have a unique "account reference ID".

Finally, navigate back to the main customers section on the left navigation and review your imported customers for accuracy.


Bulk update customers

In addition to adding customers to Zentitle2, you may wish to update the data already in the database—to do that, you must use a unique account reference ID for each customer.

To update the database in bulk, repeat the above processes with the fields you wish to update. Always include the "account reference ID" field along with the changes or additions in the header row. This will process an "insert" function to update or add new data.


Troubleshooting

When importing data, if the data and field requirements are not met, the report at the bottom of the import page will show you the results - with a red warning icon if the data import was unsuccessful.

For example, if you didn't put any data into a mandatory field, you use duplicate data like the same email when you set it to unique, etc

The red button will allow you to download a report file with all the data in the file and the issues with the import so you can fix the issues.

Fix the errors shown in the download report and then retry your import, now it should import as required.

Download the template

NOTE: The template file will update when you , so be sure to add those first and then start the import process to include any extra data over the basic fields set up as standard. Click the image below for an example.

Upload the CSV file.

Review the imported data

add your custom fields
Example CSV template with custom fields