Applications¶
Applications is your central registry for documenting the IT application landscape. It covers business applications, productivity tools, infrastructure services, and everything in between. Use it to track ownership, deployments, integrations, financial relations, and compliance information across your entire portfolio.
Application categories¶
Every application or service belongs to a category that describes its primary purpose. This classification helps different stakeholders filter and focus on what matters to them.
| Category | Description | Examples |
|---|---|---|
| Line-of-business | Core business applications that support specific business processes | SAP, Salesforce, Workday, custom ERP |
| Productivity | End-user tools for daily work, including utilities and collaboration | Office 365, Acrobat Reader, Teams, Slack, Chrome |
| Security | Tools for protecting systems, data, and access | CrowdStrike, Okta, SIEM platforms, firewalls |
| Analytics | Reporting, business intelligence, and data warehouse tools | Power BI, Tableau, Snowflake |
| Development | Tools used by developers and DevOps teams | Python, Git, Jenkins, VS Code, Docker |
| Integration | Platforms that connect systems and move data | MuleSoft, Kafka, API gateways, ETL tools |
| Infrastructure | Foundational services that other systems depend on | PostgreSQL, Redis, Kubernetes, storage systems |
Tips for classification: - Choose based on the application's primary purpose, not who manages it - When in doubt, ask: "What is this tool mainly used for?" - Categories can be customized in IT Landscape > Settings to match your organization's terminology
Filtering by stakeholder¶
Different teams can use categories to focus on their area of responsibility:
| Stakeholder | Suggested filter |
|---|---|
| Cybersecurity | Security category, or high criticality across all categories |
| Service Desk | Productivity + Line-of-business (user-facing applications) |
| Infrastructure | Infrastructure + Integration |
| Enterprise Architecture | All categories |
Getting started¶
Navigate to IT Landscape > Applications to see your list. To create an application:
- Click New application. The application page opens with an empty title in the header. The rest of the page is dimmed.
- Type the name of the application or service, up to 200 characters. See Unique names.
- Press Enter, or click outside the title. Kadratis creates the application at once. Its reference (
APP-12) shows and all tabs open.
The new application is Active, in the default category. Change them in the header and the properties drawer, then fill in the rest:
- Category: the primary purpose of this application (see categories above)
- Lifecycle: Active, Proposed, Deprecated, Retired, or any custom code defined in Settings
- Supplier: the supplier providing the software (links to your Suppliers master data)
- Publisher: the software publisher (e.g., Microsoft, SAP, Oracle)
- Description: what this application does
- Classification: Business criticality, cyber criticality, data confidentiality and recovery wave are chosen among the levels your organization defined in IT Landscape > Settings. Each option shows the level's definition. They stay unset until you choose them
- Version, Go live, End of support, Retired date: the current version and its dates. End of support and Retired date cannot be earlier than Go live
- Licensing and Notes: license terms and free-form internal notes
- Can have child apps: use this application as a "suite" that groups other applications
Press Escape on the empty title to leave without creating anything. A name that another application already uses is refused, with a message under the title.
Creating or cancelling¶
While the application is being created, its header shows Create and Cancel. They stay until you leave the application.
- Create keeps the application and closes it. You go back to where you started: the list or the previous screen. With an empty title, nothing closes and the title asks for one
- Cancel closes without keeping anything. On an application already created, it deletes it. If you entered more than the name, a confirmation lists what will be deleted. You can cancel your own creation without the right to delete applications
Leaving the application any other way keeps it. Delete it like any other application. The reference of a cancelled application is not used again.
Unique names¶
Two applications cannot share a name. The comparison ignores upper and lower case, and the spaces at the start and end of the name: CRM and crm are the same name. When the name is taken, the message names the application that has it, with its reference (APP-12). The rule applies when you create, rename, copy or import an application, and when you create a new version.
Applications that already shared a name before this rule stay editable. Their name is checked only when it changes.
Tip: Start by documenting your most critical applications. Use the Deployments tab to capture which environments exist (Prod, QA, Dev) and which servers run them, then link interfaces, contracts and budget lines as you go.
Permissions:
- View: applications:reader
- Create / edit: applications:member
- Import / Export / Delete: applications:admin
Working with the list¶
The Applications grid provides a comprehensive view of your application portfolio.
Top scope filter (Show): - My apps: shows apps where you are listed in the properties drawer as either a Business owner or IT owner. Multi-owner entries are supported. - My team's apps: shows apps where any member of your Portfolio team is listed as Business owner or IT owner. Your own ownership is also included in this scope. Disabled if you are not assigned to a Portfolio team. - All apps (default): shows the full Applications grid with the standard default lifecycle filter behavior. - Your selection is remembered across sessions: returning to the page restores your last choice.
Default columns:
- Name: Application name, with an "Included in: {suite}" line under it for an application included in a suite
- Vulnerabilities to review: the vulnerabilities still to review on the technologies the application declares or that its deployment servers have recorded, then, in orange, how many are critical or high (5 · 2). Empty for a disabled application or when none is left. Click it to open the Vulnerabilities page filtered on the application. Present when vulnerabilities are followed. See What Kadratis counts
- Category: The application's primary purpose
- Environments: Coloured chips showing active environments (Prod, Pre-prod, QA, Test, Dev, Sandbox). Hover for the base URL and lifecycle.
- Lifecycle: Current status
- Criticality: Business importance level
- Publisher: Software publisher
- Derived users {year}: the users counted for the companies and departments of the audience in the current year, or the nearest year with data. A user count entered by hand replaces it. The header tooltip says so
- Created: When the record was created
A cell with no value shows a dash.
Default sort: Name ascending (A to Z).
Additional columns (via column chooser): - Suites: Parent suites this application belongs to - Supplier: Linked supplier name - Business Owners / IT Owners: Assigned owners (truncated, hover or click to see all) - Hosting: Derived from server locations assigned to app deployments. An application on a cluster takes the locations of its members too - External Facing: Whether the app is internet-accessible - SSO Enabled / MFA Enabled: Authentication features - Data Integration / ETL: Whether the app participates in data integrations - OPEX lines / CAPEX lines / Contracts: Linked spend and contracts - Components: Child applications (if this is a suite) - Data Class / Contains PII / Data Residency: Compliance information - Cyber criticality, Recovery wave, RTO, RPO, Review state/date: Classification and continuity fields
Classification progress: the Compliance tile on your dashboard shows how many applications you can see are reviewed, need a review, or still have classification fields to complete, plus the points that call for action. Each figure opens the applications list filtered accordingly. See My dashboard.
Filtering:
- Quick search: matches name and editor/publisher
- Criticality, cyber criticality, data class and recovery wave filters list their values in catalog order (most critical first, waves in restoration order).
- Most columns use checkbox set filters showing only values present in the current result set. All ticks every value and None unticks them all. The floating filter shows All, None, or N selected with an x to clear.
- Retired applications are hidden by default; use the Lifecycle filter to include Retired.
- Vulnerabilities to review filters on With severe vulnerabilities, With vulnerabilities or Without, and sorts by the critical or high vulnerabilities, then by the total. Disabled applications come last and are in none of the filter values.
Actions:
- New application: Create a new entry (applications:member). See Getting started
- Import: Bulk import from a CSV file or an Excel workbook (applications:admin)
- Export: Export the applications the list shows to a CSV file or an Excel workbook (applications:admin). See Export options.
- Copy item: Duplicate a selected application with all its core relations (applications:member). See Copying applications for what is and is not copied.
- Delete Selected: Remove selected applications (applications:admin). An application that is the source or target of an interface cannot be deleted: disable it instead, or delete its interfaces first. Before the confirmation, the window lists those applications as kept, with their count of interfaces. The others are deleted with their deployments and their links to other records; the confirmation counts the deployments
The Applications workspace¶
Click any row to open the workspace. The workspace has a header with quick metadata, a properties drawer on the right (the application's identity card, always visible), and a content area in the centre that switches with each tab.
The tabs are Overview, Deployments, Interfaces, Operations, Compliance, Relations and History (the changes made to the application, see Record history).
Header¶
The header shows:
- Application name (editable in place)
- Reference: short identifier you can copy
- Lifecycle chip: click to change
- Business criticality chip: shows the level and opens a menu of the organization's levels
- Severe vulnerabilities, for example "3 severe": the critical or high vulnerabilities still to review on the application, with the colour of the highest one. An alert icon follows when some are known to be exploited. Click it to open the Vulnerabilities page filtered on the application. Shown only when the application has some
- Version chip (if a version is set): click to copy
- Go live date
- Share: copy a shareable link to this workspace
- New version: launch the version migration wizard (see Version management)
- Convert to technology (applications:admin and infrastructure:member): see Converting an application to a technology
- Create and Cancel: shown while the application is being created, in place of the close button. See Creating or cancelling
- Delete, a trash icon with its name in a tooltip (applications:admin): an application with interfaces gets the refusal and why, with Close only. Otherwise the confirmation names the application and counts the deployments deleted with it, along with its links to other records
- Previous / Next: walk through the filtered list without returning to the grid
Properties drawer (right panel)¶
The drawer is the application's identity card. It is shown on every tab and edited inline. Changes save automatically.
Identity: - Category, Supplier, Publisher - Included in: the suites this application belongs to. Pick one in Add a suite: the list offers the applications that have Can have child apps checked. Each name opens the suite. To remove one, hover its name and click the cross at its end. A suite can belong to another suite, but a link that would make a loop is refused (a suite inside one of its own components, for example)
Version and lifecycle dates: - Version. Under it, Previous version opens the application this one was created from with New version, and Next version opens the applications created from it. These links show only when such applications exist - Go live, End of support, Retired date. End of support and Retired date cannot be earlier than Go live
Business processes and owners:
- Business processes: the processes the application supports. Each name opens the process. Type in the field to search and add one; hover a name and click the cross to remove it. Each change is saved at once. The process shows the same link in its own Applications section. A disabled process stays listed, greyed out. Changing the list needs business_processes:member as well; without read access to business processes the field is hidden.
- Business owners: business stakeholders accountable for this application (multi-select)
- IT owners: IT team members responsible for technical support (multi-select)
To remove an owner, hover the name and click the cross at its end.
Removing an owner, a business process, a suite or a support contact shows a message with Undo, which puts it back.
Audience: - Add Company / Departments rows to record who uses this application. Pick a company and optionally restrict to specific departments. - With no department chosen, the audience is the whole company (the field shows All departments). With departments chosen, it is only those departments: clear them to include the whole company again. - A live Users count is shown. - Calculation method: Derived (computed from the audience based on master-data IT Users / Headcount metrics) or Manual (a single override number you type in).
Overview¶
The Overview tab is the application's narrative. It contains:
Description: A rich-text description of the application. The editor autosaves as you type. Anyone who can edit the application can edit its description, without a Knowledge permission. The description is kept as a managed document in Knowledge, titled with the application's reference and name, in the language of the person who created it. Renaming the application, in the workspace or by an import, updates that title.
Connections: A read-only summary built from the application's interfaces. For non-middleware apps it shows two rows: Receives from and Sends to. For ETL/middleware apps it shows a single Connected to row. Each entry is a clickable pill that opens the related application; "+ N more in Interfaces" jumps to the Interfaces tab.
Knowledge: Linked knowledge articles. If you have knowledge:member, you can create new articles directly from this section.
Support: - A table of support contacts pulled from your Contacts master data. Each row shows the contact name, email, phone, and a free-text role (e.g., Account Manager, L1 Support). - Add contact opens a dialog to pick a contact and set a role. - Support notes: free-form text for support arrangements (SLA, escalation paths, on-call info).
Deployments¶
The Deployments tab documents where the application actually runs: one block per environment, with the servers attached to each.
Environments: Production, Pre-prod, QA, Test, Dev, Sandbox.
For each deployment you can capture: - Lifecycle: per-environment status (Active, Proposed, Deprecated, Retired, etc.) - Base URL: the access URL for this environment - SSO enabled / MFA supported - Notes
Add deployment opens a dialog where you set environment, lifecycle, base URL, SSO/MFA flags and notes. Each environment can only be added once. The lifecycle chip on a deployment header can also be changed inline from a popup menu. A deployment that still has servers or interface bindings cannot be deleted: remove them first.
Servers per deployment: Each deployment block shows a table of assigned servers:
| Column | What it shows |
|---|---|
| Server | Asset name (clickable) |
| Role | e.g., Web, Database, Application (from the server role list in Settings) |
| Hosting | Derived from the asset's location |
| Since | Date the server was assigned to this deployment |
Click Add server on the deployment header to attach an asset. The picker lists the clusters with their members under their name. The assignment of a cluster reaches its members in service: they show under the cluster's row, without actions. Change the assignment on the cluster. When you pick a member of a cluster, Kadratis asks whether to assign the cluster or this server only. See Applications on a cluster. Adding, changing or removing a server needs applications:member and infrastructure:member.
When the application is assigned directly to each member in service of a cluster, a line under the table names them, with a button to assign the application to the cluster (Assign to and its name). After a confirmation, the cluster takes the assignment and the members' own assignments are removed. The application then stays available as long as one member stands.
Tip: Document servers in IT Landscape > Assets first, then link them here. The asset's Operations tab shows the same assignments in reverse, under Hosted applications.
Interfaces¶
The Interfaces tab shows all integrations this application participates in, as source, target, or middleware. The tab badge shows the total count.
Interfaces are grouped by environment (PROD, PRE_PROD, QA, ...). Within each environment they are split into:
- Inbound: this application receives data
- Outbound: this application sends data
- Routed: this application is the middleware/ETL for a flow between two other apps
Each row shows the interface name, the counterpart application, and a Via middleware indicator. Click the row to open the interface workspace; click the counterpart to open the other application.
Tip: Interfaces are managed from the Interfaces page. This tab is a convenience read-only view, but it is the fastest way to navigate between connected applications.
Operations¶
The Operations tab holds, in this order, how users access the application (Technical), the technologies it depends on and their vulnerabilities.
Technical: - Access methods (multi-select): how users access this application. Options are configurable in IT Landscape Settings. Defaults include Web, Locally installed application, Mobile application, Proprietary HMI (industrial interface), Terminal / CLI, VDI / Remote Desktop, Kiosk. - External facing: whether the application is accessible from the internet - Data integration / ETL: whether the application participates in data integration pipelines (also flips this app into "middleware" mode for the Interfaces and Connections views) - Can have child apps: turn this application into a Suite that groups other applications. You cannot uncheck it while applications are included in the suite: remove them from the suite first
Technologies lists what the application depends on, from two sources shown in the Link column. Columns: reference (TEC-4), name, family, versions, link, servers it comes through (Via), end of standard support.
- Declared: someone linked the technology to the application, for example Entra ID for an application that signs users in through it.
- Hosted: a server of one of its deployments carries the technology, a member of a cluster it is assigned to included. Via names the server, and the host when the technology runs on the host of a virtual machine. Disabled deployments do not count.
A technology can be both. A dash in the version column means the version is not known. The end of standard support turns orange once it has passed. The section needs infrastructure:reader.
Adding a technology: click Add, choose the technology, then its version: an existing one, a new one you type, or Version unknown. When the application has deployment servers in service, a last step offers to record the technology at the same version on them, for example "Also record PHP 8.2 on". Each server shows its environments and roles. Nothing is ticked: tick the servers that run it, then click Add. A server that already has the technology shows Already recorded and keeps its own version. An operating system is not offered here: set it on the server's page. Closing the list adds nothing.
Changing a declared technology: click its version to choose another one. When no server of the application carries a declared technology, the server icon at the end of its row (Record on a server) offers the same list of servers. A hosted technology is changed on the server: click the server in Via to open its page.
To add, change or remove a declared technology, and to record it on servers, you need applications:member and infrastructure:member. A hosted technology has no cross: remove it from the server instead.
Vulnerabilities (when vulnerabilities are followed) lists the vulnerabilities still to review on the application, in the alerts. The count next to the title is the number of distinct vulnerabilities to review: click it to open the Vulnerabilities page filtered on the application. One line per technology and version:
| Column | What it shows |
|---|---|
| Technology, Version | The technology and its version. Version not recorded (potentially concerned) when no version is named |
| Servers | The deployment servers that have this technology and version recorded on themselves. Declared when the application declares it and no server has it. Record on a server then offers its deployment servers, as in Technologies |
| Crit., High, Med., Low, N/R | One column per severity (Critical, High, Medium, Low, Not rated, the full name in a tooltip on the header): the vulnerabilities still to review. A vulnerability rated None counts with Low |
| Total | The distinct vulnerabilities still to review on this line |
See opens the Vulnerabilities page filtered on the application and the technology. When nothing is left to review, the section says so in one line. While the first read of a product from the NVD, or the match of a technology just recorded on this application or on one of its deployment servers, is still running, the section says "Searching for vulnerabilities…" and fills in on its own. When the search cannot be completed, the section says so. A disabled application has no section.
The section counts direct links only. A technology the Technologies section shows through the host of a virtual machine does not count here: it counts on the host. See What Kadratis counts.
A user who can read applications without reading the infrastructure still sees this section, the badge in the header and the list column, for the applications they can read.
Compliance¶
The Compliance tab captures data protection and regulatory information.
What you can edit: - Data class: confidentiality level (Public, Internal, Confidential, Restricted, or any custom code defined in Settings) - Last DR test: date of the most recent disaster recovery test - Contains PII: whether the application stores personally identifiable information - Data residency: countries where data is stored (multi-select, ISO codes + names)
Tip: Data Classes are configurable in IT Landscape > Settings. Customize them to match your organization's data classification policy.
Classification and continuity¶
The Compliance area also records the application's continuity and classification decisions. Missing values are shown as Not set; Kadratis does not substitute a default level.
The tab is organized in four blocks, in the order of a business impact analysis.
Criticality: - Business criticality is chosen among the levels defined by your organization. Each option shows the level's definition, typically the interruption the activity can tolerate. The level is a stable reference: renaming a level, changing its definition or reordering the catalog in Settings never moves an application to another level. - Cyber criticality is selected independently. The picker shows each level's description; use the level whose plausible consequences are highest. Do not confuse cyber criticality with the level of risk.
Data: - Data confidentiality uses the organization's data-class catalog. - Contains personal data and Data residency complete the data picture. - Personal data, business and cyber criticality, and the hosting of the instances also decide which clauses the contracts linked to the application are expected to hold. See the Compliance tab in Contracts.
Continuity and recovery: - Recovery wave identifies the order in which the application is restored. It does not imply a duration or severity. - RTO is the target time to restore service. RPO is the acceptable data-loss duration and may be zero. If the RTO reaches the maximum tolerable downtime defined on the chosen business level, Kadratis shows a warning but keeps both values. - Under the wave, Kadratis lists the interfaces that link this application to an application planned in a later wave ("Exchanges with CRM, planned in V3"), with a link to each interface. Both applications must be up for the flow to work; the recovery plan owner decides. Retired interfaces are ignored, and users with a restricted Business Contributor scope do not see this list. - Last recovery test records the most recent test date. A link opened from this area uses the single existing Knowledge section in Overview; it does not create a duplicate record. Older URL links remain available under Relations.
Two discreet hints may appear: data at the highest confidentiality level combined with the lowest cyber criticality, and an application at the most critical business level without a recovery test in the last twelve months. They never block anything.
Review: - Justification records the reasoning behind the levels and what the recovery plan relies on. - The review is a timestamp: Mark as reviewed records who reviewed the classification and when. It is available once business criticality, cyber criticality, data confidentiality, recovery wave and the justification are present. - The review date and reviewer stay visible afterwards. When a classification value, a recovery reference or the data residency changes after the review, the tab shows Changed since review and the list shows Review needed. Editing the application name or publisher does not affect it. Changing the catalog in Settings never invalidates a review.
Relations¶
The Relations tab shows what this application is linked to: its budget lines, contracts, projects, requests, tasks and incidents, each in its own table, then its links and files. The technologies are on the Operations tab, the business processes in the properties drawer. Click a row to open the record. The tab badge counts the linked budget lines, contracts, projects, requests and incidents, and the links and files. Tasks are not counted.
Components (only when "Can have child apps" is enabled): a table listing the child applications of this Suite, with their lifecycle and criticality. Click a row to open the child workspace.
Linked records, one table each:
| Section | Columns |
|---|---|
| Budget lines | Reference (BL-12), name, type (OPEX or CAPEX), supplier, and the amount of the current year in your default budget column, in the reporting currency. A dash means the line has no budget for the year |
| Contracts | Name, supplier, end of the current term, yearly amount in the contract currency, renewal (tacit or manual) |
| Projects | Reference (PRJ-7), name, status, planned end |
| Requests | Reference (REQ-23), name, status, desired delivery |
| Tasks | Reference (T-118), title, status, assignee, due date. Only the tasks linked to this application itself appear, not the tasks of its projects |
| Incidents | Reference (INC-14), title, severity, status, detection date |
A confidential incident appears only to the people who can see it in the incident register, without its title.
Dates in orange need attention: a contract whose renewal decision is due within your contract decision window, or an open task past its due date. A disabled budget line or contract stays listed with its name greyed out. You only see the sections of the modules you can read.
From two rows on, the budget lines and the contracts end with a total line. The budget line total is in the reporting currency. A line whose currency has no exchange rate for the year shows its amount in its own currency with a small orange mark, and the total leaves it out. A one-line warning under the table names it, for example "Excluding 1 line with no exchange rate: USD 2026." See Manual rates. Contracts get one total per currency, without the disabled ones.
Adding and removing links (applications:member): Add at the right of a section opens a search. Type a name or a reference and pick a result: the link is saved at once. To remove a link, hover the row and click the cross at its end. Removing a link deletes nothing else. Linking or unlinking an incident also needs incidents:contributor and is recorded in the incident's journal. A closed or cancelled incident cannot be linked or unlinked: reopen it first.
Related: suggestions of records you may want to link, each with the reason it is suggested:
- contracts and budget lines of the application's supplier;
- budget lines of a linked contract or of a linked project;
- projects that carry a task linked to the application.
Click Link to add the suggestion to its section. The section is absent when there is nothing to suggest.
Also related: a line under the suggestions counts the assets of the application's deployments, its interfaces and its knowledge documents. Each count opens the matching tab or section.
Links and files: the web links of the application (vendor portals, monitoring dashboards, documentation) and its files, one row each with its name, the domain of the link or the size of the file, and the date it was added. Click a link to open it in a new tab, or a file to download it. With applications:member:
- Add link opens a dialog for a URL and an optional name; the link is saved at once. To change a link, hover its row and click the pencil.
- Attach file opens the file chooser. You can also drop files on the section: it is highlighted while you drag.
- To remove a link or a file, hover the row and click the cross. Removing a link shows a message and offers Undo, which creates the link again. Deleting a file asks for confirmation first.
Converting an application to a technology¶
Some records were created as applications when they are really technologies: a database engine, a directory, an application server. Convert to technology in the header turns such a record into a technology. Convert when another application can fail or become vulnerable because of it.
You need applications:admin and infrastructure:member.
The window first checks what the conversion changes. Choose a Family, then read the three lists:
- Moves to the technology: owners, support contacts, contracts, budget lines, projects, web links, documents, incidents, and the servers of its active deployments. Each server becomes a server that carries the technology, with an unknown version. A cluster gives its members in service. Links in modules you cannot read move too.
- Kept, without its link to the application: managed documents stay in their library, among the unfiled documents.
- Lost with the application: deployments and environments, suite membership, predecessor and successors, data residency, the companies and departments using it, knowledge links, linked tasks and requests, business processes, the technologies it depends on, and the fields only applications have (users, access methods, SSO, MFA, personal data). Its
APPreference goes too.
The technology keeps the name, publisher, description, notes, support notes, lifecycle, cyber criticality and recovery fields. Each support contact is listed once, with the first role it had. The window names the hosting type the technology takes. With servers, it is the hosting type of their locations (the one with the most servers), otherwise On-prem. Without servers, it is the application's own Hosting, otherwise SaaS. You can change it afterwards on the technology. Convert creates the technology, deletes the application and opens the new record. The audit log keeps the old reference.
When it is refused: the window lists the reasons and Convert stays unavailable. An application cannot convert while it is the source, target or middleware of interfaces, an integration tool of interface bindings, a suite with components, or has interface bindings on its deployments. A technology with the same name, values a technology cannot take (including a Hosting types list without any type in use), or files missing from storage also block it. Remove these links first, or keep the record as an application.
Version management¶
Kadratis offers two ways to manage application versions, depending on how your organization handles upgrades:
| Approach | Best for | What happens |
|---|---|---|
| Simple | Most applications | Update the version fields in the properties drawer: same record, new version number |
| Sophisticated | Major migrations | Use New version to create a new application record with lineage tracking. Run old and new versions side by side |
Simple version tracking (in-place updates)¶
For most applications (where you upgrade and the old version simply goes away), update Version, Go live, End of support and Retired date in the properties drawer. The header version chip and the Go live metadata reflect what you set.
This approach keeps everything in a single record. When you upgrade, update the version fields and you're done. The History tab keeps the earlier values.
Use this when: upgrades happen in place with no overlap: one version replaces another.
Creating a new version (parallel migrations)¶
For major application upgrades where you need to run old and new versions in parallel across different environments (e.g., SAP S/4HANA 1909 in Prod while 2023 is in QA), use New version in the workspace header.
The wizard has three steps:
- Version details: new application name, version label, Go live and End of support dates. The name must be free (see Unique names), and End of support cannot be earlier than Go live.
- Copy options: choose what to copy from the source. Defaults shown below.
- Interfaces: pick which interfaces to migrate to the new version.
The new version is created as a separate application with: - A Proposed lifecycle (ready to configure before go-live) - A link to its predecessor (used by the version timeline) - Copied data based on your selections - Duplicated interfaces pointing to the new version
Once it is created, a message gives the new version's reference. The two applications then link to each other through Previous version and Next version in the properties drawer.
Classification and continuity values are copied, but the new version starts with a reset review and no copied last recovery test.
What gets copied¶
| Option | Default |
|---|---|
| Owners (business and IT) | On |
| Companies (audience) | On |
| Departments | On |
| Data residency | On |
| Links | On |
| Support contacts | On |
| Budget lines (OPEX + CAPEX, paired) | On |
| Contracts | On |
| Deployments | Off |
| Deployment bindings | Off (only available when Deployments is selected) |
Always copied: the description, the business processes, the access methods, the External facing, Data integration / ETL and Can have child apps boxes, and the user count entered by hand.
Not copied (must be set up fresh): suite membership, attachments, the source's dates, the last recovery test, the classification review and server assignments. The wizard lists them.
Interface migration¶
During version creation, the wizard shows all interfaces where this application is source, target, or middleware (when ETL is enabled). Selected interfaces are duplicated with their references updated to the new version. Each migrated interface includes its legs, owners, companies, key identifiers, links, data residency and its specification (the source's text and images). An empty interface ID stays empty. Migrated interfaces start with a Proposed lifecycle. The original interfaces stay linked to the old version.
Copying bindings: If you select both Deployments and Deployment bindings, interface bindings are also copied. Bindings are mapped to the new application's deployments (matched by environment); environment-specific details (endpoints, authentication, job names) are cleared, and binding status is reset to Proposed.
ETL/Middleware applications: If the application has Data integration / ETL enabled, the wizard also shows interfaces that flow through this application as middleware. These are interfaces where another source sends data to another target via your ETL. Copying them creates new interface definitions for the upgraded ETL with middleware references properly updated.
Tip: Use this when upgrading your ERP or ETL: migrate the critical interfaces and optionally copy bindings to get a head start on environment configuration.
Copying applications¶
There are two ways to copy an application in Kadratis:
Copy item (from the Applications grid)¶
Use this when you want to create an independent duplicate of an application, typically to create a similar application entry without version lineage.
- Select an application in the grid
- Click Copy item
- The system creates a copy named after the source, with a suffix in the language of your screen: "CRM (copy)", "CRM (copie)" in French. When that name is taken, the copy is numbered: "CRM (copy 2)", then "CRM (copy 3)"
- You're navigated to the new application to make changes
What gets copied: All core fields (except last DR test date), including classification and continuity values, owners, companies, departments, suites, OPEX/CAPEX lines, contracts, links, data residency, and support contacts. The copied application's review is reset.
What does NOT get copied: Deployments, interfaces, server assignments, attachments, version fields (version, go-live date, end of support).
Comparison: Copy item vs New version¶
| Aspect | Copy item | New version |
|---|---|---|
| Purpose | Independent duplicate | Versioned successor with lineage |
| User options | None (automatic) | 3-step wizard |
| Lineage | No predecessor link | Sets predecessor |
| Lifecycle | Preserved | Reset to Proposed |
| Name | "(copy)" suffix, numbered when taken | User-specified, must be free |
Relations:
| Relation | Copy item | New version |
|---|---|---|
| Owners (business and IT) | Yes | Optional (default: yes) |
| Companies (audience) | Yes | Optional (default: yes) |
| Departments | Yes | Optional (default: yes) |
| Data residency | Yes | Optional (default: yes) |
| Links | Yes | Optional (default: yes) |
| Support contacts | Yes | Optional (default: yes) |
| Business processes | No | Yes |
| Suites (membership) | Yes | No |
| OPEX lines | Yes | Optional (default: yes) |
| CAPEX lines | Yes | Optional (default: yes) |
| Contracts | Yes | Optional (default: yes) |
| Deployments | No | Optional (default: no) |
| Bindings | No | Optional (default: no) |
| Interfaces | No | User-selected |
| Server assignments | No | No |
| Attachments | No | No |
Core fields:
| Field | Copy item | New version |
|---|---|---|
| Description | Yes | Yes |
| Access methods | Yes | Yes |
| ETL enabled | Yes | Yes |
| Support notes | Yes | Yes |
| Last DR test | No | No |
| Version fields | No | User-specified |
| Users override | Yes | Yes |
| Users year | Yes | Reset to current year |
CSV import/export¶
Maintain your application inventory at scale using import and export. This feature supports bulk operations for initial data loading, periodic updates from external systems, and data extraction for reporting.
Accessing CSV features¶
From the Applications list: - Export: Download applications to a CSV file or an Excel workbook - Import: Upload a CSV file or an Excel workbook to create or update applications - Download Template (from inside the import dialog): Get a blank CSV with correct headers - Download an example (from inside the import dialog): an Excel workbook of sample applications, with what each column takes. See Example files
Permissions required: applications:admin for import/export operations.
Export options¶
What the file holds: the applications the list shows. The export follows the column filters, the quick search and the Show choice (My apps, My team's apps or All apps). The dialog says how many applications the file will hold. Without a Lifecycle filter, retired applications are left out, as in the list. The rows keep the order of the list.
Format: CSV or Excel (.xlsx), chosen in the dialog and remembered in your browser. The workbook holds the same columns as the CSV on one sheet, with numbers and dates as values Excel can sort and filter. The import reads either; in a workbook, it reads the first sheet. See CSV and Excel files.
Columns: the file starts with id and the reference (APP-12), then the columns follow the workspace, tab by tab. Their titles are in the language of your screen, and the import reads them in any language. The import ignores the reference.
Language of the values: catalog values (category, lifecycle, criticality, cyber criticality, recovery wave, data class, access methods) and the status are written as the screen shows them, in the language of your screen: Active in English, Actif in French. A name your organization gave a value in IT Landscape > Settings stays as it is.
Presets:
| Preset | Description |
|---|---|
| Full Export | All exportable fields including computed/read-only data (timestamps, data residency, user metrics) |
| Data Enrichment | Only importable fields, ideal for round-trip editing workflows |
Template export: Downloads headers only, useful for preparing import files with the correct structure. The template includes all importable fields.
Custom selection: Choose specific fields to include in your export.
Import workflow¶
-
Prepare your file: a CSV file or an Excel workbook (
.xlsx). Save a CSV file as UTF-8. Commas or semicolons both work, and so does a file Excel saved as plain CSV (Windows-1252). Download a template to ensure correct headers. The separator, amounts, dates and yes or no of each language are in CSV and Excel files. -
Choose import settings:
- Mode:
Enrich(default): Empty cells preserve existing values: only update what you specifyReplace: Replaces the values of the columns in the file. An empty cell clears the stored value, except in the classification columns (use__CLEAR__there). A column left out of the file keeps its values. Some fields cannot be cleared: Preflight points them out.
-
Operation:
Upsert(default): Create new applications or update existing onesUpdate only: Only modify existing applications, skip new onesInsert only: Only create new applications, skip existing ones
The operation applies to the owners and the data residency too: a row the operation skips leaves them as they are.
-
Validate first: Click Preflight to validate your file without making changes. Review errors and warnings.
-
Apply changes: If validation passes, click Import to commit changes.
Row checks¶
The preflight check applies the same rules as the workspace. A row is refused when:
- its name is longer than 200 characters, or another application already has it (see Unique names);
- its name matches two existing applications: add the
idcolumn to choose one; - its category or lifecycle matches no code or name of the catalog;
- an owner email matches no user;
- its End of support or Retired date is earlier than its Go live;
is_suiteisnofor a suite that still has applications in it.
A file with one refused row loads nothing. See CSV and Excel files.
Field reference¶
Overview fields:
| CSV Column | Description | Required | Notes |
|---|---|---|---|
id |
Application UUID | No | For updates; leave blank for new applications |
name |
Application name | Yes | Up to 200 characters. Used to match existing applications |
description |
What the application does | No | |
category |
Primary purpose | No | Accepts code or label from Settings. An unknown value refuses the row |
supplier_name |
Vendor name | No | Must match existing supplier |
editor |
Software publisher | No | Free text (e.g., Microsoft, SAP) |
criticality |
Business criticality | No | Accepts code or label from Settings; __CLEAR__ clears it |
lifecycle |
Current status | No | Accepts code or label from Settings. An unknown value refuses the row |
is_suite |
Can have child apps | No | yes or no |
Version fields:
| CSV Column | Description | Notes |
|---|---|---|
version |
Current version | Free text |
go_live_date |
When version went live | Date format: YYYY-MM-DD |
end_of_support_date |
Vendor support end date | Date format: YYYY-MM-DD |
retired_date |
Decommission date | Date format: YYYY-MM-DD |
Technical fields:
| CSV Column | Description | Notes |
|---|---|---|
access_methods |
How users access | Comma-separated codes or labels from Settings (e.g., web,mobile,vdi) |
external_facing |
Internet accessible | yes or no |
etl_enabled |
Data integration | yes or no |
support_notes |
Support information | Free text |
licensing |
License terms | Free text |
notes |
Internal notes | Free text |
Compliance fields:
| CSV Column | Description | Notes |
|---|---|---|
data_class |
Data classification | Accepts code or label from Settings |
last_dr_test |
Last DR test date | Date format: YYYY-MM-DD |
contains_pii |
Stores personal data | yes or no |
data_residency |
Data storage countries | ISO country codes, comma-separated (e.g., FR,DE). In Enrich mode an empty cell keeps the countries |
Classification fields:
| CSV Column | Description | Notes |
|---|---|---|
criticality |
Business criticality level | Tenant catalog code or unambiguous label |
cyber_criticality |
Cyber consequence level | Tenant catalog code or unambiguous label |
recovery_wave |
Recovery order | Tenant catalog code or unambiguous label |
rto_minutes / rpo_minutes |
Recovery objectives | Whole minutes; RPO may be zero |
classification_justification |
Classification reasoning | Free text |
A blank classification cell preserves the existing value in both Enrich and Replace modes; use the literal __CLEAR__ to clear a classification.
Owner fields:
| CSV Column | Description | Notes |
|---|---|---|
business_owner_email_1 through _4 |
Business owner emails | Must match an existing user's email. An unknown email refuses the row |
it_owner_email_1 through _4 |
IT owner emails | Must match an existing user's email. An unknown email refuses the row |
In Enrich mode, when all the owner cells of a type are empty, the application keeps its owners of that type.
Export-only fields (included in Full Export but not importable):
| CSV Column | Description |
|---|---|
status |
Enabled or disabled, in the language of your screen. Change it on the application itself |
users_mode |
User count method (manual, it_users, headcount) |
users_year |
Reference year for user calculations |
users_override |
Manual user count override |
created_at |
Record creation timestamp |
updated_at |
Last modification timestamp |
vulnerabilities_to_review |
Vulnerabilities still to review, as the list column counts them. Empty for a disabled application |
severe_vulnerabilities |
Of those, the critical or high ones. Empty for a disabled application |
The two vulnerability columns are left out when vulnerabilities are not followed. The import ignores them.
Label and code acceptance¶
For fields configured in IT Landscape > Settings, you can use either the internal code or the display label:
| Field | Example codes | Example labels |
|---|---|---|
| Category | lob, productivity, security |
Line-of-business, Productivity, Security |
| Lifecycle | active, proposed, deprecated |
Active, Proposed, Deprecated |
| Data Class | public, internal, confidential |
Public, Internal, Confidential |
The system automatically normalizes values during import, so Line-of-business, line-of-business, and lob all resolve to the same category. The labels the screen shows are accepted in English, French, German and Spanish: Active, Actif, Aktiv and Activo all name the same lifecycle. A file exported in one language therefore imports in another.
Matching and updates¶
Applications are matched by name, ignoring upper and lower case and the spaces at the start and end. When a match is found:
- With Enrich mode: Only non-empty CSV values update the application
- With Replace mode: The columns in the file are updated, and an empty cell clears the stored value. Columns left out of the file keep their values. A blank classification cell keeps its value, and __CLEAR__ clears it. The name, the id, the lifecycle and required fields cannot be cleared: Preflight reports an error on the row. A new application gets the default values.
If you include the id column with a valid UUID, matching uses ID first, then falls back to name. When two existing applications share the name of a row, the row is refused: add the id column to choose one.
A row matched by id with a different name renames the application. The new name must be free. The title of the application's description document follows the new name.
Limitations¶
- Deployments not included: Environment deployments (Prod, QA, Dev) require workspace configuration
- Server assignments excluded: Server bindings must be set up in the Deployments tab
- Interfaces excluded: Integration definitions are not part of the import and export
- Maximum 4 owners per type: Up to 4 business owners and 4 IT owners can be imported/exported
- User metrics are export-only: Audience and user count fields (
users_mode,users_year,users_override) are managed in the workspace - Status is export-only: Enable or disable an application in its workspace
Troubleshooting¶
"File isn't properly formatted" error: This usually indicates an encoding issue. Ensure your CSV is saved as UTF-8:
- In LibreOffice: When opening a CSV, select
UTF-8in the Character set dropdown (not "Japanese (Macintosh)" or other encodings). When saving, check "Edit filter settings" and choose UTF-8. - In Excel: Save As > CSV UTF-8 (Comma delimited).
- General tip: If you see garbled characters (
?¿,) at the start of your file, the encoding is incorrect.
Example CSV¶
name;category;supplier_name;criticality;lifecycle;go_live_date;external_facing
Salesforce CRM;Line-of-business;Salesforce Inc;Critical;Active;2020-01-15;true
Microsoft 365;Productivity;Microsoft;high;active;2019-06-01;false
Custom ERP;lob;;Moderate;Active;2018-03-20;false
Ask the assistant¶
Kad reads the version, go-live date, end of support date and retirement date of each application. It filters, sorts and groups the applications by these dates. Its list keeps the retired applications, while the End of support report keeps only those in service.
Kad also declares a technology on an application, or removes it, with its version and, if you ask, on the application's deployment servers. This needs the right to read applications and the Member level on infrastructure. A Business Contributor does it only on the applications they take part in. Kad does not link an operating system: set it on the server's page. Every change comes as a preview that you approve. When you ask Kad to undo it, it puts back exactly what it changed. A version created along the way stays on the technology.
Ask, for example: "Add PostgreSQL 16 to CheeseTrack and its servers", "Remove PostgreSQL 14 from CheeseTrack", "Which applications reach their end of support in the next six months?" or "Which applications declare PostgreSQL 14?"
Tips¶
- Start with critical apps: Document your business-critical applications first, then work down the criticality levels.
- Use Suites for grouping: Enable "Can have child apps" in the Operations tab to mark an application as a Suite that groups related components (e.g., SAP modules under an SAP Suite).
- Link to spend early: Connect OPEX, CAPEX and contracts in the Relations tab to see the full cost picture for each application.
- Keep deployments current: The Deployments tab drives the environment chips in the list. Keep it updated for accurate visibility.
- Document the audience: Set company and department audiences in the properties drawer; the user count is then derived automatically and used in reports.
- Leverage category filtering: Use the Category column filter to focus on specific application types (e.g., show only Line-of-business apps, or exclude Productivity tools).
- Attach knowledge early: Link runbooks and architecture documents from the Overview tab so the team knows where to look during incidents.
- Link tasks from either side: Add a task from Relations > Tasks, or set the App / Service field on the task itself; both show the same link.