# Creating Jobs with an Omni Connector Wizard

Each installed Omni connector adds its own wizard to Runner. All Omni wizards follow the
same four steps; the specific fields (especially credentials) vary by connector. This page
walks through the Salesforce connector's wizard, "Omni Salesforce". Other connectors work
the same way.

## Starting the Wizard

1. Click the **+ Add Job** button in the sidebar. Each installed connector has an icon on
   this page.

   .. image:: assets/add_job__connector_icons.png
      :alt: Add Job page with Omni connector wizard icons

2. Click the connector's icon to start its wizard.

## Step 1: Provide Connection Credentials

The first screen collects credentials for the connected service. Choose one of:

* **Use existing named credentials**: pick previously saved credentials for this connector
  from the dropdown. Credentials saved by an Omni wizard are specific to that connector.
* **Provide credentials now, to be saved under Credential Name**: enter new credentials.
  They are saved under the name you provide and can be reused by later jobs and wizard
  runs. See [Credentials](../user-interface/index.html#credentials) for how stored
  credentials work in Runner.

When providing new credentials, select the authentication scheme the service account
uses. The available schemes and their fields depend on the connector. Salesforce offers,
among others:

* **Basic**: user name, password, and security token.

  .. image:: assets/salesforce__credentials_token.png
     :alt: Omni Salesforce credentials screen with the Basic (security token) scheme

* **OAuth**: authorize Runner against Salesforce in your browser. For OAuth schemes the
  screen also displays a read-only callback URL; if the service requires registering a
  callback URL for the OAuth application, use this value.

  .. image:: assets/salesforce__credentials_oauth.png
     :alt: Omni Salesforce credentials screen with the OAuth scheme

Click **Next**. The wizard tests the connection with the credentials you provided and
reports any errors before continuing.

## Step 2: Authorize Access

This step applies only when you provided new credentials with an OAuth scheme. Otherwise
the wizard states that no authorization step is required; click **Next** to continue.

For OAuth:

1. Click the **AUTHENTICATE** button.

2. A new browser tab will open to display the service's login/consent page.

3. Sign in and approve access, then return to the wizard tab containing the
   **AUTHENTICATE** button.

3. Click **Next**. The wizard completes the authorization, verifies the connection, and
   saves the credentials.

## Step 3: Select Tables

The wizard queries the service for its available tables and lists them. The list includes
any custom records or objects defined in your account (for example, Salesforce custom
objects or NetSuite custom records), so it reflects how your service is customized.

.. image:: assets/salesforce__select_tables.png
   :alt: Select Tables screen listing available Salesforce tables

Check each table you want to load. At least one table must be selected. One job will be
created per selected table. Click **Next**.

## Step 4: Specify the Output

.. image:: assets/salesforce__specify_output.png
   :alt: Specify the output screen

* **Job Title**: the title of the sequence that will contain the created jobs.
* **Database URL**: the destination database, chosen from your named Database URLs. See
  [Database URLs](../databases/database-urls.html).
* **Credentials**: optional named database credentials.
* **Schema**: optional destination schema. When empty, the connector's name is used (for
  example, `salesforce`).

Click **Save**. To run the created sequence immediately after it is saved, check **Start
job on save** before clicking **Save**.

## What the Wizard Creates

When you click **Save**:

* The credentials are saved (if you provided new ones).
* One job is created per selected table, named after the connector and table (for
  example, `salesforce_account` with title `[Salesforce] Account`), tagged `omni` and
  with the connector name.
* A sequence containing all the created jobs is created with the title you provided, and
  the wizard opens it. Run the sequence to load the selected tables, or schedule it like
  any other Runner job. See [Scheduling](../jobs/jobs-intro.html#scheduling).

Each job loads its table in full on every run. To customize job behavior, including
loading only new and changed rows, see [Configuring Jobs](configuring-jobs.html).