...
SparkPlug 24.2 (or later) is required for the seca analytics 125 device integration. All of the required software to interface with the seca mBCA 554 device is included in the SparkPlug installation and no additional installation or software is required. The device profile must be provisioned into the target ClinSpark environment. Both the seca analytics 125 platform and SparkPlug must be configured correctly (detail below) to enable the two systems to connect and exchange data. Additionally, the asynchronous job to populate received data as study form data must be added to Administration > Support > Async Job Management in the target environment.
Additionally, the seca device should be configured to allow manual entry of Waist Circumference due to current limitations of the provided seca API.
Configuration
As noted above, SparkPlug must be fully configured with the required elements to enable interconnectivity via the seca API. Overall SparkPlug administration and configuration is outside of the scope of this document, but those configuration elements specific to the seca analytics 125 platform are detailed below:
...
The study participant is welcomed on the screen of the scale and steps on to perform the collection.
Height and waist circumference Waist circumference and height (when stadiometer is not connected) values are manually entered on the device during collection.
Data is returned to ClinSpark as Volunteer Monitoring Data.
Data populated as Volunteer Monitoring Data is asynchronously returned to the study form as Study Form Data.
Device Enrollment / Initialization
Demographics / Study Metadata
Prior to invocation, the seca analytics 125 platform requires a set of input demographics and study metadata be established to support the generation, processing and analysis of seca data as well as customization of the welcome message presented to the study participant. The required demographics that must be established prior to invocation are DOB, Race, Sex, Ethnicity (optional, see https://foundryhealth.atlassian.net/wiki/spaces/DEV/pages/edit-v2/4646437132#Race-Mapping below).
| Info |
|---|
This integration supports partial DOB enrollment configurations introduced in ClinSpark 24.1. See https://foundryhealth.atlassian.net/wiki/spaces/DOCS/pages/4335697921/ClinSpark+24.1#Updated-Enrollment-Configurations-for-Subject-DOB for details. |
Race Mapping
Due to limitations of race / ethnicity functionality within the seca analytics 125 platform, it was necessary to establish a hardcoded race mapping between the ClinSpark ‘Race Name’ and the seca provided ‘Ethnicity’ value. The mapping table is presented below.
ClinSpark Race | ClinSpark Ethnicity | Race Value Sent to seca |
ANY | Hispanic or Latino | Hispanic |
Hispanic | Not Hispanic or Latino | Hispanic |
Native Hawaiian or Other Pacific Islander | Not Hispanic or Latino | Other |
American Indian or Alaska Native | Not Hispanic or Latino | Other |
Asian | Not Hispanic or Latino | Asian |
North-East Asian | Not Hispanic or Latino | Asian |
South East Asian | Not Hispanic or Latino | Asian |
Black or African American | Not Hispanic or Latino | AfroAmerican |
White | Not Hispanic or Latino | Caucasian |
Other | Not Hispanic or Latino | Other |
Unknown | Not Hispanic or Latino | Other |
Device Invocation
Device enrollment & initialization is initiated via ClinSpark form by clicking on the seca analytics 125 button on an integration-enabled form. Once the button is clicked, the user is prompted to confirm their intent to begin enrollment / collection.
...
In the event that there is only a single seca device configured for the current ClinSpark site, the device will be readied for collection and values will be returned to the TENANT_ID, DEVICE_ID, and REQUEST_ID form items. In the event that the seca tenant has more than one device associated, SparkPlug will prompt the user to select the device on which the collection should be performed. For errors encountered during device enrollment / initialization, see https://foundryhealth.atlassian.net/wiki/spaces/DEV/pages/edit-v2/4646437132#Errors-%2F-Troubleshooting.
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.
...