# Documentation

### **Overview**

#### **Purpose**

The IFS API Change Impact Analyzer is a service designed to track and compare changes in Projections and their components across different versions of IFS Cloud using OData. It helps users identify structural and functional differences between versions, enabling better impact analysis, validation, and upgrade planning.

***

#### **Scope & Audience**

**Primary Users**

* Developers
* Solution Architects
* System Administrators

**Secondary Users**

* Integration Specialists
* Technical Consultants

***

#### **Core Use Cases**

* **Version Comparison** – Compare projections between two IFS versions
* **Upgrade Impact Analysis** – Identify breaking or impactful changes before upgrades
* **Regression Validation** – Verify consistency across environments
* **Integration Review** – Analyze API changes affecting external systems

***

### **Accessing the Application**

The IFS API Change Impact Analyzer is hosted as a service in Novacura and available through the Marketplace Hub.

* **Portal Page:** Flow Extensions
* **Access Link:** [Here](https://board.novacura.com/)

> ![](https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FeccBb4ivhXSabJI6s6WY%2Fimage.png?alt=media\&token=86a67725-3679-4f96-9dee-7dc343c17da9)

Users can access the service directly without any installations through the Marketplace Hub portal.

{% hint style="info" %}
If you are unable to access the Marketplace Hub portal page, please reach out to your account manager.
{% endhint %}

***

## How to Compare IFS Versions

***

### **Step 1: Select Organization**

Users begin by selecting the organization for comparison.

> ![](https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FzW690TGSd7zr0JNCQ88l%2FIFS%20API%20change%20impact%20analyser%20p1.png?alt=media\&token=8fdf17f2-24ff-48ca-a39a-7a9312b2d1fd)

#### **Actions**

* Next – Proceed to application package selection

***

### **Step 2: Select Application Package**

Choose the application package that contains the projections.

> ![](https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2F0fLkGsDEHlHCi50NCRpn%2FIFS%20API%20change%20impact%20analyser%20p2.png?alt=media\&token=82339696-abaf-49f6-8c09-52774604bb75)

#### **Actions**

* Next – Proceed to application selection

***

### **Step 3: Select Version Range**

Define the comparison range.

> ![](https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FFUkB8Iso7QJ6JO0wDmC7%2Fimage.png?alt=media\&token=d741a23a-1005-496a-8167-68a7d54d9fb1)

#### **Fields**

* **From Version** – Default lowest available version
* **To Version** – Default latest available version

Users can adjust both values using dropdown selections.

### **Step 4: Select Applications**

Users can select one or multiple applications to analyze.

> ![](https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FDYCf5bz91d0slA1vvP4N%2Fimage.png?alt=media\&token=79481340-e90f-4c01-8913-9fac0e8f9c66)

{% hint style="info" %}
While the application supports selecting multiple applications for analysis, processing a large number of applications simultaneously may increase execution time and, in some cases, lead to timeouts. For optimal performance and reliability, it is recommended to analyze larger or complex applications individually.
{% endhint %}

#### **Actions**

* Next – Start comparison

***

### **Step 5: Run Comparison**

The system scans selected applications and their components.

#### **Process Includes**

* Projection metadata analysis
* Component-level comparison

***

### **Step 6: View Results**

Results are displayed in a structured table format.

> ![](https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FXuqnBivuP2h71yWVrN6o%2FIFS%20API%20change%20impact%20analyser%20p4.png?alt=media\&token=79bf4542-9619-42ec-99d4-ace3549fe515)

#### **Features**

* Full list of records
* Highlighted differences between versions

***

### **Filtering Options**

#### **Show Changes Only**

Filters the results to display only modified records.

> ![](https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2FVuuODvYdK1wmmoiXdd52%2FIFS%20API%20change%20impact%20analyser%20p6.png?alt=media\&token=98fdd46f-85b4-42f4-aac7-6736b0396080)

***

### **Export Results**

Users can export the comparison results.

> ![](https://3218748546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MiW42YxFsGXIDjQJKNR%2Fuploads%2F44SN34bzY6Q4EVsroQLN%2Fimage.png?alt=media\&token=ce293800-e0ec-47ba-87c7-2059d1ca8b69)

#### **Export Options**

* File format: CSV

{% hint style="info" %}
**Tip:** For better visualization of the exported .csv file, it is recommended to import the file into Microsoft Excel using semicolon (;) as the delimiter. During the import process, ensure that the first row is set as column headers to properly structure and display the data.
{% endhint %}

***

### **Exit Application**

Users can exit the tool at any point.

#### **Action**

* Exit – Close the application