Skip to content

Commit fe987a2

Browse files
committed
Adding new section for File data type that is now available in NA datacenters
1 parent 5171dc6 commit fe987a2

File tree

1 file changed

+36
-5
lines changed

1 file changed

+36
-5
lines changed

powerapps-docs/maker/common-data-service/types-of-fields.md

Lines changed: 36 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ The names used for types depends on the designer used. [PowerApps portal](https:
3737
|**Decimal Number**|**Decimal Number**|`DecimalType`|
3838
|**Duration**|**Whole Number**<br />*Duration* Format|`IntegerType`|
3939
|**Email**|**Single Line of Text**<br />*Email* Format|`StringType`|
40+
|**File** | **File** | `FileType` |
4041
|**Floating Point Number**|**Floating Point Number**|`DoubleType`|
4142
|**Image**|**Image**|`ImageType`|
4243
|**Language**|**Whole Number**<br />*Language* Format|`IntegerType`|
@@ -152,7 +153,6 @@ However, you should be aware that not every lookup behaves this way. There are s
152153
<a name="BKMK_ImageFields"></a>
153154

154155
## Image fields
155-
156156
Use image fields to display a single image per record in the application. Each entity can have one image field. You can add an image field to custom entities but not to standard entities. Some standard entities have image fields defined.
157157

158158
Even though an entity has an image field, displaying that image in a model-driven app requires that you enable two settings.
@@ -164,7 +164,7 @@ When image display is enabled for an entity, any records that don’t have an im
164164
> [!div class="mx-imgBorder"]
165165
> ![Default entity image](../common-data-service/media/account-record-default-image.png "Default account entity image")
166166
167-
People can choose the default image to upload a picture from their computer. Images must be less than 5120 KB and must be in one of the following formats:
167+
People can choose the default image to upload a picture from their computer. Images must be less than 10 MB and must be in one of the following formats:
168168

169169
- jpg
170170
- jpeg
@@ -176,7 +176,23 @@ People can choose the default image to upload a picture from their computer. Ima
176176

177177
When the image is uploaded, it will be converted to a .jpg format and all downloaded images will also use this format. If an animated .gif is uploaded, only the first frame is saved.
178178

179-
When an image is uploaded, it will be resized to a maximum size of 144 pixels by 144 pixels. People should resize or crop the images before they upload them so that they will display well using this size. All images are cropped to be square. If both sides of an image are smaller than 144 pixels, the image will be cropped to be a square with the dimensions of the smaller side.
179+
When an image is uploaded, it will be resized as a "thumbnail" image to a maximum size of 144 pixels by 144 pixels. People should resize or crop the images before they upload them so that they will display well using this size. All images are cropped to be square. If both sides of an image are smaller than 144 pixels, the image will be cropped to be a square with the dimensions of the smaller side.
180+
181+
By default, when an app user adds an image to display to a form or canvas app, the image displayed is the thumbnail image. To display a full image for a canvas app, see [Display a full-sized image on a canvas app form](../canvas-apps/display-full-image-on-form.md).
182+
183+
<!--
184+
### Add an image field to an entity using the PowerApps site
185+
186+
[!INCLUDE [cc-beta-prerelease-disclaimer](../../includes/cc-beta-prerelease-disclaimer.md)]
187+
188+
1. Sign in to [PowerApps](https://web.powerapps.com/?utm_source=padocs&utm_medium=linkinadoc&utm_campaign=referralsfromdoc).
189+
2. Select **Data** > **Entities** and then select the entity where you want to add an image field.
190+
3. Select **Add field** on the command bar, enter the following properties, and then select **Done**:
191+
- **Display name**. Enter a friendly name for the field.
192+
- **Data type**. Select **Image**.
193+
- **Primary image**. When selected, the primary image field becomes the image field for the entity. You can only have one primary image for each entity.
194+
- **Maximum image size**. The maximum file size that an app user can upload to the record. 10,240 KB is the default maximum size and 10 MB is the maximum size limit.
195+
- **Can store full images**. When selected, in addition to the rescaled thumbnail image described earlier, the full image is stored when uploaded by the user for each record. Full size images are limited to 30 MB. -->
180196

181197
### Add image support for a form in a custom entity using solution explorer
182198
1. Open [solution explorer](../model-driven-apps/advanced-navigation.md#solution-explorer).
@@ -186,7 +202,8 @@ When an image is uploaded, it will be resized to a maximum size of 144 pixels by
186202
5. Enter a **Display Name**, such as *Custom entity image*.
187203
6. Complete the remaining fields as appropriate. Notice that the **Name**, **Field Requirement**, and **Searchable** fields can’t be changed. Select **Save and Close**.
188204
7. On the entity definition next to the **Primary Image** property make sure the value is set to the custom image you created in the previous step. If it's not select it.
189-
![Primary image property selected](media/primary-image-property.png)
205+
> [!div class="mx-imgBorder"]
206+
> ![Primary image property selected](media/primary-image-property.png "Primary image property selected")
190207
191208
8. Open the form where you want image support, such as the entity main form.
192209
9. On the form editor ribbon, select **Form Properties**.
@@ -202,7 +219,9 @@ App users can now select the image to display on the form. When an app user open
202219
> [!IMPORTANT]
203220
> If the record is a new record that hasn’t been saved the error Invalid Argument is returned when you try to change the image.
204221
205-
#### Change the image for a record
222+
### Change the image for a record
223+
Once an entity form has an image field, app users can change the image for a given record.
224+
206225
1. Open the app that includes the entity form, and then select the image on the form.
207226
> [!div class="mx-imgBorder"]
208227
> ![Default entity image](../common-data-service/media/default-entity-image-on-form.png "Default entity image")
@@ -215,3 +234,15 @@ App users can now select the image to display on the form. When an app user open
215234
More information for developers working with image data:
216235
- [Entity metadata > Entity images](/powerapps/developer/common-data-service/entity-metadata#entity-images)
217236
- [Image attributes](/powerapps/developer/common-data-service/image-attributes)
237+
238+
239+
## File fields
240+
[!INCLUDE [cc-beta-prerelease-disclaimer](../../includes/cc-beta-prerelease-disclaimer.md)]
241+
242+
Currently, the file data type is only available to canvas apps and flows.
243+
244+
The **File** field is used for storing binary data. The primary intended use of this field is to store a single image, note, or attachment. However, storage of other forms of binary data is also possible. One or more fields of this data type can be added to an existing standard customizable entity or a custom entity.
245+
246+
The default **Maximum file size** is 32 MB and the largest size you can set is 128 MB. The file size limit can be set individually for each field of file type added to an entity.
247+
248+
More information for developers working with file data: [File attributes](/powerapps/developer/common-data-service/file-attributes)

0 commit comments

Comments
 (0)