Creating a SuiteApp Version
Each version of your SuiteApp is a version composed of a SuiteApp ZIP archive. The archive contains a SuiteApp project representing the SuiteApp. For information about SuiteApp projects, see SuiteApp Projects.
For information about creating the SuiteApp ZIP archive, see Managing SuiteCloud Projects as Compressed Files in SuiteCloud IDE Plug-in for WebStorm.
To be valid for SuiteApp Control Center, the SuiteApp ZIP archive must meet the following criteria:
-
The ZIP is a valid archive.
-
The ZIP contains a manifest.xml file.
-
The manifest element in manifest.xml file has the projecttype attribute value set to SUITEAPP.
-
The projectid field exists in manifest.xml, and its value matches the Project ID value defined for the SuiteApp in SuiteApp Control Center. For information, see Properties of a SuiteApp Project and Creating a SuiteApp Definition.
-
The publisherid field exists in manifest.xml, and its value matches the Publisher ID value defined for the SuiteApp in SuiteApp Control Center. For information, see Properties of a SuiteApp Project and Creating a SuiteApp Definition.
-
The manifest.xml file contains a projectversion field value that is higher than the version number of either the leading release version or lagging release version. A new version cannot contain the same project version number as an existing version. The project version number for a deleted version can be used for a new version, because the deleted version no longer exists.
-
The manifest.xml file contains a projectversion field value that is valid. The value must use semantic versioning. For example, if the project version is 1.02 with a minor revision 01242017, the project version is 1.02.01242017.
-
The manifest.xml file contains a projectname field value.
Although the locking preferences (locking.xml) and hiding preferences (hiding.xml) are not part of the SuiteApp ZIP validation, they must be configured in the SuiteApp project for the SuiteApp installation to succeed. Those preferences are only a requirement for SuiteApps defined in SuiteApp Control Center. For information about configuring those preferences, see Setting Installation Preferences in SuiteCloud IDE Plug-in for WebStorm.
To create a SuiteApp version:
-
Go to Control Center > My SuiteApps > My SuiteApps.
-
Perform one of the following actions:
-
For a SuiteApp, click and select Manage Versions.
-
Click the SuiteApp name to view the SuiteApp details, and click the Versions tab.
-
-
Click Create New. The New SuiteApp Version popup window appears.
-
Click Choose file and select a SuiteApp ZIP archive from a local directory or network share. NetSuite File Cabinet files are not available for selection. After the SuiteApp ZIP archive is uploaded, the Project Version field is populated with the value from the projectversion field in the manifest of the SuiteApp project contained in the ZIP. That value is used as the version number after the version is created, for example, 1.0.1.
-
Specify the following options:
-
Phase – is the SuiteApp version phase, which can be Leading or Lagging. For information about those phases, see SuiteApp Version Phases.
This option can also be changed when editing the SuiteApp version, if the version is in the Pending state.
-
Minimal Required NetSuite Version – is the minimum NetSuite version required for the install base to install this version of the SuiteApp.
-
-
Click Create. The new version is added to the Version History list and a confirmation appears to communicate that the version has been saved.
For information about the version fields and actions that can be performed, see Viewing the SuiteApp Version History.
-
(Optional) Click Done to close the SuiteApp details and return to the My SuiteApps page.