You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Importing a Joget App


Knowledge

Joget Apps are packaged files that contain Form, Datalist, Userview and Process definitions.

Apps can be exported from another Joget installation, or downloaded from the Joget Marketplace.

Importing a new app into an environment with existing App ID will result in the creation of a new App Version.

You may also choose to retain or override environment variables and plugin default properties by checking on the checkboxes.

Example:-

  1. App with ID "leaveSystem" with App Version 2 (Process Version 10) exists in the environment.
  2. Importing an App with the same App ID will result in the creation of App with ID "leaveSystem" with App Version 3 (and Process Version 11).





To import an app, log in to the App Center as admin or a user with "admin role" (See Managing Users for more information).

Click on the Import App button (see Figure 1).


Figure 1: App Center buttons

You can also import apps from the Design App dashboard (the URL is https://localhost:8080/jw/web/desktop/apps).


Figure 2: Import app via the Design App page

In the Import App popup window, select the app ".jwa" file from your hard disk folder  and click on Upload button.

Click on the Show Advanced Options hyperlink to manage the import options, as follows:

  • Override environment variables.
  • Override plugin default properties.
  • Do not import participant mapping for existing participants.
  • Do not import tool mapping for existing tools.
  • Do not import plugins.
  • Do not import Form Data.

Note: Import plugins & import form data are new features in Joget DX. These import options are only applicable to apps that has been exported from Joget DX only.


Figure 3: Advance options for app import

Publish the app after importing if you want to run the app.

  1. At the top left, click on the Not Published button.
  2. In the popup window, click on the app version radio button and then click on Publish button.

You can also manage the following app options:

  • New Version: Clone this app into the next version number.
  • Publish: Publish for users to run the app.
  • Unpublish: Unpublish to hide the app.
  • View: Jump to this version to view the app elements.
  • Delete: Permanently delete this app. App data and process data related to this app will not be deleted. 
    You cannot undo or reverse an app deletion. You can import your app which you have previously exported or restore from a database backup (caution, a restore may affect other apps and Joget data).


Figure 4: Publish an app



Figure 5: Run a published app




Exporting a Joget App


Definition
The Export option allows one to export out the entire app design into a single file. This is useful when one is performing a backup or transferring the app into another server.

App Data not included

Application data will not be part of the export, only the app design.


  1. To export an app, the first login to any Userview in the current app as an administrator.

  2. In the Admin Bar on the right, click on All  Apps, choose the App intended, and select Properties & Export on the left.


  3. Click on the Export button along the top.

  4. A file .jwa extension will be generated. You can now take the file to other Joget servers and Import it in.









  • No labels