/xperience-by-kentico-contacts-importer

Custom module for Xperience by Kentico to enable marketers to import their Contacts from other systems and previous versions of Kentico

Primary LanguageC#MIT LicenseMIT

Xperience by Kentico Contacts Importer

Kentico Labs

CI: Build and Test

NuGet Package

About The Project

Enables bulk importing of Contacts into an Xperience by Kentico solution using a .csv file.

View of the Import Upload dashboard

Getting Started

Prerequisites

Installation

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.Contacts.Importer

Add to your application dependencies

builder.Services.AddKentico();
// ... other registrations
services.AddContactsImport();

Add to your middleware pipeline

app.InitKentico();
// ... other registrations
app.UseContactsImport();

Usage

  1. open contact importer application
    ContactImporterApplication
  2. select file
  3. select mode
    1. Delete - this mode will delete contact by ContactGUID (CSV shall contain column with ContactGUID header)
    2. Insert (skip existing) - this mode will import contacts (CSV shall contain column with ContactGUID)
  4. "Assign to contact group" - all contact (existing included) will be assigned to specified group
  5. Delimiter - delimiter used for CSV (common are ;, ,, \\t, ..)
  6. "Batch size" - size of batch used for database operation, for instances with limited resources this value should not exeed 5000, lower than 100 is not reccomended.
  7. Click "Send file" button

Depends on resources available to application, but degraded application performance is expected during import.

Notes:

  • do not close window with progress, file is uploaded from that window.
  • do not manipulate file during import, close all applications write access to file (or lock)

Supported CSV columns

Column .NET Type Required
ContactGUID Guid yes
ContactCreated DateTime yes
ContactFirstName string no
ContactLastName string no
ContactEmail string no
ContactAge Int32 no
ContactMiddleName string no

Contributing

To see the guidelines for Contributing to Kentico open source software, please see Kentico's CONTRIBUTING.md for more information and follow the Kentico's CODE_OF_CONDUCT.

Instructions and technical details for contributing to this project can be found in Contributing Setup.

License

Distributed under the MIT License. See LICENSE.md for more information.

Support

Kentico Labs

This project has Kentico Labs limited support.

See SUPPORT.md for more information.

For any security issues see SECURITY.md.