Equipment Barcode (Other Barcode Machine Generated)

1. Device Code Field Maintenance

• Pre-configure the “QR/Barcode Code (Api Name: device_code)” field value rules on the Device object. QR/barcode generation and scan recognition both rely on this field.
• Note: The legacy company field name may have been Equipment SN.
• If device barcodes were generated in another system, simply enter or sync the device barcode into the “QR/Barcode Code” field when creating new Device records; the barcode can then be recognized by scanning.

picture coming soon:

2. Device Code (Barcode) Use Cases

2.1 Scan to Associate Device on Generic Objects

• For objects that have an “Associated Device” field—such as Work Order, Spare Parts Consumption, etc.—enable the “Scan to Add” feature. Calling the UI function will recognize the device code and link the Device record.

``` // Support scanning device barcode // Example uses the field field_97ZrY__c on Work Order as the scan field. Replace with actual field as needed.

// Get the scan field value String deviceContent = context.data.field_97ZrY__c;

Map map=[:]

if (deviceContent != null) { // Query Device by barcode // Convert short link to full link APIResult ret = Fx.object.findOne(“DeviceObj”, // query Device object FQLAttribute.builder() .columns([“_id”, “name”]) // returned data id .queryTemplate(QueryTemplate.AND([“device_code”: QueryOperator.EQ(deviceContent)] )) .build(), SelectAttribute.builder() .build());

log.info(“ret ：” + ret) if (ret.data != null) { String dataId = ret.data[“_id”] as String; map=[“field_97ZrY__c”:dataId]; } } UIEvent event = UIEvent.build(context){ editMaster(map) } return event ```

picture coming soon:

2.2 External Terminal Users Scan (Barcode) to Find Devices

Prerequisites: Enable Terminal user Service Connector, and grant the Terminal User or Guest Roles access to the Device object. If you want Guest Role users to scan and search all devices, set the Device object data permission to Public. (See Roles and Business Object Permissions)

• When external users submit a Work Order, tapping the scan icon on the Device field can associate the Device.

picture coming soon:

• The Search Tool lets users type text or scan a barcode to search for devices. (See Terminal User Search Tool)

picture coming soon:

picture coming soon: