Plugin Mode

Scan a QR code on the list screen to update the record

Summary

Opening a specified list screen starts QR code scanning. When a QR code is scanned, it updates a specified field in the corresponding record to a new value. If you also specify the value before the update, only records whose current field value matches that value are updated.

Smartphone support

This plugin supports smartphones.

How to use

Set the list name, key field to match against the QR code, field to update, and new value. Scanning starts when the specified list opens. Scan a QR code to find and update records with the same key. Specify an old value if only records currently containing that value should be updated.

When it runs

Depending on the settings, this customization runs at the following times. Any configured conditions are also evaluated.

  • When you open a record list page
  • When a QR code is scanned

Parameters

Enter or select a value for each setting unless it is marked optional.

List Name

Enter one or more values.

Key Field

Choose the field whose value is matched against the scanned code to find records to update.

The following field types cannot be selected.

  • Categories
  • Table
  • Related records
  • Field group
  • Label
  • Blank space
  • Border

Fields inside tables cannot be selected.

Update Field

Choose the field to change in the matching records.

The following field types cannot be selected.

  • Categories
  • Table
  • Related records
  • Field group
  • Label
  • Blank space
  • Border

Fields inside tables cannot be selected.

Update Value

Enter the new value directly. It is not evaluated as an expression or a field reference.

Old Value

Enter the literal current value required for an update, or leave empty to skip this check. This setting is optional.

Restrictions

You can add only one instance of this plugin to a customization.

Specify different values for “Key Field” and “Update Field”.

Notes

If multiple records share the key, all that meet the conditions are updated. The search is not restricted to the current list filter. An error is shown if no records qualify, and the page reloads after updating. Leaving the old value empty disables filtering by the current field value.

The following actions and conditions are useful when building similar behavior in customization mode.

Actions

Conditions