Publish Life-cycle

In the Publish tab, when you click the Publish button, the system starts to publish life-cycle of an app. The publish life-cycle has several app publish stages. During publish app, the system validates each of the stages. Each stage indicates with a tick mark after a successful publish of that stage.

NOTE:  If a service is not configured in an app during design time, the system skips that stage without errors while publishing the app.
However, a tick mark is attached to the stage that indicates publish is successful. While accessing the app in runtime, the system skips non configured services automatically.

While publishing an app, the system processes a set of stages for the configured services in the app. The stages such as validating services, cleaning unused (Integration Orchestration, and Sync) services, propagating changes to runtime, publishing Sync services, publishing app resources, publishing identity services, publishing reporting services, and publishing messaging services.

IMPORTANT:  Ensure that you configure and validate services in the app are correct to avoid failures during publish life-cycle.

During publish life-cycle, the system fails to publish a stage due to wrong configurations in the app - such as, if a service is not configured, installed, or registered in the app, or an integration service has a broken reference of an identity service. An exclamation mark next to the failure message indicates that the stage was not successfully published.

For example, if message services have a wrong data configured in the app, the system does not publish this stage and throws the following error:

To view error details, in the Publishing dialog, click the Show Details link next that failed services.
Click OK to close the Publishing dialog.

A publish error has the following details:

  • Internal Error message: indicates service details that caused to the failure of publish.
  • Tracking ID: indicates a unique error number for that app publish. A tracking ID helps Quantum Support team to find the issue within the app and will give solutions to rectify the issue at the earliest.

Publish Failure Error Messages

The following publish failure errors indicate that you have not installed a service or registered a service as an environment.

  • Publish Error: Conflicting duplicate app key or secret used in multiple Fabric apps while publishing the app to a runtime environment:

    For example, you have published a Fabric app (App1) with a unique App Key and Secret to the runtime environment for the first time. While publishing another Fabric app (App2) with the duplicate App Key and Secret to the same environment, Fabric displays the following error message:

    Another fabric app <XYZ> with the same app key is published to this environment. Please try modifying the app key or unpublish the app <XYZ> to proceed further.

    Workaround: You can do one of the following:

    • Unpublish the Fabric app (App1) from the runtime environment and continue to publish the second App2 with the same app key and secret.

               or

    • Modify the app key and secret in the Fabric App2 and republish it.

     

  • Publish Error: Conflicting duplicate Web app name used in multiple Fabric apps while publishing to a runtime environment:

    For example, you have published the Web1 app with Fabric_App1  to a runtime Environment1. When you try to publish another Fabric_App2 with the duplicate Web1 app name to the same environment, Fabric displays the following error message:

    Another fabric app <XYZ> with the same app key is published to this environment. Please try modifying the app key or unpublish the app <XYZ> to proceed further.

    Workaround: You can do one of the following:

    • Unpublish the FabricApp1 (includes Webapp) from the runtime environment and continue to publish the FabricApp2 app with the Web1 app.

               or

    • Rename the Web1 app to Web2 in FabricApp2 and republish the Fabric app.

 

  • If the error message says Sync Services is not provisioned in the environment, follow these steps:
    • For on-premises, install Quantum Fabric Sync and register to Quantum Fabric.
    • For cloud, consult Quantum Support team to enable Quantum Fabric Sync for that cloud.

  • If the error message says App Services is not provisioned in the environment, follow these steps:
    • For on-premises, install Quantum Fabric Integration and register to Quantum Fabric.
    • For cloud, consult Quantum Support team to enable Quantum App Services for that cloud.

  • If the error message says Engagement Services is not provisioned in the environment, follow these steps:
    • For on-premises, install Quantum Fabric Engagement and register to Quantum Fabric.
    • For cloud, consult Quantum Support team to enable Quantum Fabric Engagement for that cloud.

Code Results of a Published App

The following information is available after you publish an app:

Sample Code

To view the sample code, follow these steps:

  1. Click </> below the name of the app.

    The Sample Code dialog appears.

  2. Select an environment from the Published to environment list.

  3. Select a platform to view the corresponding sample code.

    NOTE: You need to add this code in the initialization function of the respective platform SDK.

App Documentation

After you publish an app to an environment, Quantum Fabric generates app documentation for your app. You can download app documentation from the Environments list in Publish page.

  1. To view the App documentation of a published app, click the Download app documentation button in the Published Environment box. The app documentation is downloaded in a zip folder to your local system.
  2. Unzip the app documentation folder.
    The app documentation .zip comprises multiple artifacts such as index.html file, service definition in Open API Initiative (OAI) format, services references in HTML and JSON format.

  3. Open the index.html in a browser to view the app details.

App Information

To view the App key and App Secret of a published app, click the App Key button in the Published Environment box.

The Primary Key/App Secret, Secondary Key/App Secret, and Service URL are used to initialize a client app to use Quantum Fabric services.
For more information, refer to Separate App Key/App Secret for Native and Web Channels.

App Service Document, Object Services Metadata, and Sync Client Code

To view the App Service Document, Object Services Metadata, and Sync Client Code, follow these steps:

  1. Click Download button in the Published Environment box.

    Based on the configuration, the system displays links - for example:

    • App Service Document
    • Object Services Metadata
    • Sync Client Code:
      • Sync client code (PhoneGap)
      • Sync client code (Kony Studio)
      • Sync client code (Android)
      • Sync client code (iOS)
  2. Click App Service Document to view the code.

    NOTE: If an environment contains an alias hostname, the alias is used in the generated App Service Document. It is also used to make service calls from the client app.

  3. Click Sync client Code (PhoneGap) to download the Sync client code (PhoneGap) file.
  4. Click Sync client Code (Kony Studio) to download the Sync client code (Kony Studio) file.

Runtime Console

A published app provides link to the following services consoles:

Snapshots

Whenever you publish a Quantum Fabric app, a snapshot of the published app is created automatically in the Publish life-cycle. It captures the services and other configurations of the app at the time of publish. If the app is republished multiple times with some changes during the development, you can revert back to the previous versions using snapshots. This feature helps you to revert back to a stable state if the current publish results in an error so that the runtime is not effected.

To view the snapshots of the published app, click Snapshots. The History and Rollback screen is displayed.

By default, you can view the last two snapshots of an app in this screen and the last published snapshot will be marked as Active. Click Settings to change the number of snapshots you can view.

For more information on Import Deployment Package, refer to Promoting a Deployment Package.

You can do the following in the Settings screen:

  • From the Save list, select the required number of snapshots you want to save for your Quantum Fabric app. You can view maximum 10 snapshots for an app and environment combination.
  • Snapshots created during Incremental publish cannot be used for rollback, as they contain only delta services/jars information. To enable rollback capability for snapshots captured during incremental publish, you must select the Enable rollbacks when using Incremental publish check box.
  • Select the Save App Package in Snapshot check box if you want to save an export of the Fabric app as part of the snapshot to serve as a backup of the app at the time of publish. An app package contains all the services of a Quantum Fabric app. You can import this package to the same or a different Quantum Fabric Console.
    If you have reconfigured an app before publish, then you can also download the details of the cumulative reconfigured parameters in a separate file by selecting this check box.
  • Click Save. The settings will be saved accordingly.

You can perform the following activities from the contextual menu available for each snapshot in the History and Rollback screen:

  • Republish: When you click Republish, the app will be restored as per the configurations in the selected snapshot.
  • Download: It downloads the Quantum Fabric App package of the selected snapshot. You can import this package to the same or a different Quantum Fabric Console.
  • Promote: It exports/downloads deployment package of a snapshot from the current environment, a zip format. The Deployment Package zip is downloaded to your local drive on your system. For more information on how to promote a Deployment App Package, refer to App Promotion.
  • Download Reconfiguration: You can download the JSON file that contains the cumulative reconfiguration data, if you have reconfigured and published an app using Configure and Publish. The data of all the reconfigured services are stored in the snapshot.
  • Delete: It removes the selected snapshot from the list.