JASPEHR(the JApanese Standard Platform for EHRs) 実装ガイド
1.0.0 - draft

JASPEHR(the JApanese Standard Platform for EHRs) 実装ガイド - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

ValueSet: JASPEHR Questionnaire Item UI Control Codes

Official URL: http://www.hosp.ncgm.go.jp/JASPEHR/fhir/ValueSet/questionnaire-item-control-Jaspehr Version: 1.0.0
Draft as of 2021-12-13 Computable Name: QuestionnaireItemUIControlCodesJaspehr

Starter set of user interface control/display mechanisms that might be used when rendering an item in a questionnaire.

References

Logical Definition (CLD)

Generated Narrative: ValueSet questionnaire-item-control-Jaspehr

This value set includes codes based on the following rules:

This value set excludes codes based on the following rules:

  • Exclude these codes as defined in http://hl7.org/fhir/questionnaire-item-control
    CodeDisplayDefinition
    tableVertical Answer TableQuestions within the group are rows in the table with possible answers as columns. Used for 'choice' questions. The questions within a group marked with this controlType SHALL provide an enumerated list of options and SHOULD refer to the same set of options, same value set or same expression. In the case of a 'sparse' table where some options aren't available for some questions, the order of the answers in the table is not defined and some rendering tools may refuse to display the group as a table.
    htableHorizontal Answer TableQuestions within the group are columns in the table with possible answers as rows. Used for 'choice' questions. The questions within a group marked with this controlType SHALL provide an enumerated list of options and SHOULD refer to the same set of options, same value set or same expression. In the case of a 'sparse' table where some options aren't available for some questions, the order of the answers in the table is not defined and some rendering tools may refuse to display the group as a table.
    gtableGroup TableQuestions within the group are columns in the table with each group repetition as a row. Used for single-answer questions.
    atableAnswer Table
    headerHeaderThe group is to be continuously visible at the top of the questionnaire. Header must be a top-level item and must not be marked as repeating, but need not be the first item in the Questionnaire. There can be at most one group of type 'header' in a Questionnaire.
    footerFooterThe group is to be continuously visible at the bottom of the questionnaire. Footer must be a top-level item and must not be marked as repeating, but need not be the last item in a Questionnaire. There can be at most one group of type 'header' in a Questionnaire.
    promptPromptText is displayed immediately below or within the answer-entry area of the containing question item (typically as a guide for what to enter). **Deprecation Note** - Use the [[[http://hl7.org/fhir/StructureDefinition/entryFormat]]] extension instead.
    unitUnitDisplay item is rendered adjacent (horizontally or vertically) to the answer space for the parent question, typically to indicate a unit of measure. **Deprecation Note** - The display element of the [[[http://hl7.org/fhir/StructureDefinition/questionnaire-unit]]] should be used instead.
    lowerLower-boundDisplay item is rendered to the left of the set of answer choices or a scaling control for the parent question item to indicate the meaning of the 'lower' bound. E.g. 'Strongly disagree'
    upperUpper-boundDisplay item is rendered to the right of the set of answer choices or a scaling control for the parent question item to indicate the meaning of the 'upper' bound. E.g. 'Strongly agree'
    flyoverFly-overDisplay item is temporarily visible over top of an item if the mouse is positioned over top of the text for the containing item
    helpHelp-ButtonDisplay item is rendered in a dialog box or similar control if invoked by pushing a button or some other UI-appropriate action to request 'help' for a question, group or the questionnaire as a whole (depending what the display item is nested within)
    autocompleteAuto-completeA control which provides a list of potential matches based on text entered into a control. Used for large choice sets where text-matching is an appropriate discovery mechanism.
    lookupLookupA control where editing an item spawns a separate dialog box or screen permitting a user to navigate, filter or otherwise discover an appropriate match. Useful for large choice sets where text matching is not an appropriate discovery mechanism. Such screens must generally be tuned for the specific choice list structure.
    sliderSliderA control where an axis is displayed between the high and low values and the control can be visually manipulated to select a value anywhere on the axis.
    spinnerSpinnerA control where a list of numeric or other ordered values can be scrolled through via arrows.

 

Expansion

ValueSet

Expansion performed internally based on codesystem Questionnaire Item UI Control Codes System v5.2.0 (CodeSystem)

This value set contains 13 concepts

CodeSystemDisplay (en-US)Definition
  grouphttp://hl7.org/fhir/questionnaire-item-control

UI controls relevant to organizing groups of questions

  listhttp://hl7.org/fhir/questionnaire-item-control

Questions within the group should be listed sequentially

  gridhttp://hl7.org/fhir/questionnaire-item-control

Child items of type='group' within the a 'grid' group are rows, and questions beneath the 'row' groups are organized as columns in the grid. The grid might be fully populated, but could be sparse. Questions may support different data types and/or different answer choices.

  pagehttp://hl7.org/fhir/questionnaire-item-control

Indicates that the content within the group should appear as a logical "page" when rendering the form, such that all enabled items within the page are displayed at once, but items in subsequent groups are not displayed until the user indicates a desire to move to the 'next' group. (Header and footer groups for a questionnaire will be rendered on all pages.) This designation may also influence pagination when printing questionnaires.

If a group item has this itemControl value, then all sibling items SHALL also be of type group and also have an itemControl value of 'page', 'header', or 'footer'. Form fillers SHOULD raise an error if a Questionnaire fails to adhere to this requirement. Page items SHOULD be a top-level item and generally should not nest (i.e. pages should not be descendants of a page group).

  tab-containerhttp://hl7.org/fhir/questionnaire-item-control

Indicates that the group represents a collection of tabs. All child items SHALL be of type 'group' and SHALL NOT declare any item controls themselves. Each child group represents one tab within the tab container, where the item.text is the label for the tab.

  displayhttp://hl7.org/fhir/questionnaire-item-control

UI controls relevant to rendering questionnaire display items

  inlinehttp://hl7.org/fhir/questionnaire-item-control

Display item is rendered as a paragraph in a sequential position between sibling items (default behavior)

  legalhttp://hl7.org/fhir/questionnaire-item-control

Display item is rendered in a dialog box or similar control if invoked by pushing a button or some other UI-appropriate action to request 'legal' info for a question, group or the questionnaire as a whole (depending what the display item is nested within)

  questionhttp://hl7.org/fhir/questionnaire-item-control

UI controls relevant to capturing question data

  drop-downhttp://hl7.org/fhir/questionnaire-item-control

A control where an item (or multiple items) can be selected from a list that is only displayed when the user is editing the field. This control is best used for small-to-medium sized lists of options that can reasonably be scanned and selected in a drop-down control. If the list of options is managed by ValueSet, the designer should be confident that the set of codes will both be fully available and appropriately sized. For larger lists, the autocomplete control is more appropriate.

  check-boxhttp://hl7.org/fhir/questionnaire-item-control

A control where choices are listed with a box beside them. The box can be toggled to select or de-select a given choice. Multiple selections may be possible. Commonly useful for repeating items of type constrained by answerOption, answerValueset or answerExpression, however can also be used for boolean (if the checkbox is a 3-state control that allows 'unanswered' as a possibility).

  radio-buttonhttp://hl7.org/fhir/questionnaire-item-control

A control where choices are listed with a button beside them. The button can be toggled to select or de-select a given choice. Selecting one item deselects all others. Used for non-repeating items with 'closed' answerOption, answerValueset or answerExpression constraints. Can also be used for boolean so long as there is a button for 'unanswered' or it's possible to deselect all items.

  text-boxhttp://hl7.org/fhir/questionnaire-item-control

A control where a user can type in their answer freely.


Explanation of the columns that may appear on this page:

Level A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies
System The source of the definition of the code (when the value set draws in codes defined elsewhere)
Code The code (used as the code in the resource instance)
Display The display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application
Definition An explanation of the meaning of the concept
Comments Additional notes about how to use the code