Skip to main content

Defining Interoperability Settings

This page describes a small number of settings that apply either to the entire instance or to an entire namespace.

Configuring Settings in the Portal

The Management Portal lets you configure some of these settings, as follows:

  1. Select Interoperability > Manage > Configuration > Interoperability Settings.

  2. If you want to set a namespace-specific setting, change to that namespace.

  3. For the setting you want to change, select or clear the check box as needed.

  4. Click Apply.

The namespace-specific settings are as follows:

  • Exclude Production Configuration Page from Source Control—If this setting is selected, then the page Interoperability > Configure > Production does not provide source control options, even if the namespace otherwise is under source control.

  • Disable Inactivity Timeout for Interoperability Pages—If this setting is selected, then the pages within the Interoperability menu will not time out due to inactivity.

There is also a setting that applies to all namespaces:

  • Enable Automatic Refresh of Management Portal Pages—If this setting is selected, the Management Portal pages are automatically refreshed (so that they display any new information available from the server)..

Configuring Settings for Manual Purges

As productions run in a given namespace, InterSystems IRIS data platform writes data to multiple tables in that namespace. Because the entries can accumulate over time and consume large amounts of disk space, InterSystems IRIS enables you and other users with appropriate permissions to purge outdated entries in these tables.

InterSystems IRIS enables you to configure default settings for manual purges. The defaults apply on the Purge Management Data page and can be overridden only by users with appropriate permissions. For more information, see Controlling Access to Management Portal Functions.

To configure default settings for manual purges in a namespace, navigate to Interoperability > Configure > Purge Data Settings in the namespace. Alternatively, set the following nodes of the ^Ens.Configuration global for the namespace:

^Ens.Configuration("PurgeSettings","BodiesToo")
^Ens.Configuration("PurgeSettings","KeepIntegrity")
^Ens.Configuration("PurgeSettings","Description")
Caution:

Purges are irreversible and can lead to unintentionally orphaned data or the loss of unresolved requests. Consequently, InterSystems recommends that you carefully review Settings for Purging Data before you configure these settings.

Configuring Source Control Settings

You can configure source control settings for each interoperability-enabled namespace. For information on this, see Integrating InterSystems IRIS with Source Control Systems. In addition, there is a flag to indicate whether the source control system requires a project context to be supplied to work correctly. The flag is activated as follows:

 Set ^%SYS("Ensemble","SourceControl", $namespace, "ProjectContext") = 1

Also, existing user templates used as dialog windows in Studio must include the Ens_SourceControl.js in /csp/broker/ensemble/ (which can be referenced by the path ensemble/Ens_SourceControl.js) to manage your browser-based interactions. This inclusion is required both for any web pages. Depending on the context required by your source control hooks, you may need to add some extra data to certain returns.

Portal Pages Affected by Source Control

The following Management Interoperability browser based editors support Source Control hooks:

  • Interoperability > Configure > Production

    Note:

    If a production is under source control and you do not have it checked out for update, you cannot modify the production definition. You can temporarily Stop, Start, and Restart business hosts by using the buttons on the Action tab. These buttons temporarily stop or start the host but do not modify the production definition. A business host can only be temporarily stopped if it has a pool size greater than 1 or in the case of Business Processes and Business Operations are invoked Queue and not InProc.

    However, you can exclude this page from source control; see Configuring Settings in the Portal.

  • Interoperability > Configure > Data Lookup Tables

  • Interoperability > Build > Business Processes

  • Interoperability > Build > Data Transformations

  • Interoperability > Build > Business Rules

  • Interoperability > Build > Record Maps

  • Interoperability > Build > Complex Record Mapper

When source control is in use, source control buttons appear on these page.

See Also

FeedbackOpens in a new tab