DFS Lite Connectors

Use connectors to bring data from external sources into FactVerse. A connector stores the source type, connection settings, sync behavior, status, and recent error information.

Connector lifecycle

Draft configuration -> test -> save -> start -> sync -> monitor -> update or pause

Create a connector

1. Open Data Integration > Connectors.
2. Select Add Connector.
3. Choose a source type.
4. Choose a template if one fits the source.
5. Enter connection settings.
6. Choose sync strategy.
7. Test the connection.
8. Save the connector.
9. Start it immediately, or leave it disabled until mapping is reviewed.

Choose a source type

Source type	Prepare before configuring
OPC UA	Endpoint URL, security mode, credentials, namespace or node information.
BACnet	Network route, device information, object list, polling expectation.
Modbus	Host, port, unit ID, register map, data types, scale factors.
MQTT	Broker URL, topics, payload format, credentials.
REST	Base URL, authentication method, request path, response field paths.
CSV	File, delimiter, header rules, timestamp field, key columns.
JDBC	Database URL, credentials, table or query, timestamp and key columns.
Fabric	Workspace or lakehouse connection details when the deployment enables this connector.

Name connectors clearly

Use names that help operators understand the source without opening it.

Good connector names include:

• site or plant;
• source system;
• data domain;
• line, area, or equipment group.

Examples:

• Singapore DC BMS meters
• Plant A Line 3 OPC UA
• Warehouse AGV MQTT status
• CMMS work order REST feed

Set sync strategy

Strategy	Use when	Operator check
Realtime	The source supports streaming or subscription.	Confirm events arrive continuously.
Interval	The source should be polled on a schedule.	Confirm interval and expected latency.
On demand	Data should load only when triggered.	Confirm the user or job that triggers sync.

Test the connector

Run Test Connection before saving or starting.

A passing test confirms that DFS can reach the source with the current settings. Continue with browse, preview, mapping, and sync before using the data in production workflows.

If the test fails:

Symptom	Check
Authentication error	Credentials, tokens, certificates, source-side permissions.
Network timeout	Host, port, VPN, firewall, allowlist, proxy route.
Protocol error	Security mode, topic, register map, endpoint path, payload format.
Empty result	Query, topic, node selection, file content, source-side filter.

Start, pause, resume, and sync

Connector List and Connector Detail support connector operations.

Action	Use
Start	Begin data collection for an enabled connector.
Pause	Stop collection while preserving configuration and historical data.
Resume	Restart a paused connector.
Sync	Trigger an on-demand row-mode sync when supported.
Delete	Remove the connector configuration after confirming it is no longer needed.

Batch actions can start, pause, or delete multiple selected connectors. Use batch delete carefully because downstream mappings and operational expectations may still refer to the connector.

Monitor connector detail

After the connector starts, review:

• connector status;
• last sync time;
• throughput;
• data point count;
• quality score;
• recent errors;
• mapping status;
• sync logs.

Validation checklist

A connector is ready for mapping and broader use when:

• connection test succeeds;
• the connector name identifies the source;
• source owner has confirmed the source purpose;
• browse or preview shows expected data;
• sync strategy matches the operational need;
• recent errors are clear;
• source credentials and network route are approved for the project.

Next step

After a connector is reachable, continue with Mapping Source Fields.