Skip to main content
                     
As-Built As-Built - Revit As-Built - AutoCAD VirtuSurv - VirtuSurv 2018 As-Built - Modeler VirtuSurv - VirtuSurv 2019          
BuildIT BuildIT - Projector BuildIT - Construction BuildIT - Metrology              
CAM2 CAM2 - SmartInspect CAM2 - 2023 CAM2 - 2018 CAM2 - Measure 10 CAM2 - Measure Q CAM2 - Measure X CAM2 - Measure 3/4 CAM2 - AnthroCAM CAM2 - 2019 CAM2 - 2020
CAM2 CAM2 - 2021                  
Cobalt 3D Imager 3D Imager - Cobalt                  
Cobalt Design Cobalt Design - M Cobalt Design - S Cobalt Design - Dual              
Computers Computers - All Computers                  
FARO Aras 360 & CAD Zone FARO CAD Zone - Fire & Insurance FARO CAD Zone - Crime & Crash FARO CAD Zone - CZ Point Cloud FARO CAD Zone - First Look Pro FARO 360 - Reality FARO 360 - HD FARO 360 - Blitz FARO 360 - Genius    
FARO Connect FARO Connect - Connect                  
FARO Zone present4D - present4D                  
FARO Zone 2D FARO Zone 2D - 2018 FARO Zone 2D - 2019 FARO Zone 2D - 2020 FARO Zone 2D - 2021 FARO Zone 2D - 2022 FARO Zone 2D - 2023        
FARO Zone 3D FARO Zone 3D - 2018 FARO Zone 3D - 2019 FARO Zone 3D - 2020 FARO Zone 3D - 2021 FARO Zone 3D - 2022 FARO Zone 3D - 2023 FARO Zone 3D - 2024      
FARO Zone 3D Advanced FARO Zone 3D Advanced - 2018 FARO Zone 3D Advanced - 2019 FARO Zone 3D Advanced - 2020 FARO Zone 3D Advanced - 2021 FARO Zone 3D Advanced - 2022          
FaroArm/ScanArm FaroArm/ScanArm - Quantum S FaroArm/ScanArm - Quantum M FaroArm/ScanArm - Quantum E FaroArm/ScanArm - Edge FaroArm/ScanArm - Fusion FaroArm/ScanArm - Prime FaroArm/ScanArm - Platinum FaroArm/ScanArm - Legacy Quantum FaroArm/ScanArm - Titanium FaroArm/ScanArm - Advantage
FaroArm/ScanArm FaroArm/ScanArm - Digital Template FaroArm/ScanArm - Gage FaroArm/ScanArm - Quantum S Max FaroArm/ScanArm - Quantum M Max FaroArm/ScanArm - Quantum E Max FaroArm/ScanArm - Gage Max        
GeoSLAM Software GeoSLAM Software - Connect GeoSLAM Software - Draw GeoSLAM Software - Hub GeoSLAM Software - Volumes            
GeoSLAM ZEB GeoSLAM ZEB - Horizon GeoSLAM ZEB - Horizon RT GeoSLAM ZEB - Revo GeoSLAM ZEB - Revo RT GeoSLAM ZEB - Go          
Hand Held Scanner 2D Hand Held Scanner - ScanPlan 3D Hand Held Scanner - Freestyle3D 3D Hand Held Scanner - Freestyle3D X 3D Hand Held Scanner - Freestyle3D Objects 3D Hand Held Scanner - Freestyle 2          
Language Quality HT MT AT NT INT - Internal Sales - Internal Resources Sales - Order and Quote Sales - Product Info Sales - Sales Readiness Sales - Training
Language Quality Sales - Product Launch Sales - Promotions CS - Quote to Invoice CS - Phone System CS - New Hire Training CS - General CS - Product Info CS - Licensing CS - Onboarding CS - Procedures General
Language Quality CS - Procedures Salesforce CS - Procedures Loaner CS - Procedures SAP              
Languages Language - English Language - Japanese Language - German Language - Chinese Language - Spanish Language - Italian Language - Portuguese Language - French Language - Korean  
Laser Projector RayTracer - RayTracer Laser Projector - Tracer M Laser Projector - Tracer SI              
Laser Radar Imaging Laser Radar - VectorRI                  
Laser Scanner 3D Laser Scanner - Focus S 3D Laser Scanner - Focus M 3D Laser Scanner - Focus3D 3D Laser Scanner - Focus3D X 3D Laser Scanner - Focus3D X HDR 3D Laser Scanner - Focus3D S 3D Laser Scanner - Photon 3D Laser Scanner - Focus S Plus 3D Laser Scanner - Swift 3D Laser Scanner - Focus Premium
Laser Scanner 3D Laser Scanner - Focus Core                  
Laser Tracker Laser Tracker - Vantage Laser Tracker - ION Laser Tracker - Vantage S Laser Tracker - Si Laser Tracker - X Laser Tracker - Xi Laser Tracker - Vantage E Laser Tracker - Vantage S6 Laser Tracker - Vantage E6  
Legacy Gage Legacy Gage - Bluetooth Legacy Gage - Plus Legacy Gage - Standard Legacy Gage - Power            
Legacy Software Legacy Software - CAM2 Gage Legacy Software - Gage Software Legacy Software - Insight              
Mobile Scanner Mobile Scanner - Orbis                  
PointSense PointSense - Basic PointSense - Pro PointSense - Building PointSense - Plant PointSense - Heritage PointSense - Revit CAD Plugin - TachyCAD Building CAD Plugin - TachyCAD Archeology CAD Plugin - TachyCAD Interior CAD Plugin - PhoToPlan Basic
PointSense CAD Plugin - PhoToPlan CAD Plugin - PhoToPlan Pro CAD Plugin - PhoToPlan Ultimate CAD Plugin - DisToPlan CAD Plugin - MonuMap CAD Plugin - hylasFM CAD Plugin - VirtuSurv      
RevEng RevEng - RevEng                  
ScanArm ScanArm - Design ScanArm 2.0 ScanArm - Design ScanArm ScanArm - Forensic ScanArm ScanArm - Design ScanArm 2.5C            
SCENE SCENE - Capture and Process SCENE - WebShare Server and 2Go SCENE - WebShare 2Go App SCENE - 2018 SCENE - 7.x SCENE - 6.x SCENE - 5.x SCENE - 4.x SCENE - LT SCENE - 2019
SCENE SCENE - 2go App SCENE - 2020 SCENE - 2021 SCENE - 2022 SCENE - 2023          
Serial FaroArm Serial FaroArm - Silver Serial FaroArm - Gold Serial FaroArm - Bronze              
Sphere FARO Sphere - Sphere                  
Visual Inspect Visual Inspect - App Visual Inspect - CAD Translator                
WebShare WebShare - Enterprise WebShare - WebShare Cloud                

BuildIT

Projector

Laser Projector

Tracer SI

Tracer M

FARO® Knowledge Base

Login/Logout Commands and User Level Profiles with BuildIT Operator

BuildITProjector-bty.png

Overview

In this article you will find a description of the following commands:

  • Windows Login: Login to BuildIT as a Windows user and set the User Level accordingly
  • BuildIT Login: Login to BuildIT as a custom user and set the User Level accordingly
  • Logout: Logout of BuildIT

These commands are completely optional to projection workflows, but for customers that want additional traceability and control, they can be set up to capture username and disable commands based on their assigned permission levels.

FAQs related to this topic are also included below for your reference.

Login / Logout Description

In the Operator workbench only, you will find Windows Login, BuildIT Login and Logout in the toolbar as well as in the File menu.

Clicking the login command OperatorLoginIcon.png will pop up the Login Interface:

OperatorLoginScreen.png

Windows Login:

  • The Username field will accept any Windows User that is defined in the Users.config file (see Related Files).
  • The Password for a given user name stored and managed by Windows. In other words, your Windows account password is the same one used in BuildIT.

BuildIT Login:

  • Both the Username and the Password fields will accept any custom user and its password that are defined in the Users.json file (see Related Files). A maximum of three login attempts is allowed. If authentication fails 3 times, the user will be locked.
     

Clicking the logout command OperatorLogoutIcon.png will restore to "no user" mode, which has a user level of 0 (maximum restriction) when there is not a user logged in.

The Username is used for traceability on reports by tagging the name with their operations (i.e. measurements, completed layers, etc.) while the User Level is used to restrict the use of BuildIT user interface accordingly (i.e. it defines what commands are enable/unable for the current user). Both Username and User Level will be shown on the BuildIT title bar when logged in.

 

User Level Description

The User Level may be defined as follows:

0 - Observers Users at this level can only open and view an existing BuildIT file to look at the results. They cannot make any modifications. This is equivalent to the "Viewer" mode that is enabled if there is no license detected.
1 - Operators Users at this level can open an existing file an run through a predetermined process but should not be allowed to execute operations outside this defined workflow (process).
2 - Users Users at this level are regular users or Operators with the ability to assemble their own command sequences, likely following a prescribed workflow (external), but with some ability to backtrack or fix measurements on minor operational errors.
3 - Supervisors Users at this level can bypass some validations or gates defined to limit any out-of-spec parts and accept them anyway.
4 - Specialists Users at this level are in charge of defining the workflow for their organization or cover a wide range of applications and are able to determine the proper methods to be applied in each case.
5 - Administrators Users at his level have full control of the application, including defining site-specific configuration parameters and customizing the application and restricted parameters.

 

Related Files

Name Location Description
Users.config

C:\Users\UserName\Documents\BuildIT

Note: This file is only created after the first time the Login command has been launched.

Defines the User Level for each Windows user and/or group.

When initially created, the "users" section will be empty. You can add any existing username. The "groups" section will already be populated with the groups made available by the IT administrators managing the computer. You can edit the permission level assigned to each group.

Users.json

Location is set by the user.

Note: This file needs to be manually created.

 

Defines the list of users when using BuildIT Login only. It is not required for Windows Login.

It also defines the Usernames, User Level, and Password.

login_path.config

C:\Users\UserName\Documents\BuildIT

Note: This file needs to be manually created

Defines the location of the Users.json file so that BuildIT can access it and retrieve the list of users when using BuildIT Login only. It is not required for Windows Login.
permissions.data

C:\Program Files\BuildIT\BuildIT Projector 20xx.x\data\profiles\Projector

Note: For older versions it is in ..\profiles\Operator

Defines the minimum User Level required to enable for each command.

It also defines the default User Level when launching BuildIT, before anyone inputs their credentials. When first installing BuildIT, it is set at User Level 5 so that there are no restrictions initially. If you wish to enforce user levels, edit this file by setting "defaultUserLevel" to 0.

FAQs

What is the difference between the user when using Windows Login or BuildIT Login? Are they interchangeable?

When using Windows Login, users are defined by the active Windows user. On the other hand, when using BuildIT Login, users are custom defined. Each type of user needs to use its specific login command. Windows Users cannot login using BuildIT Login and custom users cannot login using Windows Login.

What login command is preferable, Windows Login or BuildIT Login?

While both Windows Login and BuildIT Login have their merits, Windows Login is generally the preferred choice due to its password schema being defined by Windows, which offers a higher level of security. BuildIT Login is designed to be an alternative when Windows Login cannot be used. For instance, it becomes the preferred option in cases where operators lack individual Windows accounts and rely on a single shared account for access.

For Windows Users, how are the permission level define for each Username? How can I define or customize the permission level for each Username?

When you first login, the following message will appear:

“The configuration file for user levels was not found and one was created automatically. It should be reviewed to adjust the level assigned to key user groups.
C:\Users\UserName\Documents\BuildIT\Users.config”

This file is auto populated with all Windows groups, whose User Levels may be edited. You may also set the User Levels individually in the “users” section. If customization is needed, follow these instructions:

  1. Go to “C:\Users\UserName\Documents\BuildIT
  2. Create a copy of the “User.config” file and rename it as “User_old.config”, if needed for backup
  3. Open Notepad as an administrator
  4. Open the “User.config” file
  5. Make changes to the groups’ User Level or add specific Usernames with respective User Level:
    1. Groups (“groups” section): Change the numbers of each group to the desired values between 0 and 5. Note that the number represent the User Level given to each user of the respective group. Make sure to change the numbers only.
    2. Users (“users” section): Add the Username and its respective User Level in the following the format
      "username": user level where:
      "username" is a Windows user login
      user level is a value between 0 and 5.

Example:

    "users": {
        "John Smith": 5
    },

Contact us at support@builditsoftware.com for more details.

For BuildIT Users, how can I setup users and configure it to work in BuildIT?

There are 2 files that need to be manually created: Users.json file and login_path.config.

To create Users.json file:

  1. Go to your preferred location to store the file containing the list of users. This location should not be obvious for regular users.
  2. Create a file named “Users.json”
  3. In this JSON file, define the list of users, along with their passwords and permission levels, using the following format:

{
    "user1":
        {
            "level": 1,
            "password":"password1"
        },
    "user2":
        {
            "level": 2,
            "password":"password2"
        }
}

To create login_path.config file:

  1. Go to “C:\Users\UserName\Documents\BuildIT
  2. Create a file named “login_path.config”
  3. In this file, specify the path to the Users.json file on a single line. For example: C:\PATH\Users.json

For BuildIT Users, how can I unlock a user that was locked after 3 failed connection attempts?

  1. Navigate to the folder where the Users.json file was created during setup.
  2. Delete the file named "LockedUsername.lock," where "LockedUsername" is the specific user that you want to unlock. Once deleted, next time the command BuildIT Login is run, that user would be able to have 3 more attempts.

Contact us at support@builditsoftware.com for more details.

What’s the purpose of this command?

The Username is used for reporting purposes. The User Level is used for enabling/disabling some commands.

Do we have some levels of restrictions, edit, etc.?

Yes, on installation of the software, there are default restrictions according to the User Level (see User Level Description section above). If customization is needed, follow these instructions:

  1. Go to "C:\Program Files\BuildIT\BuildIT Projector 20xx.x\data\profiles\Projector"
  2. Create a copy of the “permissions.data” file and rename it as “permissions_old.data”, if needed for backup
  3. Open Notepad as administrator
  4. Open the “permissions.data” file
  5. Change the numbers to the desired values. Note that the number represents the minimum level required to enable the command. Make sure to change the numbers only.

Contact us at support@builditsoftware.com for more details.

Can multiple users log in simultaneously?

By default, only one user can be logged in at a time. However, for workflows where multiple operators are working on the same plan, you may enable the "multiuser" parameter, and then you’ll be able to have multiple names (users) per layer in the report. If desired, follow these instructions:

  1. Go to “C:\Users\[UserName]\Documents\BuildIT
  2. Create a copy of the “User.config” file and rename it as “User_old.config”, if needed for backup
  3. Open Notepad as administrator
  4. Open the “User.config” file
  5. Make the following change:

    OperatorUserConfigEdit.png

Contact us at support@builditsoftware.com for more details.

If I enable multiple users, can a mix of Windows Users and BuildIT users connect simultaneously?

Yes, there is no restriction on what time of user is connected. The only restriction is that a Windows Users connects using the Windows Login command and BuildIT user using the BuildIT login command. For example, operators could be defined as BuildIT users and higher level users like Supervisors or Administrators can login with their Windows login information.

Can I lock projection plans so that they can only be run by specific users?

Yes. In order to make it available, go to “File > Settings > Projection”, and check “Allow defining specific users for projection”.

OperatorSpecificUserSettings.png

Then, select the projection plan that you want to lock and add the users to the “Allowed Users” property.

OperatorAllowedUsers.png