Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Joget Apps are packaged files that contain Form, DatalistList, UserviewUI, Process definitions, custom plugin and or app data. Apps can be exported from another Joget installation, or downloaded from the Joget Marketplace. Importing a new app into an environment with an 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.

...

  1. Click on the Import App button (see Figure 1).
    Image Removed
    Image Added
    Figure 1: App Center buttons

  2. You can also import apps from the Design App dashboard (the URL is httpshttp://localhost:8080/jw/web/desktop/apps/userview/appcenter/home3/_/home).
    Image Removed
    Image Added
    Figure 2: Import app via the Design App page

  3. 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.

      Image AddedImage Removed
      Figure 3: Advance options for app import

      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.


      If the target environment has an existing version of the app and:

      • If override environment variables are checked, environment variables such as counters (such as the running number created by use of ID Generator Field) will be overridden.
      • If override environment variables are not checked,  environment variables that are intended to be overwritten will not carry over. 


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

    1. At the top left, click on the Not Published or Version button Versions button.
    2. A window will popup the App Configuration Management. In the Manage App Version tab, click Click on the app version radio button and then click on Publish button.
    Image Removed

    Image Added
    Figure 4: Publish an app

    You can also manage the following app import 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).

  5. Click the Launch button to run the published app. The app will open in a new browser tab.
    Image Removed
    Image Added
    Figure 5: Run a published app

...

  1. To export an app, the first login to any Userview UI 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.
    Image Removed
  3. Click on the Export button along the top.
  4. the App Composer of the Application click on the Export Button on the top left.
    Image Added

  5. A file .jwa extension will be generated. This is a zip file you can open in any zip or compression utility. You can now take this .jwa file and import into another Joget platform.

...

Caution: If the app's transaction records are huge, export and import of the app could take a long time and may cause a performance issue for other Joget users. If you have a lot of data records, it is better to use a database utility to perform a database SQLdump.

Image RemovedImage Added

Figure 7: Exporting An App

...