Skip to main content
Skip table of contents

User Credentials Guide

Difficulty

Intermediate

EMS Compatible

(tick)

iMIS 2017 Compatible

(tick) 

Usage Notes

iMIS 2017 is only able to unlock user accounts, not create or delete credentials. Credentials are not able to be updated if already existing.

Length of Video

n/a

iImport

(tick)

iUpdate

(tick)

Actions

Insert, Insert with Matching, Update, Insert & Update, Delete

Overview

You can create credentials for new or existing iMIS records using the User Credentials source. Existing records must not already have User Credentials to create them. You can also unlock User Accounts. Details about deleting User Credentials can be found in the Delete Action Tutorial.

Updating User Credentials Not Supported

User Credentials are not able to be updated. The Update function is used for locking and unlocking user accounts.

However, an alternative method to update User Credentials involves using the Delete Action to delete User Credentials, followed by Inserting new User Credentials.

Create User Credentials for an Existing ID

When creating user credential for an existing iMIS ID, the ID must have an email associated and must not have credentials already created.

Required Fields

  • iMIS ID - the ID of the user whose credentials are being created.

Optional Fields

  • Username - The username to be assigned.

  • Password - The password to be assigned.

  • Unlock User Account - Used for unlocking (or locking) the user account.

Unsupported Fields

The following fields are not currently supported via iDMS and/or the iMIS REST API:

  • Effective Date - Date to start allowing the user to login.

  • Expiration Dates - Date to stop allowing the user to login and expires their account.

  • Disabled Flag - Whether the user’s account is disabled.

View Example Spreadsheet and Mappings
image-20240207-154542.png
image-20240207-154738.png

Create Credentials While Inserting a New User

Required Fields

  • First name - First name of the new user.

  • Last name - Last name of the new user.

  • Email - Email of the new user.

  • Username - Username for the new user.

  • Password - Password for the new user.

View Example Mapping
image-20240207-155619.png

Requirements for Creating User Credentials

Only first and last name are required to create a new user. When creating user credentials, email is also required.

Please remember, another option for creating credentials on existing records with emails is to use this checkbox option under iMIS Settings > Contacts > Account Management, and this is useful in both iMIS EMS as well as iMIS 2017. 

image-20240207-155027.png

Unlock User Accounts in iMIS EMS

The Update Action is used for unlocking User Accounts

One use case is to use an IQA Query to find all locked out accounts and use iUpdate to unlock all of them.

iMIS EMS Mappings

  • Match On iMIS ID

  • Map "Unlock User Accounts" to True/T/Y/Yes/1

View Example Mapping
image-20240207-160413.png
image-20240207-160826.png

Limitation

Locking User Accounts is not supported at this time.

Unlocking User Accounts in iMIS 2017

For iMIS 2017, you can unlock locked out user accounts with the Update action. Use the UserData panel under Business Object Definitions source - you'll need to type UserData into the field for Business Object Definition.

One use case is to use an IQA Query to find all locked out accounts and use iUpdate to unlock all of them.

iMIS 2017 Mappings

  • Match On iMIS ID

  • Create a mapping to the "Is Locked Out" field from UserData with the value 0/F/False/N/No

View Example Mapping
image-20240207-161327.png

This is different from iMIS EMS, where you use "1/True" to unlock.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.