Equipment Barcode (Generated in ShareCRM)

1. Device Code Field Maintenance

• Pre-configure the “QR Code/Barcode (API Name: device_code)” field value rules on the Device object. Both QR code/barcode generation and scanning recognition rely on this field.
• Note: For legacy systems, this field may be labeled as “Equipment SN”.
• By default, the QR code/barcode value equals the serial number. If custom rules apply, manually input or generate values into this field using functions.
• If device barcodes are pre-generated in external systems, simply input/synchronize them into the “QR Code/Barcode” field when creating new device records to enable scanning recognition.

picture coming soon:

2. Generating Barcodes in ShareCRM

• Navigation: Service Connector → System Settings → Device Management → Device Settings
• Select the “Device Code” menu and click [Generate Device Code Rules]

picture coming soon:

2.1 Barcode Styles

• In the basic settings of device code generation rules, select code type(s): barcode, QR code, or both.
• Barcode: Generates scannable barcodes that display text content without redirection.
• Customize the output filename for exported PDFs to facilitate organization.

picture coming soon:

• Configure print templates for barcode styling.
• Select “Barcode” as the code type.

picture coming soon:

picture coming soon:

2.2 Barcode Printing

• The system pre-configures a [Print Device Code] button on Device objects. Assign [Export Device Code] button permissions to relevant Roles.
• Click [Print Device Code] to generate/print codes, or batch-select devices and use [Export Device Code]/[Merge Export Device Codes].

picture coming soon:

picture coming soon:

picture coming soon:

3. Barcode Use Cases

3.1 Scanning for Device Association

• Objects with “Associated Device” fields (e.g., Work Orders, Spare Part Consumption) can enable scan-to-assign functionality via UI functions to identify and link devices.

```java // Scan device barcode // Example uses field_97ZrY__c on Work Order – replace as needed

String deviceContent = context.data.field_97ZrY__c; Map map=[:]

if (deviceContent != null) { // Query device by barcode APIResult ret = Fx.object.findOne(“DeviceObj”, FQLAttribute.builder() .columns([“_id”, “name”]) .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:

4.2 Terminal User Barcode Scanning

Prerequisite: Enable Terminal User Service Connector and grant Device object permissions to Terminal Users/Guest Roles. Set device data permissions to Public if guests require full access. (Business Objects and Role Permissions)

• External users can scan barcodes to associate devices when submitting Work Orders.

picture coming soon:

• Use the Query Tool to manually input or scan barcodes for searches. (Terminal User Query Tool)

picture coming soon:

picture coming soon: