Publish an app and app versions

Versions

When you first create an app it has draft status and it is not assigned a version number until you publish it. When you publish it for the first time, it is assigned version number 1 and each time you publish it afterwards the version number is incremented by one.

You can revert to a previously published version by directly publishing it, and this will replace the current published version.

Apps that have never been published are in draft mode and have no version number assigned.

Publish an app

Note: For details on publishing a system app, see System apps.

Note: For details on publishing a System app go to the System apps documentation.

Standalone app

When you click Publish, the following window appears showing the published standalone app's URL along with the option to create a menu entry in ERPx.

2.In the Publish new version modal, you see the following fields described in the table:

Field	Description
Version	This field is auto populated and cannot be changed. It shows the next version number to be assigned to your app.
Version label	Enter a version label for your app.
Description	Enter a description for this version of your app.
Create URL suffix	Enter a unique URL suffix for your app. This suffix is appended to the base URL to create the full URL for your app.
App URL	This field is auto populated based on the URL suffix you enter. You can copy this URL to share your app with others.

3.Select the Publish button and the App successfully published modal appears. You can follow the link to your app, copy the app's URL or create a Business screen app by selecting the Create ERPx entry button.

Business screen app - create a menu entry in ERPx

1. Open the info window for your app and select Create ERPx entry.

   

2. Enter the menu item description to appear in the ERPx menu.

3. Click Create entry and the newly created menu item is placed under the Your employment in ERPx.

   • App description: Enter the menu item description to appear in the ERPx menu.
   • Client ID: Only for ERP CR menu entries. Enter the client ID where you want the app to be published. You must enter the exact client ID name as it appears in ERP CR.

4. Select the Create entry button and the newly created menu item is placed under the Your employment in ERPx.

5. Open ERPx and go to the Menu access window and grant the necessary access rights to your app.

   

6. If you want to move the menu item from Your employment to another place in the main menu, open the Custom menu items window and move the menu item to the desired place in the main menu. See how to change an app location in ERPx for more details.

Modify a published app

You can modify an app that is already published without having to unpublish it as follows:

1. Open the app in the Canvas.
2. Make your edits as required.
3. Choose Save draft to save your changes or Publish to publish your draft and give it a version number.

Note: If you select Save draft in a published app and close it without publishing, the changes remain as draft until you publish it.

View published versions

To view the published versions of your app, select View all versions from the three dots menu in the bottom-right corner of your app, to open the Versions window as shown below:

In this window you can see:

• The Versions list with the following columns described in the table:

Column	Description
Version number	The version number assigned to the app. A Currently published badge is displayed next to the version number of the currently published version.
Label	The version label given to the app when it was published.
Description	The description given to the app when it was published.
Date	The date when the version was published.
Author	The name of the user who created the app.
Preview	Select the Eye icon to preview the app version. A modal opens where you can import to canvas or view the app full screen.

• Preview all the app versions by selecting the Eye icon.
• Delete version. This deletes the selected version and cannot be undone. You cannot delete the current live published version, and you must unpublish it first. You cannot delete all versions of an app.
• Edit version details to change the version label and description.
• Export the selected version as a JSON file. This JSON file can then be imported to the Canvas as a new app or shared with others. You can also export your app directly from the dashboard using the three dots menu.

• Publish/Unpublish. When you select a published app the Unpublish button is available, select to unpublish. When you select an unpublished app the Publish button is available to unpublish the current version and replace it with the selected version.
• Import the selected version to the Canvas for editing. This will overwrite the current unpublished draft version if one exists.