Manage Users

This task can be completed by: 

• Account Administrators
• Participants with 'Manage User' permission

To add new users to the account

1. Go to the Manage Users page.
2. Click Add.
3. On the Add New User page, complete all necessary fields.

Optionally pre-populate any known information for your users in the Business Information section to make this process easier for them when they purchase their license and log in to e-Builder for the first time. Users can overwrite this information if they choose.

4. Select the Notify user that he/she has been added check box to send a notification email to the user that includes their username and password. You can also send the notification at a later time.
   For Trimble ID (TID) enabled accounts, an email will be sent automatically to new users with the TID invitation link. The newly added users must follow the registration process, which includes creating a Trimble ID account. See Add users for more information on adding users to the Admin Console.
5. Optional: On the Access Expires field, set the date that the user's access to Trimble Unity Construct will expire. Access expire dates apply to contract users, which are users that have access to e-Builder using on your organization's purchased licenses. Account administrators have the ability to modify the access expiration date.
6. Click Save.
Tip

After completing this task, manage the user's project membership so they have the appropriate access to system features.

Adding existing users refers to adding an already licensed e-Builder user who has access to another account. Doing so will help you avoid having to create a new user profile. After users have been copied over, you must place them in the appropriate roles and give them project access before they are able to begin working in their projects.

If the user is configured to be hidden in the global directory, they are restricted from being added to multiple accounts. These participants will not show up in the list of available users. This setting is can be managed from the User Details page.

This task can be completed by: 

• Account Administrators
• Participants with 'Manage User' permission

To add existing users

1. Open the Manage Users page.
2. Click Add Existing.

The Add Existing User page is displayed.

3. Enter the person's name and/or username and company affiliation to find them in the directory, and then click Filter
4. Select the check box next to the user's name and click Add User(s).

You are redirected to the Manage Users page and the new user appears in the Users table below.
For Trimble ID (TID) enabled accounts, an email will be sent automatically to new users with the TID invitation link. The newly added users must follow the registration process, which includes creating a Trimble ID account.

Tip

After completing this task, manage the user's project membership so they have the appropriate access to system features.

Add user that changed companies: Best Practices for Implementation

This section provides the best practice procedures for adding existing Trimble Unity Construct users to a new client account when they switch employers.

When an individual who already has an established Trimble Unity Construct username changes employers and moves to a new Trimble Unity Construct client, the new client may want to add the employee as a user under their own company name. Because Trimble Unity Construct associates users with only one company at a time across its global directory, changing a existing user's company name in the new account updates that user's company name globally. As a result, the employee's former employer will see the new company's name displayed on historical actions taken by that employee in their account.

To prevent cross-populating company names and preserve historical data integrity for former employers, follow the best practice implementation steps below:

1. Create a unique username for the employee that is changing jobs on the Add New User page. At the new employer, do not repurpose the former username but instead create a new unique username. By doing so, there are no negative repercussions to associating the user to their new employer's company.
2. To protect the former employer in this scenario, the user that is changing jobs can be hidden in the Global Directory. On the Add Users page, select the Hide in Global Directory check box to hide this user in the global directory, which will prevent them from being added to multiple accounts. When adding existing users from another account, this person will not be included in the list of available users.

This task can be completed by: 

• Account Administrators
• Participants with 'Manage User' permission

A user's record includes their profile data, such as their name, email address and username as well as business information. In addition to this, there are a few access settings that are subject to modification, such as a user's license type, the ability to restrict their access to documents only, and whether or not the person can be added to multiple accounts. For a description of each setting, see Add/Edit User Page Overview.

To edit the details of a user's records

1. Go to the Manage Users page.
2. Click the user's name.

The User Details page is displayed.

3. Click Edit.
4. Make all necessary changes.
5. Click Save.

On occasion you will have a new user start that will have the exact project and role permissions as another user. Instead of having to create the new user and assign the associated projects and role, you can copy another user's project and role membership.

This task can be completed by: 

• Account Administrators
• Participants with 'Manage User' permission

To copy users

1. Go to the Manage Users page.
2. Select the check box next to the user you want to copy, and then click Copy.

The Add New User page is displayed.

3. Enter the new user's profile information.
Tip

When selecting a username, it is recommended to use the initial of the name followed by the last name or the user's email address. All usernames must be unique; otherwise you'll be prompted to enter another username.

4. Select the Notify user that he/she has been added check box to send a welcome email that includes their login information and instructions.
5. Click Save.

Use the email function to send emails to account users to inform them that they've been added to the account, send them their username and password, or send them a password reset link.

Each email recipient will receive the appropriate password reset link as follows:

• When Trimble ID (TID) is enabled on an account, non-migrated users who have not yet completed the TID pairing will receive a Trimble Unity Construct password reset link. They can use that to reset their legacy Trimble Unity Construct password and complete the pairing process.
• Users who have already completed the TID setup will receive a link to reset their TID password (https://myprofile.trimble.com).
• For accounts without TID enabled, users will receive a Trimble Unity Construct password reset link as usual.

This task can be completed by: 

• Account Administrators

To email users

1. Go to the Manage Users page.
2. Select the check box next to the users you want to email, and then click Email.

The Email Users page is displayed.

3. Complete all necessary fields like the Subject and Body.
Tip

CC yourself if you'd like to have a copy of the email for your personal records.

4. To inform users that they've been added to the account, select the Notify user that he/she has been added check box.
5. To include a password reset link, select the Include login info check box.
6. Click Send.
   Each recipient will receive the appropriate password reset link based on their current TID status.

Use this function to resend Trimble ID (TID) invitations to selected users who have not completed the TID migration. At least one user must be selected for this button to be enabled.

This task can be completed by: 

• Account Administrators

If some invitations fail, try again by selecting only those users and clicking Resend TID Invite again. If the issue persists, contact Support.

To email users

1. Go to the Manage Users page.
2. Select the check box next to the users you want to email, and then click Resend TID Invite.

A confirmation pop up is displayed.

3. Click Invite to confirm.
   A message appears confirming how many invitations were sent and reflects the exact outcome for every user in your selection. Any errors that occurred will also be mentioned.
   Users who have already completed TID setup are automatically skipped. The confirmation message will include a skipped count so you know exactly who was excluded.

Users may have to be removed from the account if they are no longer with the organization or their membership is no longer required on a particular account.

If you remove a user from an account while they are logged in, they will be logged out as soon as they attempt to take an action.

This task can be completed by: 

• Account Administrators
• Participants with 'Manage User' permission

To remove users from the account

1. Go to the Manage Users page.
2. Select the check box next to the users you want to remove from the account.
3. Click Remove.

A confirmation page displays.

4. If the user has work assigned to them, click the This user still has work assigned link to reassign their work to another resource.
5. Click Remove User(s) from Account.

Account administrators have the ability to reassign work from one team member to another. There are several reasons why this may be necessary, such as if the user's roles have changed, workload needs to be reallocated, the resource is on vacation, or they are out sick or no longer available. Anything that is assigned to a resource can be reassigned, such as tasks, workflow forms and processes. Work reassignment can also be completed by project administrators from the Projects module. See Reassign Work - Projects for more information.

This task can be completed by: 

• Account Administrators

To reassign work from the Users section

1. Go to the Manage Users page.
2. Select the check box next to the user you want to reassign work for, and then click Reassign Work.
3. Select the project from which you'd like to reassign work.

All open work items display on the next page.

4. Select the check boxes next to the items you want to reassign.
5. Click the Select a user to reassign work to drop-down arrow to make a selection.

By default, the Notify User check box is selected and an email will be sent to the new task owner informing them of this change.

6. Click Reassign.

Multi-Factor Authentication (MFA) is a more secure login process that combines validating two or more independent credentials before allowing the user to access e-Builder. Two-factor authentication provides an extra layer of security to e-Builder user accounts, minimizing the potential for unauthorized access.

Important: Once a user has been configured for MFA they will be required to complete an additional security check before they are allowed to access e-Builder. This added check is known as a Time-Based One Time Password (TOTP). This code will be generated using an Authenticator app on their smart phone or browser authenticator. Due to this, the user will need to have access to their smart phone or browser authenticator each time they wish to log in.

Using a separate mobile device with an authenticator app is the preferred method for MFA validation. If you do not have a mobile device available, you can set up a browser authenticator on your computer.

Contact Support with a request to enable Multi-Factor Authentication (MFA) for your account. Once MFA has been toggled on, you can enable it per user or for all users for additional authentication when they log in. The additional security check will only be required once a user is toggled on for the feature.

If you are using an older version of the e-Builder mobile app and if you are not sure if Multi-Factor Authentication (MFA) is supported, please contact e-Builder Support.

Enable Multi-Factor Authentication

To start the multi-factor authentication set up process - please contact our support team so that they can enable MFA for your account. Following this you can begin the user configuration.

Until MFA is enabled for your account you will not see the MFA toggle.

To enable Multi-Factor Authentication (MFA) for all users in your account

1. Go to the Manage Users page.
2. From the toolbar, click MFA and then select the Enable all users option. A message is displayed asking you to confirm whether you want to enable the two-step authentication for all accounts.
3. Click Enable all users to confirm.
   

   MFA can also be configured on the Add/Edit User page.

To enable Multi-Factor Authentication (MFA) for one or more users

1. Go to the Manage Users page.
2. Use the search filters to narrow down and select the particular users for whom you want to enable MFA.
3. From the toolbar, click MFA and then select the Enable option. A message is displayed asking you to confirm whether you want to enable the two-step authentication for the selected users.
4. Click Enable to confirm.

Register MFA User Profile

Once a user has been enabled for MFA (see Login Using Multi-Factor Authentication) the user needs to then register their user profile for MFA.

To register the user's profile:

• Once the user has been enabled they will get an email sent to them with the registration instructions.
• If they do not receive an email please validate that the email on file in the User Details page for them is correct. Only the account admin can change a user email.
• Once the user receives the email they will need to log on to e-Builder and follow the registration instructions. This will include downloading the third party authenticator app to your mobile device. We recommend Google Authenticator for this.
  • Browser alternative: Install an authenticator on your browser such as the Google Authenticator Chrome extension.

Disable Multi-Factor Authentication

To disable Multi-Factor Authentication (MFA) for all users

1. Go to the Manage Users page.
2. From the toolbar, click MFA and then select the Disable all users option. A message is displayed asking you to confirm whether you want to disable the two-step authentication for all users.
3. Click Disable all users to confirm.
   

To disable Multi-Factor Authentication (MFA) for one or more users

1. Go to the Manage Users page.
2. Use the search filters to narrow down and select the particular users for whom you want to disable MFA.
3. From the toolbar, click MFA and then select the Disable option. A message is displayed asking you to confirm whether you want to disable the two-step authentication for the selected users.
4. Click Disable to confirm.

Reset Multi-Factor Authentication

If a user has lost access to the device needed to complete 2-step verification, resetting the multi-factor authentication will delete their active enrollment. The user will need to re-register.

To reset Multi-Factor Authentication (MFA) for one or more users

1. Go to the Manage Users page.
2. Use the search filters to narrow down and select the particular users for whom you want to reset the MFA configuration.
3. From the toolbar, click MFA and then select the Reset option. A message is displayed asking you to confirm whether you want to reset the two-step authentication for the selected users.
4. Click Reset to confirm.

When a new user is added to your e-Builder account and your account is enabled for MFA the user will automatically be enabled for MFA. If you want to disable the user for MFA see the Disable Multi-Factor Authentication section above.

If you have a large number of users to add to e-Builder, you can import the list using an Excel spreadsheet.

The Import Users process is an import that only creates brand new records. It does not update existing records.

For more details on importing bill rates for the users, see Import Bill Rates.

This task can be completed by: 

• Account Administrators
• Participants with 'Manage Membership' permission

To import a file

The following are the required fields and should be the column headers in your import file. Additional fields can also be added, as seen in the screenshot below.

• First Name
• Last Name
• Username
• Company
• Email
• License Type

If the column names in your import file are different from those in e-Builder, you must map the e-Builder columns to the corresponding columns in your file. However, if the column names are identical to the e-Builder field names, they will be automatically recognized and you will avoid having to map these fields. The image below is of the Field Mappings page that will appear after the file is uploaded. The left column lists the built-in e-Builder fields. The right column (with the drop-down menus) is the column names of the import file.

Custom field values can also be included in the import file.

To import users

1. Go to the Manage Users page.
2. Click Import and select Import Users. The Import Users page is displayed.
3. Click Choose File to search for the file to import.
4. Click Next.
5. If necessary, map the e-Builder built-in fields to the corresponding fields in the import file.
6. Click Next.
7. Click Save.

Bill rates are required for billable Time Tracking activities. They allow you to set hourly rates for project participants in order to more accurately track project costs. You can set default rates for participants which can be applied to all projects they are a part of or you can set different rates for different projects. When a time sheet is entered and a commitment is selected, the pay out calculations will be determined based on the established bill rate for that user.

The Import Bill Rates option is available only if time tracking has been enabled on the account.

To import bill rates

1. Go to the Manage Users page.
2. Click Import and select Import Bill Rates. The Import User Bill Rates wizard page is displayed and guides you through the following sequence of steps:
   1. Step 1 of 3: Select the Import File
      

      Click Choose File to search for and choose the file to import and click Next.

      It is recommended that you download the import template (.xlsx) and use it during the import process. For faster updates, it is recommended that you use the data filter in MS Excel to select the desired username(s) to be updated.

   2. Step 2 of 3: Complete Field Mappings
      • Map the e-Builder built-in fields to the corresponding fields in the import file, if needed.
      • Ensure that the required fields (marked with an *) are mapped correctly and then click Next

      If the template is used for the import, all fields will be automatically mapped.

   3. Step 3 of 3: Review the import details
      

      If there are exceptions, click on the Exceptions tab to review all rows with the exceptions. After resolving the exceptions, save the .xlsx file with the corrections and return to Step 1 to upload the corrected file.

      If there are no exceptions, click Import to complete importing the updated file. The Import User Bill Rates - Results page is displayed.

3. Review the confirmation message and click Finish to exit the wizard.

To check an updated user's bill rates after successful import

1. Go to the Manage Users page.
2. Open the User Details page for the updated user.
3. Click Manage Membership.
4. On the Manage Membership page, click the Manage Bill Rates tab.
5. Observe that the bill rates match the rates that were updated in the Import Template.

User adoption reports can be run at any time. They allow you to view stats on how frequent users are logging into e-Builder.

This task can be completed by: 

• Account Administrators

To run a user adoption report

1. Go to the Manage Users page.
2. Click Adoption Report.

The User Adoption Report page lists all account users, their company affiliation, number of logins and the last time they accessed the system.

3. Optional: Adjust the date fields accordingly and click Run Report to update the results in the table.