App Reconfiguration

During app publishing, Kony Fabric allows you to reconfigure the default values of app services specific to an environment and publish the app to another environment.

App Key and App Secret are used by a Mobile app to identify and communicate with a published instance of a Kony Fabric app. You can configure specific values or let the system auto-generate those.

Important:  For more details about How to Publish an App, refer to Publish.

Use Cases

You can use service reconfiguration based on the following scenarios:

A developer can use an app configuration in the current workspace and publish the reconfigured app to another environment. A developer can reconfigure only a few entities (such as base URL, User ID, and password).

• For example, currently an endpoint URL of an integration service of the app is configured as http://sample.test.com, which is a test environment. But after an app is published in a production environment, a developer wants the integration service to communicate to a production endpoint - for example, https://sample.com. In such cases, a developer reconfigures the endpoint URL from http://sample.test.com    to    https://sample.com, and publishes the app to a production environment.

To display the app reconfiguration page while publishing an app, follow these steps:

1. After you complete configuring services in an app, click the Publish tab.
2. In the Publish page, select an environment. The CONFIGURE & PUBLISH and PUBLISH buttons are active only after you select an environment.
3. Click CONFIGURE & PUBLISH to display the app reconfiguration page.

   

   The App Configuration page appears with the following properties:

   App Details	Properties
   Primary App Key	Primary App Key/Secret for Web Channel Secondary App Key/Secret for Native Channel Note: For more information on separate app key/secret, refer to Separate Appkey/Secret for Native and Web Channels Note that App Key needs to be unique. Additionally App Key and App Secret should only contain alpha numeric characters or '-' and must contain at least 5 and a max of 60 characters.
   Primary Secret
   Secondary App Key
   Secondary Secret

   

4. To change any value, click the Edit button.
   The system displays the original value in the text box, and the save and cancel buttons next to the text box. The text field is active.
5. Change the value in the text field.
6. Click save.
7. If you have configured sync services in your app and also uploaded a binary file for Web client, do the following:
1. Under Synchronization, choose Yes to keep the previous sync configuration in the application history. By default, the synchronization is set to No.

   Note: You are publishing an update to your sync configuration. If you keep the previous sync config in the application history, any devices that already have a local copy of the data can attempt to sync only the schema changes and avoid a full sync. If you do not keep the previous sync config in application history, all devices will be required to fully rebuild their local copy of the data using a full sync. In either case, the client app must be rebuilt with the new sync configuration and updated to all devices.

2. Under the Web Client, Select the required version from the drop-down list. When you select a version and publish the app, the system overrides the existing version of the .war file with the selected new version in the Server. If there is no published version, the system adds the new Web client in the server.
   
   
   • Skip: If you select Skip, Web Client Assets will not be included in this Publish. If you select a version of Web Client, the last published Web Client will be deleted and the said Version of Web Client will be published to Server.
   • Remove: If you select Remove, the Web Client is removed if present in the Server.

   

8. Click SAVE & PUBLISH to start the publishing. The process of publishing the app begins.

Copyright © 2020 Kony, Inc. All rights reserved.