Context
One of the key benefits of Teamworks AMS is the ability to provide a holistic view of your people and data, but organizations often have a range of places where data is collected and stored before it makes its way to AMS. To assist in pulling those data sources together, we integrate with a wide range of third-party providers to sync data from other products to your AMS site so you can understand the relationships between all of your information. You can read more about the products that we integrate with in our article on integrations.
Another option we provide is the ability to connect to some devices using Bluetooth so that data can automatically be synced to AMS during data entry. A prime example of this is with body mass measurements. Perhaps your organization regularly tracks body mass from groups of people so that you can provide feedback about hydration after a training session or monitor changes over time.
We built Bluetooth input support into the AMS mobile app so data can be synced from compatible Bluetooth devices straight to a form in AMS. This reduces the risk of data errors and manipulation associated with manual data entry. It is also aimed at improving engagement with AMS by making it easier for people to enter their data.
Check whether your Bluetooth scales are listed in our supported devices in our article on user-defined property schemas. If not, you can reach out to your Product Success Manager to see if there are any other options available to you.
Goals
This tutorial will show you how to sync weight values from Bluetooth-enabled scales to AMS by building an event form and configuring the AMS mobile app to link to the scales. This workflow is intended to be used in kiosk mode on the mobile app. We will be using the Rice Lake Healthweigh Scales to measure body weight and an Apple iPad to run the app, but you could also use a mobile device.
Outcomes
- Configure a User-defined property schema for the Bluetooth scales.
- Create an event form to collect body composition information.
- Configure the Bluetooth connection on the mobile app.
- Configure kiosk mode on the mobile app.
- Collect body weight from Bluetooth scales.
- Test your workflow.
Outcome 1: Configure a User-defined property schema for the Bluetooth scales
- From the builder interface of your AMS site, select the User-defined property schemas tool.
- Create a new schema with the following properties, exactly as they are written here:
- Name: Bluetooth Input Device
- Description: Use this setting to assign the field to a Bluetooth device
- Category: Bluetooth
- Device Key: bluetooth-input
- Applies to: Form Item
- Selector: Dropdown
-
Options: rice-lake-healthweigh-lbs
If you are using different scales, refer to the Options listed in our article on user-defined property schemas and choose the one that corresponds to your Bluetooth scales.
- Tick the Active checkbox
- Save the schema.
Outcome 2: Create an event form to collect body composition information
- Return to the builder interface and use the Event forms tool to create a new event form.
- Name the event form Weight Tracking, or customize the name as preferred.
- Add a Number field and name it Body Mass. In the advanced field properties, set an appropriate number Format and Units.
- In the field properties, select the Bluetooth device properties settings and select your Bluetooth scales option from the Bluetooth input device dropdown.
- Save the event form.
- Navigate to the administration interface.
- Search for the role of the account that will be logged into the mobile app and add Write permission for the Weight Tracking form.
Outcome 3: Configure the Bluetooth connection on the mobile app
- Log into your AMS account on the mobile app.
- If you are using a Bluetooth-enabled form for the first time since installing the app, your device will ask you to grant permission to access Bluetooth.
On some devices, access to your location may also be required by the device operating system. Please grant these permissions if you wish to enter data using a Bluetooth device.
If you are not prompted to enable Bluetooth for the app, you will be prompted in the next step. - In the app, go to Settings > Bluetooth settings. Use the toggle to Enable Bluetooth. If you have not already granted permission for the app to use Bluetooth, you will be prompted to do so.
- Step onto the scales to activate the Bluetooth module and wait until a weight is recorded.
- Tap Scan for devices to search for your Bluetooth scales.
- Find the Rice Lake Healthweigh Scale option from the available Bluetooth devices listed, then tap Connect.
- When the scales are connected, the device name will be listed under Connected.
Outcome 4: Configure kiosk mode on the mobile app
- Return to the app Settings and select Kiosk.
- Select Event forms and use the relevant toggle to enable the Weight Tracking form in kiosk mode.
- Return to the Kiosk settings and use the toggle to Enable kiosk mode.
- Use the back arrow to return to the Settings.
Outcome 5: Use the mobile app to collect body weight
- Return to the home screen and enter a new record for the Weight Tracking form.
- When the athlete stands on the scales, the value will be automatically populated in the Body mass field.
- Use the Save button to record the value.
Outcome 6: Test your workflow
- Ensure that the user's role has the necessary permissions to use the event form on the app (Objective 2, step 7).
- Connect the Bluetooth scales to the mobile device and record the body weight for different users (Outcome 5).