Overview

This framework provides a way to track and view integration activity between RIO Education (Salesforce), and external systems such as Canvas, Xero, and Microsoft 365. Cyclr performs all integration work, and RIO displays basic information about each job.

1. Purpose

• Give administrators a central place in RIO to see what integration jobs exist and when they last ran.
• Provide simple visibility without needing to open Cyclr.
• Help identify whether jobs are running on schedule.

2. How It Works

1. Cyclr executes each integration cycle (syncing users, enrolments, invoices, etc.).
2. After each run, Cyclr updates a record in Salesforce called RIO Connect Job.
3. RIO Connect Job shows the last run time and other basic metadata.
4. Detailed success/failure information remains inside Cyclr.

3. RIO Connect Job (Monitoring Object)

A custom object in RIO Education that lists all integration jobs.

What it shows:

• Job Name
• Job Type (Scheduled / On-Demand)
• Schedule Interval
• Last Run Time
• Basic runtime metadata
• Link/reference to the Cyclr flow

Important:
The RIO Connect Job record does not show whether the job succeeded or failed.
Instead, individual sync records (e.g., job run logs or transaction-level records created by the integration) will contain the sync status, error details, and failure descriptions.
Administrators can review these individual records when troubleshooting issues or checking failed transactions.

4. Alerts for Long-Running Jobs

The framework can alert administrators when a sync job takes longer than expected:

• Threshold: If a job runs longer than X hours (configurable per job), an alert is triggered.
• Alert Delivery: Notifications can be sent via email, Salesforce notifications, or integration into existing support channels.
• Purpose: Early detection of stalled or stuck integrations to prevent downstream impact.
• Administrators can investigate the affected individual sync records for errors or incomplete transactions.

5. What Admins Can Do

• Verify that integration jobs are running on schedule.
• Confirm that the last sync occurred recently.
• Identify which job corresponds to which system.
• Use the job reference to quickly jump into Cyclr when a deeper investigation is required.

6. Benefits

• Clear, central list of all integration jobs inside RIO Education.
• Quick visibility of job frequency and last run.
• Faster navigation to related Cyclr flows for troubleshooting.
• Works consistently across all external systems.