You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
If the item isn’t in the left navigation pane, select […More](../maker/canvas-apps/intro-maker-portal.md#1--left-navigation-pane) and then select the item you want.
1
+
If the item isn’t in the side panel pane, select […More](../maker/canvas-apps/intro-maker-portal.md#1--left-navigation-pane) and then select the item you want.
Copy file name to clipboardExpand all lines: powerapps-docs/mobile/files-images-offline-canvas-apps.md
+66-63Lines changed: 66 additions & 63 deletions
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ description: Learn how to configure files and images in offline canvas apps.
5
5
author: trdehove
6
6
ms.component: pa-user
7
7
ms.topic: article
8
-
ms.date: 12/05/2023
8
+
ms.date: 2/6/2024
9
9
ms.subservice: mobile
10
10
ms.author: trdehove
11
11
ms.custom: ""
@@ -18,117 +18,120 @@ searchScope:
18
18
---
19
19
20
20
# Configure files and images in offline canvas apps (preview)
21
+
21
22
[This article is prerelease documentation and is subject to change.]
22
23
23
-
This article explains how to configure files and images in offline canvas apps.
24
+
This article explains how to configure files and images in a Power Apps table for offline canvas apps.
25
+
26
+
> [!IMPORTANT]
27
+
>
28
+
> - File and image use in offline canvas apps is a preview feature.
29
+
> - Preview features aren't meant for production use and might have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
24
30
25
-
> [!Important]
26
-
> - This is a preview feature.
27
-
> - Preview features aren't meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
31
+
## Prerequisites
28
32
29
-
## Prerequisite: View column properties for a file or image
33
+
- Have an existing canvas with Dataverse tables. For more information, see [Build an app](../maker/canvas-apps/getting-started.md#build-an-app).
34
+
35
+
### View column properties for a file or image
30
36
31
37
1. Sign in to [Power Apps](https://make.powerapps.com).
32
38
33
-
1. In the left side panel, select **Tables**.
34
-
39
+
1. In the left navigation menu, select **Tables**. [!INCLUDE [left-navigation-pane](../includes/left-navigation-pane.md)]
40
+
41
+
1. Select the table that has the columns you want to view.
42
+
43
+
1. Under **Schema**, select **Columns**.
44
+
35
45
1. Select the **Display name** of a column where **Data type** is set to **File** or **Image**.
36
46
37
-
1. The column properties show the **Data type**. Expand **Advanced options** to view the maximum size for a file or image.
47
+
1. The column properties show the **Data type**. Expand **Advanced options** to view the maximum size for a file or image. For more information about columns, see [Columns overview](../maker/data-platform/fields-overview.md).
38
48
39
-
> [!div class="mx-imgBorder"]
40
-
>![Maximum size for files and images.](media/offline-file-images-1.png"Maximum file and image size")
41
49
42
50
## Turn on support for file and image columns in Dataverse offline feature
43
-
1. In [Power Apps studio](../maker/canvas-apps/power-apps-studio.md), in the left side panel, select **Apps**.
44
51
45
-
1. Select your canvas app, and then select **Edit**.
52
+
1. Sign in to [Power Apps](https://make.powerapps.com).
53
+
1. In the left navigation pane, select **Apps**.
54
+
1. Select a canvas app and on the command bar select **Edit**. This opens your app in editing mode in [Power Apps Studio](../maker/canvas-apps/power-apps-studio.md).
55
+
1. On the command bar, select **Settings** > **Upcoming features**.
56
+
2. Select the **Preview** tab and set the **Enable support for file/image column in Dataverse offline** toggle to **On**.
46
57
47
-
1. Select **Settings**.
58
+
## Download options
48
59
49
-
1. Select **Upcoming features**, and then select the **Preview** tab.
60
+
In an offline-enabled canvas app, there are two ways to download files and images:
50
61
51
-
1. Turn on the **Enable support for file/image column in Dataverse offline** option.
62
+
-**On view**: Downloaded when you view them—the default option.
63
+
-**On sync**: Downloaded during offline sync when device is connected.
52
64
53
-
In an offline-enabled canvas app, you can either allow the files and images to be downloaded **on view**, which is the default option or **on sync**. We recommend that you download files and images on sync if you don't expect to download a large number of files or images.
65
+
### Download files and images on view
54
66
55
-
## Download files and images on view
56
-
When files and images are configured to be downloaded **on view**, the content is downloaded on the device when the user explicitely opens a file or when an image is presented to the user. Files and images are downloaded when the device is connected to the network and can be used afterward without connectivity.
67
+
When files and images are configured to download **on view**, the content is downloaded on the device when the user opens a file or when an image is presented to the user. Files and images are downloaded when the device is connected to the network and can be used afterward without connectivity.
57
68
58
-
This mode is enabled by default without any specific configuration.
69
+
This mode is enabled by default without any specific configuration.
59
70
60
-
## Download files and images on sync
61
-
When files and images are configured to be downloaded **on sync**, files and images are downloaded during the offline sync when the device is connected. The user can access the content without connectivity and is notified in the application when the download of the files and images is completed.
71
+
If you want to keep this default, then you don't need to proceed with this article.
62
72
63
-
To configure automatic download of files and images on sync, create a mobile offline profile in the Power Platform admin center and edit it to include files and images. See [Create a mobile offline profile](canvas-mobile-offline-setup.md#create-a-mobile-offline-profile) to learn how to create a new mobile offline profile and select it from your app.
73
+
### Download files and images on sync
64
74
65
-
### Add image columns to mobile offline
75
+
When files and images are configured to download **on sync**, they're downloaded during the offline sync when the device is connected. The user can access the content without connectivity and is notified when the download of the files and images is completed. **On sync** is recommended if you don't need to download a large number of files or images.
66
76
67
-
It is required to add both the **Image Descriptor** and **FileAttachment** tables to your mobile offline profile to make images available in offline mode.
77
+
The remainder of this article helps you configure on sync.
68
78
69
-
1. Go to [Power Platform admin center](https://admin.powerplatform.microsoft.com) and sign-in as an admin.
79
+
## Configure on sync
70
80
71
-
1. In the left side panel, select **Environments**.
72
-
73
-
1. Choose an environment and then select **Settings**.
74
-
75
-
1. Expand **Users + permissions** and then select **Mobile configuration**.
81
+
### Prerequisites - mobile offline profile
76
82
77
-
1. Select a mobile offline profile to edit it.
83
+
To configure the automatic download of files and images on sync, you need to [create a mobile offline profile](canvas-mobile-offline-setup.md#create-a-mobile-offline-profile) in the Power Platform admin center.
78
84
79
-
1. In the **Data available offline** section, select **Add table**.
85
+
### Enable offline access to images and files
80
86
81
-
1. Select **Image Descriptor** and then select **Next**.
87
+
You can add both the **Image Descriptor** and **FileAttachment** tables to your mobile offline profile by configuring the settings of your environment.
82
88
83
-
1.Under **Choose the rows that you want to make available offline**, select **Related rows only**.
89
+
1.Go to [Power Platform admin center](https://admin.powerplatform.microsoft.com) and sign-in as an admin.
84
90
85
-
1.Expand**Relationships**and select **Column name:** for each applicable column where **Data type** is set to **Image** (that is, as shown in the screenshot below for the **DemoTable1** and **DemoTable3** tables).
1. Choose an environment and then select **Settings** on the menu bar.
94
+
95
+
1. Expand **Users + permissions**, then select **Mobile configuration**.
96
+
97
+
:::image type="content" source="media/files-images-offline-canvas-apps/mobile-configuration.png" alt-text="Screenshot that shows where the mobile configuration setting is located in your environment settings.":::
98
+
99
+
1. Select a mobile offline profile to edit it.
91
100
92
101
1. In the **Data available offline** section, select **Add table**.
93
102
94
-
1. Select **FileAttachment** and then select **Next**.
103
+
1.Proceed with adding [image columns](#add-image-columns-to-mobile-offline-with-image-descriptor) and [file columns](#add-file-columns-to-mobile-offline-with-fileattachment).
In your mobile configuration setting, you can add the **Image Descriptor** table to enable image downloads.
100
108
101
-
1. Select **Save**.
109
+
1. Select **Image Descriptor** and then select **Next**.
102
110
103
-
### Add file columns to mobile offline
111
+
:::image type="content" source="media/files-images-offline-canvas-apps/select-image-descriptor.png" alt-text="Screenshot that shows where to select the Image Descriptor table." lightbox="media/files-images-offline-canvas-apps/select-image-descriptor.png":::
104
112
105
-
It is required to add the **FileAttachment** tables to your mobile offline profile to make files available in offline mode.
113
+
1. Under **Choose the rows that you want to make available offline**, select **Related rows only**.
106
114
107
-
1.Go to [Power Platform admin center](https://admin.powerplatform.microsoft.com) and sign-in as an admin.
115
+
1.Expand **Relationships** and select **Column name: Display name** for each column where **Data type** is set to **Image**. In this example, we select the unnamed column names from the **DemoTable1** and **DemoTable3** tables.
108
116
109
-
1. In the left side panel, select **Environments**.
110
-
111
-
1. Choose an environment and then select **Settings**.
112
-
113
-
1. Expand **Users + permissions** and then select **Mobile configuration**.
117
+
:::image type="content" source="media/offline-file-images-2.png" alt-text="Screenshot that shows the Image Descriptor table settings.":::
118
+
119
+
1. Select **Save**.
114
120
115
-
1. Select a mobile offline profile to edit it.
121
+
#### Add file columns to mobile offline with FileAttachment
116
122
117
-
1.In the **Data available offline** section, select **Add table**.
123
+
In your mobile configuration setting, you can add a **FileAttachment** table to enable file downloads.
118
124
119
125
1. Select **FileAttachment** and then select **Next**.
:::image type="content" source="media/offline-file-images-4.png" alt-text="Screenshot that shows how to add the FileAttachment table.":::
123
128
124
129
1. Under **Choose the rows that you want to make available offline**, select **Related rows only**.
125
130
126
-
1. Expand **Relationships** and select **Column name: Display name** for each applicable column where **Data type** is set to **File** (that is, as shown in the screenshot below for the **DemoTable3** table).
131
+
1. Expand **Relationships** and select **Column name: My column name** for each column where **Data type** is set to **File**. In this example we add **Column name: MyFile** from the **DemoTable3** table.
Copy file name to clipboardExpand all lines: powerapps-docs/mobile/offline-file-images.md
+15-22Lines changed: 15 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -18,43 +18,36 @@ searchScope:
18
18
19
19
# Configure mobile offline profiles for files and images
20
20
21
-
To work with file and image columns in offline mode, you need to add the corresponding columns to the offline profile.
21
+
To work with file and image columns in offline mode, you need to add them to your mobile offline profile.
22
22
23
-
Follow the steps in this article, for a mobile offline profile that has a table with a column where **Data type** is set to **File** or **Image**.
23
+
This article helps you configure a mobile offline profile that has a table with a column where **Data type** is set to **File** or **Image**.
24
24
25
25
## View column properties for a file or image
26
26
27
27
1. Sign in to [Power Apps](https://make.powerapps.com).
28
28
29
-
1. In the left navigation, select **Tables**. [!include [left nav](../includes/left-navigation-pane.md)]
29
+
1. In the navigation menu, select **Tables**. [!INCLUDE [left-navigation-pane](../includes/left-navigation-pane.md)]
30
+
31
+
1. Select the table that has the columns you want to view.
32
+
33
+
1. Under **Schema**, select **Columns**.
30
34
31
35
1. Select the **Display name** of a column where **Data type** is set to **File** or **Image**.
32
36
33
-
1. The column properties show the **Data type**. Expand **Advanced options** to view the maximum size for a file or image.
34
-
35
-
> [!div class="mx-imgBorder"]
36
-
>![Maximum size for files and images.](media/offline-file-images-1.png"Maximum file and image size")
37
+
1. The column properties show the **Data type**. Expand **Advanced options** to view the maximum size for a file or image. For more information about columns, see [Columns overview](../maker/data-platform/fields-overview.md).
37
38
38
39
## Add file and image columns to mobile offline
39
40
40
41
Add the column where **Data Type** is set to **File** or **Image** to your mobile offline profile to make files and images available in offline mode.
41
42
42
-
1. In [Power Apps studio](../maker/canvas-apps/power-apps-studio.md), in the left side panel, select **Apps**.
43
-
44
-
1. Select your model-driven app, and then select **Edit**.
45
-
46
-
1. Select **Settings**.
47
-
48
-
1. Select **General**.
49
-
50
-
1. Make sure the **Can be used offline** toggle is **On**.
51
-
52
-
1. In the **Select offline mode and profile** section, select **Edit selected profile** from the "..."
53
-
54
-
1. Select the table that contains the file or image column to enable for offline, and then select **Edit** from the **More actions** button.
55
43
44
+
1. Sign in to [Power Apps](https://make.powerapps.com).
45
+
1. In the left navigation pane, select **Apps**.
46
+
1. Select a model-driven app and on the command bar select **Edit**. This opens your app in editing mode in [model-driven app designer](../maker/model-driven-apps/app-designer-overview.md).
47
+
1. Select **Settings** > **General**.
48
+
1. Set the **Can be used offline** toggle to **On**.
49
+
1. Under **Select offline mode and profile**, select **Edit selected profile** from the "...".
50
+
1. Find the table that contains the file or image column to enable for offline, and then select **Edit** from the **More actions** button.
56
51
1. In the **Include these files and images** section, select the column where **Data Type** is set to **File** or **Image** (the columns are grouped by **Files** or **Images**).
0 commit comments