Configuring Apps & Pages

When you create a new app or page within CommonTime Infinity there are a number of settings which can be configured. These allow you to specify a number of details about the app/page, ranging from the app’s name to the way it should look and behave.

The settings can be initially set when you select the ‘Create App’ or ‘Create Page’ button.

If you wish to modify the settings at a later point in time, you can enter Edit Mode and select the yellow edit button above the name of the app/page.

Topics covered in this article

1. Configuring Apps
2. Configuring Pages

1. Configuring Apps

There are a wide variety of settings which can be set for an application which are spread across 5 separate tabs. The first tab covers a range of general settings, including the app’s name and icon. The ‘Settings’ tab includes a collection of different app-based settings, such as the app’s version number and default language settings.

The remaining 3 tabs are more specialised. The ‘Push Notifications’ and ‘Message Queues’ tabs allow you to enable and configure more advanced application features, whereas the final tab can be used to include additional metadata which is accessible within the app (e.g. App Author, Last Updated).

1a. ‘General’ Tab
1b. ‘Settings’ tab
1c. Other tabs

1a. ‘General’ Tab

App Name

The ‘App Name’ specifies the name you wish to use for the application. It is used to identify the app within the Infinity Studio and will be displayed under the app’s icon when installed as a standalone app on a device. There are a number of restrictions:

  • Can only contain alphanumeric characters, _ and $
  • Must also be unique within the installation of the Infinity App Studio
  • Cannot contain spaces
  • Can’t start with a number or $
  • Limited to 20 characters

Icon

Using the ‘Icon’ section you can select the icon which will be used for your application. This will be used to identify your app within the Infinity App Studio and displayed on devices when the app is built as a standalone application.

To pick the icon either select one of the provided images or upload your own .png file using the ‘Choose Icon‘ option.

Splash

Chose a splash screen which will be displayed when the app is launched and starts loading. You can either select to use the default splash screen or create your own by supplying a logo and background colour.

1b. ‘Settings’ Tab

Package ID

The ‘Package ID’ (also known as an App ID) is a unique identifier which is used by devices to differentiate between applications. Using different Package IDs allows multiple Infinity apps to be installed on the same device, whilst also allowing the app to be targeted by other services (e.g. iOS Push Notifications)

Package IDs are generally specified in ‘reverse domain notation’ in the format com.companyname.appname though this can differ depending on the deployment platform and requirements of your app.

Note that this field will automatically be populated by CommonTime Infinity when you specify the ‘App Name’ within the ‘General’ tab. You can however choose to modify it to a different value if a specific Package ID is required.

 

App Version

As the name suggests the ‘App Version’ field can be used to supply a version number for your application. This is used by App Stores and MDM platforms and is publicly visible on some platforms.

Theme

CommonTime Infinity provides a number of themes which can be applied to change the base appearance of the app (e.g. header colour, font). This styling can then either be enhanced or overwritten using custom CSS.

Routing Mode

The ‘Routing Mode’ controls when the application will load pages into the device’s memory. You can choose from the following options:

  • Intelligent
    Only loads pages which the user can navigate to. This prevents pages being stored in memory if the user cannot access them.
  • All-in
    Loads all pages when the application is launched. Whilst this may result in a longer loading time at the start, it is useful for older devices which take time to load pages when the application is in use.
  • Single
    Only store the current page in memory, with new pages being loaded when the user navigates to them. This is a good option for new devices that have quick non-volatile storage.

Animation

The ‘Animation’ field specifies the style of animation which should be shown when a user changes pages in the application. By default the animations are turned off, though can be set to Slide In, Flip In, Fade In or Rotate In Left.

API Loading Message

By default, each time a ‘Call API’ action is triggered the app will display a ‘Loading data...’ message at the top of the application screen. This message can be enabled/disabled using the ‘API Loading Message’ setting.

Security

The ‘Security’ section includes two settings which control security based features:

  • Authentication
    Specifies whether the user will be asked to authenticate when the app is opened. Note that this option only affects applications used on a device. If enabled, this will use the device’s current authentication method (e.g. pin code, swipe pattern, fingerprint).
  • Encryption
    Specifies whether data captured by the app should be encrypted whilst held in app’s Data Model. Note that this will only encrypt data in the application – if data is passed out of the app (e.g. sent to an API) it will not be sent in an encrypted format.

Language

The ‘Language’ section includes a number of language-based settings including the default locale ID and the initial language the app should be displayed in. These settings should be configured if you include multiple language packs within your app. For more details, see the Localisation documentation.

Crash Reporting

Applications built using CommonTime Infinity are able to capture data if the application crashes. This is achieved through the Splunk MINT service and must be configured using the ‘Crash Reporting’ section of the application settings. For more information, see the crash reporting guide.

Kiosk Support (Android)

The ‘Kiosk Support’ switch allows you to enable/disable support for Kiosk Mode on an Android device. When enabled, it allows you to lock down the device such that it can only run a single built application, without access to the home screen, settings etc. Further documentation on this process will be available soon.

Note that all iOS applications built using CommonTime Infinity can be launched in single-app mode through the use of Guided Access mode or the Apple Configurator.

1c. Other tabs

Push Notifications

The ‘Push Notifications’ tab can be used to enable and configure push notifications for Android, iOS and Windows Phone. For further information on the required settings, please see the this documentation.

Message Queue

The ‘Message Queues’ tab allows you to configure your application to send/receive messages from an Azure Service Bus (ASB). For details of how to use this feature within your application, please see the Message Queues documentation.

Metadata

Additional information relating to the app can added to the application through the ‘Metatdata’ Tab. This is useful for embedding values into the application’s file (such as the Author or last date updated), with the data being stored in the following location within the Data Model:

cti.store.schema.metadata.name

2. Configuring Pages

There are a number of page-related settings which are provided when you choose to create a new page within an application. These are spread across two separate tabs, with the first providing basic information about the page and the second used to configure the page’s behaviour.

2a. ‘General’ Tab
2b. ‘Settings’ Tab

2a. ‘General’ Tab

Page Name

The ‘PageName’ specifies the name you wish to use for the page. It is used to identify the page within the application and will be used in the Data Model to store data which has been entered into fields on the page. There are a number of restrictions on the chosen name:

  • Can only contain alphabet characters, 0-9, _ and $
  • Must also be unique within the app
  • Cannot contain spaces
  • Can’t start with a number or $
  • Limited to 20 characters

Start

The ‘Start’ setting indicates which page the application should navigate to when the application is first opened or all data is cleared

By default this will be turned on for the first page created in each application. As only one start page can be specified per app, enabling this setting on one page will automatically disable the setting on page which was previously designated as the start page.

Within the app the Infinity App Studio the start page can be identified through the ‘Start’ label which appears in the lower right corner of the chosen page.

Page Template

When a new page is created it is possible to select a Page Template to pre-populate the page with areas and items. To achieve this you can either select one of the built in templates provided by CommonTime Infinity, or select a custom template which you have created using another page.

For more details, see the Page Template documentation.

Note that the Page template can only be selected when creating a new page and will therefore not appear on the edit screen.

2b. ‘Settings’ Tab

Authentication

When enabled, it requires the user to authenticate when the page is opened. This is only available on devices, and uses the device’s current authentication method (e.g. pin code, swipe pattern, fingerprint).