Settings

The Settings page allows you to set the offline caching options for forms and attachments, as well as view, email and delete system logs. Using this page you can also change the sending of anonymous usage data to K2 and configure refresh intervals and timeouts for the app.

The following configuration options are available:

The System Logs option allows you to manage and send system logs to support when troubleshooting K2 Mobile issues.

Two options are available:

  • Send Logs
  • Delete Logs
Only logs captured over a seven day period are available.

Sending System Logs

  1. Tap the Send Logs button.
  2. Your default mobile email client opens.
  3. Address the email and tap Send.

Delete System Logs

  1. Tap the Delete Logs button.
  2. Tap OK on the Delete page.

The offline settings allows you to manage settings such as when to download forms, form attachments, and the clearing of cached data (downloaded forms and attachments).

Offline Forms

Offline forms allow you to configure caching and viewing of forms for offline viewing.

To configure Offline Forms follow these steps:

  1. Open the Settings page and select the Offline option.
  2. Select the Download Forms option.
  3. The following options are available:

    OptionDescription
    Always This setting enables the automatic download of forms with the Offline Availability property set to true in the form properties at design time. Caching does not start until you open the form manually. The forms are downloaded using cellular data or over Wi-Fi. If both are available, Wi-Fi is used.
    WiFi onlyThis is the default setting and enables the automatic download of forms with the Offline Availability set to true in the form properties at design time, but only when connected to a Wi-Fi network. When not connected to a Wi-Fi network, forms can only be cached manually using cellular data.
    ManualNo automatic downloading of forms happens, and you must open the form to begin downloading.
    Note: In multi-auth environments, when opening a form and the authentication screen is closed prior to selecting an authentication mechanism, the form is not cached. The user will have to reopen the form, select an authentication mechanism, so caching can begin.
  4. Select the required option.

Below is an example of using offline forms. For the purpose of this example, the Always offline forms option is used.

  1. Configure your offline forms settings to use Always.
  2. View a task with an associated form in the Inbox.
  3. On the Task Card, notice the animated Form button. This means the form is being cached.
  4. Next, go offline.
  5. Open the menu and tap Forms.
  6. Find the form that was previously downloaded.
  7. Open the form.
  8. The form is available offline.

Offline Attachments

The Download Attachments setting allows you to configure how and when attachments are downloaded to the phone or tablet.

If there is insufficient space on the device while caching an offline attachment, no warning message is displayed. Ensure there is enough space on your device prior to caching offline attachments.

To configure Offline Attachments follow the steps below:

  1. Open the Settings page and select the Offline option.
  2. Select the Download Form Attachments option.
  3. Two options are available:

    OptionDescription
    When the form is downloadedAttachments are downloaded to the device when the form is downloaded.
    When the attachment is opened Attachments are only downloaded when opened manually from a form.
  4. Select the desired option.
If you sign out of the app, all saved attachments are removed from your device.

Below is a runtime example of offline attachments. For the purpose of this example the When the attachment is opened option is used.

  1. Configure your offline attachments settings as discussed above.
  2. Open a task from the Inbox which contains a form with an attachment. Tap the Form icon.
  3. The form contains an attachment.
  4. Open the attachment.
  5. The attachment is saved to the device.
  6. Next, go offline.
  7. Open the form again, and tap the Attachment.
  8. The attachments opens.

Clear Offline Data

The Clear Offline Data option clears all cached data, such as attachments and forms.

Tapping the Clear Offline Data option displays the following message:

Tap OK, K2 Mobile is restarted and all cached data is cleared.

The Refresh Timeout option allows you to specify how long the device will try to refresh the Inbox.

The following options are available:

  • 15 Seconds
  • 30 Seconds
  • 1 Minute
  • 2 Minutes

This option allows K2 Mobile to send anonymous data to K2.