Managing Users
Learn how user administration works within Unimarket and how you can create, view and update User details.
-
Manage Users Overview
Community users can be created and managed, by users with the Community Administrator or User Administrator role.
Organization units, buyer groups and user default settings, can also be created and assigned from the Manage Users view screen.
Additionally, a list of community users can be exported in a CSV formatted file.
Note: If users are externally managed, all user details must be edited within your system and not within Unimarket. Access Manage Users View Screen
To view the Manage Users screen go to the the Administration module > click Users.
The following functions can be actioned from the Manage Users screen. For additional subject information, click on the link(s) below:
- Create User - Create individual users.
- Upload Users - Used to upload user details in bulk via a CSV file import.
- Edit or Delete User - Update user details.
- Unlock User - Unlocking a user account.
- Buyer Groups - Used to determine suppliers, buyers can access.
- Invite Users - Send invitation email to users to finalize the user setup process.
- Out of Office - Used to assign an alternative approver, when the approver is unavailable.
Settings
This is that a great way to streamline the new user (including new SSO users) setup, to establish a user default Role, Buyer Groups, and Organization Units.
Which allows Community Administrators or User Administrators, to default certain roles and permissions to all users upon creation.
Communities who use auto-provisioning can add new SSO user or new user, by adding Roles, Buyer Groups, and Organization Units.
Once completed, select Save.
To find out more information on New User SSO & Auto-provisioning, watch this short video:
-
User Export
Unimarket provides the ability for Community Administrators or User Administrators to export a list of Users. This provides a lot of useful information, and can also be used as the starting template if you are updating user records in bulk.
To Export the User List:
Go to Administration > Users
Expand the filters and apply any filters (or untick the default state of enabled users only)
Click Export
The User Export will run as a background job and be available to download as a spreadsheet, just the same as our other exports.
The fields in the User Export are:
Field Purpose Username The users system username as per the customers naming conventions First Name User First Name Last Name User Last name Email User Email Address Enabled Y or N (to denote enabled yes or no) External User Management Y or N (to denote if users are externally managed) External User ID External ID where applicable (if provided by the customer) Vendor ID Where applicable (if provided by the customer) Self Approval Level If the user has a self-approval limit to approve their own requisitions/expenses to that value Org Units The Organisation Unit(s) the user is attributed to On Behalf Of Org Units The Organisation Unit(s) the user can buy on behalf of Roles The Roles the User has (see list of roles) Buyer Groups The Buyer Group(s) the user is included in, which drives the visibility of suppliers and catalogues in the marketplace. Phone User phone number that has been added to their profile Last Login The date & time the user last logged into the system Created Date The date & time the user was created Deactivated Date The date & time the user was deactivated -
Create A Community User - Manually
Users with the Community Administrator or User Administrator role, can create individual users. This is ideal, if the community has a small number of users to add.
To add a large number of users, the bulk upload option may be useful. For additional information, refer to help article Uploading Community Users.
Before creating individual users, ensure the appropriate Organization Units, Self Approval Levels and Buyer Groups has been assigned, first.
Note: Users are only able to edit their name, phone number and email address (and default account code, if set as a user default). All other settings are managed by Administrators. Create A Community User
To manually create a user, go to the Administration module > select Users > click Create.
The Create User pop-up box will appear, to enter information in the required fields marked with a red asterisk. For additional field descriptions, refer to the list below.- First Name: User's first name.
- Last Name: User's last name.
- Username: The username the user use when logging into Unimarket.
- Display Name: Name displayed once logged into Unimarket.
- Send Invitation: If the box is checked, an invitation email will be sent to the user to complete user setup by creating a password. Otherwise, you need to enter a password for them in the next field.
- Password: If the Send Invitation box is checked this field will be unavailable. If not this is where you enter the users login password.
- Confirm Password: If the Send Invitation box is checked this field will be unavailable. If not this is where you enter the users confirm the login password.
- Email: User's email address (where all notifications will be sent for the user).
- Enabled: If the Send Invitation box is checked, this box will be unavailable. As the user's login will be disabled, until activated via the invitation.
- External User Management: This box indicates whether the user details are managed via integration with an external user management system or within the Unimarket portal.
- External Unique ID: The External Unique ID is assigned from the community's management system, if External User Management is being used.
- External User ID: This field is populated with the external user ID from your external user management system. If the community uses one that requires the user to have this entered.
- Vendor ID: If a user is set up in your external ERP or finance system, as a vendor and your community has the Expenses module enabled in Unimarket. You may need to enter their vendor ID here to ensure any data regarding expenses for this user, can be transferred to your ERP/Finance system.
- Self Approval Level: This is where you would assign the maximum value that the user can self approve their own requisitions/expenses, up to. If blank, the user cannot self approve anything.
- Phone: A contact number for the user.
- Roles: This is where you select the roles that give the user the correct access and abilities. For additional information, refer to help article Unimarket User Roles.
- Buyer Groups: Select the buyer groups the user will need access to.
- Organization Units: Select the org units the user is a part of.
- On Behalf Of Organization Units: This field is only available, if the user has the Buyer role assigned. If the user makes purchases on behalf of any org units, they are not a part of. Those org units would need to be entered in this field. This allows other users in the entered org units to reassign requisitions to the buyer for ordering.
Once completed, select Save.
Note: Once the community user has been created, to send the user invitation refer to help article Invite Community Users. -
Invite Community Users
Users with the Community Administrator or User Administrator role, can send Community user invitations. If the Send Invitation box was checked, when creating a user.
The user invitation requires action by the user, to complete their account setup. A link will be provided within the invitation, to confirm their user details before their initial login.
Once Community Administrators or User Administrators has created a user (individually or via upload), the Invite Users screen provides useful details and the option to resend the user invitation, if needed.
Only users who are created in Unimarket, will appear in the user list. For additional information about creating a user, refer to help article(s) Create A Community User - Manually or Upload Community Users.
Invite A Community User
To send a user invitation, go to the Administration module > select Users > click Invite Users.
Users can customized the message sent within the user invitation.
Create A User Invitation
To create a user invitation, users with the Community Administrator or User Administrator role can go to the Administration module > select Users > click the Invite Users tab.
The Invitation screen will populate.
A number of tokens are available to customize the email sent to the user. The use of tokens eliminates the need to draft a different email for individual users.
A generic email is pre-populated in field, as a suggestion. However, users can edit the message in the text box.
Users can preview the message, by selecting Preview. To review extended formatting and editing tools, view the Markup Help guide, by clicking Help.
Note: Please do not remove the @ symbols and/or alter the capital font between the @ symbols. Once completed, select Save.
Send User Invitation
To send the user invitation, locate the desired user in the list > check the Select box, to send an individual invitation > click Invite.
To send a user invitation to all listed users, click Select All > click Invite.
Once the user invitation is sent, their user login will appear as Disabled. Until the user sets their password and logs in for the first time.The Enabled/Disabled status, Created Date (when the user was created, in Unimarket) and/or the Invitation Sent Date/Time, can be viewed on the Invite Users tab.
Resend A User Invitation
If the Enabled status is No, Community Administrators or User Administrators can resend a user invitation. By locating the desired user in the list > check the Select box, to send an individual invitation > click Invite.
To re-send multiple user invitations > check the Select box next to the desired users > click Invite.
-
Create Community Users - Upload
Users with the Community Administrator or User Administrator role, can create multiple users, at once. This is ideal, if the community has a large number of users to add.
If communities have a small number of users to add, the manual option may be useful. For additional information, refer to help article Create A Community User - Manually.
If the community is updating their User list, please remove the below column from the CSV file:
- O (Last Login)
- P (Created Date) and
- Q (Deactivated Date)
You can read below to find out more information on Uploading Users or watch this short video:
Create Community Users via Upload
To create a users via upload, go to the Administration module > select Users > click the Upload Users tab > select Download Template, to insert required user details on the file.
For additional field information, refer to the chart below and the Tips at the bottom of this help article.
Details for User Download Template fields are below:
Column Type Mandatory Length Comments First Name Text Y 255 Last Name Text Y 255 Username Text Y 255 Must be unique Display Name Text N 255 Display Name works like a nickname, where if a user's first name was Daniel they might want to use Dan. This field is used to allow better searchability for a user. Email Text Y 255 Must be a valid email address Enabled Y/N N Defaults to Y External User Management Y/N N Defaults to Y External User ID Text N 255 Vendor ID Text N 255 Self Approval Level Text N 255 Must be blank or match an existing approval level name Org Units N Comma separated list of existing Organization Unit names. On Behalf Of Org Units N Comma separated list of existing Organization Unit names Roles N Comma separated list of existing User Roles names Buyer Groups N Comma separated list of existing Buyer Group names Phone Text N 47 prefix-number-extension with length limits 5-20-20 Default Account Code N This is only included if the Default Account Code settings is set to User Default.
If entered, the format is validated according to the community's Account Code format.
Once the file is updated, save as a CSV file > click Browse > select the CSV file > in the Missing User Action field, select the dropdown.
To disable users not included in the CSV file, click Disable or Ignore > select Upload.
If there are any errors, a red error message will appear on the screen, advising what caused the failed upload. Make corrections to CSV file and upload again.
Once all users are imported successfully, an alert message will appear.
Once Community Administrators or User Administrators has created users via upload, the Invite Users screen is where user invitations will be manually sent and provide useful details.
For additional information, refer to help article Invite Community Users.
Uploading User Data via Automation
Unimarket, also offers customers the ability to update account code data by automatic upload. Speak to your Customer Success Manager, for further details.
Tips
- All the comma separated lists will need to be within quotation marks (" "). Excel and other apps should do this automatically.
- The Column names should not be changed; otherwise the CSV will not load.
- Roles should reference the valid User Roles, in Unimarket.
- Organization Units (Org Unit), Buyer Groups and Self Approval Levels should reference a valid Org Unit, Buyer Group and/or Self Approval Level. That has been setup in the system (first) before loading users.
- You can use the User Upload process to Bulk Change existing users. For example, to assign roles or other information for all users.
-
Edit, Delete and Export Users
Users with the Community Administrator or User Administrator role has the ability to:
- Edit a user details
- Manage the user's Self Approval Level, Roles, Buyer Groups and Organization Units the user belongs to.
- Export users
- Delete (Disable) users
Access the Manage Users Screen
To access the Manage Users screen, go to the Administration module > select Users.
Search Feature
Users can locate desired users by using the User Name field and the Role field. To customize the search, select Filters.
Once Filters is selected, additional search fields will populate.
To view disabled and/or locked users > in the State field, click Disabled and/or Locked > click Apply Filter.
Note: For additional information about how to enable and/or unlock a community user, refer to help article Unlock a Community User. Edit Users
Community Administrators or User Administrator can manually edit user details, locating the desired user > select Edit. To view setting descriptions, refer to the list below.
Once updated, select Save.
- First Name: User's first name.
- Last Name: User's last name.
- Username: The username the user use when logging into Unimarket.
- Display Name: Name displayed once logged into Unimarket.
- Email: User's email address (where all notifications will be sent for the user).
- Enabled: Enables / Disables the user.
- External User Management: This box indicates whether the user details are managed via integration with an external user management system or within the Unimarket portal.
- External Unique ID: The External Unique ID is assigned from the community's management system, if External User Management is being used.
- External User ID: This field is populated with the external user ID from your external user management system. If the community uses one that requires the user to have this entered.
- Vendor ID: If a user is set up in your external ERP or finance system, as a vendor and your community has the Expenses module enabled in Unimarket.
- Self Approval Level: The maximum value that the user can self approve their own requisitions/expenses, up to. If blank, the user cannot self approve anything.
- Phone: A contact number for the user.
- Roles: The roles that give the user the correct access and abilities (i.e. Buyer, Create Invoices). For additional information, refer to help article Unimarket User Roles.
- Buyer Groups: Select the buyer groups the user will need access to.
- Organization Units: Select the org units the user is a part of. This can be used to drive approvals and restrict access to account codes.
- On Behalf Of Organization Units: This field is only available, if the user has the Buyer role assigned. If the user makes purchases on behalf of any org units, they are not a part of. Those org units would need to be entered in this field. This allows other users in the entered org units to reassign requisitions to the buyer for ordering.
Export Users
At times, communities may desire a current listing of users in Unimarket (including their user details).
To receive a customized CSV file for users, select the desired options utilizing the applicable Filter fields > select Apply Filter.
Select Export > click Export Users.
A pop-up box will appear > select the "here" hyperlink.
The Background Jobs screen will populate > once the file is in the Finished state, select Download.
To view the downloaded export at a later time, select Tasks menu > click Background Jobs.
Delete (Disable) Users
Users cannot be deleted within Unimarket.
Alternatively, users can be disabled by locating the desired user > select Edit > uncheck the Enabled box > click Save.
-
Unimarket User Roles
Roles are a system of permissions in Unimarket, determining what features a user has access to. These roles help maintain a well functioning purchasing team and allow each community to tailor the needs within the system to each user. Users with the Community Administrator or User Administrator role can assign user roles.
To Assign/Edit User Roles
- Within the Administration Module, select Users from the menu on the left.
- Search for the User.
- Click Edit on the right side of the users name.
- Make desired changes to Roles field.
- Click Save.
Note:
- If your Users are externally managed, all user roles will be assigned within your finance system.
- All users will have at least the Marketplace, User and Tasks menus visible.
Role Module/ Feature Description Community Administrator Admin - Community Administrators have access to all transactions and settings for the community.
- Reporting menu visible
- Create reports and transaction runs on community data.
- Procurement and Performance dashboards are visible.
NOTE: Users assigned the Community Admin role can switch into other users and make changes if Switch User Edit is enabled. If turned on, the history tab will show data of the actions that were undertaken while a different user was switched in.
Community Features Admin - Administration and Modules menu visible.
- Manage administrator functions that relate to the community features such as general community preferences, ordering and checkout preferences and invoice matching preferences.
Community Management Admin - Administration and Modules menu visible.
- Manage administrator functions that relate to the community setup and master data.
Community Profile Admin - Administration menu visible.
- Manage administrator functions that relate to the community profile such as community name, branding, welcome text, links, community email addresses and more.
Community Supplier Administrator Admin - Administration menu visible.
- Manage supplier information, categories, invitations and connections.
Catalog Reviewer Admin - Visibility of all supplier catalogs shared with the community
- Administration of the Buyer Groups that have visibility of the catalog
-
Accept or decline new and updated catalogs
- Based on Community Catalog Approval settings
- Will receive notifications for catalog approval
- Comment to the suppliers related to their catalogs
Supplier Request Administrator Admin - Manage new supplier requests from end users.
- The requests can be turned into invitations if the supplier is not currently in the marketplace.
User Administrator Admin - Administration menu visible.
- Manage community users including user details and roles.
- Cannot allocate a user the Community Administrator role.
- Manages the Organization settings and Org Units
-
Organization Settings
- PO terms and Conditions
- Locations
- Sharing and Sensitive Transactions settings
User Support Admin - Allows User to Switch into other users to assist with support.
- Not able to make changes while switched into other users, including transaction updates or returning a cart from a supplier.
View Tax Profiles Admin - View Tax Profiles (W9/W8BEN forms) submitted by suppliers.
View Transactions Admin - Users with this role can view any transaction (Purchase, Invoice, Expense, Bid Request, Payments etc) throughout the entire community.
- Without this role, users may only see transactions they are involved in.
- Gives the user a menu option called Reporting, where they are able to see and run reports on community data.
- Allows the user to see the Procurement and Performance dashboards.
Approval Administrator Approvals - Administration menu (gear icon) is visible.
- View and manage community approval information and configurations.
Escalate Approval Approvals - Escalate approvals for viewable requisitions.
Contracts Administrator Contracts - Allows users to make changes and edit a contract as if they were the owner of the contract without being a member of the contract.
- Allows users to able to access the Documents and Transactions tabs without being a member.
Create Contracts Contracts - Contracts menu visible.
- Create new contracts
- Users would need to have this role assigned to create contracts even if they already have the Community Administrator role.
- Users are able to view any Contracts they are a member of (not all contracts)
View Contracts Contracts - Contracts menu visible.
- View any existing contract leadsheets entered for your community.
Expense Administrator Expenses - Expenses menu visible.
- Create expense claims.
- Create expense claims on behalf of other users.
- User is able to Edit Expense Types, Payment Types, Reimbursement Types and Settings under Expenses.
Expenses Expenses - Expenses menu visible.
- Create expense claims.
- Users would need to have this role assigned to create expenses even if they already have the Community Administrator role.
On Behalf of Expenses Expenses - Expenses menu visible.
- Create expense claims on behalf of other users in your org unit.
Create Buyer Invoices Invoicing - Allows Buyers the ability to process invoices which relate to their orders only.
Create Invoices Invoicing - Users with this role can view any transaction (purchase, invoice, expense, bid request, payments etc) throughout the entire community.
- Reporting menu available and able to create and export reports and transaction runs on the community data.
- Invoices outside community tolerances (Rejected/On Hold/ Pending Buyer/Requester Approval) - Depending on community settings they can Reject, Force Match, Send for Approval or Cancel an invoice outside tolerance.
- PO Flip enabled - Use the Order to Invoice feature.
- Retrofit Invoices enabled - Create invoices for orders not yet in Unimarket for buyer approval.
- Invoice Inbox enabled - Access and full use of the Invoice Inbox.
- Users would need to have this role assigned to create invoices even if they already have the Community Administrator role.
- Can upload Payment Status information
Browser Procurement - Shop the marketplace.
- Create incomplete requisitions to reassign to Buyers within their org unit.
- Create Supplier Requests, if the feature is enabled.
- The Browser role can not be used with the Buyer Role.
Buyer Procurement - Shop the marketplace.
- Create requisitions.
- Complete reassigned requisitions from users with the Browser role.
- Create Supplier Requests, if the feature is enabled.
Create Blanket Order Procurement - Create Blanket Orders.
- Users require this role to create blanket orders even if they already have the Community Administrator role.
On Behalf Of Procurement - When a user also has the buyer or browser role they can Create requisitions on behalf of any other user in the community.
On Behalf Of Receiving Procurement - Receive orders on behalf of other users.
- User will see full community open receiving. Ideal for Central Receiving staff.
Over Receiving Procurement - Allows users to receive more than the ordered quantity if Over Receiving is enabled.
RFQ Procurement - Initiate simple RFQs with suppliers.
Bid Request Collaboration Sourcing - Sourcing menu is visible.
- Gives users with the Bid Requests role the ability to select collaborators when creating a bid request.
Bid Requests Sourcing - Sourcing menu is visible.
- Initiate bidding events (RFQ, RFP, RFI) through the sourcing module.
-
Buyer Groups
Buyer Groups are created by Community Administrators, to assign buyers for visibility and access to designated suppliers.
Most communities create a General buyer group, that contains all the suppliers that majority of buyers can purchase from. However, more specific buyer groups (e.g. I.T. or Facilities) can be created if the community desires to restrict specific suppliers to a selected group of buyers.
Buyers and suppliers can be assigned to more than one Buyer Group.
Access the Buyer Group Screen
To access the Buyer Group screen, go to the Administration module > click Users > select the Buyer Groups tab.
Add a New Buyer Group
To add a new buyer group, go to the Administration module > click Users > select the Buyer Groups tab > click +Add Buyer Group > a pop-up box will appear > in the Name field, enter the desired named.
In the Description field, enter optional information that will be viewed under the Description header on the Buyer Group view screen.
Once completed, select Save.
Edit Existing Buyer Group(s)
To edit an existing Buyer Group, go to the Administration module > click Users > select the Buyer Groups tab > locate the desired listed buyer group > select Edit > a pop-up box will appear > update the desired information > select Save.
Delete Existing Buyer Group(s)
To delete an existing Buyer Group, go to the Administration module > click Users > select the Buyer Groups tab > locate the desired listed buyer group > select Delete > a pop-up box will populate > select OK.
Assign Supplier(s) to a Buyer Group
To assign suppliers to an existing Buyer Group, go to the Administration module > click Users > select the Buyer Groups tab > locate the desired listed buyer group > select Suppliers > a pop-up box will appear > in the Available column, select the desired supplier > click the
icon > the desired supplier will move to the Selected column.
Once completed, select Save.
Remove Supplier(s) from a Buyer Group
To remove suppliers from an existing Buyer Group, go to the Administration module > click Users > select the Buyer Groups tab > locate the desired listed buyer group > select Suppliers > a pop-up box will appear > in the Selected column, select the desired supplier > click the
to add the supplier in the Available column > click Save.
Assign Buyers to a Buyer Group
To assign buyers to a Buyer Group, go to the Administration menu > click Users > locate the desired user > select Edit > a pop-up box will appear > in the Buyer Group field, add the desired Buyer Group > click Save.
-
Unlock or Enable a Community User
For security purposes, a user's account will be locked if their password has been entered incorrectly more than five times.
If a user becomes locked, a Community Administrator or Unimarket Support can assist with unlocking the account.
Additionally, Community Administrators or User Administrators can assist with enabling a disabled user account.
Access the Manage Users Screen
To access the Manage Users screen, go to the Administration module > select Users.
Locate Locked Users
To locate locked users, Community Administrators or User Administrators can go to the Administration module > select Users > click Filters.
Once Filters is selected, additional search fields will populate > in the State field, click Locked > click Apply Filter.
Locate the desired user > click Edit > a pop-up box will appear > select Unlock > click Save.
Enable Users
To locate disabled users to enable, Community Administrators or User Administrators can go to the Administration module > select Users > click Filters.
Once Filters is selected, additional search fields will populate > in the State field, click Disabled > click Apply Filter.
Locate the desired user > click Edit > a pop-up box will appear > check the Enabled box > click Save.
If the user was disabled as a result of not receiving a user invitation via email, please confirm the user's email address is correct. If not, update the email address.Once completed, if the community is using:
- SSO Auto-Provisioning: Ask the user to login back into Unimarket, using the assigned username and SSO login process.
- Non SSO Auto-Provisioning: Ask the user to access the Unimarket login page > select Forgotten Password, to receive a temporary password to login. User invitations cannot be resent.