Replacement Values

Replacement values are references to device, session, or configuration attributes that Launcher can read and display.

The BlueFletch Launcher supports a variety of replacement variables, or values that can be utilized by widgets, custom intents, layout items, and custom fields. These variables act as placeholders for actual values stored in the referenced location. This is a list of the supported values, which fall within the categories of Device, Session, and Extended attributes.

Device Attributes

• ${device.key_name_here}

• Includes:

  • device.MODEL

  • device.BRAND

  • device.MANUFACTURER

  • device.HARDWARE

  • device.SDK_INT

  • device.SECURITY_PATCH

Session Attributes

All Extended Attributes from session object are available as:

• ${session.ex.key_name_here}

• Example: ${session.ex.accessToken}

Main session attributes:

• ${session.key_name_here}

• Includes:

  • session.userId

  • session.userName

  • session.role

  • session.groups

  • session.location

  • session.extension

  • session.session_idle

  • ssession.session_max

  • session.retain_session_oncradle

  • session.logout

Extended Attributes

• ${config.ex.key_name_here}

• Includes by default:

  • config.ex.siteId

  • config.ex.deviceId

    • To add device ID to the header

          "customField": {
              "format": "${config.ex.deviceId}"
          },

  • config.ex.phoneNumber

    • starting in Launcher version 3.26.24

  • Other key-value strings can be added to the extendedAttributes object in the the launcher.json.

• Any columns added to the sitelist.csv become extended attributes:

  • config.ex.COLUMN_NAME