Manage an integration and its jobs

The configuration of an integration or the jobs associated with it might require your attention and assistance if there are any errors that prevent the integration from running properly.

As an integration manager, you create an integration using a configuration file. Once an integration is enabled, it will have jobs associated with it. You need to disable the integration to make changes to its configuration. You can re-enable it after you finish your changes. We recommend that you do this at a time when it won't impact the integration's schedule. You can also make changes to the statuses of integrations. Follow the steps in this topic to manage your integration.
  1. On the Home page, filter the list of integrations or integration groups as needed, based on one or more of the following criteria:
    • Last modified date filters by date range.
    • Integration name filters by the name of the integration.
  2. Select an integration group row to expand it and to see a list of integrations associated with it.
  3. Select the integration you want to manage. If the integration you want to edit is enabled, select the green toggle once to disable it.
  4. Select the checkbox of the integration.
  5. Along the top, select Manage Integrations and select Edit Settings.
    You can edit the following details for an integration:

    Table 3-1 List of integration settings

    Field Details
    Title Add or change the title of the integration.
    Job Start Date Add or change the date on which the integration starts running.
    Days When to Send Data

    Select the days of the week when the integration will run, Monday through Sunday.

    You can also choose one of the following, which allow you to configure the intervals at which the data is sent:
    • At
    • Every
    Send Data

    Add the time when the data is sent.

    Only available when At is selected as part of the Days When to Send Data setting.

    Send Data Every

    Define the interval at which data is sent.

    Only available when Every is selected as part of the Days When to Send Data setting.

    Data Transfer Options Configure how much of the data is transferred. Select one of the following:
    • Transfer all data: transfer all the data associated with a study
    • Only transfer data from specific date: select a date from which the data will be transferred.
    Reattempt to Send Data The number of times the integration will re-attempt to send data, should the data transfer fail.
    Send Notifications to Add the email addresses to which notifications are sent.
    Integration File Add or replace integration files.
  6. To manage the jobs associated with an integration, do the following:
    1. Select the row of the integration that failed.
    2. Tip:

      You can search for the job using the filters along the top. For example, you can filter for Status or a date range.
      Find the job that you want to resend or cancel.
    3. Select the checkbox for that job.

      WARNING:

      Never cancel an Oracle InForm or Argus Safety job. Canceled jobs are never resent and the data would be lost.

      Note:

      To see the history of a job, select the job and look into Job Details, on the right.
    4. On the right, below Job details, select Resend if the job isn't working or select Cancel Job if you want to stop the job.
  7. Re-enable the integration by selecting the gray toggle once. The toggle turns green, indicating that the integration is active.