General Synchronization Behaviour

The app supports manual and automatic synchronization to ensure that all data is available to the user.

In order to make sure that the app is syncing, enable it in iOS as well check the app settings.

Generally Yonder remains usable while the application is being updated (with the exception of the initial installation).

In general the iOS settings overrule the individual app settings. If in iOS the use of mobile or cellular data is not granted, the app wont sync even the app settings would permit the use of mobile or cellular data.

So please ensure, that the usage is granted.

The app supports both manual and automatic synchronization to ensure all data is accessible to the user.

To ensure the app syncs properly, ensure that data usage permissions are granted in iOS for proper syncing.

Yonder App Synchronization

There are 2 types the Yonder App is synchronizing:

• manuall synchronization
• automatic synchronization

Typically, Yonder remains fully functional while updates are being applied, except during the initial installation.

Login Requirement for Synchronizaton

A successful login is required before synchronization can begin.

By default, users log in using their company name followed by their user credentials. However, the login process may vary depending on the specific setup, such as:

• Single Sign-On (SSO)
• Active Directory authentication
• Other enterprise authentication methods

Users should follow their organization's designated login procedure.

Synchronization in the App

This section describes how automatic and manual synchronization is triggered to keep your data up to date across devices and systems.

Automatic Synchronization

Sync is automatically triggered in the following chapters described scenarios:

• Initial installation:
  With successful installation an automatic sync will be launched after successful authentication:
• App launch and running app:
  When the user opens the app and the last successful sync was more than 15 minutes ago.
• Offline to online transition:
  When the user has been using the app offline, and an internet connection becomes available.
  If the last sync was more than 15 minutes ago, the automatic sync is triggered.
• Enforced full synchronization:
  To handle edge cases (e.g. extended offline periods), a full sync is enforced under specific conditions.

1. Initial Installation

The initial syncronization will start when installing Yonder. An automatic synchronization process will commence, downloading all the authorized data accessible specific to the user. 

The duration of this initialization phase will vary depending on the data volume, potentially requiring a longer time. It is crucial for the user to maintain a stable internet connection during the initial synchronization and avoid going offline.

The app is usable once the initial installation has been performed successfully.

Trigger: After successful installation and authentication, an automatic full sync begins.

Purpose: Downloads all user-authorized data.

Requirements:

• User is authenticated
• Device is online

2. App Launch or running App

If the last sync was performed more than 15 minutes ago, an automatic sync is triggered in the background. This ensures that any data the user created or modified while offline is properly uploaded to the server, and that any changes from the backend are retrieved as soon as connectivity is restored.

This logic helps maintain data consistency between the local and remote sources without requiring manual user action after being offline.

Condition: The user opens the app or the app is already running.

Trigger: If the last successful sync was more than 15 minutes ago, an automatic background sync starts.

Purpose: Ensures changes made offline are uploaded and new backend updates are pulled.

3. Offline to Online Transition

When the user has been actively using the app in offline mode (i.e. without an internet connection), the app monitors for changes in network connectivity. As soon as a stable internet connection becomes available again, the app checks when the last successful sync occurred.

Condition: The user was using the app offline and reconnects to the internet.

Trigger: If more than 15 minutes have passed since the last sync, an automatic sync is triggered.

Purpose: Syncs any changes made during offline usage and fetches the latest data.

4. Hourly Timer Sync

General timer that is implemented to check for content updates.

Condition: A background timer runs automatically every 60 minutes.

Trigger: If the last successful sync was more than 15 minutes ago, a sync is initiated.

Use Case: Ensures periodic data refresh and consistency, even if the user hasn’t interacted with the app or triggered any other sync events.

5. Enforced Full Synchronization

To avoid edge cases (e.g. if a user was on a longer leave and didn't synchronize), a full sync shall be enforced under certain conditions.

Conditions:

• User has not synced their device for more than 14 days
  A significant lapse in synchronization increases the risk of data inconsistencies. A forced full sync ensures data integrity across devices.
• User has paused, cancelled, or interrupted the full sync
  An incomplete sync operation can leave the device’s state inconsistent, potentially leading to overwritten or missing user data (e.g., favorites, tasks).

For both scenarios, a popup will notify the user of the need for a full sync. 

Trigger: Under specific conditions (e.g., extended offline periods or sync inconsistencies), a full sync is enforced automatically.

Purpose: Ensures consistency and data integrity in edge cases.

Manual synchronization

Manual sync allows users to trigger data synchronization on demand, ensuring they have the most up-to-date content regardless of the automatic sync schedule.

Condition: The user presses the Sync button in the app.

Trigger: Sync starts immediately, regardless of the last sync time.

Use Case: Useful when a user wants to ensure immediate data refresh or upload.

Initiate a manual synchronization

You can trigger a manual sync in two ways:

• pressing the Sync button
• swiping down the primary column

Synchronization on weak connection

In both the initial- and a manual synchronization, Yonder assesses the connectivity type and identifies a poor connection for:

• cellular generation = 2G, 3G

A corresponding info message will be displayed informing the user that a sync will take longer.

Synchronization error messages

In case the synchronization can not be performed as intended, Yonder will prompt the user for:

• No network connection
• Incomplete (partial sync)
• Not enough free disk space (checked starting an initial sync)

Device storage

To ensure optimal performance, the app checks your device's available storage with every sync. If your storage is running low, you may receive a warning. These warnings help prevent issues and ensure the app functions smoothly.

Types of Storage Warnings 

(as of 1.6.4)

There are two levels of warnings:

1. Low Storage Warning – This informal alert notifies that the available storage is becoming low, allowing enough time to take action before it affects performance.
2. Critical Warning – This indicates that your storage has reached a critical level, not only impacting the app's performance but also causing potential issues across the entire device, such as slowdowns and instability.

Low Storage Warning ‘Avail. Storage <4GB’

The app displays an orange bar indicating that the device has less than 4GB of free space available.
While the device can still function, it is recommended to free up space to ensure optimal performance and to allow the operating system to function fully.

• Recommended Action: Delete unnecessary files, apps, or transfer content to external storage to regain space.

Critically Low Storage ‘Critical: Avail. Storage <2GB’

The app displays an red bar indicating that the device has less than 4GB of free space available. This could severely affect performance, cause slowdowns, and limit the ability to install new apps or updates.

• Recommended Action: Free up space immediately by removing large files, uninstalling unused apps, or transferring content to external storage.

Note: These warnings are based on the recommendations provided by the operating system to ensure your device functions fully and efficiently. It's important to monitor your available storage and take action before it reaches a critically low level.

Wi-Fi data settings

Ensure that Wi-Fi access is granted

Mobile data settings

Using a SIM card and wanting to make sure that mobile data can be used, ensure that ‘Mobile Data’ is allowed in the iOS control center:

Yonder app settings

iOS mobile data settings differ between iPadOS and iOS, particularly in how they are displayed and managed, depending on whether the device has a SIM card slot and an active SIM card.Below are the key differences, specifically in the context of mobile data settings and app usage behavior.

General Mobile Data Settings

iPhone

On iPhones, the Mobile Data option is always displayed in the device's general settings.

Mobile data for apps is automatically governed by the iPhone’s general Mobile Data setting.

iPad (SIM-enabled)

On SIM-enabled iPads, the Mobile Data option will only appear in the device's general settings if the user has manually enabled it. If mobile data is not enabled in the general settings, the option will be hidden by default.

App Mobile Data Usage

With recent updates, the mobile data usage of apps will no longer be disabled by default on either iPhones or iPads.

Standard behavior: 
The app’s mobile data usage follows the status of the Mobile Data setting as configured in the device’s general settings.

iPhone: The app will respect the general mobile data status at all times.

iPad: Mobile data usage for the app will depend on whether the user has enabled mobile data in the iPad’s general settings.

Changing Mobile Data Settings from the App

When selecting the 'Mobile Data Settings' option within the app’s settings App Preferences > Sync Options, you will be guided directly to the corresponding iOS Mobile Data settings for the device (iPhone or iPad). This provides a seamless way to manage mobile data preferences without navigating through multiple system menus.

App Update

iOS apps are automatically updated based on the system settings for automatic updates. By default, iOS tries to update apps during times when your device is likely to be plugged in and connected to Wi-Fi. This typically means updates are more likely to occur during overnight periods when the device is charging. Here are the key conditions under which automatic updates happen:

• Wi-Fi Connection: Automatic updates usually require a Wi-Fi connection to avoid using cellular data.
• Power Source: Updates are more likely to occur when your device is plugged in to ensure it has sufficient battery.
• Idle Time: The system tries to perform updates during periods when the device is not in active use, such as during the night.

To ensure that automatic updates are enabled, you can check your settings:

1. Go to Settings.
2. Tap on App Store.
3. Under the Automatic Downloads section, make sure App Updates is toggled on.
4. Optionally, you can also toggle on Automatic Downloads under Cellular Data if you want updates to happen over cellular networks, though this is typically off by default to save data.

If you prefer to manually update your apps, you can always go to the App Store, tap on your profile picture in the top right corner, and scroll down to see available updates.

iPad OS - App Refresh

In order to ensure synchronization on the iPad, please ensure below prerequisites:

Background App Refresh

Prerequisite:

• user is authenticated
• device is online
• application is not terminated
• Background App Refresh is enabled:

App Updates

To enable automatic app updates on an iPad, you can follow these steps:

1. Open the Settings app on your iPad.
2. Scroll down and tap on App Store.
3. Under the Automatic Downloads section, toggle on App Updates.
4. (Optional) If you want app updates to happen over cellular data, you can enable Automatic Downloads under Cellular Data and then turn on App Downloads. Note that this might use more data if you're not on Wi-Fi.

This setup will ensure that your iPad automatically updates apps when new versions are available, as long as it's connected to Wi-Fi (or cellular, if that option is enabled).iOS updates apps automatically, but it usually does so in the background when your device is connected to Wi-Fi, plugged in, and not actively in use. 

This timing can mean updates may not happen immediately when they’re released. If you want apps to update more promptly, here are a few tips:

Manually Check for Updates:

• Open the App Store.
• Tap your profile icon in the upper-right corner.
• Scroll down to see Pending Updates and pull down to refresh the list. Tap Update All to get the latest versions immediately.

Restart the Device:

• Occasionally, restarting the iPad can prompt any queued updates to process, especially if the device has been running for a long time without a reboot.

Check Your Wi-Fi Connection:

• Sometimes, automatic updates may pause if the Wi-Fi connection is spotty or slow. Ensure your iPad is connected to a reliable Wi-Fi network.

Update to the Latest iPadOS:

• Sometimes, newer iPadOS versions improve the speed and reliability of app updates. Check for any pending system updates under Settings > General > Software Update.

iPhone OS

In order to ensure synchronization on the iPhone, please ensure below prerequisites:

Prerequisite:

• user is authenticated
• device is online
• application is not terminated 
• Background App Refresh
  iPhone OS may terminate background app refresh in order to optimize your phone's performance and battery efficiency. In this case Yonder will indicate a warning message that ‘Synchornization could not be completed’. To finalize your synchronization, please re-initiate it by clicking on the Sync icon.
• Cellurar Data
  In order to use your cellular data plan if required.

You can check if Background App Refresh is enables also in: Settings > General > Background App Refresh and validate (enable / disable) Yonder.

General iOS behaviour

• System Triggers: iOS monitors various factors such as network availability, device activity, and power status to determine when to initiate background app refresh for specific applications.
   
• Refresh Intervals: iOS manages the frequency and timing of background app refresh based on factors like app usage patterns and device resources. It aims to strike a balance between keeping apps updated and conserving battery life.
   
• Scheduled Updates: iOS determines the optimal times to refresh each registered app's content based on historical usage data. It may consider factors like when the device is connected to Wi-Fi, charging, or during periods of low activity.
   
• Background Fetch: iOS periodically wakes Yonder in the background to allow it to perform small tasks and fetch new content. Apps are given a short window of time to execute their refresh operations before being suspended again.

Note: the exact behaviour and capabilities of background app refresh can vary based and defined by the specific iOS version, device settings, and app permissions. 
The app needs to be opened in the background (not closed / swiped away)

You have control over enabling or disabling background app refresh for individual apps in the device settings to manage battery life and data usage.

Date & Time

Please set the “Date & Time” settings of your iPad to 24h.