Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.
  • Madrid
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store

Post CSV or Excel files directly to an import set

Log in to subscribe to topics and get notified when content changes.

Post CSV or Excel files directly to an import set

An administrator can post CSV or Excel files directly to instance.

Before you begin

Role required: import_set_loader

About this task

The target lets you dynamically upload a CSV or Excel file into the import set table specified by the sysparm_import_set_tablename parameter. You must specify a name that matches an existing import set table name. If the import set table does not exist, pre-create it by performing a manual import. The sysparm_transform_after_load=true parameter causes the CSV transform to be executed immediately, if a transform map exists.
You can upload a file using POST to the following URL (replace placeholders with desired values):
Important: The body of the POST must contain the file as a multi-part attachment.

Posting a CSV file - Perl example

An example using Perl to post a CSV file with basic auth credentials.

# file:
# call me like this:
# --url="" 
# --uploadfile=/Users/davidloo/Desktop/test_files/test_users.csv
# the "sysparm_transform_after_load=true" parameter instructs the import set to transform immediately after loading
use strict;
use LWP::UserAgent;
use HTTP::Request::Common;
use Getopt::Long;
use File::Basename;
my ( $o_url, $o_fqn );
    "url=s"        => \$o_url,
    "uploadfile=s" => \$o_fqn,
# mandatory arguments: url
&usage unless ( $o_url && $o_fqn );
my $url   = $o_url;
my $fname = $o_fqn;
# put timeouts, proxy etc into the useragent if needed
my $ua  = LWP::UserAgent->new();
# setup basic authentication credentials
  'admin' => 'admin'
my $req = POST $url, Content_Type => 'form-data',
        Content      => [
                submit => 1,
                upfile =>  [ $fname ]
my $response = $ua->request($req);
if ($response->is_success()) {
    print "OK: ", $response->content;
} else {
    print $response->as_string;
sub usage {
        printf "usage:&nbsp;%s --url=%s --uploadfile=%s\\n",

Posting a CSV file - Java example

An example using the Java Apache HttpClient class to post a CSV file with basic auth credentials.

Attention: The Apache HttpClient may limit the amount of data you can import in a single transaction. This example is meant as a starting point and should not be used in production.
HttpClient httpclient = new HttpClient();
PostMethod post = new PostMethod("");
try {
  Credentials defaultcreds = new UsernamePasswordCredentials("admin", "admin");
  httpclient.getState().setCredentials(AuthScope.ANY, defaultcreds); // Prepare HTTP post
  File targetFile = new File("/Users/davidloo/Desktop/test_files/nodeinfo2736820198834983863.csv");
  Part[] parts = { new FilePart(targetFile.getName(), targetFile) };
  post.setRequestEntity(new MultipartRequestEntity(parts, post.getParams()));
  int result = httpclient.executeMethod(post);
  // Display status code
  System.out.println("Response status code: " + result);
  // Display response
  System.out.println("Response body: "+post.getResponseBodyAsString());
} catch(Exception e) {
} finally {
  // Release current connection to the connection pool
  // once you are done