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

1. Device Code Field Maintenance

• Pre-create a field on the Device object named “QR/Barcode Code (API Name: device_code)” and define its value assignment rules. QR/barcode generation and scan recognition both rely on this field.
• Note: Historical company implementations may have named this field Equipment SN.
• By default, the QR/barcode code equals the Equipment SN. If your organization uses a different assignment rule, populate this field manually or generate its value via functions.

picture coming soon:

2. Device Code (QR) Templates and Styles

• Navigation: Service Connector -> System Settings -> Device Management -> Device Settings, then open the “Device Code” menu.
• Other systems can generate codes: copy the specified link within your tenant and convert that link to a QR code on other machines to generate the code.

picture coming soon:

3. Device Code (QR) Use Cases

3.1 Scanning from Generic Objects that Reference a Device

• For objects that reference a device (for example, Work Order or Spare Part Consumption records) you can enable a “Scan to add” feature. Calling the UI function will identify the device code and associate the record with the corresponding Device.

``` // Support scanning device codes (QR) // This example uses the field field_n63ql__c on the Work Order as the scan field. Replace as needed.

// Retrieve scan field value String deviceContent = context.data.field_n63ql__c;

Map map=[:] // If the content is a link if (deviceContent != null && deviceContent.startsWith(“https://”)) { // Extract trailing code from the short URL int indexOf = deviceContent.lastIndexOf(“/”) String code = deviceContent.substring(indexOf + 1); log.info(“Scanned content：” + deviceContent) // Resolve short link to original long URL def(boolean error, Map data, String message) = Fx.biz.callAPI(“Fx.BI.shorturlInnerGetOriginalUrl”, code) log.info(“Long URL result：” + data) if (data != null) { // Long URL 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) { // Extract data 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 Scans to Lookup a Device

• Add a “Scan” entry to the Engineer Workbench. When an engineer taps Scan and scans a QR code, the system opens the Device detail page where the engineer can drill down to related Work Orders and other records.
• Engineers can also tap the “+” in Chats and select “Scan” to scan a QR code and open the Device detail page for related information.

picture coming soon:

4.3 External Terminal Users Scanning to Lookup a Device

Prerequisite: Terminal user Service Connector must be enabled and Device object permissions must be granted to the Terminal User or Guest Role. If you want guests to scan and view all Devices, set the Device object data permissions to Public. (See: Business Objects and Role Permissions)

1. External terminal users in WeChat: Tap “Scan”, scan the QR code (only QR codes are supported) to open the Device detail page and then tap “Fault Report” to submit a Work Order.
2. Configure a WeChat service account Scan menu (WeChat Service Account menu settings). Scanning the QR code (only QR codes) opens the Device detail page and allows users to submit a Work Order via “Fault Report”.
3. Add a “Scan” menu in the Terminal User Portal page. Terminal users tap Scan and scan the QR code (only QR codes) to open the Device detail page and submit a Work Order via “Fault Report”.

picture coming soon:

picture coming soon:

picture coming soon:

• Terminal users in a browser: Click “Scan” in the portal, scan the QR code (only QR codes) to open the Device detail page and submit a Work Order via “Fault Report”.

picture coming soon:

3.4 External Terminal User Fault Report Mapping Rules

• The Device detail page includes a preconfigured “Fault Report” button with default field-mapping logic. Your organization can map Device fields to the Work Order fields according to your needs.
• For detailed configuration of Device fault reporting, see: Device Fault Reporting