PreNUDGE FHIR® IG for Data Provider / Data from Apps (R4)
0.1.0 - ci-build

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Structures: Questionnaires

These define forms used by systems conforming to this implementation guide to capture or expose data to end users.

Alkoholkonsum im letzten Jahr

Categorical variable for the frequency of alcohol consumption in the last year (IPS compatible).

Arbeitsbezogenes Kohärenzgefühl (Work-SoC)

Work-related Sense of Coherence (Work-SoC) questionnaire. The raw item responses are collected in the QuestionnaireResponse. Category scores are defined as SDC calculated expressions and may be mapped to a Work-SoC score Observation.

Arbeitsfähigkeit (WAI Kurzmodul)

Short Work Ability Index (WAI) questionnaire module based on Tuomi et al. 1998. The raw answers are collected as QuestionnaireResponse.

Blutzucker bei der letzten Messung

A simple questionnaire for asking how high the blood glucose level is right now. The blood glucose option only allows values inbetween 0 and 999 mg/dL.

Durchschnittliche Schlafdauer pro Nacht

A simple questionnaire for self-reporting average sleep duration per night in hours. Only allows values between 0 and 24 hours.

EHIS-PAQ: Zu-Fuß-Gehen

The questions Q2 and Q3 from the EHIS-PAQ about the number of days and duration of walking (for transport) in a typical week.

Höchster abgeschlossener Bildungsabschluss

A simple questionnaire asking for the person's highest completed education level using ISCED 2011 levels.

Rauchstatus und Nikotinkonsum

ATHIS 2025-based questionnaire module for smoking status, cigarette consumption, duration of daily smoking, tobacco heaters, electronic cigarettes or similar electronic products, and nicotine pouches. A derived IPS-compatible Observation can be created from SK1 and the past tobacco smoking question.

Schlafqualität – Selbsteinschätzung (WHOQOL-BREF Q16)

Standalone questionnaire for self-assessing sleep quality based on WHOQOL-BREF question Q16 ('Wie zufrieden sind Sie mit Ihrem Schlaf?').

Schrittzahl am heutigen Tag

A simple questionnaire for asking how many steps the patient has taken today. Only allows values inbetween 0 and 150,000.

WHOQOL-BREF Lebensstil Selbsteinschätzung

The WHOQOL-BREF is a 26-item instrument for assessing subjective quality of life in four domains: physical, psychological, social relationships, and environment. Developed by the WHO.

Structures: Abstract Profiles

These are profiles on resources or data types that describe patterns used by other profiles, but cannot be instantiated directly. I.e. instances can conform to profiles based on these abstract profiles but do not declare conformance to the abstract profiles themselves.

AT PreNUDGE Observation

This FHIR profile is defining the overall Observation for PreNUDGE. It is abstract, so no instances of this profile directly are allowed. Be aware that if the user enters values from a device into a questionnaire, it is still considered a manual input. Please keep in mind that all observations must comply with the qualification matrix on https://prenudge.at/qualificationmatrix/.

AT PreNUDGE Questionnaire

This FHIR profile is defining the overall Questionnaire for PreNUDGE. Every top level item requires one comment subitem, with the linkId ending or equal 'comment'. Be aware that if the user enters values from a device into a questionnaire, it is still considered a manual input. Please keep in mind that all questionnaires must comply with the qualification matrix on https://prenudge.at/qualificationmatrix/.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

AT PreNUDGE Observation Alcohol Use

This FHIR profile is derived from the APS Observation Alcohol Use profile. Additional fields from the PreNUDGE Observation profile are added.

AT PreNUDGE Observation Blood Glucose (only in mg/dL)

This FHIR profile is defining the Blood Glucose Observation, similar to the Observation Social History - Alcohol Use from the IPS. The blood glucose option only allows values inbetween 0 and 999 mg/dL.

AT PreNUDGE Observation Highest Completed Education

This FHIR profile defines the person's highest completed education level using ISCED 2011. It is intended for sociodemographic data collected by a simple questionnaire.

AT PreNUDGE Observation Other Quantities

This FHIR profile can be used for all the other Observations for PreNUDGE, beeing quantities and not fitting the existing narrow standardized observations. If some code for specifying a new Observation is missing, please contact prenudge@joanneum.at.

AT PreNUDGE Observation Other not Quantities

This FHIR profile can be used for all the other Observations for PreNUDGE, not being an quantity and not fitting the existing narrow standardized observations.

AT PreNUDGE Observation Sleep Duration

This FHIR profile defines the Sleep Duration Observation recording average nightly sleep in hours. Applicable for both automated wearable measurements (method = automated) and self-reported values derived from a questionnaire (method = manual).

AT PreNUDGE Observation Sleep Quality

Records the self-assessed sleep quality from PROMIS (My sleep quality was…in past 7 days). Also used to map WHOQOL-BREF Q16 from standalone SleepQualityQuestionnaire or the full WhoQolBrefQuestionnaire.

AT PreNUDGE Observation Smoking Status

This FHIR profile is defining the current smoking status observation for PreNUDGE. It is derived from the APS Observation Tobacco Use profile, which imposes the IPS Observation Social History - Tobacco Use profile. The value is derived from the ATHIS-based SmokingStatusQuestionnaire, primarily from SK1 and, if SK1 is negative, from the past tobacco smoking question. Additional fields from the PreNUDGE Observation profile are added.

AT PreNUDGE Observation Step Count

This FHIR profile is defining the Step Count Observation. The step count only allows values inbetween 0 and 150,000 steps per 24 hours.

AT PreNUDGE Observation WHOQOL-BREF Score

Observation profile for recording WHOQOL-BREF domain scores. The overall score is represented in Observation.value, individual domain scores are recorded as components.

AT PreNUDGE Observation Work-SoC Category Score

This FHIR profile defines the calculated work-related sense of coherence (Work-SoC) category score observation. It contains the category scores for comprehensibility, manageability and meaningfulness as Observation components. The raw Work-SoC item answers are represented in the source QuestionnaireResponse.

AT PreNUDGE Questionnaire Response

This FHIR profile is defining the overall Questionnaire Response for PreNUDGE. Be aware that if the user enters values from a device into a questionnaire, it is still considered a manual input. Please keep in mind that all questionnaire responses must comply with the qualification matrix on https://prenudge.at/qualificationmatrix/.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

AT PreNUDGE Alcohol Use Frequency

Frequencies used in the PreNUDGE alcoholuse questionnaire.

AT PreNUDGE Blood Glucose Meal Context

Meal context used in the PreNUDGE Blood Glucose questionnaire and observation.

AT PreNUDGE ISCED 2011 Education Level ValueSet

Permitted answer values for the highest completed education level according to ISCED 2011.

AT PreNUDGE Observation Methods

ValueSet containing SNOMED CT codes for differentiating methods used in the PreNUDGE observation.

AT PreNUDGE Other Observations Codes

Allowed observation codes for the 'Other' observation profile.

AT PreNUDGE Other Observations Units

Allowed UCUM units for the 'Other' observation profile.

AT PreNUDGE WAI Physical Demands Answer ValueSet

Permitted categorical answers for current work ability in relation to physical work demands.

AT PreNUDGE WHOQOL-BREF Score Type ValueSet

ValueSet containing SNOMED CT codes for differentiating WHOQOL-BREF overall and domain scores.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

AT PreNUDGE ISCED 2011 Education Level Codes

Local representation of ISCED 2011 education levels for the highest completed education level used in PreNUDGE. Austrian levels are described at https://bildungssystem.oead.at/isced-klassifikation

AT PreNUDGE WAI Answer Codes

Local answer codes for categorical Work Ability Index answer options.

AT PreNUDGE WHOQOL-BREF Answer Scales

Consolidated CodeSystem for all answer scales of the WHOQOL-BREF questionnaire.

AT PreNUDGE Workability Codes

Local PreNUDGE codes for workability questionnaires and derived Work-SoC score observations. Work-SoC source DOI: https://doi.org/10.4102/sajip.v39i1.1111

ATHIS – Antwortmöglichkeiten

Vollständige Antwortmöglichkeiten aus dem ATHIS Fragebogen (Österreichische Gesundheitsbefragung, STATISTIK AUSTRIA, Version 31.03.2025). Codes sind englisch; Display-Werte bleiben deutsch. Gruppiert nach Skalentypen. Hinweis: Bestehende PreNUDGE CodeSystems bleiben gültig – whoqol-bref-scale (LQ16-Zufriedenheitsskala), prenudge-nutrition-consumption-frequency (DH1/DH3 numerische Codes), prenudge-alcoholuse-frequency (AL1 SNOMED-basiert).

Terminology: Structure Maps

These define transformations to convert between data structures used by systems conforming to this implementation guide.

ATHIS-based Smoking Status Q to O

ATHIS-based Smoking Status Q to O

Alcohol Use Q mapping frequency to O drinks per day

Alcohol Use Q mapping frequency to O drinks per day

Blood Glucose Q to O

Blood Glucose Q to O

Shared base for Q to O

Shared base for Q to O

Sleep Duration Q to O

Sleep Duration Q to O

Sleep Quality Base (WHOQOL-BREF scale to LOINC)

Sleep Quality Base (WHOQOL-BREF scale to LOINC)

Step Count Q to O

Step Count Q to O

WHOQOL-BREF Q score to O score

WHOQOL-BREF Q score to O score

Work-SoC Q score to O score

Work-SoC Q score to O score

Terminology: Concept Maps

These define transformations to convert between codes by systems conforming with this implementation guide.

AT PreNUDGE Code-to-Unit Mapping

Maps observation codes to their expected UCUM units for the 'Other Quantities' observation profile.

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Alcohol Use O - Moderate (3-4 times weekly)

Example of an alcohol use observation for a moderate drinker consuming alcohol 3-4 times per week (0.5 drinks per day).

Alcohol Use O mapped from Q - Daily

Example of an alcohol use observation for a daily drinker (1 drink per day).

Alcohol Use O mapped from Q - Non-Drinker

Example of an alcohol use observation for a lifetime non-drinker (0 drinks per day).

Alcohol Use Q - Daily

Example of an alcohol use observation for a daily drinker.

Alcohol Use Q - Non-Drinker

Example of an alcohol use observation for a lifetime non-drinker.

AtApsPatient-example

An example of a patient with a license to krill.

Blood Glucose O - Low Example

Example of a low fasting blood glucose measurement (62 mg/dL), indicating hypoglycemia.

Blood Glucose O mapped from Q - Elevated Example

Example of an elevated fasting blood glucose measurement (142 mg/dL), indicating diabetes mellitus.

Blood Glucose O mapped from Q - Normal Example

Example of a normal fasting blood glucose measurement (95 mg/dL).

Blood Glucose Q - Elevated Example

Example of an elevated fasting blood glucose measurement (142 mg/dL), indicating diabetes mellitus.

Blood Glucose Q - Normal Example

Example of a normal fasting blood glucose measurement (95 mg/dL).

Education O mapped from Q - Bachelor's Level Example

Example of a highest completed education observation mapped from the EducationQuestionnaire.

Education O mapped from Q - Upper Secondary Education Example

Example of a highest completed education observation mapped from the EducationQuestionnaire.

Education Q - Bachelor's Level Example

Example of a highest completed education questionnaire response using ISCED 2011 level 6.

Education Q - Upper Secondary Education Example

Example of a highest completed education questionnaire response using ISCED 2011 level 3.

Sleep Duration O - Normal Automated Example

Example of a normal average sleep duration (7.5 h) measured by a wearable device.

Sleep Duration O - Short Automated Example

Example of a short average sleep duration (5.5 h) measured by a wearable device, indicating insufficient sleep.

Sleep Duration O mapped from Q - Normal Example

Example of a self-reported average sleep duration (7 h) derived from a questionnaire response.

Sleep Duration Q - Normal Example

Example of a self-reported normal average sleep duration (7 h per night).

Sleep Duration Q - Short Example

Example of a self-reported short average sleep duration (5.5 h per night).

Sleep Quality O mapped from Q - Dissatisfied Example

Example of a sleep quality observation indicating poor sleep satisfaction (LA8969-3 - Poor), derived from the standalone SleepQualityQuestionnaire (S2 - Unzufrieden mapped to LOINC).

Sleep Quality O mapped from Q - Satisfied Example

Example of a sleep quality observation indicating good sleep satisfaction (LA8967-7 - Good), derived from the standalone SleepQualityQuestionnaire (S4 - Zufrieden mapped to LOINC).

Sleep Quality Q - Dissatisfied Example

Example of a standalone sleep quality questionnaire response indicating dissatisfaction with sleep (S2 - Unzufrieden).

Sleep Quality Q - Satisfied Example

Example of a standalone sleep quality questionnaire response indicating satisfaction with sleep (S4 - Zufrieden).

Smoking Status O - Not Stated Example

Example of a smoking status observation where no clinically meaningful smoking status could be derived because the respondent declined to answer.

Smoking Status O mapped from ATHIS Q - Current Daily Tobacco Smoker Example

Example of a smoking status observation for a current daily tobacco smoker, mapped from SK1 of the ATHIS-based SmokingStatusQuestionnaire.

Smoking Status O mapped from ATHIS Q - Former Tobacco Smoker Example

Example of a smoking status observation for a former tobacco smoker, mapped from SK1 and the past tobacco smoking question of the ATHIS-based SmokingStatusQuestionnaire.

Smoking Status O mapped from ATHIS Q - Never Tobacco Smoker Example

Example of a smoking status observation for a person who never smoked tobacco, mapped from SK1 and the past tobacco smoking question of the ATHIS-based SmokingStatusQuestionnaire.

Smoking Status Q ATHIS - Current Daily Tobacco Smoker Example

Example of an ATHIS-based smoking status questionnaire response for a current daily tobacco smoker. The derived observation maps SK1 daily to SNOMED CT 449868002.

Smoking Status Q ATHIS - Former Tobacco Smoker Example

Example of an ATHIS-based smoking status questionnaire response for a former tobacco smoker. The derived observation maps SK1 no and past tobacco smoking to SNOMED CT 8517006.

Smoking Status Q ATHIS - Never Tobacco Smoker Example

Example of an ATHIS-based smoking status questionnaire response for a person who never smoked tobacco. The derived observation maps SK1 no and past tobacco smoking no to SNOMED CT 266919005.

Smoking Status Q ATHIS - Not Stated Example

Example of an ATHIS-based smoking status questionnaire response where the respondent declined to answer the current tobacco smoking question. The derived observation uses dataAbsentReason asked-declined.

Step Count EHIS PAQ Q - High Example

Example of a high step count (7 times a week with 2-3 hours).

Step Count EHIS PAQ Q - Normal Example

Example of a normal step count (5 times a week with 30-59 minutes).

Step Count O - Sedentary Example

Example of a low step count (1,204 steps per day), typical for a mostly sedentary day.

Step Count O mapped from Q - High Example

Example of a high step count (133,519 steps per day).

Step Count O mapped from Q - Normal Example

Example of a normal step count (8,432 steps per day).

Step Count Q - High Example

Example of a high step count (133,519 steps per day).

Step Count Q - Normal Example

Example of a normal step count (8,432 steps per day).

WAI Q - Example

Example of a short Work Ability Index questionnaire response.

WHOQOL-BREF O Score only mapped from Q

Example of a WHOQOL-BREF score observation with a general score and all four domain scores.

WHOQOL-BREF Q

Example of a completed WHOQOL-BREF QuestionnaireResponse including all 26 items and calculated scores.

Work-SoC Q - Example

Example of a Work-SoC questionnaire response with nine raw item answers.

Work-SoC Score O mapped from Q - Example

Example of a calculated Work-SoC category score observation derived from the WorkSocQuestionnaire.