(this page was created automatically. In case of formatting issues, please visit the official Wiki Page)

RFID Scanner

Example Usage

General Properties

  • displayName - Sets the display name of the component shown in the structure panel. For example, "Inventory RFID Scanner" allows for easy identification of the component's purpose within the UI builder interface.

Visual Properties

RFID Visual Properties

  • labelTranslations - Sets the label text displayed above the scanner field, with support for multiple languages. For example, {"en-US": "Scan Asset Tag", "de-DE": "Asset-Tag scannen"} provides localized instructions to users.

  • scanningMessageTranslations - Sets the text shown during the active scanning process, with language support. For example, {"en-US": "Scanning in progress...", "fr-FR": "Numérisation en cours..."} guides users during the scanning action.

  • postScanningMessageTranslations - Sets the text displayed after a successful scan, with language support. For example, {"en-US": "Scan complete!", "es-ES": "¡Escaneo completo!"} confirms successful scan completion.

  • dialogTitleTranslations - Sets the title of the scanner dialog window, with language support. For example, {"en-US": "RFID Scanner", "ja-JP": "RFIDスキャナー"} provides context for the scanning interface.

  • alternativeInputLabelTranslations - Sets the label for the manual input option when scanning fails, with language support. For example, {"en-US": "Or type code manually", "de-DE": "Oder Code manuell eingeben"} offers an alternative input method.

  • confirmButtonLabelTranslations - Sets the text on the confirmation button in the scanner dialog, with language support. For example, {"en-US": "Confirm", "fr-FR": "Confirmer"} provides clear action instructions.

  • closeDialogOnSuccess - Determines whether the scanner dialog automatically closes after successful scan. When enabled, the dialog will close immediately after scanning a valid RFID code, improving workflow efficiency.

  • readonly - Controls whether the field is in read-only mode. When set to true, the component will display existing values but prevent scanning or manual entry of new values, useful for review screens or locked records.

  • visible - Determines if the component is displayed to users. When set to false, the component will be hidden but can still be used programmatically, enabling dynamic visibility based on context.

  • enabled - Controls whether the component is interactive. When set to false, the component will be visible but grayed out and unresponsive to user input, useful for conditional form interactions.

  • required - Specifies if the field must have a value before form submission. When enabled, form validation will prevent submission until an RFID code is provided, ensuring critical data is collected.

  • defaultValue - Sets an initial value for the scanner field when first loaded. For example, setting a defaultValue of "TAG-12345" will pre-populate the field with this value when the component is initialized.

  • saveInLocalStorage - Enables persisting the scanned value in browser's local storage. When enabled, the last scanned value will be recalled even after page refresh, providing continuity in user sessions.

Non-Visual Properties

RFID Non-Visual Properties

  • dataField - Specifies the form field name where the scanned RFID code value will be stored. For example, setting it to "assetTagId" ensures the scanned code is saved to that field in form submissions.

  • controlsRequestType - Specifies how the scanned data should be included in API requests. Options include "BODY" (in request body), "PATH" (in URL path), or "HEADER" (in HTTP headers), allowing flexible integration with backend services.

Authorization Properties

  • authorizationDisable - Links the component's enabled state to a policy set. For example, setting to "scannerAccessPolicy" will only enable the scanner for users who meet the policy requirements, providing role-based access control.

Event Actions

RFID Actions

  • events - Configures the events that the component can trigger and respond to:
    • ON_INIT: Triggered when the component is initialized. Can be used for setup operations like pre-fetching associated data.
    • ON_DESTROY: Triggered when the component is removed from the DOM. Useful for cleanup operations when navigating away from the page.
    • ON_SCAN_START: Triggered when the scanning process begins. Can be used to prepare other components for scanning or log scanning attempts.
    • ON_SCAN_SUCCESS: Triggered when an RFID code is successfully scanned. Provides the scanned value for further processing or validation against a database.
  • No labels