# Applications

## Table of Contents

1. [Overview](#1-overview)
2. [Browsing Applications](#2-browsing-applications)
3. [Creating an Application](#3-creating-an-application)
4. [Viewing Application Details](#4-viewing-application-details)
5. [Updating an Application](#5-updating-an-application)
6. [Supported Application Types](#6-supported-application-types)

***

## 1. Overview

Applications in Axilon represent the software systems your organization manages -- for example, an Ignition SCADA installation, a WinCC deployment, or an Ovation DCS. Every major resource in Axilon (configurations, repositories, clones) is linked to an application, so creating applications is typically one of the first setup steps.

***

## 2. Browsing Applications

### Steps

1. Click **Applications** in the sidebar.
2. The page displays a **grid of application cards**, with responsive layout (up to 4 cards per row on large screens).
3. Pagination is shown at the bottom (8 applications per page by default).

### Reading an Application Card

| Area             | What It Shows                                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------------------------- |
| **Header**       | Application name, icon, and a three-dot actions menu.                                                         |
| **Icon**         | A large visual icon chosen during creation.                                                                   |
| **Library Info** | Application type with version and platform badges.                                                            |
| **Description**  | A summary of the application (truncated to 3 lines, with a "Show More" link for longer text).                 |
| **Footer**       | Created by (username) and creation date. Hover over the date to see both created and last-updated timestamps. |

### Card Actions

Click the three-dot menu on a card to see available actions:

| Action           | Who Can See It    |
| ---------------- | ----------------- |
| **View Details** | Everyone          |
| **Update**       | Global Admin only |

***

## 3. Creating an Application

> **Required role:** Global Admin

### Steps

1. Go to **Applications**.
2. Click **"Create Application"** in the page header.
3. Fill out the form:

| Field           | Required | Rules                     | Notes                                                                                                     |
| --------------- | :------: | ------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Name**        |    Yes   | Minimum 5 characters      | A human-readable label for the application.                                                               |
| **Description** |    Yes   | Minimum 1 character       | Describe what this application is used for. Shown on the card and details page.                           |
| **Icon**        |    Yes   | Must select one           | Choose from the icon picker. A "random" option is available.                                              |
| **Library**     |    Yes   | Must select from dropdown | The application type (see [Section 6](#6-supported-application-types)). Cannot be changed after creation. |

4. Click **"Submit"**.
5. On success, a *"Application created successfully"* notification appears and you are taken to the new application's details page.

***

## 4. Viewing Application Details

### Steps

1. From the Applications grid, click **View Details** in the card's actions menu.
2. The details page contains:

**Header**

* Application name with breadcrumb navigation (Applications > Details).
* **"Update"** button (Global Admin only).
* **"Back"** button.

**Application Stats** (3-column layout)

| Stat             | Description                             |
| ---------------- | --------------------------------------- |
| **Name**         | The application name.                   |
| **Icon**         | The selected icon with its name.        |
| **Last Updated** | When the application was last modified. |

**Description Card**

* Full application description.
* Created by (username) and creation timestamp.

**Library Details**

* For standard libraries: logo, name, version, platform badge, and description.
* For custom libraries: library name only.

***

## 5. Updating an Application

> **Required role:** Global Admin

### Steps

1. Navigate to the application's details page.
2. Click **"Update"** in the header. Alternatively, click **"Update"** from the card's actions menu on the Applications grid.
3. The form is pre-filled with the current values. All fields except **Library** can be changed (the library type is locked after creation).
4. Make your changes and click **"Submit"**.
5. A *"Application updated successfully"* notification appears and you are returned to the details page.

***

## 6. Supported Application Types

When creating an application, you must select a library type. The following types are available:

| Type            | Description                                   |
| --------------- | --------------------------------------------- |
| **Ignition**    | Inductive Automation Ignition SCADA platform. |
| **WinCC**       | Siemens WinCC SCADA system.                   |
| **AssetCentre** | Rockwell Automation FactoryTalk AssetCentre.  |
| **Ovation 3.8** | Emerson Ovation DCS, version 3.8.             |
| **Ovation 4.0** | Emerson Ovation DCS, version 4.0.             |
| **Custom**      | Any other application type not listed above.  |

> **Note:** The library type cannot be changed after the application is created. Choose carefully.