Complete User Guide

dotnet --version

dotnet new console -n MyHealthcareApp
cd MyHealthcareApp

# Windows
cd C:\Projects\MyHealthcareApp

# macOS / Linux
cd ~/Projects/MyHealthcareApp

dotnet add package InteropSuite

info : Adding PackageReference for package 'InteropSuite' into project 'MyHealthcareApp.csproj'.
info : Package 'InteropSuite' is compatible with all the specified frameworks.
info : PackageReference for package 'InteropSuite' version '1.0.5' added to file 'MyHealthcareApp.csproj'.

dotnet list package

Project 'MyHealthcareApp' has the following package references
   [net9.0]:
   Top-level Package      Requested   Resolved
   > InteropSuite         *           1.0.5

export INTEROPSUITE_LICENSE="your-license-key"

$env:INTEROPSUITE_LICENSE = "your-license-key"

using InteropSuite.Fhir.Engine;

// Activate with your license key
Interop.ActivateLicense("your-license-key");

using InteropSuite.Fhir.Engine;

// Your HL7 message
string hl7Message = @"MSH|^~\&|SENDING|FACILITY|...";

// Transform it
var result = await Interop.HL7ToFhirAsync(hl7Message);

if (result.Success)
{
    string fhirJson = result.FhirBundle;
    Console.WriteLine($"Detected: {result.DetectedFormat}");
}

using InteropSuite.Fhir.Engine;

// Your X12 transaction
string x12Message = "ISA*00*...";

// Transform it
var result = await Interop.X12ToFhirAsync(x12Message);

if (result.Success)
{
    Console.WriteLine($"Detected: {result.DetectedFormat}"); // e.g., "X12^837P"
}

using InteropSuite.Fhir.Engine;

// Your C-CDA document
string cdaDocument = "<ClinicalDocument>...</ClinicalDocument>";

// Transform it
var result = await Interop.CDAToFhirAsync(cdaDocument);

if (result.Success)
{
    Console.WriteLine($"Detected: {result.DetectedFormat}"); // e.g., "CDA^34133-9"
}

// Standard US Core output
var usCore = await Interop.X12ToFhirAsync(x12Message);

// CMS-0057-F compliant output
var cms = await Interop.X12ToFhirAsync(x12Message, OutputFormat.Cms0057F);

using InteropSuite.Fhir.Engine;
using InteropSuite.Fhir.Engine.Batch;

var options = new BatchOptions
{
    Sources = new[]
    {
        new BatchSource("input/hl7", "HL7", OutputFormat.UsCore),
        new BatchSource("input/x12", "X12", OutputFormat.UsCore),
        new BatchSource("input/cda", "CDA", OutputFormat.UsCore),
        new BatchSource("input/cms", "CMS-0057-F", OutputFormat.Cms0057F),
    }
};

// Files interleaved: HL7[0], X12[0], CDA[0], CMS[0], HL7[1]...
var result = await Interop.ProcessBatchAsync(options);

Console.WriteLine($"Total: {result.TotalFiles}");
Console.WriteLine($"Succeeded: {result.Succeeded}");
Console.WriteLine($"Failed: {result.Failed}");

using InteropSuite.Fhir.Engine;
using InteropSuite.Fhir.Engine.Batch;

var options = new BatchOptions
{
    Domain = "HL7",
    OutputFormat = OutputFormat.UsCore
};

var result = await Interop.ProcessBatchAsync("./input", options);

Console.WriteLine($"Total: {result.TotalFiles}");
Console.WriteLine($"Succeeded: {result.Succeeded}");
Console.WriteLine($"Failed: {result.Failed}");

InteropSuite.TraceServer.exe -d C:\path\to\your\app\interopsuite\dashboard

# Make executable (first time only)
chmod +x InteropSuite.TraceServer

# Run with -d pointing to your app's dashboard directory
./InteropSuite.TraceServer -d /path/to/your/app/interopsuite/dashboard

InteropSuite Trace Server
=========================

Server running at: http://localhost:8765/report.html
Dashboard directory: /path/to/your/app/interopsuite/dashboard

Press Ctrl+C to stop.

# Show help
./InteropSuite.TraceServer --help

# Point to specific dashboard directory
./InteropSuite.TraceServer -d /path/to/dashboard
./InteropSuite.TraceServer --directory /path/to/dashboard

# Or just pass the path directly
./InteropSuite.TraceServer /path/to/dashboard

using InteropSuite.Fhir.Engine;

// Enable dashboard data generation (required!)
Interop.DashboardEnabled = true;

// Optional: Configure data retention (default: 7 days)
Interop.DashboardRetentionDays = 7;

// Now process files - TraceServer will see them!
var result = await Interop.ProcessBatchAsync("./input", options);

# Relative to your application directory
{workingDir}/interopsuite/dashboard/sessions/

# Example: if your app is in /Users/john/MyHealthApp/
/Users/john/MyHealthApp/interopsuite/dashboard/sessions/

# Point TraceServer to your app's data
./InteropSuite.TraceServer -d /path/to/your/app/interopsuite/dashboard

# Or use environment variable
export INTEROPSUITE_DASHBOARD_DIR=/path/to/your/app/interopsuite/dashboard
./InteropSuite.TraceServer

using InteropSuite.Fhir.Engine;
using InteropSuite.Fhir.Engine.Batch;  // For batch processing

var result = await Interop.ToFhirAsync(message);

if (result.Success)
{
    string fhir = result.FhirBundle;      // FHIR JSON string
    string format = result.DetectedFormat; // e.g., "HL7 ADT^A01"
}
else
{
    foreach (var error in result.Errors)
    {
        Console.WriteLine(error);
    }
}