Kam-pickers

ValueSet picker

The valueSet picker can be used to select the following valueSets:

• ObservationCodes

• Conditions

To open the valueSet picker, sent a custom event with name “openValueSetPicker”.

Example:

window.dispatchEvent(
    new CustomEvent('openValueSetPicker', {
        detail: {
            callerId: 'useContextCondition',
            readonlyMode: false,
            multiSelect: true,
            language: 'da',
            designationUseCode: 'consumer',
            valueSetType: 'Conditions',
            codeableConcepts: this.form.value.useContext,
        },
    })
);

Input data:

interface ValueSetPickerData {
  callerId: string;
  readonlyMode: boolean;
  multiSelect: boolean;
  language: string;
  designationUseCode: string;
  valueSetType: ValueSetType;
  selectedValues: CodeableConcept[];
}
 
enum ValueSetType {
  ObservationCodes = 'ObservationCodes',
  Conditions = 'Conditions',
}

Explanation:

• callerId: an unique id that will be returned with the output result. CallerId makes it possible for the caller to distingues which form field the pickers was opened as the same picker can be used multiple times

• readonlyMode: true for readonly mode

• multiSelect: true if it should be possible to select more than one

• language: language code. eg. "da" for danish

• designationUseCode: display text targeting specific audience

  • values:

    • "consumer"

      • description: Designation for use in display to non-clinicians and those not in healthcare professions as a more friendly term for coommunication.

• valueSetType:

  • values:

    • "ObservationCodes"

    • "Conditions"

• selectedValues: Which CodeSystem should be preselected when the valueSet picker is opened.

  • Supported CodeableConcept:

    • Only one coding per CodeableConcept

Output data:

interface ValueSetPickerDialogResult {
  callerId: string;
  codeableConcepts: CodeableConcept[];
}

Explanation:

• callerId: An unique id that will be returned back with the output result. CallerId makes it possible for the caller to distingues which form field the pickers was opened from as the same picker can be used multiple times

• codeableConcepts: List of all the selected codes.

  • Always only one code per CodeableConcept

Organization picker

The organization picker can be used to select organizations from STS-ORG or SOR.

To open the organization picker, sent a custom event with name “openOrganizationPicker”.

Example:

window.dispatchEvent(
      new CustomEvent('openOrganizationPicker', {
        detail: {
          callerId: 'ownerField',
          onlyAllowRootSelection: false,
          selectedIds: ['139636'],
        },
      })
    );

Input data:

interface OrganizationPickerData {
  callerId: string;
  onlyAllowRootSelection: boolean;
  selectedIds: string[];
}

Explanation:

• callerId: an unique id that will be returned with the output result. CallerId makes it possible for the caller to distingues which form field the pickers was opened from as the same picker can be used multiple times

• onlyAllowRootSelection: If true only organization on top level i selectable. At the moment top level is: Regions and municipalities

• selectedIds: Which organization should be preselected when the organization picker is opened.

Output data:

interface OrganizationPickerDialogResult {
  callerId: string;
  selected: Organization[];
}
 
interface Organization {
  id: string;
  name: string;
  source: Source | null;
  alias: string[];
  parentReferenceId: string | null;
  cvrNumber: string | null;
  referenceUrl: string;
}

Explanation:

• OrganizationPickerDialogResult

  • callerId: an unique id that will be returned back with the output result. CallerId makes it possible for the caller to distingues which form field the pickers was opened from as the same picker can be used multiple times

  • selected: List of all the selected organizations

• Organization

  • id: organization id

  • name: organization name

  • source: Possible values: 'SOR', 'STS-ORG', 'manual'

  • alias: A hierarchy from the root organization down to the specific organization

  • parentReferenceId: id of the parent organization

  • cvrNumber: cvr number

  • referenceUrl: URL to the specific organization

Questionnaire picker

The questionnaire picker can be used to select questionnaire. To open the questionnaire picker, sent a custom event with name “openQuestionnairePicker”.

Example:

window.dispatchEvent(
      new CustomEvent('openQuestionnairePicker', {
        detail: {
          callerId: 'questionnaireField',
          selectedIds: ['23'],
          multiSelect: true,
        },
      })
    );

Input data: 

interface QuestionnairePickerData {
    callerId: string;  
    selectedIds: string[];
    multiSelect: boolean;
}

Explanation:

• callerId: an unique id that will be returned with the output result. CallerId makes it possible for the caller to distingues which form field the pickers was opened as the same picker can be used multiple times

• selectedIds: Which organization should be preselected when the organization picker is opened.

• multiSelect: true if it must be possible to select more than one questionnaire

Output data:

interface QuestionnairePickerDialogResult {
  callerId: string;
  selected: Questionnaire[];
}

Explanation:

• callerId: an unique id that will be returned back with the output result. CallerId makes it possible for the caller to distingues which form field the pickers was opened from as the same picker can be used multiple times

• selected: List of all the selected questionnaire

Timing picker

The timing picker can be used to setup timing expressions. To open the timing picker, sent a custom event with name “openTimingPicker”.

Example:

window.dispatchEvent(
      new CustomEvent('openTimingPicker', {
        detail: {
          timingPickerData: {
            callerId: 'timingField',
            timing: timingObject,
          },
        },
      })
    );

Input data: 

interface TimingPickerData {
  callerId: string;
  timing: Timing;
}

Explanation:

• callerId: an unique id that will be returned with the output result. CallerId makes it possible for the caller to distingues which form field the pickers was opened as the same picker can be used multiple times

• timing: fhir timing object.

Output data:

interface TimingPickerData {
  callerId: string;
  timing: Timing;
}

Explanation:

• callerId: an unique id that will be returned with the output result. CallerId makes it possible for the caller to distingues which form field the pickers was opened as the same picker can be used multiple times

• timing: fhir timing object updated/created in the timing picker