- Introduction
- Configuring the Application to Application Dependencies scope
- Where do the links come from?
- Accessing the Application to Application Dependencies scope
- Interactions
- Drill down into an Application
- Application details
- Right click options
- Custom scope
- Application search option
- Export options
- Working with tags
- Finding objects belonging to multiple applications
Introduction
The Application to Application Dependencies scope is a specific view made available for a specific use case: the requirement to view interactions between any of the Applications that have been imported into CAST Imaging:
Each Application is represented by a circular node, the larger the node, the larger the Application (based on the number of lines of code):
Configuring the Application to Application Dependencies scope
By default this scope is empty: before you can use it, links between applications must first be generated. This can be done by a user with the ADMIN role - see Admin Center - Application to Application Dependencies management for more information about this:
Where do the links come from?
When the links between applications in the Application to Application Dependencies scope are generated, the information is taken from different locations: see Where do the links come from? in Admin Center - Application to Application Dependencies management for more detailed information.
Accessing the Application to Application Dependencies scope
When the links have been generated (see Admin Center - Application to Application Dependencies management), you can access the scope from the main application entry point:
Accessing the Application to Application Dependencies scope from 'Welcome page'. It does not show all apps (or allow you to select applications as introduced in versions ≥2.14)- instead it only displays the identified interactions between the selected application and other linked applications.
In versions ≥ 2.14
Clicking on App to App from either the main application entry point/page, Welcome page or from the application dropdown from the header, a sidebar is displayed with the list of applications (selected by admin user in the admin centre). You may select any single application, multiple applications or all the applications to view their App to App dependencies. Your selection will remain persistent (even if you logout and login).
Interactions
During the link generation process, the imported Applications are scanned to check for specific objects that potentially interact with another object in a different application. Where an interaction exists, a green dotted line between the two applications will be displayed in the view, together with information about the type of interaction that exists (i.e. the specific mechanism used in the source code):
Clicking an interaction between two applications will display the following popup:
- the total number of interactions (in the top right corner)
- a clickable list of the interaction types - clicking the type will drill down into the view and show the objects that are interacting, for example (clicking anywhere else in the popup will drill down and show all interactions):
Interaction grouping
Where two applications are linked with more then one type of interaction (in the same direction) as shown in the example below, the interactions will not be grouped together by default:
You can use the Group/UnGroup Links option available in the left hand menu to toggle this display:
Legend
A clickable legend is available that lists all the available interactions in the view - these interactions are available in the Relationships section:
You can click use this to filter the interactions that are displayed in the view:
In ≥ 2.19, Tags comes with Technology option which lets you to select a technology and view the nodes associated with the selected technology.
Drill down into an Application
Drilling down into an Application (double-click the circular node) will display the specific objects from all other Applications together with the objects from the selected Application that they interact with:
Application details
Use the Properties panel to find out more information about a selected application:
Right click options
Node
Right clicking a node will show a contextual menu:
Highlight Callees | Highlights all the nodes that are called by the selected node (arrow out). See User Guide - Using the Highlight options. |
---|---|
Highlight Callers | Highlights all the nodes that are calling the selected node (arrow in). See User Guide - Using the Highlight options. |
Highlight Path | Highlights all the paths between selected nodes - if a path exists. See User Guide - Using the Highlight options. |
View Application | Will take you direct to the selected Application for further investigation. |
View orphans | This option displays any potential app-to-app items, which are not linked to any other app-to-app items. All orphans are displayed in a custom view, together with the parent Application:
The objects that form the link can be viewed by clicking the link between the application and the orphan: The objects in the orphan itself can be viewed by double clicking the orphan item: An option is available in the legend on the right hand side, which, when clicked, will highlight all applications in the App to App Dependencies view which contain potential orphan items: When viewing the content of a link between an Application and potential orphaned items, clicking the orphan option in the legend will highlight all the orphaned items: |
View External Libraries | This option functions in a similar manner to the View orphans option. When clicked, all nodes in the selected application that contain External Library related code (i.e. third party API libraries such as Log4j, jExcelAPI etc.) will be displayed in a custom view, together with the parent Application: Click to enlarge The objects that form the link can be viewed by clicking the link between the application and the External Library Node: An option is available in the legend on the right hand side, which, when clicked, will highlight all applications in the App to App Dependencies view which contain potential External Library node items: When viewing the content of a link between an Application and potential External Library node items, clicking the External Library option in the legend will highlight all the External Library node items: |
Hide object | Use this to hide the selected object. To unhide, either use the "Undo" option or refresh the page. |
Remove object | Use this option to remove the node from the view. When you reload the view, the object will be re-displayed. |
Properties | Displays information about the Application in the right hand slide in panel: |
Node in Custom scope
Right click menu available only when working in the Custom scope within the Application to Application Dependencies scope:
Add callers/callees | Retrieves all caller/called applications. Links are added to the selected application and to any other objects present where a link exists. The number in square brackets in the contextual menu indicates the number of items available. |
---|---|
Add linked apps | See User Guide - Using the Add Linked Objects feature for more information (instead of objects, this option functions on applications) |
Add 2 levels of Callers/Callees | Same principal as the Add Callers/Callees options, but instead displays two levels of applications |
Highlight Callee/Highlight Callers/Highlight path | See User Guide - Using the Highlight options |
View Application | Will take you direct to the selected Application for further investigation. |
View orphans | This option displays any potential app-to-app items, which are not linked to any other app-to-app items. All orphans are displayed in a custom view, together with the parent Application:
The objects that form the link can be viewed by clicking the link between the application and the orphan: The objects in the orphan itself can be viewed by double clicking the orphan item: An option is available in the legend on the right hand side, which, when clicked, will highlight all applications in the App to App Dependencies view which contain potential orphan items: When viewing the content of a link between an Application and potential orphaned items, clicking the orphan option in the legend will highlight all the orphaned items: |
Hide object | Use this to hide the selected object. To unhide, either use the "Undo" option or refresh the page. |
Remove object | Use this option to remove the node from the view. When you reload the view, the object will be re-displayed. |
Properties | Displays information about the Application in the right hand slide in panel: |
Link
Right clicking a link between two applications will show a contextual menu:
Hide Link | Enables you to temporarily hide the link between the two applications if required. When a link is hidden, it will be listed in the Admin Center - Application to Application Dependencies management page: Click to enlarge 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. |
---|
Custom scope
Available in CAST Imaging ≥ 2.7.0.
It is possible to create a Custom scope based on the Applications available in your Application to Application Dependencies scope:
See User Guide - Custom scope for more information.
Application search option
It is possible to use the Application search option to search for specific applications within the scope (see also User Guide - Search for items for more information):
In ≥ 2.20
Application to Application search is consistent with the global search.
In ≤ 2.19
Searching for objects in the Application to Application Dependencies scope is not possible.
Search for Apps | The standard search popup will be displayed. To search for an App, enter the App name: Enter the string to search for - i.e. the string to match specific App names. You can choose more advanced search options if required:
These filter settings are persistent for the duration of the user session (i.e. until a log out occurs), therefore you will not need to re-enter them when you perform a new search. | ||||||||
---|---|---|---|---|---|---|---|---|---|
Filter by | You can filter the search results to narrow down the number of items that will be returned. Use the Filter By slider to do so:
|
Export options
The export action functions in this scope, as in other scopes:
- by default the information about all the applications in the view and their interaction protocol and technology are exported for CSV, XML and JSON formats.
- from ≥ 2.8.0-funcrel, it is possible to select multiple applications and view only the information pertaining to the selected applications for CSV, XML and JSON formats. In older releases, the number of applications that can be selected is limited to 2.
- For image exports (JPG/SVG), all applications are always included.
Working with tags
Tags can be associated to Applications from 2.8.0-funcrel, however, these tags are kept separate to tags added at Objects level (see also User Guide - Working with tags). Tags can be exploited in the same way as tags added at Objects level when performing an application search:
Click to enlarge
Finding objects belonging to multiple applications
Available in CAST Imaging ≥ 2.13.
If you want to find out whether an object belongs to more than one application, a specific badge will indicate this. For example, when working at Object level (in any scope) the following badge indicates that the object is also present in another application:
Clicking the object will update the right hand panel under the Properties tab, allowing you to view the other application(s) that the object is present in: