Illness Symptoms Selector

Launch an illness symptoms selection interface from a Fulcrum form using OPENEXTENSION(), then save selected symptom values back to a target text field.

This app extension example gives users a custom illness symptoms selection interface in Fulcrum. It opens a dedicated HTML extension from a Hyperlink field, allows users to select any current symptoms, and writes the selected values back to a target text field.

Use this when you want a selector for illness symptom screening at a job-site or work location. This app extension runs inside a Fulcrum form and uses a Reference File for offline-friendly access in the mobile app.

Demo Clip

Watch a short clip of the extension workflow:

Download clip: OPENEXTENSION Demo for Illness Symptoms Selector.mp4

What this clip shows:

  • Launching a custom HTML web application from Fulcrum using OPENEXTENSION()
  • Configuring the app and data event to trigger the extension
  • Selecting illness symptoms from a guided interface
  • Returning and storing selected values back in Fulcrum

Setup

  1. Download illness-symptoms-selector.html and upload it as a Reference File in your app.
  2. Add a trigger field, commonly a Hyperlink field, with a data name such as select_illness_symptoms_if_any.
    • Recommended label: Select Illness Symptoms (If Any)
  3. Add a target Text field with a data name such as illness_symptoms.
  4. Paste the Data Event below into your app and update the field data names as needed.

Data Event Script

/**
 * Fulcrum Data Event — Illness Symptoms Selector
 * ──────────────────────────────────────────────
 * Paste this script into the Data Events editor for your app.
 *
 * HOW IT WORKS
 * ────────────
 * 1. The user taps the trigger field, for example a Hyperlink field labelled
 *    "Select Illness Symptoms (If Any)".
 * 2. The illness-symptoms-selector.html extension opens from a Reference File.
 * 3. The user selects any current symptoms in the custom interface.
 * 4. The extension sends the selected values back to Fulcrum.
 * 5. Fulcrum writes the returned values into the target text field using
 *    SETVALUE().
 *
 * FIELD SETUP (in the form builder)
 * ─────────────────────────────────
 * • Trigger field – a Hyperlink field, Label/Button field, or similar launch field.
 *   Recommended label: "Select Illness Symptoms (If Any)"
 *   Data name (example): select_illness_symptoms_if_any
 *
 * • Target field – a Text field.
 *   This field stores the returned symptom values.
 *   Data name (example): illness_symptoms
 *
 * Replace BOTH data names below in the data event with your actual field data names.
 */

ON('click', 'select_illness_symptoms_if_any', () => {
  OPENEXTENSION({
    url: 'attachment://illness-symptoms-selector.html',
    title: 'Illness Symptoms',
    data: { illness_symptoms: $illness_symptoms },
    onMessage: ({ data }) => {
      SETVALUE('illness_symptoms', data.illness_symptoms);
    }
  });
});

Extension File

The full extension file is available here: illness-symptoms-selector.html