Work with promotions
About app promotion
The system supports and interfaces with promotion levels, which are hierarchical controls for promoting apps from a development state into a final production position.
Examples of promotion levels are development, testing, and production, where production is the final or highest promotion level. There must be at least two promotion levels.
A promotion level can have more than one environment assigned to it. When apps are promoted, new copies are created, which means that the apps are published. The app must publish successfully for all of the environments that are assigned to both the promotion level and to the app to run effectively. Promotion of an app will fail unless it is free of all defects and it can satisfy all environment-specific references to registered resources, such as downloads and function calls.
Once an app is promoted, it can no longer be edited. The purpose for this is to maintain app integrity. The base app must be modified and re-promoted for it to affect a promoted app.
When promoting an app that references components that have been changed, a warning will appear indicating that new app items have been detected.
Promoted apps contain a copy of all subapps, includes, forms, wires, and table definitions. When an app is promoted, the latest version of all referenced subapps, includes, and tables are copied into it. This maintains app integrity.
For example, app version 20 contains subapp version 13, and no matter what modifications occur to that subapp, the compatible subapp version is preserved inside of the main app. For this reason, subapps, includes, forms, wires, and tables cannot be promoted.
When an app is checked in, the versions of all sub-items that are referenced in the app are recorded. These recorded versions are used in all the app's publishing or promotion, even if the sub-items have changed. To include any sub-item changes, the main app must be checked out and checked back in to record the most current version of the sub-items.
Beginning in 9.0 SP12, you can use the Promote All feature to promote multiple apps within a project. This feature allows you to promote all apps within a project that are in a specified promotion level.
Promote an app
The system supports and interfaces with promotion levels, which are hierarchical controls for promoting apps from a development state into a final production position. There must be at least two promotion levels.
Prerequisite: If promoting an app from the base level (lowest promotion level), make sure the app being promoted is checked in.
To promote an app to the next promotion level, complete the following steps in Platform Manager.
-
Go to Develop > Application Studio > Library.
-
Select Applications.
-
Hover over the app's version number in the highest promotion level and select Promote from the menu.
-
One of the following results occurs.Expected ResultResult:
-
A message that indicates the app was successfully promoted, showing the same version number as in the level from it was promoted.
-
Messages appear that indicate which errors were found. The app is not promoted. Make sure the app is free of all defects and it can satisfy all environment-specific references to registered resources such as downloads and function calls. Then try promoting the app again.
-
About promotion packages
Apps that are complete, and have been promoted can be packaged with their supporting files. This promotion package can then be imported into another Mobile Enterprise Platform instance.
When a completed app is promoted, it contains the latest version of all subapps, includes, forms, wires, and table definitions that are referenced in the app. When this app needs to be used in another instance of the Mobile Enterprise Platform, you can create a promotion package.
Create a promotion package
When an app needs to be taken to another instance of Mobile Enterprise Platform, a promotion package can be created and then imported on the other instance.
Prerequisite: Before a promotion package can be created, the app must have already been checked in, published, and promoted to a promotion level above the Develop level.
To create a promotion package, complete the following steps in Advanced Inventory Platform Manager.
-
Go to Develop > Application Studio > Library.
-
Select Applications.
-
Hover over the app's version number in the highest promotion level and select Promotion Package from the menu.
-
In the package window, select what to do with the package file.Expected ResultResult: If you select Save, the file will save to your Downloads folder with the extension .package .
Postrequisite: The .package file can now be uploaded in another Mobile Enterprise Platform instance.
Download a promotion package
A promotion package, which exports and saves an app and all its items (forms, wires, subapps, etc.) to a .package file, can be downloaded. The promotion package .package file can then be uploaded in another Mobile Enterprise Platform instance. Promotion Packages can only be exported from the highest promotion level in the instance. They can be imported into development and non-development instances.
To download a promotion package, complete the following steps in Advanced Inventory Platform Manager.
-
Go to Develop > Application Studio > Library.
-
Locate the app for which to download a promotion package.
-
In the Production column, hover over the version number for the app, and then select Promotion Package.Expected ResultResult: The package file appears in the bottom left corner of the section.
-
Optional. Right-click on the file package for the following options.
-
Open: Opens the file in the browser of your choice.
-
Always open files of this type: Always opens this type of file.
-
Show in folder: Opens the folder location where the file was downloaded.
-
Postrequisite: The .package file can now be uploaded in another Mobile Enterprise Platform instance.
Upload a promotion package
Uploading a promotion package retains the version numbers of the app and its related items. The promotion package has a manifest that contains referenced items and their versions.
Note:Starting with version 9.5 SP4, the app promotion process speed has improved up to 15% faster than previous versions. Please contact your Cloud Inventory® representative to discuss upgrade options.
Prerequisite: The promotion package you want to upload must exist as a file with the .package extension.
To upload a promotion package, complete the following steps in Platform Manager.
-
Go to Develop > Application Studio.
-
Select Upload > Promotion Package.
-
Optional. For Promo Package ID, enter an ID.
-
In the Upload Promotion Package dialog box, select Choose File.
-
Select the .package file that you want to upload and select Open.
-
Select OK.
-
If the Items Conflict dialog box displays, some of the promotion package items already exist in the target instance of Mobile Enterprise Platform. To specify how to handle each conflict, complete one of the following actions.Step InformationNote:For a user with a non-development license and pristine items, only device database tables will display.Important:We recommend that you verify each item before you select Replace. If an item is used in an app, and you replace the item with the wrong version, it may result in the app no longer functioning.
-
For each item you want to keep, select Keep. The item maintains the current version number.
-
To keep all items, in the header row, select Keep. The items maintain their current version numbers.
-
For each item you want to replace, select Replace. Replacing a item will increase the version number of that item.
-
To replace all conflicting item, in the header row, select Replace. Replacing items increases the version numbers of those items.
Expected ResultResult: If a device database table is part of the project upload, the system prompts you to provide additional information, such as the source and middle-tier connection strings, and to indicate whether to include the data replication schedules. If you specify to replace a device DB table, the system deletes the existing table and its data, and then recreates the table. This action cannot be undone. -
-
When all selections are made, select OK.
-
If the Style Group Selection dialog box displays, the uploaded promotion package includes a form that does not reference a style group. This dialog allows you to select a style group for each form included in the promotion package.Step InformationNote:This conflict happens only for packages created prior to 8.1 SP2 and if the target system contains more than one style group.
-
Select OK.
Loading...
There was a problem loading this topic