Working with integration jobs

Create a new integration job

To create a new push or population integration job, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.
2. Click the name of the integration point to which you want to add a new integration job.
3. Click the Add integration job icon (), and then select the type of integration job that you want to add. Depending on your choice, the Population Job or Push Job pane opens.
4. Enter a name for the integration job.
5. Click the Add icon () to add an available integration query to the job definition. If the integration job has multiple queries, click the Up Arrow () and Down Arrow icons () to change the order in which the queries are run. To remove a query, click the Delete icon ().

6. (Non-Jython-based population jobs only) Select the Allow integration job to delete removed data option to enable the deletion of CIs or relationships from the local CMDB. When this option is selected, any CIs or relationships that are removed from the remote source are also deleted from the local CMDB when you next perform a full synchronization.

7. (Data push jobs only) Select the Enable live job option if you want the integration job to automatically perform delta synchronization when its TQL query result changes.

   Note If you enable this option, the job's scheduler will be disabled.

8. (Data push jobs only) Select DELTA SYNCHRONIZATION if you want the integration job to synchronize only the data has changed since the job last ran, or select FULL SYNCHRONIZATION if you want the integration job to synchronize all data every time that it runs.
9. Select the Scheduler Enabled option to choose scheduling options for the integration job.
   • In the Repeat drop-down list, select how often you want the integration job to run. You can also select to schedule the integration job by using a Cron expression.
   • Provide the information that corresponds to the Repeat option that you selected. For example, select the days of the week if you selected "Weekly", or enter a valid Cron expression if you selected "Cron Expression".
   • In the Time Zone drop-down list, select the time zone to which the schedule applies.
   • In the Starts field, click the Clock icon () to select the date and time when the integration job will start to run.
   • In the Ends field, click the Calendar icon () to select the date when the integration job will stop running. If you want the integration job to run indefinitely, select the Never option.
10. Click OK to create the integration job.

Search for an integration point

To search for an integration job, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.
2. Click the Job List icon () to display the list of integration jobs.

3. Click the Search icon (), enter your search terms in the Search box, and then press Enter.

   Note To display all available integration jobs again once that you have performed a search, click the Search icon, clear the Search box, and then press Enter.

View the integration jobs

To view the details and statuses of integration jobs, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.

2. Click the Job List icon () to display the list of integration jobs.

Sort and filter the displayed integration jobs

To sort and filter the displayed integration jobs, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.
2. Click the Job List icon () to display the list of integration jobs.

3. Click the Filter icon () to display the filter pane.

   • You can sort integration jobs by job name or by integration name. Click the Up Arrow () or Down Arrow icons () to change the sort order.
   • You can filter integration jobs by job category (push or population) or by job status.

Synchronize an integration job

To synchronize an integration job, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.

2. Click the name of the integration point which contains the integration job that you want to synchronize.

3. Select the job that you want to synchronize, click the Synchronize integration job icon (), and then select Full Sync or Delta Sync.

   A full Synchronization synchronizes all data, whereas a delta synchronization synchronizes only the data that changed since the job last ran .

Delete an integration job

To delete an integration job, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.

2. Click the name of the integration point from which you want to delete an integration job.

3. Select the integration job that you want to delete, click the Delete icon (), and then click YES in the confirmation window.

Edit an integration job

To edit an integration job, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.

2. Click the name of the integration point that contains the integration job that you want to edit.

3. Select the integration job that you want to edit to open the job details pane.
4. Select DEFINITION, and then edit the integration job as required.
5. Click OK to save your changes.

View integration job information and statistics

To view integration job information and statistics, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.

2. Click the name of the integration point that contains the integration job that you want to view.

3. Select the integration job that you want to view to open the job details pane.

Select DEFINITION to view the integration job details.

Select STATISTICS to view the statistics for each query in the integration job. If a warning or error icon is displayed beside a query, you can click the icon to display more detailed information about the issue.

Pin the integration jobs to the UCMDB Home Landing Page

To pin a widget that displays the status of all integration jobs to the UCMDB Home Landing Page, follow these steps:

1. In UCMDB Home, click the Menu icon () to expand the Modules pane, and then click Integration Studio.
2. Click the Job List icon () to display the list of integration jobs.

3. Click the Pin to Dashboard icon () to display the integration job widget on the UCMDB Home Landing Page.

   To unpin the widget from the UCMDB Home Landing Page, click the Unpin from Dashboard icon () or remove it directly from the UCMDB Home Landing Page.

   Note The integration job widget is displayed on the UCMDB Home Landing Page by default. When you click on each integration job status on the widget, the integration job list in Integration Studio opens and displays the integration jobs that currently have that status.