Published at: 2025-10-31

Equipment QR Code (Machine-Generated for Other Device Codes)


1. Equipment Code Field Maintenance

  • Pre-configure the “QR Code/Barcode Encoding” field (API Name: device_code) on the Equipment object. Both QR code/barcode generation and scanning rely on this field.
  • Note: For legacy systems, this field may be labeled as “Equipment SN.”
  • By default, the QR code/barcode encoding matches the serial number. If custom rules apply, manually input or generate the value via functions.

picture coming soon:

2. Equipment Code (QR Code) Template and Style

  • Configuration Path: Service Connector > System Settings > Equipment Management > Equipment Settings > “Equipment Code” menu.
  • External System Generation: Copy the designated link within the tenant and convert it to a QR code on another machine.

picture coming soon:

3. Equipment Code (QR Code) Use Cases

3.1 Generic Object: Linking Equipment via QR Code

  • Objects like Work Orders or Spare Parts Consumption can use the “Link Equipment” field to enable QR scanning. The system identifies the equipment code and establishes the association via UI functions.

```java // Enable QR code scanning for equipment
// Example uses field_n63ql__c as the scanning field; replace as needed

// Retrieve scanned data
String deviceContent = context.data.field_n63ql__c;

Map map=[:]
if (deviceContent != null && deviceContent.startsWith(“https://”)) {
// Extract code from URL
int indexOf = deviceContent.lastIndexOf(“/”);
String code = deviceContent.substring(indexOf + 1);
log.info(“Scanned content: “ + deviceContent);
// Resolve short URL
def(boolean error, Map data, String message) = Fx.biz.callAPI(“Fx.BI.shorturlInnerGetOriginalUrl”, code);
log.info(“Resolved URL: “ + data);
if (data != null) {
String url = data[“originalUrl”] as String;
int startIndex = url.indexOf(“dataId%3D”);
if (startIndex != -1) {
url = url.substring(startIndex + 9, url.length());
int endIndex = url.indexOf(“%26”);
if (endIndex != -1) {
// Map equipment ID
url = url.substring(0, endIndex);
map=[“field_n63ql__c”:url];
}
}
}
}
UIEvent event = UIEvent.build(context){
editMaster(map)
}
return event
```

picture coming soon:

3.2 Engineer Workbench: QR Code Scanning

  • Engineers can scan QR codes via the “Scan” option in the workbench or Chats (+) menu to access equipment details and related Work Orders.

picture coming soon:

3.3 External Terminal User: QR Code Scanning

Prerequisites: Enable Terminal User Service Connector and grant Roles (e.g., guest) access to the Equipment object. Set data permissions to “Public” for full visibility.

  1. WeChat Scan: Terminal users scan QR codes to view equipment details and submit Fault Repair Work Orders.
  2. Service Account Menu: Configure a WeChat scan menu (Guide) for QR-based access.
  3. Self-Service Portal: Add a “Scan” option (Guide) to enable QR scanning.

picture coming soon:
picture coming soon:
picture coming soon:

  • Browser Scan: Terminal users can also scan QR codes via browser to submit Fault Repair Work Orders.

picture coming soon:

3.4 Fault Repair Rules for Terminal Users

  • The equipment detail page includes a preconfigured “Fault Repair” button with default mapping logic. Customize mappings to align with business needs.
  • Configure Fault Repair workflows here: Fault Repair Guide.
Submit Feedback