Versions Compared

Version Old Version 6 New Version 7
Changes made by

Mike Nicolaides

Mike Nicolaides

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Collection Workflow & Forms

...

...

Collection of seca analytics 125 body composition data using the seca mBCA 554 follows a device enrollment / initialization > On-Device Collection > Data Returned to ClinSpark via SparkPlug workflow. Additionally, to facilitate downstream workflows in ClinSpark, returned data is synchronized from Volunteer Monitoring Data to Study Forms via an asynchronous job. The workflow is detailed below:

  1. The device is successfully enrolled and data collection is initiated in ClinSpark by invoking the seca analytics 125 platform

via a ClinSpark form containing the minimum required parameters (see https://foundryhealth.atlassian.net/wiki/spaces/DEV/pages/edit-v2/4646437132#Form-Design) and having the prerequisite subject demographics included as part of the request.

  1. The study participant is welcomed on the screen of the scale and steps on to perform the collection.

  2. Height and waist circumference values are manually entered on the device during collection.

  3. Data is returned to ClinSpark as Volunteer Monitoring Data.

  4. Data populated as Volunteer Monitoring Data is asynchronously returned to the study form as Study Form Data.

Form Design

As detailed in the description of collection workflows, the seca analytics 125 uses a single collection form to facilitate data collection. The form incorporates both clinical and ancillary device parameters that receive result data and enable further workflows.

At a minimum, a seca analytics 125 collection form must include MEASUREMENT_ID and MEASUREMENT_DATETIME. If these parameters are not included on the form, invoking the integration will fail.

Note

All device configuration is performed directly on the seca device and cannot be driven by form design.

Device Profile / Parameters

The seca analytics 125 Device Profile implements both Clinical Parameter clinical result parameters and supporting parameters that capture device / measurement metadata. This As noted in Form Design, the device integration does not allow for any configuration parameters to control device behavior - all device configuration is done directly on the device itself. For all Clinical Parameters, both a Value as well as Unit parameters are provided as the units used by the device are not controlled by the integration (but instead by the device itself).

...

...

All device configuration and behavior is done directly on the seca device and cannot be configured as part of form design.

Clinical Parameters

Parameter Name

Description

BMI_VALUE

Body mass index measurement value expressed as number.

BMI_UNIT

Body mass index measurement unit expressed as abbreviation.

WEIGHT_VALUE

Weight measurement value expressed as number.

WEIGHT_UNIT

Weight measurement unit expressed as abbreviation.

HEIGHT_VALUE

Height measurement value expressed as number.

HEIGHT_UNIT

Height measurement unit expressed as abbreviation.

WC_VALUE

Waist circumference measurement value expressed as number.

WC_UNIT

Waist circumference measurement unit expressed as abbreviation.

TBW_VALUE

Total body water measurement value expressed as number.

TBW_UNIT

Total body water measurement unit expressed as abbreviation.

TBWP_VALUE

Total body water percentage measurement value expressed as number.

TBWP_UNIT

Total body water percentage measurement unit expressed as abbreviation.

ECW_VALUE

Extracellular water measurement value expressed as number.

ECW_UNIT

Extracellular water measurement unit expressed as abbreviation.

ECWP_VALUE

Extracellular water percentage measurement value expressed as number.

ECWP_UNIT

Extracellular water percentage measurement unit expressed as abbreviation.

ECWBYTBW_VALUE

Water ratio (ECW/TBW) measurement value expressed as number.

ECWBYTBW_UNIT

Water ratio (ECW/TBW) measurement unit expressed as abbreviation.

FM_VALUE

Fat mass measurement value expressed as number.

FM_UNIT

Fat mass measurement unit expressed as abbreviation.

FMP_VALUE

Fat mass percentage measurement value expressed as number.

FMP_UNIT

Fat mass percentage measurement unit expressed as abbreviation.

FMI_VALUE

Fat mass index measurement value expressed as number.

FMI_UNIT

Fat mass index measurement unit expressed as abbreviation.

ZFMI_VALUE

Z-score fat mass index measurement value expressed as number.

ZFMI_UNIT

Z-score fat mass index measurement unit expressed as abbreviation.

SMM_VALUE

Skeletal muscle mass measurement value expressed as number.

SMM_UNIT

Skeletal muscle mass measurement unit expressed as abbreviation.

SMMP_VALUE

Skeletal muscle mass percentage measurement value expressed as number.

SMMP_UNIT

Skeletal muscle mass percentage measurement unit expressed as abbreviation.

SMMOVERAGE_VALUE

Skeletal muscle mass over age measurement value expressed as number.

SMMOVERAGE_UNIT

Skeletal muscle mass over age measurement unit expressed as abbreviation.

SMMOVERAGE_PERCENTILE

Skeletal muscle mass over age measurement value in comparison to population for age expressed as number.

SMMOVERAGEBMIINDEPENDENT_VALUE

Skeletal muscle mass over age (BMI independent) measurement value expressed as number.

SMMOVERAGEBMIINDEPENDENT_UNIT

Skeletal muscle mass over age (BMI independent) measurement unit expressed as abbreviation.

SMMOVERAGEBMIINDEPENDENT_PERCENTILE

Skeletal muscle mass over age (BMI independent) measurement value in comparison to population for age expressed as number.

ZSMI_VALUE

Z-score skeletal muscle index measurement value expressed as number.

ZSMI_UNIT

Z-score skeletal muscle index measurement unit expressed as abbreviation.

SSMMRIGHTARM_VALUE

Segmental skeletal muscle mass (right arm) measurement value expressed as number.

SSMMRIGHTARM_UNIT

Segmental skeletal muscle mass (right arm) measurement unit expressed as abbreviation.

SSMMLEFTARM_VALUE

Segmental skeletal muscle mass (left arm) measurement value expressed as number.

SSMMLEFTARM_UNIT

Segmental skeletal muscle mass (left arm) measurement unit expressed as abbreviation.

SSMMRIGHTLEG_VALUE

Segmental skeletal muscle mass (right leg) measurement value expressed as number.

SSMMRIGHTLEG_UNIT

Segmental skeletal muscle mass (right leg) measurement unit expressed as abbreviation.

SSMMLEFTLEG_VALUE

Segmental skeletal muscle mass (left leg) measurement value expressed as number.

SSMMLEFTLEG_UNIT

Segmental skeletal muscle mass (left leg) measurement unit expressed as abbreviation.

SSMMTORSO_VALUE

Segmental skeletal muscle mass (torso) measurement value expressed as number.

SSMMTORSO_UNIT

Segmental skeletal muscle mass (torso) measurement unit expressed as abbreviation.

SSMMRIGHTARMBMIINDEPENDENT_VALUE

Segmental skeletal muscle mass (right arm, BMI independent) measurement value expressed as number.

SSMMRIGHTARMBMIINDEPENDENT_UNIT

Segmental skeletal muscle mass (right arm, BMI independent) measurement unit expressed as abbreviation.

SSMMLEFTARMBMIINDEPENDENT_VALUE

Segmental skeletal muscle mass (left arm, BMI independent) measurement value expressed as number.

SSMMLEFTARMBMIINDEPENDENT_UNIT

Segmental skeletal muscle mass (left arm, BMI independent) measurement unit expressed as abbreviation.

SSMMRIGHTLEGBMIINDEPENDENT_VALUE

Segmental skeletal muscle mass (right leg, BMI independent) measurement value expressed as number.

SSMMRIGHTLEGBMIINDEPENDENT_UNIT

Segmental skeletal muscle mass (right leg, BMI independent) measurement unit expressed as abbreviation.

SSMMLEFTLEGBMIINDEPENDENT_VALUE

Segmental skeletal muscle mass (left leg, BMI independent) measurement value expressed as number.

SSMMLEFTLEGBMIINDEPENDENT_UNIT

Segmental skeletal muscle mass (left leg, BMI independent) measurement unit expressed as abbreviation.

SSMMTORSOBMIINDEPENDENT_VALUE

Segmental skeletal muscle mass (torso, BMI independent) measurement value expressed as number.

SSMMTORSOBMIINDEPENDENT_UNIT

Segmental skeletal muscle mass (torso, BMI independent) measurement unit expressed as abbreviation.

VAT_VALUE

Visceral adipose tissue measurement value expressed as number.

VAT_UNIT

Visceral adipose tissue measurement unit expressed as abbreviation.

PHA_VALUE

Phase angle measurement value expressed as number.

PHA_UNIT

Phase angle measurement unit expressed as abbreviation.

PHA_PERCENTILE

Phase angle measurement value in comparison to population for age expressed as number.

BIVA_ZRH_UNIT

Bioelectrical impedance vector analysis index for resistance (R) by height measurement unit expressed as abbreviation.

BIVA_ZRH_VALUE

Bioelectrical impedance vector analysis index for resistance (R) by height measurement value expressed as number.

BIVA_ZXCH_UNIT

Bioelectrical impedance vector analysis index for reactance (Xc) by height measurement unit expressed as abbreviation.

BIVA_ZXCH_VALUE

Bioelectrical impedance vector analysis index for reactance (Xc) by height measurement value expressed as number.

TBS_VALUE

TRU body score measurement value expressed as number.

TBS_UNIT

TRU body score measurement unit expressed as abbreviation.

TBS_FATSCORE_UNIT

TRU body score fat score measurement unit expressed as abbreviation.

TBS_FATSCORE_VALUE

TRU body score fat score measurement value expressed as number.

TBS_TOPPERCENT

TRU body score measurement value that belongs to top percent of people of person's age and BMI.

TBS_MUSCLESCORE_UNIT

TRU body score muscle score measurement unit expressed as abbreviation.

TBS_MUSCLESCORE_VALUE

TRU body score muscle score measurement value expressed as number.

XC_VALUE

Reactance measurement value expressed as number.

XC_UNIT

Reactance measurement unit expressed as abbreviation.

R_VALUE

Resistance measurement value expressed as number.

R_UNIT

Resistance measurement unit expressed as abbreviation.

...

Reports / Dashboards

Errors / Troubleshooting

Demographics Errors

...

'Device Not Ready' Errors

...

Notes

Known Limitations

  • It is currently possible in ClinSpark to start a seca measurement on a form that already has a status of “Complete”, meaning measurement data has been populated via the async job. If a second measurement would be invoked from a “Complete” form, it's possible that the enrollment data (TENANT_ID, DEVICE_ID, & REQUEST_ID) would be inaccurate for the measurement data saved to the form. TENANT_ID would be the same because the data would be collected for the same site. And more than likely DEVICE_ID would match as well if the site only has a single device (as we expect in most cases). But certainly the REQUEST_ID would be wrong as it would reflect an identifier for requesting a measurement that has yet to be acquired.

    -------

    There is currently no solution to block this behavior. I even attempted setting the item group data and form data as locked. The best way to block this would be a ClinSpark code change to prevent invoking the device on the form once it’s "Complete". Can we please get this issue on the product backlog?

  • Currently, measurements that are “Weight Only” are not able to be sent / transferred through ClinSpark. These weight measurements would need to be manually captured on a scale independent of device invocation and entered onto the form manually.

  • The seca mBCA 554 device will timeout if a subject does not step on the platform within 5 minutes of measurement start. We set the threshold to 10 minutes to allow for a 5-minute grace period in the event a subject stands on the platform moments before timeout. Measurement acquisition should not take more than 5 minutes. This threshold is used to prevent processing records that are too old to be considered for data posting.

  • If a Volunteers Demographics are updated following a measurement all past measurements will retain the data as calculated prior to the change. As each invocation and measurement is sent to the seca analytics platform ClinSpark sends the volunteer details as a “snapshot in time” so retrospective data will not be updated within past forms collected via ClinSpark.

  • In scenarios where a scale is not reserved for a specific person / measurement prior to device invocation. In these cases it has been noted that Date of Birth may be requested following the collection workflow. Seca calls this the anonymous workflow and confirmed that this can be caused by error conditions in pushing Demographics to the device. In these instances, the recommendation is to start the collection workflow again. If the condition is seen in numerous consecutive invocations, please review demographics and contact the help desk.

...