📘 Time‑to‑Breach Monitor

SLA Remaining Time & Breach Indicator Control

Full Documentation

📌 Overview

Time‑to‑Breach Monitor is a reusable OutSystems UI component that calculates, displays, and visualizes the remaining or exceeded time of any SLA-based request.
By providing real‑time countdown logic, human‑readable time breakdown, and clear visual indicators, this control helps teams instantly understand SLA status and avoid breaches.

It is ideal for ITSM applications, workflow engines, ticketing portals, and any system that needs SLA monitoring.

🧩 Key Features

✔ 1. SLA Remaining Time Calculation

The component takes:

• Request Creation DateTime
• SLA Duration in Days

and automatically calculates:

• Months
• Weeks
• Days
• Hours

Example output:
“The remaining time is 0 months, 0 weeks, 6 days, and 16 hours.”

✔ 2. Automatic Breach Detection

If the SLA end date is exceeded, the component switches to overdue mode:

“Overdue by 0 months, 0 weeks, 2 days, and 8 hours.”

This is shown with a red overdue icon for instant feedback.

✔ 3. SLA Progress Bar (Before Breach)

When the SLA is active, the component displays a visual progress bar showing the remaining percentage.

Example:
Remaining: 70%

If the SLA is exceeded, the progress bar is hidden automatically.

✔ 4. UI Indicators

The component shows a clear icon based on status:

• 🟢 Green Countdown Icon → SLA still valid
• 🔴 Red Overdue Icon → SLA breached

⚙ Inputs

📤 Outputs

The control generates:

1. A readable SLA message

Examples:

• “The remaining time is 1 month, 1 week, 2 days, and 5 hours.”
• “Overdue by 0 months, 0 weeks, 2 days, and 8 hours.”

2. SLA Status Mode

• Remaining
• Overdue

3. Progress Percentage (remaining SLA time)

🧠 Logic Summary

1. Calculate SLA Deadline
   CreationDateTime + SLAInDays

2. Compare with Current DateTime

   • If now < deadline → remaining
   • If now > deadline → overdue

3. Break the duration into:

   • Months
   • Weeks
   • Days
   • Hours

4. Display progress bar only when SLA is not breached

🖼 Example Screens

1. SLA Still Valid

The remaining time is 0 months, 0 weeks, 6 days, and 16 hours.
Remaining: 70%

Displayed with a blue progress bar and green SLA icon.

2. SLA Breached

Overdue by 0 months, 0 weeks, 2 days, and 8 hours.

Displayed with a red overdue icon and no progress bar.

🎯 Use Cases

• Ticketing systems
• Service management dashboards
• Customer complaint tracking
• Workflow approval systems
• Maintenance & field service apps
• Contract-based SLA monitoring

🛠 Installation & Usage

1. Install the component from OutSystems Forge.
2. Drag the Time‑to‑Breach Monitor block into your screen.
3. Provide the two required inputs:
   • CreationDateTime
   • SLAInDays
4. The component automatically:
   • Calculates SLA deadline
   • Determines if SLA is active or overdue
   • Displays remaining time breakdown
   • Shows progress bar if applicable

No additional configuration is required.