Homepage

Overview

We have introduced a new UI in the IEM that merges former App Projects into Device Applications, and we are extending this concept to the Industrial Edge App Publisher.

The new experience in the IEAP, which appears once you are logged in to your IEM, allows you to build applications more efficiently, eliminating the need to create an App Project or specify any company in Industrial Edge Management. This streamlines the development and management of your applications.

NOTICE

If you connect to an IEM version higher than 1.15.5 in Industrial Edge App Publisher, you will automatically be redirected to the new experience.

Notable changes from the previous experience

• Simplified app creation: No need to create an App Project or provide company details. You can now push your app directly to IEM and see it in the Device Applications overview page.
  

• Streamlined interface: The App Projects & Authorized Application sections have been removed from the IEAP. You can only create standalone applications in IE App Publisher, which will be shown in the Device Applications overview. After creating your app version, you can directly push it to the IEM.

Old IEAP Homepage

New IEAP Homepage

• Unified upload process: Previously, you could upload your custom app either as an App Project or directly to the Catalog, which caused confusion. Now, all applications which can be installed on an IED, are handled under Device Applications accordingly.

Old upload tab

New upload tab

• Custom app ID: You can now set your own app ID when creating a new application. This also makes it easy to connect to existing applications in IEM and create new versions. To create a version of an existing IEM application, please ensure that you provide same appid, name and reponame.
  

• Removal of unused fields: Unused fields such as Auth Service and Web Address have been removed for a cleaner experience.
  

Old app creation wizard

New app creation wizard

NOTICE

Use the "Return to Previous Design" button if you want to revert to the older homepage design.

Getting started

Creating and uploading a new application version

1. Login to your IEM and click the Create button on the IEAP homepage to create a new application.
2. Enter the required application details, such as name, description, repository name, and icon.
3. After creating the application, click the Add New Version button to add a version.
4. Fill in the necessary version information and create the version.
5. To upload the application version to IEM, click the upload icon and select Industrial Edge Management.
6. Once uploaded, the application version will appear in the Device Applications tab in IEM.
7. Optionally, export the application version in *.app format by clicking the Export Version button. This allows you to upload the application version as a standalone to both IE Hub or IEMs.

Managing existing applications and their versions

1. To manage an existing application in IEM App Project, start by creating a new application in the Publisher with the same app name, app ID, and repository name as the original application in IEM.
   Ensure that these three fields exactly match the existing application's details in IEM.
2. Once the new application is created, click the Add New Version button to add a new version.
3. Enter the required version information and create the version.
4. Upload the new version to IEM by clicking the upload icon and selecting Industrial Edge Management.
5. The new version will be associated with the existing application and will appear under the Device Applications tab in IEM.

Migration from old to new user experience

• Apps which are uploaded from the old experience in IEAP as App Projects will appear in both IEM UIs (App Projects & Device Applications)
• Apps which are uploaded from the old experience in IEAP as Catalog apps will only appear in the old experience of the IEM UI (IEM Catalog)
• Apps which are uploaded from the new experience in IEAP will only appear in the new experience of the IEM UI (Device Applications)

old experience of IEM UI = IEM version < 1.15.5   |   old experience of IEAP = IEAP version < 1.23.4

Warning

To prevent the loss of your standalone applications data, we recommend taking backup of your workspace/applications before migrating to the new experience.

The following table shows the compatibility between IE App Publisher versions and IEM versions:

IEAP version	IEM version	Comments
>= 1.23.4	>= 1.15.5	Routes to the new app experience UI in IEAP and uploads the application to the new device application overview in IEM. (This is the optimal and intended experience with the new UI)
< 1.23.4	Any	Old IEAP experience, Apps can be uploaded to App Project and Catalog.
>= 1.23.4	< 1.15.5	Routes to the old experience of IEAP. Shows a "Discover a new experience" button, if clicked it will show an error saying "Unable to switch to new experience. Please update the Industrial Edge Management."

IECTL commands related to the new experience:

iectl iem device-apps app-details

iectl iem device-apps list

iectl iem device-apps upload

Further UI explanations

The following image shows the "Header" of the homepage.

The following table explains the function of each header element:

Component	Description
	Home: Click this button to go to the homepage. This button is always present in the IE App Publisher.
	Workspace: To select another Workspace, click this button.
	Export Workspace: To export your Workspace to another folder in your system, click this button.
	Tasks: To see all Tasks of your current session, click this button.
	Account: If you click this button, a drop-down screen with the following options appears: - Management: To change the Edge Management, with which the IE App Publisher is connected, click this button. - Profile: To view and change your profile settings, click this button. - Sign Out: To sign out your account, click this button.
	Create Image: To create an image, click this button. Find more information in the section "Creating a Docker image"
	Pull Image: To pull an image from a public repository and download the image to the Docker Development Server, click this button.
	Docker Engine: To change or disconnect the Docker Development Server, click the blue address of the Docker Development Server.
	Logs: To change the logging settings or download the log files, click this button.