Preview a Visualizer Enterprise App on a Device

Using the Quantum App, you can view the front-end prototype of a project on a device. You can run any action attached to a form or widget such as navigating from one form to another, executing events of the forms, and applying a skin to a widget.

You can make changes to your project and then incrementally preview those changes, you can see those changes reflected in a local preview of the app on your device. For the incremental preview you must set the Quantum App on your device to do so, as described later in this topic.

NOTE: The Quantum App does not support the display of Cordova Browser widget in the 7.1.1 version of App User Guide.

IMPORTANT: Incremental preview is supported only for local preview of projects. For previews published to the cloud, the project must do a full Preview > Publish; incremental previewing is currently not available for the cloud.

This section provides the following documentation on Previewing an App:

After the prerequisites have been met, you're ready to generate a preview of the app and then view it on a device.

Once you have generated the preview, you can view it on your device via the cloud or locally. For more information, click the option you want:

Prerequisites

To preview an app, you must satisfy the following prerequisites:

Create a Quantum Account

You must have a Quantum account to use App Viewer feature of the Quantum App. If you do not have a Quantum account, you can create one by using one of the following methods:

Self-Registration

To self-register, follow these steps:

  1. Navigate to the App User GuideQuantum Cloud registration site.

    The Create your Kony Cloud Account page appears.

  2. Provide the required details, and then click Create your account.

    A message appears confirming that your request for registration has been accepted.

  3. You will receive an email from Quantum Accounts with an activation link. Click Activate My Quantum Account.

    The Activate Your Account page appears.

  4. Provide the required details, and then click Create Cloud.

    Your account is activated, and the Quantum Cloud dashboard appears.

Receive an Invitation

The owner (or a member) of a Quantum account who has the necessary permissions to invite a user can send an invitation from manage.kony.com. The invitee receives an email asking them to register for App User Guide.

When the owner of a Quantum account sends an invite to allow you access to the cloud, you receive an email with a Quantum account registration link.

To create a Quantum account after receiving an invitation, follow these steps:

  1. In the invitation email, click Accept Invitation.

    The Accept Invitation page appears.

  2. Provide the required details, and then click Accept invitation.

    Your account is activated, and the Quantum Cloud dashboard appears.

Install the Quantum App on Your Device

The Quantum App allows you to view the complete prototype designed on App User Guide on your mobile or tablet device.

You can download the Quantum App on your

  • Android device from Google Play.
  • iOS device from Apple App Store.

Android

To install the Quantum App, follow these steps:

  1. Tap Applications, and then tap Google Play. Google Play Store opens.
  2. Search for Quantum.
  3. From the search results, tap Quantum.
  4. Tap Install. Type your login credentials, if requested.
  5. Tap the Applications folder, and then tap Quantum to open it.

    NOTE: Follow the same process for installing the Quantum Tablet app on your Android tablet. The Reports and Analytics feature that is present in the Quantum app is not available in the Quantum Tablet app.

    NOTE: On Android, the Quantum Visualizer App Viewer has been upgraded with additional enhancements and has been renamed as Quantum App.

iPhone or iPad

To install the Quantum App, follow these steps:

  1. On your Apple device, tap App Store.
  2. Search for Quantum.
  3. From the search results, tap Quantum.
  4. Tap Install. Type your login credentials, if requested.

    The app is downloaded and installed on your mobile or tablet device.

  5. Locate Quantum on your home screen and tap it.
  6. Sign in to your Kony account by entering your username and password. If you want to bypass entering your login credentials the next time you run the app, select Remember me. Then, tap Sign In.

    NOTE: Follow the same process to install the Quantum App on your iPad. The Reports and Analytics feature that is present in the Quantum app is not available in the Quantum Tablet app.

    7. NOTE: The Quantum App supports Face ID unlock from iOS 11 onwards.

    NOTE: The Quantum Visualizer App Viewer is no longer available in the Apple App Store. A new Quantum App is available with an enhanced feature set and user experience.

Generate a Preview of the App

You must have Kony Fabric configured for Enterprise. This procedure assumes that you have already created and published a Quantum Fabric app and have bound your client app to it. These details are covered in Publish a Project to Kony Fabric.

From V8 SP4 onwards, to create a prototype viewable on the Quantum App:

  1. If you are not currently logged in to your Kony account, do so now by clicking Login in the top right corner of the App User Guide window. The Kony Account sign-in window opens.
  2. Enter your email and password credentials for your Kony account, and then click Continue. Once you are signed in, your account name displays in the top right corner of the App User Guide window.
  3. Do one of the following, depending on whether you want to preview the app via the cloud, or locally by establishing a connection between the device and the computer hosting the app.
    • Local. On the Preview menu, click Configure Channels.
      1. The Live Preview Settings windows appears. Select the platforms and channels that you want the Quantum Appto support.
      2. Click Save & Run. App User Guide builds the local preview. To view it, see Preview an App Locally.
    • Cloud. On the Preview menu, click Publish. The Publish Live Preview window appears.
      1. Select the platforms and channels that you want to publish.
      2. If the project has an existing preview with a publish code, the Publish Live Preview window displays a Preview option.

        3. Toggle the Preview switch to Create New option to publish the app to a new cloud account. If you have access to the app's account, Replace Existing is selected by default, so that the preview you are publishing replaces the existing preview, under that same publish code.

        IMPORTANT: Make sure you select the Quantum Fabric environment you want to use.

      3. If you want to password-protect the preview, toggle the Permission to Private.
      4. Enter a password, and then re-enter it in the Confirm Password text box.
      5. You can change the Preview Mode to Debug, to be able to debug the app. Run mode is selected by default.
      6. Click Publish.

        App User Guide proceeds to publish the app, as indicated by the progress bar. Depending on the size of your application and the speed of your internet connection, uploading an application may take some time. Once the application is uploaded to your Kony account, a publish code is generated as shown here. Also, if you selected the Permission to Private, the password you entered is displayed as well.

        NOTE: The publish code is essential for viewing the preview of the application, and can contain numbers and uppercase letters.

      7. You can easily share the publish code and password by clicking Share Via Email. A New Message window from your default mail client (for example, Outlook) appears. The code, along with the steps for viewing the preview of the app, is auto-generated in the body of your new email message. Add the email address of all the stakeholders to whom you want to give access to the preview of the application, and then send the email.

        8. Once you have generated a preview of the app, the publish code appears in the status bar located over the Properties Editor.

To create a preview viewable on the Quantum Appfor versions released prior to V8 SP4, follow these steps:

  1. If you are not currently logged in to your Kony account, do so now, by clicking Login in the upper right corner of the App User Guide window. The Kony Account sign in window opens.
  2. Enter your email and password credentials for your Kony account, and then click Continue. Once you are signed in, your account name displayed in the upper right corner of the App User Guide window.
  3. On the Preview menu, click Configure Channels.
  4. Select the platforms and channels that you want the Quantum Appto support, and then click Apply.
  5. Select Preview Mode as Debug to enable debug mode for all apps viewed on the Quantum App.
  6. Click OK.
  7. Do one of the following, depending on whether you want to preview the app via the cloud, or locally by establishing a connection between the device and the computer hosting the app.
    • Local. On the Product menu, click Run As. Choose your device from the Devices list. A preview is built. To view it, see Preview an App Locally.
    • Cloud. On the Preview menu, click Publish. On the Publish menu, clickApp Viewer. The Publish App dialog box displays.
      1. Select the channels to which you want to publish, and then click OK.
      2. If prompted, sign in to your Kony account.

        3. The Publish App dialog box appears. If the project does not have an existing preview with a publish code, the dialog box displays only a Create New option.

        If the project does have an existing preview with a publish code, the dialog box displays both a Create New option and a Replace Existing option. If you have access to the app's account, Replace Existing is selected by default, so that the preview you are publishing replaces the existing preview, under that same publish code, as illustrated in the example. If you do not have access to the app's account, you can only use the Create New option; the Replace Existing option is deactivated.


      3. Under Create New, the default Kony cloud account name and the Visualizer project name are auto-populated in the Account and Name fields. From the Account drop-down list, select the account that you want to use.

        4. IMPORTANT: Make sure the account you select has the Quantum Fabric environment that you want to use.

        If you want to change the name of the preview to something other than the Visualizer project name, change the value in the Name text box. If you want, enter a description of the app that you are previewing in the Description text box.

      4. If you want to password-protect the Quantum App, enter a password, and then re-enter it in the Confirm Password text box.
      5. Click Apply.
        App User Guide proceeds to publish the app, as indicated by the progress bar. Depending on the size of your application and the speed of your internet connection, uploading an application may take some time. Once the application is uploaded to your Kony account, a publish code is generated as shown here. Also, if you selected the Access Settings to Protected, the password that you entered is displayed as well.

        From Kony Visualizer V8 SP3 onwards, a QR code is displayed along with the Publish code. This QR code helps in auto-populating the required data in your device for ease of viewing your application.

         

        NOTE: The publish code is essential for viewing the preview of the application, and can contain numbers and uppercase letters.

      6. You can easily share the publish code and password by clicking Share Via Email. A New Message window from your default email client (for example, Outlook) appears. The code, along with the steps for viewing the preview of the app, is auto-generated in the body of your new email message. Add the email address of all the stakeholders to whom you want to give access to the preview of the application, and then send the email.

        7. Once you have generated a preview of the app, the publish code appears in the status bar located over the Properties Editor.

Preview an App Locally

Runs the Quantum App for a prototype by using the device on which you have App User Guide installed, to act as the host for displaying the app on your device. You can connect your device by either by using a wireless connection or, starting from App User Guide version 7.3, via a USB connection.

A French version of the Quantum App is available. To view the Quantum App in French, set your device's language to French (and for Apple devices, also set the region to France), and then restart the Quantum App.

Preview an App by using a USB Connection

When you preview an app locally, use your App User Guide computer to act as the host for displaying the app on your device via a wireless or USB connection. This procedure assumes that you have already generated a preview on App User Guide and that both your computer and your mobile device have a wireless or USB connection. For more information, see Generate a Preview of the App.

NOTE: To connect to an Android device via a USB connection, the device must have Android version 5.0 or later.

NOTE: To connect to an iOS device via a USB connection, the device must have iOS version 10 or later.

IMPORTANT: USB Tethering for iOS devices on Windows Machine:
Prerequisites - Ensure that the latest version of iTunes is installed on the Windows machine. Before you start viewing the app on your iOS device by using the USB feature on the Quantum App, open iTunes on your Windows machine.

To view the preview of your application locally, follow these steps:

  1. Establish a USB connection between the computer(Workstation) that generated the preview, and the device.
  2. Tap the Quantum App on your device. The application is launched.
  3. If necessary, provide your Kony account credentials on the sign-in page and tap Sign In.
  4. Tap the USB tab on the Quantum App tray to display the USB Preview page, if it is not already visible.
  5. The Quantum App automatically connects to Visualizer on the computer, and previews the application for which you have performed the Preview > Run command on Visualizer.
  6. If you want the incremental preview changes that take place on App User Guide to be automatically reflected in the preview of the device, enable Real Time Updates. Additionally, when you enable Real Time Updates, you can opt to enable Silent Updates.
    When enabled, the Silent Updates feature refreshes the preview any time you select Run on App User Guide, so that the preview reflects the incremental changes made during the last build. If Silent Update is disabled but Real Time Updates is enabled, when you select Run on App User Guide to initiate an incremental preview to incorporate your latest project changes, the Quantum App shows a dialog box. In the dialog box, the Quantum App prompts you that an update is available and asks if you want to refresh the preview. Selecting No keeps the current preview, while selecting Yes refreshes the Quantum App, thereby loading the latest build.

    IMPORTANT: You can enable or disable the Real Time Updates and Silent Updates options from the Settings page on the Quantum App.

  7. Tap the preview project name that you want to see. This name is identical to the name of the project on App User Guide.

    8. Alternatively, you can tap the History icon at the bottom of the screen to see a list of previews previously viewed on the device. If you have signed in by using your Kony credentials, the previous preview can be stored on the cloud and can be accessed on any device by using the same cloud credentials.
    If the preview is cached locally on the device so that it can be viewed without a wireless or USB connection, the preview's listing includes a Cached status. If the preview has an update available for download, its listing includes an Update status.

    NOTE: To email information about the preview to a recipient, click the email icon . Included in the email is the App Viewer ID, and for each platform, the preview's name, short notes, and timestamp.

  8. Tap the App Viewer ID of the preview that you want to see.
  9. To cache the preview locally on the device so that you can view it without a wireless connection, activate the Caching slider.
  10. Tap any one of the following options:
    • If an update of the preview is available and you want to view it, tap Update and Launch.
    • If you want to view the version of the preview to which the device is currently synced, tap Launch.

      NOTE: If the Kony Visualizer version that you are using is earlier than V8 SP3, you are prompted to enter the Application name.



You can cancel the download whenever you want.

  1. The preview build is downloaded to your device. You can view the prototype of the project and execute any actions attached to the prototype.
  2. When you are ready to close the preview and return to the home screen of the Quantum App, swipe the device screen with two fingers from left to right.

Preview an App by using a Wi-Fi connection

IMPORTANT: Your computer and your mobile device must be connected to the same wireless network.

To view the preview of your prototype locally, follow these steps:

  1. Tap the Quantum App on your device. The application is launched.
  2. If necessary, provide your Kony account credentials on the sign in page, and then tap Sign In. The Quantum App displays its home screen.
  3. Tap Wi-Fi on the Quantum App tray to display the WiFi preview page.

    4. From the list of available Visualizer workstations, tap the computer hosting the app that you want to preview.

    Or, tap Scan QR Code and scan the QR code displayed on Kony Visualizer after generating a preview.

  4. If you want the incremental preview changes that take place on App User Guide to be automatically reflected in the preview on the device, enable Real Time Updates. Additionally, when you enable Real Time Updates, you can opt to enable Silent Updates.
    When enabled, the Silent Updates feature refreshes the preview any time you select Run on App User Guide, so that the preview reflects the incremental changes made during the last build. If Silent Update is disabled but Real Time Updates is enabled, when you select Run on App User Guide to initiate an incremental preview to incorporate your latest project changes, the Quantum App displays a dialog box. In the dialog box, the Quantum App prompts you that an update is available and asks if you want to refresh the preview. Selecting No keeps the current preview, while selecting Yes refreshes the Quantum App, thereby loading the latest build.

    IMPORTANT: You can enable or disable the Real Time Updates and Silent Updates options from the Settings page on the Quantum App.

  5. Tap the preview project name that you want to see. This name is identical to the name of the project on App User Guide.

    Alternatively, you can tap the History icon at the bottom of the screen to see a list of previews previously viewed on the device. If you have signed in by using your Kony credentials, the previous preview can be stored on the cloud and can be accessed on any device by using the same cloud credentials. If the preview is cached locally on the device so that it can be viewed without a wireless connection, the preview's listing includes a Cached status. If the preview has an update available for download, its listing includes an Update status.

    NOTE: To email information about the preview to a recipient, click the email icon . Included in the email is the App Viewer ID, and for each platform the preview's name, short notes, and timestamp.

  6. Tap the App Viewer ID of the preview that you want to see.
  7. To cache the preview locally on the device so that you can view it without a wireless connection, activate the Caching slider.
  8. Tap any one of the following options:
    • If an update of the preview is available and you want to view it, tap Update and Launch.
    • If you want to view the version of the preview to which the device is currently synced, tap Launch.

      NOTE: If the Kony Visualizer version that you are using is earlier than V8 SP3, then you are prompted to enter the Application name.


You can cancel the download whenever you want.

  • The preview build is downloaded to your device. You can view the prototype of the project, and execute any actions attached to the prototype.
  • When you are ready to close the preview and return to the home screen of the Quantum App, swipe the device screen with two fingers from left to right.

Preview an App on the Cloud

This procedure assumes that you have already generated a preview on App User Guide. For more information, see Generate a Preview of the App.

A French version of the Quantum App is available. To view the Quantum App in French, set your device's language to French (for Apple devices, also set the region to France), and then restart the Quantum App.

To view the preview of your prototype on the cloud, follow these steps:

  1. Tap the Quantum App on your device. The application launches.
  2. Tap Sign In.
  3. Do any one of the following:
    • If your company's Kony account uses standard authentication, enter your Kony credentials and tap Sign In.
    • If your company has a custom authentication arrangement with Kony: tap Enterprise Login, enter your Enterprise Identifier/ Company Name, tap Next, enter your Kony credentials and tap Sign In.
  4. If the Cloud Preview screen does not appear, tap the Cloud icon at the bottom of the screen.
  5. The Kony Visualizer Cloud Preview is displayed, from which you can launch a preview in two ways: by either launching by using the App Viewer ID, or opening a previous preview from the History screen:
    • Launch by using the App Viewer ID. If it is not already highlighted, tap the Cloud icon at the bottom of the screen. Next, tap the Enter Code field, type the publish code for the preview you just published, and tap the Launch button. Or, you can just tap the Scan QR Code button to auto-populate the required details and preview the app.
      While generating the preview of the app on App User Guide, if you selected the Access Settings to Protected and set up a password, when you tap the Launch button, you are prompted to enter the app password.
    • Open a previous preview. Tap the History icon at the bottom of the screen to see the list of previews previously viewed on the device. A previous preview can be stored on the cloud and can be accessed on any device by using the same cloud credentials. If the preview is cached locally on the device, it can be viewed without a wireless connection; the Quantum App's listing includes a Cached status. If the application preview has an update available for download, its listing includes an Update status.
      When you open the History page, it initially shows the app previews stored on your cloud account. You can pull to refresh the screen and load the latest app previews stored in your cloud account.
      Tap the App Viewer ID of the Project Name that you want to preview.
  6. The preview gets downloaded to your device and is displayed. You can now move around on the Quantum App and run any actions attached to it.
    You can execute different lifecycle events of the app. For more information, refer Execute App Lifecycle Events.

  7. At any time, to create or view notes for a particular form, hold two fingers on the device screen for about two seconds or shake the device. The App Viewer menu is displayed. Tap either Create Note or View Notes, which displays the Form Notes pane. To dismiss the Form Notes pane, tap X, which is located near the right edge of the Form Notes title bar. For more information, see Create a Note, View Notes, and Edit or Delete a Note.
  8. When you are ready to close the preview and return to the home screen of the Quantum App, swipe the device screen with two fingers from left to right.

View Temenos Forge Components or Applications

Once you launch the Quantum App on your device, you can access Temenos Forge and view components and applications available in it. You can browse and launch Temenos Forge applications that interest you on the Quantum App.

IMPORTANT: When you access an application from Temenos Forge through an internet browser on a device, if the Quantum App is installed on the device, the application will open on the Quantum App.

To view Marketplace applications on the Quantum App:

  1. In the Quantum App, click Temenos Forge . The Temenos Forge page appears with components and applications.
  2. Browse through the components and applications.
    You can search for a specific component by typing its name or by anpplyig related filters in the search option.
  3. Tap Preview to view the details of the component. The Preview button does not appear for components that do not have their preview available. You can tap the play icon to play the video of the component.
  4. To view an application, tap the application. The application page is displayed.
  5. Tap Preview. The application opens, and you can verify the application functionality.

    NOTE: You may need to sign in to Temenos Forge with your credentials to access the app. For more information, see the corresponding documentation for the app you are using in Temenos Forge .

  6. When you are ready to close the preview and return to the home screen of the Quantum App, swipe the device screen with two fingers from left to right.