...
Collection Workflow & Forms
Form Design
Device Profile / Parameters
The seca analytics 125 Device Profile implements both Clinical Parameter and supporting parameters that capture device / measurement metadata. This 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).
| Note |
|---|
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. |
| Info |
|---|
All Clinical Parameters that return a value also have an associated unit parameter to indicate which parameters were set on the device at the time of collection. |
Other Device Parameters
Parameter Name | Description |
|---|---|
TENANT_ID | Unique seca tenant (site) identifier. |
DEVICE_ID | Unique device identifier. |
REQUEST_ID | Unique start measurement request identifier. |
RAW_JSON_DATA | Raw JSON Measurement data from seca. Do not include in form |
MEASUREMENT_ID | Unique measurement identifier. |
MEASUREMENT_DATETIME | Measurement acquisition date and time. |
| Note |
|---|
RAW_JSON_DATA is included to support seca’s Reporting Widgets and are not intended for inclusion on ClinSpark forms. |
Data
Volunteer Monitoring Data
...
Errors / Troubleshooting
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.
---------------------START OLD--------------------
...
Include any relevant notes that you may reference above.
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.
...