Merge pull request #209112 from dominicbetts/central-file-upload

IoT Central add file upload UX details

Author: Maggiemouse1

articles/iot-central/TOC.yml

@@ -167,6 +167,8 @@
           href: core/howto-manage-devices-individually.md
         - name: Manage devices in bulk with jobs
           href: core/howto-manage-devices-in-bulk.md
+        - name: Configure and use file uploads
+          href: core/howto-configure-file-uploads.md
         - name: Migrate devices to IoT Hub
           href: core/howto-migrate-to-iot-hub.md
     - name: Extend your application
@@ -242,8 +244,6 @@
           href: core/howto-create-organizations.md
         - name: Customize application UI
           href: core/howto-customize-ui.md
-        - name: Configure and use file uploads
-          href: core/howto-configure-file-uploads.md
         - name: Integrate with DevOps
           href: core/howto-integrate-with-devops.md
         - name: Manage and monitor in the Azure portal

articles/iot-central/core/howto-configure-file-uploads.md

@@ -1,10 +1,10 @@
 ---
 title: Upload files from devices to Azure storage | Microsoft Docs
-description: How to configure file uploads from your devices to the cloud. After you've configured file uploads, implement file uploads on your devices.
+description: How to configure file uploads from your devices to the cloud. After you've configured file uploads, implement file uploads on your devices, and manage uploads in IoT Central.
 services: iot-central
 author: dominicbetts
 ms.author: dobett
-ms.date: 06/22/2022
+ms.date: 08/25/2022
 ms.topic: how-to
 ms.service: iot-central
 
@@ -14,6 +14,8 @@ ms.service: iot-central
 
 IoT Central lets you upload media and other files from connected devices to cloud storage. You configure the file upload capability in your IoT Central application, and then implement file uploads in your device code.
 
+Optionally, you can manage and preview files uploaded by your devices inside your IoT Central application.
+
 To learn how to upload files by using the IoT Central REST API, see [How to use the IoT Central REST API to upload a file.](../core/howto-upload-file-rest-api.md)
 
 ## Prerequisites
@@ -34,6 +36,8 @@ To configure device file uploads:
 
 1. If necessary, adjust the upload timeout that sets how long an upload request remains valid for. Valid values are from 1 to 24 hours.
 
+1. To enable users to view and manage uploaded files inside IoT Central, set **Enable access** to **On**.
+
 1. Select **Save**. When the status shows **Configured**, you're ready to upload files from devices.
 
 :::image type="content" source="media/howto-configure-file-uploads/file-upload-configuration.png" alt-text="Configure file upload in application":::
@@ -48,10 +52,34 @@ If you want to disable device file uploads to your IoT Central application:
 
 1. Select **Delete**.
 
+## Control access to uploaded files
+
+Use roles and permissions to control who can view and delete uploaded files. To learn more, see [Manage users and roles in your IoT Central application > Managing devices](howto-manage-users-roles.md#managing-devices).
+
 ## Upload a file from a device
 
 IoT Central uses IoT Hub's file upload capability to enable devices to upload files. For sample code that shows you how to upload files from a device, see the [IoT Central file upload device sample](/samples/azure-samples/iot-central-file-upload-device/iotc-file-upload-device/).
 
+## View and manage uploaded files
+
+If you enabled access to files in the file upload configuration, users with the correct permissions can view and delete uploaded files.
+
+> [!IMPORTANT]
+> All the files in the blob container folder associated with a device are visible in the **Files** view for that device. This includes any files that weren't uploaded by the device.
+
+To view and delete uploaded files, navigate to the **Files** view for a device. On this page, you can see thumbnails of the uploaded files and toggle between a gallery and list view. Each file has options to download or delete it:
+
+:::image type="content" source="media/howto-configure-file-uploads/file-upload-list-files.png" alt-text="Screenshot that shows the gallery view for uploaded files.":::
+
+> [!TIP]
+> The file type is determined by the mime type assigned to the file when it was uploaded to blob storage. The default type is `binary/octet-stream`.
+
+You can customize the list view by filtering based on file name and choosing the columns to display.
+
+To preview the content of the file and get more information about the file, select it. IoT Central supports previews of common file types such as text and images:
+
+:::image type="content" source="media/howto-configure-file-uploads/file-upload-preview.png" alt-text="Screenshot that shows a preview of a text file.":::
+
 ## Next steps
 
 Now that you know how to configure and implement device file uploads in IoT Central, a suggested next step is to learn more device file uploads:

articles/iot-central/core/howto-manage-users-roles.md

@@ -140,6 +140,8 @@ When you define a custom role, you choose the set of permissions that a user is
 | Delete | View <br/> Other dependencies: View device templates and device groups  |
 | Execute commands | Update, View <br/> Other dependencies: View device templates and device groups  |
 | View raw data | View <br/> Other dependencies: View device templates and device groups  |
+| View uploaded device files | View <br/> Other dependencies: View device templates and device groups  |
+| Delete uploaded device files | View <br/> Other dependencies: View device templates and device groups  |
 | Full Control | View, Update, Create, Delete, Execute commands, View raw data <br/> Other dependencies: View device templates and device groups  |
 
 **Device groups permissions**