Skip to content

Commit e4b3b6b

Browse files
authored
Live publish for 05 November 2019.
2 parents bee698c + 5b8f1ed commit e4b3b6b

File tree

3 files changed

+163
-52
lines changed

3 files changed

+163
-52
lines changed

powerapps-docs/breadcrumb/toc.yml

Lines changed: 41 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -2,50 +2,51 @@
22
href: /
33
topicHref: /
44
items:
5-
- name: PowerApps
6-
tocHref: /powerapps/
7-
topicHref: /powerapps/
5+
- name: Power Platform
6+
href: /power-platform/
7+
topichref: /power-platform/
88
items:
9-
# Adding Create app for each type of app
10-
- name: Create apps
11-
tocHref: /powerapps/maker/common-data-service/
12-
topicHref: /powerapps/maker/index
13-
- name: Create apps
14-
tocHref: /powerapps/maker/model-driven-apps/
15-
topicHref: /powerapps/maker/index
16-
- name: Create apps
17-
tocHref: /powerapps/maker/canvas-apps/
18-
topicHref: /powerapps/maker/index
19-
# Make sure Create apps appears for topics in developer folder
20-
- name: Create apps
21-
tocHref: /powerapps/developer/common-data-service/
22-
topicHref: /powerapps/maker/index
23-
items:
24-
- name: Common Data Service
9+
- name: PowerApps
10+
tocHref: /powerapps/
11+
topicHref: /powerapps/
12+
items:
13+
# Adding Create app for each type of app
14+
- name: Create apps
15+
tocHref: /powerapps/maker/common-data-service/
16+
topicHref: /powerapps/maker/index
17+
- name: Create apps
18+
tocHref: /powerapps/maker/model-driven-apps/
19+
topicHref: /powerapps/maker/index
20+
- name: Create apps
21+
tocHref: /powerapps/maker/canvas-apps/
22+
topicHref: /powerapps/maker/index
23+
# Make sure Create apps appears for topics in developer folder
24+
- name: Create apps
2525
tocHref: /powerapps/developer/common-data-service/
26-
topicHref: /powerapps/maker/common-data-service/index
27-
items:
28-
- name: Developer
26+
topicHref: /powerapps/maker/index
27+
items:
28+
- name: Common Data Service
2929
tocHref: /powerapps/developer/common-data-service/
30-
topicHref: /powerapps/developer/common-data-service/index
30+
topicHref: /powerapps/maker/common-data-service/index
3131
items:
32-
- name: Organization Service
33-
tocHref: /powerapps/developer/common-data-service/org-service/
34-
topicHref: /powerapps/developer/common-data-service/org-service/index
35-
- name: Web API
36-
tocHref: /powerapps/developer/common-data-service/webapi/
37-
topicHref: /powerapps/developer/common-data-service/webapi/index
38-
- name: Create apps
39-
tocHref: /powerapps/developer/model-driven-apps/
40-
topicHref: /powerapps/maker/index
41-
items:
42-
- name: Model-driven apps
32+
- name: Developer
33+
tocHref: /powerapps/developer/common-data-service/
34+
topicHref: /powerapps/developer/common-data-service/index
35+
items:
36+
- name: Organization Service
37+
tocHref: /powerapps/developer/common-data-service/org-service/
38+
topicHref: /powerapps/developer/common-data-service/org-service/index
39+
- name: Web API
40+
tocHref: /powerapps/developer/common-data-service/webapi/
41+
topicHref: /powerapps/developer/common-data-service/webapi/index
42+
- name: Create apps
4343
tocHref: /powerapps/developer/model-driven-apps/
44-
topicHref: /powerapps/maker/model-driven-apps/index
44+
topicHref: /powerapps/maker/index
4545
items:
46-
- name: Developer
46+
- name: Model-driven apps
4747
tocHref: /powerapps/developer/model-driven-apps/
48-
topicHref: /powerapps/developer/model-driven-apps/index
49-
- name: Guided Learning
50-
tocHref: /powerapps/guided-learning/
51-
topicHref: /powerapps/guided-learning/index
48+
topicHref: /powerapps/maker/model-driven-apps/index
49+
items:
50+
- name: Developer
51+
tocHref: /powerapps/developer/model-driven-apps/
52+
topicHref: /powerapps/developer/model-driven-apps/index

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-Navigation/navigateTo.md

Lines changed: 85 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "navigateTo (Client API reference) in model-driven apps| MicrosoftDocs"
3-
ms.date: 10/4/2019
3+
ms.date: 11/04/2019
44
ms.service: powerapps
55
ms.topic: "reference"
66
author: "KumarVivek"
@@ -23,15 +23,93 @@ search.app:
2323
2424
## Syntax
2525

26-
`Xrm.Navigation.navigateTo(pageInput).then(successCallback,errorCallback);`
26+
`Xrm.Navigation.navigateTo(pageInput,navigationOptions).then(successCallback,errorCallback);`
2727

2828
## Parameters
2929

30-
|Name |Type |Required |Description |
31-
|---|---|---|---|
32-
|pageInput|Object|Yes|Input about the page to navigate to. The object contains the following attributes:<br/>- **pageType**: String. Specify "entitylist".<br/>- **entityName**: String. The logical name of the entity to load in the list control. <br/>- **viewId**: (Optional) String. The ID of the view to load. If you don't specify it, navigates to the default main view for the entity.<br/>- **viewType**: (Optional) String. Type of view to load. Specify "savedquery" or "userquery".|
33-
|successCallback|function|No|A function to execute on successful navigation to page.|
34-
|errorCallback|function|No|A function to execute when the operation fails.|
30+
<table style="width:100%">
31+
<tr>
32+
<th>Name</th>
33+
<th>Type</th>
34+
<th>Required</th>
35+
<th>Description</th>
36+
</tr>
37+
<tr>
38+
<td>pageInput</td>
39+
<td>Object</td>
40+
<td>Yes</td>
41+
<td><p>Input about the page to navigate to. The object definition changes depending on the type of page to navigate to: <i>entity list</i> or <i>HTML web resource</i>.</p>
42+
<p><strong>entity list</strong>
43+
<p>The object contains the following attributes:</p>
44+
<ul>
45+
<li><strong>pageType</strong>: String. Specify "entitylist".</li>
46+
<li><strong>entityName</strong>: String. The logical name of the entity to load in the list control.</li>
47+
<li><strong>viewId</strong>: (Optional) String. The ID of the view to load. If you don't specify it, navigates to the default main view for the entity.</li>
48+
<li><strong>viewType</strong>: (Optional) String. Type of view to load. Specify "savedquery" or "userquery".</li>
49+
</ul>
50+
<p><strong>HTML web resource</strong>
51+
<p>The object contains the following attributes:</p>
52+
<ul>
53+
<li><strong>pageType</strong>: String. Specify "webresource".</li>
54+
<li><strong>webresourceName</strong>: String. The name of the web resource to load.</li>
55+
<li><strong>data</strong>: (Optional) String. The data to pass to the web resource.</li>
56+
</ul></td>
57+
</tr>
58+
<tr>
59+
<td>navigationOptions</td>
60+
<td>Object</td>
61+
<td>No</td>
62+
<td><p>Options for navigating to a page: whether to open inline or in a dialog. If you don't specify this parameter, page is opened inline by default. The object contains the following attributes:</p>
63+
<ul>
64+
<li><strong>target</strong>: Number. Specify <strong>1</strong> to open the page inline; <strong>2</strong> to open the page in a dialog. <br/><i>Entity lists</i> can only be opened inline; <i>web resources</i> can be opened either inline or in a dialog.</li>
65+
<li><strong>width</strong>: (Optional) Number or Object. The width of dialog. To specify the width in pixels, just type a numeric value. To specify the width in percentage, specify an object of type <b>SizeValue</b> with the following properties:
66+
<ul><li><b>value</b>: Number. The numerical value.</li>
67+
<li><b>unit</b>: String. The unit of measurement. Specify "%" or "px". Default value is "px".</li></ul></li>
68+
<li><strong>height</strong>: (Optional) Number or Object. The height of dialog. To specify the height in pixels, just type a numeric value. To specify the width in percentage, specify an object of type <b>SizeValue</b> with the following properties:
69+
<ul><li><b>value</b>: Number. The numerical value.</li>
70+
<li><b>unit</b>: String. The unit of measurement. Specify "%" or "px". Default value is "px".</li></ul></li>
71+
<li><strong>position</strong>: (Optional) Number. Specify <strong>1</strong> to open the dialog in center; <strong>2</strong> to open the dialog on the side. Default is 1 (center).</li>
72+
</ul></td>
73+
</tr>
74+
<tr>
75+
<td>successCallback</td>
76+
<td>function</td>
77+
<td>No</td>
78+
<td><p>A function to execute on successful navigation to the page when navigating inline and on closing the dialog when navigating to a dialog.</p></td>
79+
</tr>
80+
<tr>
81+
<td>errorCallback</td>
82+
<td>Function</td>
83+
<td>No</td>
84+
<td><p>A function to execute when the operation fails.</p></td>
85+
</tr>
86+
</table>
87+
88+
## Example
89+
90+
The following example demonstrates how to navigate to an HTML web resource that is opened in a dialog:
91+
92+
```javascript
93+
var pageInput = {
94+
pageType: "webresource",
95+
webresourceName: "new_sample_webresource"
96+
};
97+
var navigationOptions = {
98+
target: 2,
99+
width: 400,
100+
height: 300,
101+
position: 1
102+
};
103+
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
104+
function success() {
105+
// Handle dialog closed
106+
},
107+
function error() {
108+
// Handle errors
109+
}
110+
);
111+
```
112+
35113

36114

37115
### Related topics

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

Lines changed: 37 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,24 @@ 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+
<!--
182+
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).
183+
184+
185+
### Add an image field to an entity using the PowerApps site
186+
187+
[!INCLUDE [cc-beta-prerelease-disclaimer](../../includes/cc-beta-prerelease-disclaimer.md)]
188+
189+
1. Sign in to [PowerApps](https://web.powerapps.com/?utm_source=padocs&utm_medium=linkinadoc&utm_campaign=referralsfromdoc).
190+
2. Select **Data** > **Entities** and then select the entity where you want to add an image field.
191+
3. Select **Add field** on the command bar, enter the following properties, and then select **Done**:
192+
- **Display name**. Enter a friendly name for the field.
193+
- **Data type**. Select **Image**.
194+
- **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.
195+
- **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.
196+
- **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. -->
180197

181198
### Add image support for a form in a custom entity using solution explorer
182199
1. Open [solution explorer](../model-driven-apps/advanced-navigation.md#solution-explorer).
@@ -186,7 +203,8 @@ When an image is uploaded, it will be resized to a maximum size of 144 pixels by
186203
5. Enter a **Display Name**, such as *Custom entity image*.
187204
6. Complete the remaining fields as appropriate. Notice that the **Name**, **Field Requirement**, and **Searchable** fields can’t be changed. Select **Save and Close**.
188205
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)
206+
> [!div class="mx-imgBorder"]
207+
> ![Primary image property selected](media/primary-image-property.png "Primary image property selected")
190208
191209
8. Open the form where you want image support, such as the entity main form.
192210
9. On the form editor ribbon, select **Form Properties**.
@@ -202,7 +220,9 @@ App users can now select the image to display on the form. When an app user open
202220
> [!IMPORTANT]
203221
> 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.
204222
205-
#### Change the image for a record
223+
### Change the image for a record
224+
Once an entity form has an image field, app users can change the image for a given record.
225+
206226
1. Open the app that includes the entity form, and then select the image on the form.
207227
> [!div class="mx-imgBorder"]
208228
> ![Default entity image](../common-data-service/media/default-entity-image-on-form.png "Default entity image")
@@ -215,3 +235,15 @@ App users can now select the image to display on the form. When an app user open
215235
More information for developers working with image data:
216236
- [Entity metadata > Entity images](/powerapps/developer/common-data-service/entity-metadata#entity-images)
217237
- [Image attributes](/powerapps/developer/common-data-service/image-attributes)
238+
239+
240+
## File fields
241+
[!INCLUDE [cc-beta-prerelease-disclaimer](../../includes/cc-beta-prerelease-disclaimer.md)]
242+
243+
Currently, the file data type is only available to canvas apps and flows.
244+
245+
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.
246+
247+
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.
248+
249+
More information for developers working with file data: [File attributes](/powerapps/developer/common-data-service/file-attributes)

0 commit comments

Comments
 (0)