FormSDK VB.NET Example

A VB.NET Windows Forms application demonstrating the Tiro Health Form SDK integration.

Overview

This application shows how to integrate FHIR questionnaires using the Tiro Health Form SDK. It displays a form viewer that allows users to fill out medical questionnaires and handles form submission with proper validation.

Features

• FHIR Integration: Uses FHIR Patient data to provide context for questionnaires
• Form Submission Handling: Processes submitted QuestionnaireResponse with validation
• Validation Support: Shows validation errors and allows users to choose whether to close anyway
• Narrative Display: Shows the narrative text from submitted responses

Key Components

Form1.vb

Main form containing:

• TiroFormViewer: The form viewer user control
• Patient Context: Sample patient data (Leonardo da Vinci)
• Form Submission Flow: Handles the complete submission lifecycle

Form Design

The form design is minimal - it's simply a basic Windows Form with the TiroFormViewer user control added and docked to fill the entire form. The user control handles all the form rendering and interaction, making integration straightforward.

Form Submission Flow

1. Form Closing: When user closes the form, SendFormRequestSubmitAsync() is called
2. Submission Processing: The HandleFormSubmitted event handler processes the response
3. Validation: Checks e.Outcome.Success for validation errors
4. User Choice: If validation fails, user can choose to close anyway
5. Form Closure: Form closes after successful processing

Usage

1. Build and run the application
2. Fill out the displayed questionnaire
3. Close the form to trigger submission
4. Review any validation messages
5. View the narrative response in the message box

Dependencies

• Tiro.Health.WinForms.FormViewer
• Hl7.Fhir.Model
• SMARTWebEHR.Events

Template

The application uses a predefined questionnaire template: http://templates.tiro.health/templates/2630b8675c214707b1f86d1fbd4deb87