Summary

There are cases where you want to collect quantities for a product that is not a per-item measurement, a linear measurement, or an area measurement. You may need to convert your product into a different quantity.

Examples of this include:

Converting a linear foot measurement into the number of fence sections
Converting a square foot measurement into the number of rolls of turf it will take, etc.

These situations utilize Quantity Modifiers.

Sections

Accessing the Quantity Modifier UI

Using the Advanced Quantity Settings dialog

Available Syntax List

Applying Calculations in Bulk

Videos

Simple Modifier - applied once to the total of a captured product

Simple Modifier - applied to each instance of a captured product separately

Custom Expression - applied once to the total of a captured product

Custom Expression - applied to each instance of a captured product separately

Quantity Modifiers - Calculations and Conversions

Accessing the Quantity Modifier UI

During the Product creation process, tap on the Convert Quantity button

Using the Advanced Quantity Settings dialog

Step 1 – Choose whether to apply the settings to each instance of the product separately (Per Item) or all instances together (Total Quantity).

Per Item example – An excavation job can be defined as an area-based product, which allows you to draw rectangles in-app to represent holes. However, if you need to tally the number of man-hours required instead of rectangular areas, you’ll need a “Per-Item” modifier that allows you to input “Depth” in-app and converts the area to volume. Then you’ll need a second modifier that allows you to enter “DigRate” in-app and converts the volume to the number of man-hours.

Total Quantity example – An artificial turf product that is laid out in rectangles in drawing, but needs to be tallied by the number of rolls. This product will need a “Total” modifier that converts area to length, and a second “Total” modifier that converts length to the number of rolls.

Step 2 – Add Quantity Modifier dialog

Use the Add Quantity Modifier dialog to define what will be converted and the equation needed

Provide a description of the change. Note this is only needed so that you can know the conversion later. It does not appear in the externally facing app
Define the name of the unit that will be shown in the externally facing app
You divide or multiply to change the quantity
Choose to round up, down, or no rounding

Step 3 – Test Panel (Preview your quantity calculation)

After you add one or more Quantity Modifiers, use the Test Panel to validate the results before saving the product.

In the Advanced Quantity Settings dialog, click Test Panel.
In Testing Product Items, enter a sample value in the INPUT field.
- The INPUT represents the product’s base measurement (for example, the linear/area quantity you would normally draw in ArcSite).
Review the Quantity result shown for that item. The Test Panel also shows how the quantity was calculated (for example: “multiply … and round up”).
(Optional) Click + More Testing Items to add additional test inputs.
- This is especially helpful when your modifier is set to Total Quantity, because it lets you test how multiple items subtotal and then convert to the final quantity.
If the output isn’t what you expect, close the Test Panel, adjust your Quantity Modifier(s), and open Test Panel again to re-test.
Click Done when you’ve verified the calculation.

Tip: If your modifier is set to Total Quantity, add multiple testing items so you can confirm both the Subtotal and the final converted Quantity.