Skip to main content

Datasets

availability
Platform:WebMobile
Plan Type:BasicEssentialPremiumEnterprise
User Type:RequesterFull UserAdministrator

This article provides a list of the fields and filters available to create reports in MaintainX.

A dataset is a collection of data attached to a specific entity (e.g., parts, work orders, etc.). Use one or more datasets to create reports.

Datasets​

Assets​

Column/FilterDescription
All Parent LocationsA comma-delimited list of the locations of the asset's ancestors (parent asset's location, location for the parent asset's parent asset, etc.).
All ParentsA comma-delimited list of the asset's ancestors (parent asset, parent asset's parent asset, etc.).
Created byThe name of the user who created the asset.
Created onThe creation date and time of the asset.
CriticalityThe criticality of the asset.

The criticality specifies whether the asset is Critical, Important or Normal for your organization. Criticality can be used for filtering and reporting.
DescriptionThe description of the asset.
IDThe asset's unique identification number in the MaintainX organization.
Last UpdatedThe date and time the asset was last updated.
LocationThe address of the location associated with the asset.
ManufacturerThe asset's manufacturer.
ModelThe asset's model.
NameThe name of the asset.
ParentThe parent asset associated with the asset.
Parent LocationThe location of the parent asset associated with the asset.
QR/BarcodeBarcode or QR Code used to identify the asset.
Serial NumberThe asset's serial number.
StatusThe status of the asset:
  • Online: the asset is working as expected
  • Offline: the asset is not operational, usually for planned or unplanned maintenance.
  • Do Not Track: do not track the asset's uptime/downtime.
Teams Assigned toThe teams assigned to the asset.
TypesThe types of the asset.
VendorsThe name of the vendors associated with the asset.
YearThe asset's year.

Labor Utilization by Day​

Column/FilterDescription
Available HoursThe user’s total number of available hours tied to their capacity during the date range.

A user's capacity is available in the Workload View. For details, see The Workload View.
Charged HoursThe total number of hours logged working on a work order in the date range previously defined.

Work hours are logged through the Time and Cost Tracking section of the work order.
DateThe date and time the user was available.

For each user, there is one row for every day since they joined their organization.
Total CostsThe total cost (time and other costs) added to the work orders by the user.
UserThe name of the user who logged the time or cost entry on the work orders.
Work OrdersThe names of the work orders in MaintainX.

Labor Utilization by Work Order​

Column/FilterDescription
Created AtThe creation date and time of the work order’s time or cost entry.
DescriptionThe description of the cost or time entry.
Hourly RateThe user’s hourly rate.
Total Time DurationThe total number of hours logged working on a work order in the date range previously defined.

Work hours are logged through the Time and Cost Tracking section of the work order.
TypeThe time type added by the user to the work order.
Updated AtThe data and time the user logged hours on the work order.
UserThe name of the user associated with the work order’s time or cost entry.
Work OrderThe name of the work order in MaintainX.

Locations​

Column/FilterDescription
AddressThe address associated with the location.
All Parent LocationsAll the parent locations associated with the location.

The field remains empty if the location is not attached to a parent.
Created atThe creation date and time of the location in UTC format.
Created byThe name of the user who created the location.
DescriptionThe description of the location.
LocationThe name of the location in the MaintainX organization.
Parent LocationThe parent location associated with the location.

The field remains empty if the location is not attached to a parent.
TeamsThe teams assigned to the location.
Top Level LocationThe top level location in a location hierarchy.

Let's say, you have "Canada" as a location, and "Montreal" as a child location. "Canada" will appear as a top level location.
Updated atThe date and time the location was last updated.

Parts​

Column/FilterDescription
Available QuantityThe quantity of units in stock.
Created AtThe date and time the part was created.
Created ByThe user who created the part.
DescriptionThe description of the part.
Minimum QuantityThe number of units that should be in the inventory at all times.

If the part is set as Critical and there is an escalation team set up, the escalation team receives an alert by email when this number drops below the set minimum.
Ordered QuantityThe number of units ordered.
Ordering Part NumberThe ordering number attached to the part.
PartThe part name and unique identification number in the MaintainX organization.
QR Code/BarcodeBarcode or QR Code used to identify the part.
Reserved QuantityThe current number of units in inventory.
Total CostThe total cost of the part.

The total cost is calculated by multiplying the following values:

Unit Cost x Quantity Added to Inventory.

If the number of parts is 0 and parts are removed from inventory, a minus sign appears next to the total cost.
Unit CostThe unit cost of the part.
Updated AtThe date and time the part was last updated.

Part Transactions​

Column/FilterDescription
AssetThe asset associated with the part transaction.
Created ByThe user who initiated the part transaction through a work order or a purchase order.
DirectionThe part transaction direction indicates whether the part is being added to or removed from the inventory.
  • Added: The part is added to the inventory.
  • Removed: The part is removed from the inventory.
LocationThe location associated with the part.
PartThe part name and unique identification number in the MaintainX organization.
Purchase OrderThe purchase order title and unique identification number in the MaintainX organization.
Quantity AfterThe total number of parts in the inventory after the part transaction.

If before the transaction the number of parts is 0 and parts are removed from inventory, a minus sign appears next to the number of parts.
Quantity BeforeThe number of parts in the inventory before the part transaction.
Quantity ChangeThe number of parts to be added or removed from the inventory in the transaction.

When parts are removed from the inventory, a minus sign appears next to the quantity.
Total CostThe total cost of the part.

The total cost is calculated by multiplying the following values:

Unit Cost x Quantity Added to Inventory.

If the number of parts is 0 and parts are removed from inventory, a minus sign appears next to the total cost.
Transaction DateThe date and time the transaction happened in UTC format.
Transaction NoteThe reason for the transaction.
Transaction TypeThe type of transaction:

  • Available Quantity Updated: A user restocks a part, and the inventory is updated.
  • Cycle Count Completed: A cycle count updated the part inventory.
  • Part Created: A user creates a part and adds the units in stock.
  • Restock from Purchase Orders: A purchase order fulfillment updates a part inventory.
  • Restock from Part: A user restocks a part, and the inventory is updated.
  • Transfer Approved, Unit Sent - Transfer Cancelled, Unit Returned - Transfer Received, Unit Returned: A part transfer from one MaintainX organization to another updates the part inventory. For more information, see Share Parts Between Organizations.
  • Work Order Updated: Completing a work order uses a part, and the inventory is updated.
  • - : Not available

Depending on how you create the part transaction, MaintainX automatically generates the transaction type.
Work OrderThe work order title and unique identification number in the MaintainX organization attached to the part transaction.

Purchase Orders​

Column/FilterDescription
Approved AtThe date and time you approved the purchase order.
Approved ByThe user in your MaintainX organization who approved the purchase order.

MaintainX uses this ID to record the user's activity in the web and mobile apps.
Billing AddressThe billing address in the purchase order.

You can configure this in the Purchase Order settings.
Completed AtThe date and time you marked the purchase order as completed.
Cost OrderedThe COST OF UNITS ORDERED in the corresponding line item in the purchase order.

For parts, this is the total cost for the number of units you ordered.

For additional costs, this is the amount you entered in the purchase order.

For taxes, this is the calculated amount based on the tax percentage you specified in the purchase order.
Cost ReceivedThe COST OF UNITS RECEIVED in the corresponding line item in the purchase order.

For parts, this is the total cost for the number of units you received.

Cost Received is not calculated for additional costs or taxes.
Created AtThe date and time you created the purchase order.
Due DateThe Due Date and time entered when you created the purchase order.

Due Date is an optional field, so if you did not set it in the purchase order, this column will be blank.
NoteNotes you added in the Details section of the purchase order.
PartThe part name and unique identification number in the MaintainX organization.
PriceThe sum of the COST OF UNITS ORDERED for all items in the purchase order, plus any additional costs or taxes.
Purchase OrderThe purchase order title and unique identification number in the MaintainX organization.
Quantity OrderedThe quantity of the item you ordered when you created the purchase order.
Quantity ReceivedThe quantity of the item you actually received when the purchase order was fulfilled.

You enter this value when you fulfill the purchase order.
Serial NumberThe serial identification number of the asset.
Shipping AddressThe shipping address in the purchase order.

You can configure this in the Purchase Order settings.
StatusThe purchase order's current status when you export this data.
TitleThe title of the purchase order.

Purchase orders can only have titles if you toggle the Custom Title preference on in the purchase order settings. For details, see Purchase Order Settings.
Unit CostThe unit cost of the item, specified in the Parts Inventory module, or entered manually when you create the purchase order.

This column is blank in lines that don't represent parts (e.g., lines for taxes or additional costs).
VendorThe vendor specified in the purchase order.

This is always a vendor that you've set up for your organization in the Vendors module.

Requests​

Column/FilterDescription
AssetThe asset added to the request from a requester portal.
Created AtThe creation date and time of the request.
Created ByThe user who created the request.
DescriptionThe description of the request.
LocationThe name of the location specified in the request.
PriorityThe priority set for the request.
RequestThe request title and unique identification number in the MaintainX organization.
Reviewed AtThe date and time an Administrator approved or declined the request.
Reviewed ByThe Administrator who approved or declined the request.
Review NoteThe reason why the request was declined.

This field remains empty if the request is not declined.
StatusThe current status of the request or the current status of the work order generated by the request.

If the request is not attached to a work order, the status of the request appears here. If the request is attached to a work order, the status of the work order appears.
Updated AtThe date and time the request was last updated.
Work OrderThe title and unique identification number of the work order attached to the request.

This field remains empty if the request is not converted into a work order.

Users​

Column/FilterDescription
Created AtThe creation date and time of the user in the MaintainX organization.
Deleted AtThe deletion date and time of the user in the MaintainX organization.
UserThe name of the user in the MaintainX organization.

Vendors​

Column/FilterDescription
Created AtThe creation date and time of the vendor.
Created byThe user who created the vendor.
DescriptionThe description of the vendor.
VendorThe vendor name and unique identification number in the MaintainX organization.

Work Orders​

Column/FilterDescription
AssetThe asset added to the work order.
Assigned toThe name of the user assigned to the work order.
CategoriesThe categories assigned to the work order.
Completed byThe name of the user who completed the work order.
Completed onThe completion date and time of the work order.
Created byThe name of the user who created the work order.
Created onThe creation date and time of the work order.
CriticalityThe criticality of the asset.

The criticality specifies whether the asset is Critical, Important or Normal for your organization. Criticality can be used for filtering and reporting.
DescriptionThe description of the work order.
Due dateThe due date and time of the work order.
LocationThe location specified on the work order.
Planned Start DateThe planned start date when the work order will show up in the To-do view of the Work Order module.
PriorityThe priority set for the work order.
Procedure FailuresThe number of procedure steps marked Fail.
Procedure FlagsThe number of procedure steps marked Flag.
Procedure PassesThe number of procedure steps marked Pass.
Procedure ScoreThe success score of the procedure attached to the work order.
Requested byThe name of the user who requested the work order.

This field is only filled when the work order is created from a work request. For more details, see Finish Approving a Request.
Requested onThe creation date and time of the work order request.

This field remains empty if the work order is not created from a work request. For more details, see Finish Approving a Request.
ScheduleThe recurrence schedule of the work order.

In the exported file, this information appears in the Recurrence column.
Started onThe date the assignee started working on the work order.
StatusThe work order's current status.
Teams Assigned toThe teams assigned to the work order.
Time In ProgressThe time the work order stayed in the In Progress status.
Time On HoldThe time the work order stayed in the On Hold status.
Time OpenThe time the work order stayed in the Open status.
Time to CompleteThe time it took to complete the work order, from creation or start date to completion.

The Time to Complete is calculated by adding the following values:

Time Open + Time In Progress + Time On Hold.
TitleThe title of the work order in MaintainX.
Total Parts CostThe total cost of all parts used to complete the work order.
Total Reported TimeThe total reported (or logged) time in the Time & Cost tracking section of the work order.
Total Time CostThe total time cost to complete the work order tied to the reported time and calculated with the assigned user’s hourly rate.
VendorsThe list of vendors specified in the work order.

This is always a vendor set up for your organization in the Vendors module.
Vendor IDsThe vendor's unique identification numbers for the organization.
Work TypeThe work type of the work order:
  • Preventive
  • Reactive
  • Other

When you add two datasets to a report, MaintainX adds related columns which reveal connections and relationships between them. For details, see About Report Builder.

Let's say you select Parts as a primary dataset and add Vendors as a secondary dataset. MaintainX automatically adds the Part Number for Vendor column. This additional column provides more options for analyzing your data.

Parts and Locations​

Column/FilterDescription
Part Available Quantity at LocationThe number of units you have in stock at a location.

This is different from the overall Available quantity, which is calculated based on the quantity in stock and the quantity currently assigned to work orders.
Part Area at LocationThe precise area where the part is located at a location.

For example, the part is located in the area named Storage Bin 9-L in Parts Warehouse.
Part Minimum Quantity at LocationThe minimum number of units required to have in inventory at a location.

If the part is set as Critical and there is an escalation team set up, the escalation team receives an alert by email when this number drops below the set minimum.

Parts and Vendors​

Column/FilterDescription
Part Number for VendorThe part number specified in the Parts Inventory module for a specific vendor.