Integrations Page |
Required Edition |
Automation, Enterprise Automation |
The Integrations page of Administration Console allows you to view and manage your deployed integrations. From this page you can stop and start integrations, add a new deployment for an integration file, or delete the deployed integration file from the Integration Service. You can also open a detailed view of each integration, where you can start and stop the integration, and view the logged messages related to the integration and its actions.
To open the Integrations page, click Integrations in the left Navigation Pane of Administration Console.
The page has two views, the first for viewing and managing all deployed integrations and the second for viewing detailed information for a selected integration.
To access the Deployed Integration View of the Integration page, simply click Integrations in the left Navigation Pane of Administration Console.
There are three buttons at the top-right of this view:
Start All: Starts all currently deployed integrations.
Stop All: Stops all currently deployed integrations.
Add: Opens the New Deployment dialog, where you can schedule a deployment for any of your saved integration files.
Integration Tables
Each deployed integration file appears in an individual table identified by the deployment name that was specified on the New Deployment dialog at the time that the file was deployed. Each integration file table lists the integrations contained in the integration file, with information about each integration described in the following columns:
Status: Shows whether the integration is running or stopped.
Name: Lists the name of the integration.
Last Executed Event: Shows the last time the integration was started, stopped, or deployed.
Event Occurrences: Shows any event that has occurred during the integration's current run time.
Last Error Message: Shows the last error message logged by the integration.
You can also start or stop an individual integration. Simply locate the desired integration within the deployed integration file's table and click the appropriate button.
Start: Starts the integration so that it begins monitoring for the integration event.
Stop: Stops the integration so that it no longer monitors for the integration event.
Each integration table also provides a button that allows you to remove an integration file from the Integration Service,
Remove: Removes the integration file from the Integration Service. As the integration file is no longer deployed, it is also no longer displayed on the Integrations page. This does not delete the integration file; you can re-deploy it at any time.
You can customize an integration table view to change column widths, sort ascending or descending, or filter the rows to show only the desired integration(s) contained in the integration file.
Use one of the following methods to change the width of columns in the integration table:
Place your cursor over a column divider between two column headers. When the cursor pointer turns into horizontal arrows, click and drag the divider until the desired column widths are achieved.
Right-click a column header and select Best Fit to automatically fit the column from which the context menu was opened.
Right-click a column header and select Best Fit (all columns) to automatically fit all the columns to their best width.
To sort the rows ascending or descending
Use one of the following methods to sort the rows in the table ascending or descending:
Click on the desired column header to toggle sorting of the table rows ascending or descending based on the contents of the selected row.
Right-click on the desired column header to open the context menu, and select Sort Ascending or Sort Descending to sort the table rows ascending or descending based on the contents of the selected row.
|
You can clear sorting at any time by right-clicking a column previously used for sorting and selecting Clear Sorting from the context menu. |
To filter the integrations displayed in the integration table
If you have a number of integrations contained in an integration file, you may need to filter the list of integrations to quickly display a single integration, or perhaps to display only those integrations that have 1 "Event Occurrence" or those that are "Waiting For Events".
Filter the integrations in the table based on specific column's value using the following method:
Click the Filter Editor icon in the desired column header and select the filter criteria from the dropdown list of valid values.
|
To clear a filter, click the Filter Editor icon in the column header that was previously filtered and select All from the dropdown list. Alternatively, right-click anywhere in the column header that was previously filtered and select Clear Filter from the context menu. |
To access the Detailed Integration View of the Integration page, locate the desired integration file table on the Deployed Integration View and click on the name of the integration that you want to display in the Detailed Integration View.
|
To return to the Deployed Integration View, click at the top left of the page. |
The following information and options are available on this view:
Integration Name: The integration name is located at the top of the page and includes the name of the integration file to which the integration belongs, and the server on which the integration file is deployed.
Start: Starts the integration so that it begins monitoring for the integration event.
Stop: Stops the integration so that it no longer monitors for the integration event.
The General Statistics area of the page is located directly under the integration name. It shows the following information for the integration:
Status: The current status of the integration. For example, "Stopped" or "Waiting for Events".
Event Occurrences: The number of times the integration event has occurred since the integration was last started.
Last Started: When the integration was last started.
Integration Type: The integration method. For example, "File", "Database" or "Email".
Run Time: How long the integration has been running since it was last started.
Last Executed Event: When the last integration event was detected.
Number of Failures: The number of failures the integration has experienced since it was last started. If failures have occurred, you can hover the cursor over the icon to view the last error message. Alternatively, click to open the Last Error Message dialog, where you can copy the error message to the clipboard.
The Actions area of the page shows the action(s) that the integration will perform when the integration event is detected.
Action statistics include the action name, status, and last error message. If failures have occurred with execution of the action, you can hover the cursor over the icon to view the last error message. Alternatively, click to open the Last Error Message dialog, where you can copy the error message to the clipboard.
The Output area of the page shows the messages associated with the integration, including messages for the integration starting or stopping, detection of the integration method, and running of the integration's actions.
The Output area includes the following options and controls:
Errors: Click to toggle between showing and hiding error messages in the output table.
Warnings: Click to toggle between showing and hiding warning messages in the output table.
Messages: Click to toggle between showing and hiding messages in the output table.
Events: Click to toggle between showing and hiding event messages in the output table.
Search Message: Searches the output table for messages using the provided keyword, filtering the contents to show only those messages that meet the search criteria. Click at the right of the search field to remove the search criteria filter.
: If you have scrolled down the list of messages in the output table, clicking this icon returns the view to the most recent message.
: Opens the Message Options menu, where you can select from the following options.
View Output Messages in Window: Opens the Output Messages dialog, which provides a larger view of the output table. This dialog offers the same controls as those available for the output table on the Detailed Integration View.
View Message History: Opens the Integration Messages dialog, which is a stand-alone dialog with the same functionality as the Message History page.
Clear Messages: Clears the messages currently showing in the Output pane. The messages have not been deleted; you can still view them on the Message History page or in the Integration Messages dialog.
Export Messages to XML: Opens a browser window where you can save your messages as .xml files.
You can customize the output table to change column widths, sort ascending or descending, or filter the rows to show only the desired messages.
Use one of the following methods to change the width of columns in the output table:
Place your cursor over a column divider between two column headers. When the cursor pointer turns into horizontal arrows, click and drag the divider until the desired column widths are achieved.
Right-click a column header and select Best Fit to automatically fit the column from which the context menu was opened.
Right-click a column header and select Best Fit (all columns) to automatically fit all the columns to their best width.
To sort the rows ascending or descending
Use one of the following methods to sort the rows in the table ascending or descending:
Click on the desired column header to toggle sorting of the table rows ascending or descending based on the contents of the selected row.
Right-click on the desired column header to open the context menu, and select Sort Ascending or Sort Descending to sort the table rows ascending or descending based on the contents of the selected row.
|
You can clear sorting at any time by right-clicking a column previously used for sorting and selecting Clear Sorting from the context menu. |
To filter the messages displayed in the output table
If there are a number of messages contained in the output table, you may need to filter the list of messages to display only the messages you are interested in viewing.
You can filter the messages in the output table based on specific column's value using the following method:
Click the Filter Editor icon in the desired column header and select the filter criteria from the dropdown list of valid values.
|
To clear a filter, click the Filter Editor icon in the column header that was previously filtered and select All from the dropdown list. Alternatively, right-click anywhere in the column header that was previously filtered and select Clear Filter from the context menu. |
Related Topics