Dimensioners at the price of a coffee per day

Support Center

vMeasure Forge UX

Table of contents

1. Introduction

1.1 – The purpose of this guide

This document is necessary to understand the vMeasure Forge Application, the cloud-based Dimensioning Intelligence Platform powering the world’s first and only dimensioning as a service solution.
vMeasure Forge collects all the measurement data from Ultima and is also used to configure and manage the device. Therefore, anyone who uses the cloud application should learn about its various features and settings to ensure smooth operations of both vMeasure Ultima and Forge (Cloud).

1.2 – How to use this guide?

The vMeasure Forge Application walkthrough manual will provide step-by-step instructions using samples from the cloud application. This will cover all the essential settings within vMeasure Forge. You can also view a video demonstration of that step at the end of its section.

1.3 – Pre-requisites

Whitelist the following URL and ports from the network firewall.

URL: https://forge.vmeasure.ai/

Ports: 8000, 6600, 8003, 8050

Getting started with vMeasure Forge

The vMeasure team will assign your system to the Forge account. This is how to initialize the vMeasure Ultima system through Forge:
Resetting Password -> Site Creation -> Assign System to Site -> User Creation -> Assign User to Site
In the 4th step, a default admin user and an operator will be created by the vMeasure Team. Additional operators can be created as per demand.

2.1 – Resetting Password

Step 1: You will receive an automated mail from noreply@visailabs.com for resetting the password. Please check the junk folder if it does not pop up in your inbox.

Reset Password Email

Step 2: Click on the ‘Reset Password’ button.

Set New Password Window

Step 3: This will take you to the ‘Set New Password?’ web page where you can create your password. Click on the ‘Create Password’ button to proceed.

Password Reset Successful

Step 4: The password reset is now successful. Navigate to the Login Page to enter vMeasure Forge using the new password.

2.1.1 – Forget Password

If the ‘Reset Password’ link expires, then you would have to create a new password (if you are logging in for the first time) or set a new password (if you have forgotten the old one)

Link Expired Message

Step 1: Navigate to the ‘Login Page’ and click on the ‘Forgot Password’ button.

Forgot Password

Step 2: Enter your email ID and click on the ‘Reset Password’ button.

Forgot Password Web Page

Step 3: Repeat the steps provided in section 2.1 – Resetting Password.

2.2 – Site Creation

The first step in system initialization is to specify your site details on the application.
Figure 1: Login Page
Step 1: Login to Forge using your credentials

Step 2: Navigate to the ‘Site’ tab on the left corner of the screen as shown in the image below:

Figure 2: Site Tab
Step 3: Click on the ‘Add Site’ button indicated on the image below:
Figure 3: The Add Site Button
Step 4: Enter the details of the site
Figure 4: Site Form

Step 4a: Select the ‘Site Type’ from the dropdown.

Figure 5: Site Type

Step 5: Click ‘Save’ after completion.

Figure 6: Saving the Site Information

2.3 Assign site to a system

This step will allow you to assign your site to the device. If you have more than one site, then here is where you allocate specific devices to specific sites.

Step 1: Click on the ‘Systems’ tab on the left corner of the screen.

Figure 7: Assigning site to a system
Step 2: Select the desired system to which you would like to assign a site.
Figure 8: System Selection

Step 3: Click the ‘Assign Site’ dropdown on the right corner of the screen. Choose the site from the dropdown.

Figure 9: Assigning Site
Step 4: Confirm the selection by clicking the tick button.
Figure 10: Assign Site Confirmation

Step 5: A Confirmation pop up appears displaying old site and new site. Click ‘Yes’ to confirm your selection.

Figure 11: Assign Site Popup

Step 6: Once Clicked ‘Yes’, you have successfully updated the site.

Figure 12: Site Update Confirmation

Step 7: After selecting the site, click the Reload button above the ‘Assign Site’ button for the assignment to take effect.

Figure 13: The Reload Button
With that step, you have successfully assigned a system to your site.

2.4 User Creation

There are four types of users who can be created on vMeasure Forge:
Admin: The admin user will have a separate login credentials to vMeasure Ultima device and the Forge application. This persona can create, assign, and manage users, sites, and workflows.
Custom User: A Custom User is a sub-admin. This persona has access to all features of an Admin, with limited accessibility to user creation, logs, device, and account configuration.
Supervisor: A supervisor’s access is limited to the dashboard and reports. This persona cannot access any other features.
Operator: An operator can only access the touchscreen. This persona is given as much access as needed to do the everyday dimensioning activity.
Step 1: Log in to the Forge account.

Step 2: Click on the ‘Users’ on the left side of the screen.

Figure 14: The Users Tab
Step 3: Click on the ‘Add User’ on the right side of the screen.
Figure 15: The ‘Add User’ Tab

Step 4: Fill the ‘User Form.’ In the ‘User Type’ field, select the preferred user.

Figure 16: The ‘User Type’ Tab

Step 5: Click the ‘Save’ user button to create a preferred user on vMeasure Forge.

Figure 17: The ‘User Type’ Save Tab

2.5 – Assign User to the site

In this section, you will be able to assign a user to a specific site of your choice.

Step 1: Navigate to the ‘Site’ menu.

Figure 18: The ‘Site’ Menu

Step 2: Click on the Tools Icon in the site to which you want to assign a user to.

Figure 19: Tools Icon

Step 3: Step 3: Inside the ‘Site View’ tab, click on the ‘Users’ on the left side of the screen.

Figure 20: User Tab
Step 4: From the dropdown menu, select the desired user.
Figure 21: User Selection
Step 5: Once you select the user you want to assign, click on the ‘+ Add User’ button beside the dropdown menu.
Figure 22: Add User Button

Creation of workflows, webhooks, file hooks, and config groups

You can have up to 10 custom workflows on the vMeasure Ultima device which can be set up via Forge. This allows the user to capture additional data than just the SKU dimensions and weights.

For instance, you can capture the SKU attributes such as flammability and fragility before proceeding with its measurement. This will enable better slotting decisions and ensure SKU safety during the put away process.

On the integration front, you can create webhooks to integrate the cloud server of your choice with Forge. Alternatively, you can also use the device on Slave Mode which helps you to trigger measurements from a remote system.

So, vMeasure Forge allows you to combine workflows and webhooks by putting them into a ‘config group’ and assigning that config group to a system.

These are the 5 steps for configuring a new system:
A default workflow will be available on the vMeasure system. If you need any additional custom workflows, you can create them as per requirement.
Not all steps here are mandatory for the operation of vMeasure Forge.

Workflow Creation – To get a custom workflow.
Webhook Creation – To hook measurement data with 3rd Party Cloud.
File hook Creation – To hook the image data to cloud storage.
Config Group Creation – To select the workflow and webhook combination.
Assign Config Group – To assign the Group to the system.

Before we see all these steps in detail, you must know about the two primary modes of the Ultima System:
  1. Master Mode – The user can trigger measurements through the touch screen or any other local triggering options such as the barcode or weight sense trigger to initiate measurements. Once the measurements are done, the data will be automatically pushed to the configured webhook URL. Here, the vMeasure device is the center of all dimensioning activities.
  2. Slave Mode – In this mode, the vMeasure device is passive and triggered by a remote system through Rest API calls.

3.1 – Workflow Creation

This section will explain the workflow creation both in the Master and the Slave Mode.

3.1.1 – Workflow Creation

To create a workflow in the Master/Slave mode, login to your Forge account and follow the below steps:

Step 1: Navigate to the ‘Workflows’ menu.

Figure 23: The Workflow Tab

Step 2: Click on the ‘Add Workflow’ button to the right side of the screen.

Figure 24: Add Workflow Button
3.1.1.1 – Workflow Creation – Tab 1 – Basic Settings
The Workflow creation spans 3 different tabs. We will breakdown these tabs and their fields in the upcoming sections.

Step 1: Enter all the details in this Workflow form.

Note: Choose the Device Mode as either Master or Slave Mode as per your preference.

Figure 25: The Workflow Form Tab 1 – Basic Settings

For Master Mode, you can enable the Key Navigation to configure the ‘Next Key’ and the ‘Skip Key’ using the keyboard buttons provided in the dropdown.

Figure 25.1: The Workflow Form – Basic Settings – Key Navigation Field

You can also use the Barcode to navigate the touch screen. For this to work, generate a Barcode for the ‘Next Key’ and ‘Skip Key’ using the key codes provided in this section.

Figure 25.2: The Workflow Form – Basic Settings – Barcode Navigation Field

NOTE: Key Navigation Field and Barcode Navigation Field is not available under Slave Mode.

Calibration Settings: You can set the calibration either as Auto Detect Mode or Manual Mode.

  • Auto Detect Mode: Automatically detects the Calibration setting.
    • Note: Auto Detect Mode doesn’t work on the Envelope Mode
  • Manual Mode: You can choose the preferred Calibration Modes from the dropdown.
  • Calibration Expiry: You can set the validity of the calibration from 24 hours to 48 hours.
Figure 25.3: The Workflow Form – Basic Settings – Calibration Settings Field
3.1.1.2 – Workflow Creation – Tab 2 – Measurement Page

In the Measurement Page, you will find the following fields highlighted in the table given below. You will also get an idea of their functionalities.

Figure 26: The Workflow Form Tab 2 – Measurement Page

In the Measurement Page, you will find the following fields highlighted in the table given below. You will also get an idea of their functionalities.

# Field Description

1

Barcode Field
Enabled only in Master Mode. Provide the Barcode Field Name and its minimum and maximum length

2
Barcode Classification
Enable this to mention the barcode classification
2.1
RegEx
Enter more than one Regular Expression and Classification Name
2.2
API Validation
Select the Classification Names and Click Configure button

3
Additional Barcodes
Enable to include additional barcodes

4
Measurement Trigger

The Trigger mode is enabled only for Master Mode and set to ‘Barcode’ by default
4.1
Delay After Trigger
The time delay between the barcode scan and measurement
4.2
Weighing Scale Trigger
This is an additional trigger option to work along with the barcode/remote trigger

5

Smart Measurement
This feature used to perform measurement without failure due to non-placement of object/hand over the object/person/other object closer to the object

6
Volumetric Weight
This section contains the Volumetric Weight configurations
6.1
Standard / Dynamic
You can choose either standard or dynamic. Dynamic allows you to add more than one Volumentric Divisor
6.2
Volumetric Divisor
This is a read-only field that displays a volumetric divisor set.

7

Cubic Volume
Option to enable or disable Cubic Volume of the parcel.

8

Real Volume
Option to enable or disable Real Volume of the parcel.

9

Custom Field
Option to enable or disable Custom Field of the parcel.
9.1
Add Field
This button allows you to add multiple Custom Fields as list, toggle or text

10

Image Annotation
This section contains image annotation configurations
10.1
Date/Time
Select check box to display date and time on the annotation on the image
10.2
Volumetric Weight
Select check box to display Volumetric Weight annotation on the image
10.3
Barcode ID
Select check box to display Barcode ID
10.4
Cubic Volume
Select check box to display Cubic Volume
10.5
Enable Custom Field
Select check box to display the Custom Field list

11

Measurement Result
11.1
Enable Result timeout
Set the result timeout from the drop down
11.2
Enable Measurement Reject
This option is available only for result timeout greater than or equal to 5 sec
11.3
Show Additional Result
Enable or disable additional result to show Volumetric Weight, Cubic Volume or Real Volume
11.4
Show Result Barcode

12

Measurement Retry
Enable this to set the Maximum Retry Count

13

Upload Mode
This mode provides the flow in which measurement data is uploaded to Forge cloud.
13.1
Synchronous / Asynchronous
  • Synchronous mode immediately tries uploading data, user need to wait for upload to complete.
  • Asynchronous mode pushes data to queue for uploading in background. Set the Max Queue size to avoid accumulation of data in device.

14

Additional Images
Enable Additional Images to display images captured before measurement and captured on measurement

15

Additional Video
Enable Additional Video to include video. Select the preferred video duration from the dropdown

Click on the ‘Next’ button to proceed to the final step of the Workflow creation process.

3.1.1.3 – Workflow Creation – Tab 3 – Additional Inputs Page
In this section, you can add additional fields between the barcode and the measurement page to collect even more information.
You can do so by creating any one of the following field types:
– Text Box
– Check Box
– Radio Button
Figure 27: The Workflow Form – Tab 3 – Additional Inputs

Click the ‘Save’ to finish the workflow creation.

3.2 – Webhook Creation

A webhook is an URL of a server you wish to push the SKU measurements and the workflow data to. This section will explain how you can create one such webhook.

Step 1: After logging in to your Forge account, navigate to the ‘Webhook’ tab.

Figure 28: The Webhook Tab

Step 2: Click on the ‘Add Webhook’ on the right side of the screen.

Figure 29: The Add Webhook Button

Step 3: Input the required details in the ‘Webhook Form’ using the instructions given below

Figure 30: The Webhook Form
S.No Field Description
1
Webhook Name
Specify the name for this webhook
2
Request Format
You can select the request format from anyone of these two extensions: JSON or XML
3
Measurement Status
Set measurement Status to ALL, SUCCESS, FAILED based on your preference
4
Method
Choose the API method (PUT or POST) that will meet your need.
5
Webhook URL
Enter the webhook URL

Step 4: Either choose the Default Payload or Customize Payload in the ‘Standard Payload’ section to use the existing field name or customize the payload keys containing the measurement data as shown below.

This field allows you to have all the fields in the desired format of the server. For instance, if a shipping software accepts ‘length’ as ‘LENGTH,’ then you can configure the same in this menu.
Figure 31: The Standard Payload Menu

Step 5: Click on ‘Pencil’ icon to edit any fields based on your requirement and input the desired value

Figure 32: Key Payload
Similarly, configure all other desired keys.

Step 6: Click on the ‘Save’ button to successfully create a Webhook.

3.3 – File hook Creation

File hook enables you to save the measured SKU photographs to your desired S3 bucket.
In this section, you will see how to create a File Hook.

Step 1: Login to your Forge account and navigate to the ‘Web Hook’ tab.

Figure 33: The Webhook Tab

Step 2: Click on the ‘File Hook’ tab next to the ‘Webhook’ tab.

Figure 34: The File hook Tab

Step 3: Click the ‘Add File Hook’ button to the right side of the screen.

Figure 35: The File hook Tab

Step 4: Enter all the required details in the ‘S3 Webhook Form’

Figure 36: The Add File Hook Button

Step 5: Click on the ‘Save’ button to successfully create a File Hook.

3.4 – Config Group Creation

Config Group is the centralized location from where the system accesses the webhook, file hook, and the workflow configurations. Once you have created a Config Group, you can easily assign a group to a system.
So, this section will provide you with the steps required to create a Config Group.

Step 1: Login to your Forge Account and navigate to the Config Group tab.

Figure 37: The Config Group Tab

Step 2: Click on the ‘Add Config Group’ button on the right side of the screen.

Figure 38: The ‘Add Config Group’ Tab

Step 3: Enter all the required details in the ‘Config Group’ Form. Select the desired workflow, file hook, and webhook from the respective dropdown.

Figure 39: The Config Form

Step 3.1: You can have up to three webhook based on their Measurement Type.

  1. Measurement Check – To pass all measurement data done using reference box.
  2. Classification – To pass all measurement data based on column classification (custom fields)
  3. Normal – To pass all daily measurement data.
Figure 40: Webhook Prioritization

Step 4: Click on the ‘Save’ button to successfully create a Config Group.

3.5 – System Configuration

Now that you have your Config group ready, it is now time to assign that group containing its own set of workflows, webhooks, and file hooks to a system and get it up and running.

Step 1: Navigate to the Systems tab on the left side of the screen.

Figure 41: The Systems Tab
Step 2: Selected the desired system to which you would like to assign the Config Group.
Figure 42: System Selection

Step 3: Click on the ‘Assign Group’ dropdown and select your desired group.

Figure 43: Group Selection

Step 4: Click on the Tick icon to confirm the selection.

Step 5: Click Yes to confirm the newly assigned config group.

Figure 44: Assign Group Confirmed

Step 6: Click on the ‘Reload’ button for the System configuration to take effect.

Figure 45: Reload for System Configuration to take effect
After reloading, you will see that the selected system has been assigned to the Config Group you have specified. This step will successfully configure the system and get it ready for use.

4. Getting started with Forge APIs

You can integrate your system to the vMeasure Forge (Cloud) seamlessly with the help of APIs. Refer to the vMeasure Forge API Documentation to know more about API integrations.

The Forge APIs need systemid and the userid to validate and identify the respective system(s).

This section will show you how to retrieve the systemid and the userid from vMeasure Forge.

Step 1: Login to your Forge account and navigate to ‘My Account’ tab on the top right corner of the screen.

Figure 46: My Account

Step 2: Click on the ‘Account Keys’ tab.

Figure 47: The ‘User Keys’ Tab

Step 3: Copy the USER ID.

Figure 48: API KEY

Step 4: To get the systemid, navigate to the ‘Systems’ tab.

Figure 49: The Systems Tab

Step 5: Identify the system to which you want the integrations to be done. Copy the ‘Device Token’ of that system.

Figure 50: Device Token

5. Reports Management

vMeasure Forge allows you to view and download the SKU/Parcel measurement data including the photograph. Every SKU/Parcel you ever dimensioned will be stored here for a period of 30 days.
In this section, you will see how to download the measurement data to your system and all other features in the reports page.

Click on the Reports dropdown tab. You can choose your preferred reports from the list of Reports.

Figure 51: The ‘Reports’ Drop Down

5.1 Reports

The reports allow you to download the 30-day report which includes the following:
  • ID
  • Barcode ID
  • Length, Width, Height
  • Cubic Volume
  • Actual Weight
  • Volumetric Weight
  • Image
  • Artifacts (Contains Videos or additional images taken during measurement)
  • Scanned Time
Figure 52: Reports Tab

Step 1: Click on the period dropdown to download the report for up to 30 days.

Figure 53: Reports Tab- Period Selection

Step 2: You can use the Select Columns option to select the list of columns you wish to display in your report

Figure 54: Select Columns

Step 3: You can click on the check box to select one or more measurements you wish to download to your system.

Figure 55: Measurement Data Selection

Step 4: You can download the data in three different formats:

  • CSV
  • JSON
  • ZIP containing all images

Choose your desired format and click the ‘Download’ button to begin download.

Figure 56: File Format Selection

Step 5: The file is now downloaded to your system.

Figure 57: File Downloaded

5.2 Detailed Report

Similarly, you can also utilize the functionality of the Detailed Report to download a report for the past 7 days

Figure 58: Detailed Report

5.3 Daily Reports

Use Daily Reports to download a report for one day.

Figure 59: Daily Report

6. Support

If you have any questions about our product or applications, contact our support team – send an email, call us, or use our contact form.
It might take a few minutes so that we can support you as efficiently as possible. While contacting, tell us:
  • The name of the product
  • The serial number of the product
  • The short description of the issue
  • The peripherals connected to the system for answering your questions
We will be happy to help you!

Contact us,

Email: vmeasure@visailabs.com
How well did we answer your query?

vMeasure Parcel Ultima
The world’s first and only Dimensioning as a Service (DIMaaS).

Dimension everything from an envelope/lipstick to a refrigerator using a single device at the cost of a coffee per day.
Schedule a Demo
View Pricing Plans

Request Free Trial