# Omni Connectors

Zuar Runner 3.7.0 introduces Omni connectors: a family of more than 240 connectors for
popular applications, databases, and services. The full list is on the
[Connectors](../connectors/index.html) page.

Each Omni connector is installed individually and provides its own job creation wizard,
named after the connector. For example, the Salesforce connector provides the
"Omni Salesforce" wizard and the Sage Intacct connector provides the "Omni Sageintacct"
wizard. A connector's wizard is available only while the connector is installed; removing
the connector also removes its wizard.

Working with an Omni connector follows the same lifecycle regardless of the service it
connects to:

1. [Install the connector](installation.html) from **Settings** > **Licensing**.
2. [Create jobs](creating-jobs.html) with the connector's wizard. The wizard collects
   credentials for the service, lets you choose which tables to load, and creates one job
   per table plus a sequence that runs them together.
3. [Configure jobs](configuring-jobs.html) as needed. Most jobs can run immediately after
   creation; the job configuration supports customization such as custom SQL queries,
   connection options, and upsert.
4. [Troubleshoot](troubleshooting.html) with driver logging if a job or connection does
   not behave as expected.

Behavior specific to each service (available tables, connection properties,
authentication details) is covered by the connector's own reference documentation, linked
from the [Connectors](../connectors/index.html) page.

.. toctree::
   :maxdepth: 1
   :titlesonly:

   installation
   creating-jobs
   configuring-jobs
   troubleshooting

## TODO

Remove this section before release. The images under `assets/` are placeholders; replace
each with a real screenshot:

| Image                                   | Should show                                                              |
|-----------------------------------------|--------------------------------------------------------------------------|
| `licensing__package_information.png`    | Settings > Licensing: Package Information section with Omni connector checkboxes |
| `licensing__update_version_details.png` | Settings > Licensing: Update Version Details panel with pending connector changes |
| `licensing__download_restart.png`       | Settings > Licensing: status message with the Download / Restart button  |
| `add_job__connector_icons.png`          | + Add Job page showing installed Omni connector wizard icons             |
| `salesforce__credentials_token.png`     | Omni Salesforce wizard: credentials screen, Basic scheme (security token) |
| `salesforce__credentials_oauth.png`     | Omni Salesforce wizard: credentials screen, OAuth scheme with callback URL |
| `salesforce__authorize_access.png`      | Omni Salesforce wizard: Authorize Access screen with AUTHENTICATE button |
| `salesforce__select_tables.png`         | Omni Salesforce wizard: Select Tables screen                             |
| `salesforce__specify_output.png`        | Omni Salesforce wizard: Specify the output screen                        |
| `sageintacct__job_config_editor.png`    | Sage Intacct job config editor with a query parameter in the input       |
| `sageintacct__query_tab.png`            | Job editor Query tab shown after a query is added to the config          |