Page tree
Skip to end of metadata
Go to start of metadata

Summary: this page describes how to manage Applications for the Application to Application dependencies scope using the Admin Center.

A user with the ADMIN or SUPER ADMIN role is required.

Introduction

The Applications panel enables you to manage the Applications that are available in CAST Imaging and can be added in to the Inter Application Dependencies scope:

When first displayed, no options are visible in the screen, even if Applications have been imported into CAST Imaging already. Links must be generated before any options will be listed in this screen:

In addition, the Application to Application dependencies scope entry item will be disabled until:

Generating Application to Application Dependencies Links

Links must be generated before the Application to Application Dependencies scope can be accessed. To do so, click the Link Generation icon:

The Link Generation process will then begin. Technically, CAST Imaging will scan all imported applications for objects that potentially have links to objects in other Applications:

When the process is complete, the status updates and the page will be populated with all the Applications that were present in CAST Imaging when the link generation process was started:

The App to App Dependencies Links Available column indicates the following:

  • Yes - CAST Imaging has detected objects in the Application which link to other Applications present in CAST Imaging.
  • No - CAST Imaging has not detected any objects in the Application which link to other Applications present in CAST Imaging.

When should I regenerate links?

The link generation process will take into account all Applications that are present in CAST Imaging at the point when the process is started. If additional Applications are subsequently imported into CAST Imaging, and they must be included in the Application to Application Dependencies scope, then the link generation process must be run again.

Viewing the status of any ongoing jobs

If you need to run a link generation action, the job is placed in a queue if any other jobs are currently ongoing (such as application import or delete). You can view the status and/or cancel any ongoing jobs using the following option:

Using the queue mechanism, it is possible to trigger multiple imports, generate links for app to app dependencies one after the other and remove applications at the same time. There is limit of 25 jobs at a time for the job queue.

Include Applications in Application to Application Dependencies scope

When the links have been successfully generated, the final step that is required before Applications are visible in Application to Application Dependencies scope, is to select them for inclusion. Use the check box on the left hand side to choose which applications you want to include:

Remember to use the pagination options underneath the table if you have more than 10 applications.

Review hidden links

When a link between two applications is hidden in the view (see User Guide - Application to Application dependencies scope) the hidden link will be listed in a dedicated section:

  • To unhide a hidden link, select the check box next to the link and return to the Application to Application Dependencies scope - the link will be restored and removed from the hidden links list.
  • You  can download a list of all hidden links to CSV file using the export option:

Note that if you re-run an Application to Application Dependencies scope scan all hidden links will be lost. This behaviour is expected to changed in the future.

Rules Definition

This panel is available in CAST Imaging 2.5.0.

This panel is used to build rules that define when a link between applications should be excluded from the App to App Dependencies panel. In other words you can define a rule or rules that will exclude a link between applications based on any one, a combination or all of the following:

  • Caller object's name
  • Caller object's type
  • Caller object's parent application
  • Callee object's name
  • Callee object's type
  • Callee object's parent application

When the panel is opened for the first time, some predefined rules will be present - these rules can be deleted/edit, but will be recreated each time the app to app dependencies link generation is actioned:

Click to enlarge

Create a new rule

To create a new rule, click the + icon and a new line (i.e. a rule definition) will appear in the list. Then click the edit button to define the rule:

Click to enlarge

Now configure the rule, for example, to exclude links between applications involving specific object names, define the Caller Name and Callee Name (you can also define just the Caller Name or just the Callee Name):

Click to enlarge

To define a rule to exclude links between applications involving a specific caller object type, choose the caller type from the list of available items, for example .NET Class (you can also define just the Callee Type, or both Caller Type and Callee Type):

Click to enlarge

To define a rule to exclude links between specific applications, choose either the Caller or Callee Application (or both) - this is available in CAST Imaging ≥ 2.6.0:

Click to enlarge

  • Rules can use any combination of the columns available in the editor.
  • New rules are only taken into account the next time you run the link generation action .
  • It is not possible to edit/delete default rules.
  • The fields Caller Name and Callee Name will accept regular expressions (Java Regular expressions only - see for example https://www.w3schools.com/java/java_regex.asp):

Activate/deactivate rules

Available in CAST Imaging ≥ 2.6.0.

It is possible to deactivate/activate rules according to your requirements. Use the check box next to the rule to toggle the option:

A deactivated rule will no longer be taken into account the next time the link generation action is run.

Delete a rule

Use the trash icon to remove a rule:

The rule will no longer be taken into account the next time the link generation action is run.

Export / import rules

Available in CAST Imaging ≥ 2.6.0.

It is possible to export all rules available in the UI to file (.CSV format). This file can then be used as an import on another CAST Imaging installation to avoid having to recreate the rules manually:

If you have specified specific application/objects that do not exist in the target CAST Imaging instance, inconsistencies may be evident when you run the link generation. Ensure that your rules are all consistent after you import them in bulk.

Technical information

When creating a rule, you should always define the rule pattern (i.e. the caller and callee names) for the lowest level of links available in the App to App Dependencies view for the rule to work correctly. "Lowest level" in this situation means when you cannot drill down any further, for example:

or between an object and a method:

Objects/methods connected by the App to App link types listed below will be ignored by any rule pattern you create:

  • Remote Call
  • File Access
  • Data Access
  • File Transfer
  • Scheduler Call
  • Redirect
  • Shared Data

This is because these links are created by a configuration file called queries.json located here:

%PROGRAMFILES%\CAST\ImagingSystem\web-service-linker\venv\bin\queries.json

If you need to exclude any of the link types defined in queries.json, they must be manually removed from this file. CAST highly recommends creating a backup of this file before you edit it.

  • No labels