Changes
Created page with "To support offline use cases, {{UBIK}} clients provide the possibility to bring data offline. It's achieved by downloading specified data branches in advance. == Manual Downl..."
To support offline use cases, {{UBIK}} clients provide the possibility to bring data offline. It's achieved by downloading specified data branches in advance.
== Manual Download ==
When using the clients in non-offline sync modes, you can trigger a branch download from any content object. Depending on the clients and the XAML customizings, the UI for starting branch downloads might differ. Here's the default UI on different clients.<gallery widths="300" heights="200">
File:UI_WinX_Branch_Download_Button.png|button in bottom bar (UWP)
File:UI_Xamarin_Branch_Download_Page_Menu.png|button in page menu (Xamarin)
File:UI_Xamarin_Branch_Download_Item_Swipe.png|button in item swipe menu (Xamarin)
</gallery>
{{Hint|Manual downloads always have higher priorities than automatic downloads. More specifically, a manual download will "cut in line" in front of all automatic downloads (except if one is already in the middle of executing).}}
== Automatic Download {{Version/WinXSince|3.8}} ==
Content objects can be classified in a way that their branches are automatically downloaded to the clients.
[[SYSCLS_OFFLINE_SYNC_CONFIGURATION|Different configurations]] are supported so that the download can happen at different timing.
== Download States {{Version/WinXSince|3.8}} ==
To help users better understand what is going on during a branch download, the clients display different icons. The following examples are from the Xamarin clients.
<gallery widths="400" heights="120">
File:UI_Xamarin_Branch_Pending.png|pending (to run at least once, see [[#Automatic Download|Automatic Download]])
File:UI_Xamarin_Branch_Syncing.png|syncing
File:UI_Xamarin_Branch_Synced.png|synced
File:UI_Xamarin_Branch_Failed.png|failed
</gallery>
{{Hint|All states are displayed for an entire branch. If the parent (direct or indirect) of a child object is syncing, that child object will display the same syncing state.}}
{{Hint|States are displayed in different priorities (syncing > pending > synced/failed). For example, if a child object is syncing and its parent is pending, the child object will "retain" its syncing state. But if their states are switched, the child object's pending state will be "overwritten" by the parent's syncing state. As for the synced/failed states, the more recent one is displayed.}}
[[Category:Client|Branch Download]]
[[Category:WinX|Branch Download]]
[[Category:Xamarin|Branch Download]]
[[Category:Version 3.8|Branch Download]]
== Manual Download ==
When using the clients in non-offline sync modes, you can trigger a branch download from any content object. Depending on the clients and the XAML customizings, the UI for starting branch downloads might differ. Here's the default UI on different clients.<gallery widths="300" heights="200">
File:UI_WinX_Branch_Download_Button.png|button in bottom bar (UWP)
File:UI_Xamarin_Branch_Download_Page_Menu.png|button in page menu (Xamarin)
File:UI_Xamarin_Branch_Download_Item_Swipe.png|button in item swipe menu (Xamarin)
</gallery>
{{Hint|Manual downloads always have higher priorities than automatic downloads. More specifically, a manual download will "cut in line" in front of all automatic downloads (except if one is already in the middle of executing).}}
== Automatic Download {{Version/WinXSince|3.8}} ==
Content objects can be classified in a way that their branches are automatically downloaded to the clients.
[[SYSCLS_OFFLINE_SYNC_CONFIGURATION|Different configurations]] are supported so that the download can happen at different timing.
== Download States {{Version/WinXSince|3.8}} ==
To help users better understand what is going on during a branch download, the clients display different icons. The following examples are from the Xamarin clients.
<gallery widths="400" heights="120">
File:UI_Xamarin_Branch_Pending.png|pending (to run at least once, see [[#Automatic Download|Automatic Download]])
File:UI_Xamarin_Branch_Syncing.png|syncing
File:UI_Xamarin_Branch_Synced.png|synced
File:UI_Xamarin_Branch_Failed.png|failed
</gallery>
{{Hint|All states are displayed for an entire branch. If the parent (direct or indirect) of a child object is syncing, that child object will display the same syncing state.}}
{{Hint|States are displayed in different priorities (syncing > pending > synced/failed). For example, if a child object is syncing and its parent is pending, the child object will "retain" its syncing state. But if their states are switched, the child object's pending state will be "overwritten" by the parent's syncing state. As for the synced/failed states, the more recent one is displayed.}}
[[Category:Client|Branch Download]]
[[Category:WinX|Branch Download]]
[[Category:Xamarin|Branch Download]]
[[Category:Version 3.8|Branch Download]]
