Import Users field descriptions

Last Updated : Jan 07, 2021 |

Use this page to bulk import users and their attributes from a valid XML or Excel file.

File Selection

Name

Description

Select Import File Type

The type of the file from where you import the users. The options are:

  • XML

  • Excel

Select File

The path and name of the XML or Excel file from which you import the users.

If you select the Excel file option, use the template that System Manager supports. You can download the template from User Management > Manage Users > More Actions > Download Excel Template.

If a file type does not match, System Manager displays an error message.

Button

Description

Browse

Displays a dialog box to select the file from which you import the users.

General

Name

Description

Select Error Configuration

The options are:

  • Abort on first error: Aborts importing the user records when the import user operation encounters the first error in the import file containing the user records.

  • Continue processing other records: Imports the next user record even if the import user operation encounters an error while importing a user record.

Select Import Type

The options are:

  • Complete: Imports users with all the user attributes.

  • Partial: Imports users with specific user attributes.

Select Import Type is available only for imports using the XML file.

If a matching record already exists

The options are:

  • Skip: Skips a matching user record that already exists in the system during an import operation. Currently, with this option you can add a new communication profile to a communication profile set but you cannot update an existing communication profile in a communication profile set.

    Note:

    This option is not available if you select the Partial option in Select Import Type.

  • Replace: Re-imports or replaces all the data for a user including access control lists, contact lists, and so on. With this option, you can replace a user and the associated data of the user.

    Note:

    Replace is available only for imports using the XML file.

  • Merge: Imports the user data at an even greater degree of granularity. Using this option you can simultaneously perform both add and update operation of users. For example, add a contact to a contact list and update a last name.

  • Delete: Deletes the user records from the database that match the records in the input file.

Note:

The system confirms that a user already exists in the database by matching the login name of the user in the database with the login name of the user in the imported file.

Job Schedule

Name

Description

Schedule Job

The options for configuring the schedule of the job:

  • Run immediately: Use this option to run the import job immediately.

  • Schedule later: Use this option to run the job at the specified date and time.

Date

The date on which you run the import users job. The date format is mm:dd:yyyy. Use the calendar icon to choose a date.

This field is available when you select the Schedule later option for scheduling a job.

Time

The time of running the import users job. The time format is hh:mm:ss and 12 (AM or PM) or 24-hour format.

This field is available when you select the Schedule later option for scheduling a job.

Time Zone

The time zone of your region.

This field is available when you select the Schedule later option for scheduling a job.

Button

Description

Import

Imports or schedules the import operation based on the option you selected.

Manage Job

Name

Description

Select check box

Use this check box to select a job.

Scheduled Time

The time and date of scheduling the job.

Status

The current status of the job. The following are the different status of a job:

  1. PENDING EXECUTION: The job is in queue.

  2. RUNNING: The job execution is in progress.

  3. SUCCESSFUL: The job execution is completed.

  4. INTERRUPTED: The job execution is cancelled.

  5. PARTIAL FAILURE: The job execution has partially failed.

  6. FAILED: The job execution has failed.

Job Name

A link to the Scheduler user interface. You can also cancel the job from the Scheduler user interface.

% Complete

The job completion status in percentage.

User Records

The total user records in the input file.

Warnings

The number of user records in the input file with warnings.

Errors

The number of user records in the input file that failed to import.

Button

Description

View Job

Displays the details of the selected job.

Cancel Job

Cancels the import operation for the selected job. You can cancel a job that is in progress or queued for import.

Delete Job

Deletes the selected job.

Refresh

Refreshes the job information in the table.

Show

Provides you an option to view all the jobs on the same page. If the table displaying scheduled jobs are spanning multiple pages, select All to view all the jobs on a single page.

Select: All

Selects all the jobs in the table.

Select: None

Clears the check box selections.

Previous

Displays jobs in the previous page.

Next

Displays jobs in the next page.

Done

Navigates to the User Management page.