Skip to content

Commit e4319f8

Browse files
authored
Merge pull request MicrosoftDocs#3164 from MicrosoftDocs/matp-githubissue-1580
Revised per https://github.com/MicrosoftDocs/powerapps-docs/issues/1580
2 parents 26b155a + 6442662 commit e4319f8

File tree

2 files changed

+13
-7
lines changed

2 files changed

+13
-7
lines changed

powerapps-docs/maker/common-data-service/create-edit-field-portal.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Create and edit fields for Common Data Service using Power Apps portal | MicrosoftDocs"
33
ms.custom: ""
4-
ms.date: 08/13/2019
4+
ms.date: 07/22/2020
55
ms.reviewer: ""
66
ms.service: powerapps
77
ms.suite: ""
@@ -54,7 +54,7 @@ Initially, just three field properties are available:
5454
|**Display Name**|The text to be displayed for the field in the user interface.|
5555
|**Name**|The unique name across your environment. A name will be generated for you based on the display name that you've entered, but you can edit it before saving. Once a field is created the name cannot be changed as it may be referenced in your applications or code. The name will have the customization prefix for your **Common Data Service Default Publisher** prepended to it.|
5656
|**Data type**|Controls how values are stored as well as how they are formatted in some applications. Once a field is saved, you cannot change the data type with the exception of converting text fields to autonumber fields.|
57-
|**Required**| A record can't be saved without data in this field. |
57+
|**Required**| A record can't be saved without data in this field. More information: [Saving records programmatically for required fields](#saving-records-programmatically-for-required-fields) |
5858
|**Searchable**| This field appears in Advanced Find and is available when customizing views. |
5959
|**Calculated or Rollup**| Use to automate manual calculations. Use values, dates, or text.|
6060
|**Advanced Options**| Add a description, and specify a maximum length and IME mode for the field.
@@ -148,17 +148,21 @@ Every field has the following properties you can change:
148148

149149
|Property|Description|
150150
|--|--|
151-
|**Required**|When this is selected a record can't be saved without data in this field.|
151+
|**Required**|When this is selected a record can't be saved without data in this field. More information: [Saving records programmatically for required fields](#saving-records-programmatically-for-required-fields) |
152152
|**Searchable**|De-select this for fields for the entity that you don’t use. When a field is searchable it appears in **Advanced Find** and is available when customizing views. De-selecting this will reduce the number of options shown to people using advanced find.|
153153
|**Description**|Found within **Advanced Options**. Enter instructions to the user about what the field is for. These descriptions appear as tooltips for the user in model-driven apps when they hover their mouse over the label of the field.|
154154

155155
> [!NOTE]
156-
> **Making fields required**: Be careful when you make fields required. People will resist using the application if they can’t save records because they lack the correct information to enter into a required field. People may enter incorrect data simply to save the record and get on with their work.
156+
>**Making fields required**: Be careful when you make fields required. People will resist using the application if they can’t save records because they lack the correct information to enter into a required field. People may enter incorrect data simply to save the record and get on with their work.
157157
>
158158
>**Set requirement dynamically**: In model-driven apps you can use business rules or form scripts to change the requirement level as the data in the record changes as people work on it. More information: [Create business rules and recommendations to apply logic in a form](../model-driven-apps/create-business-rules-recommendations-apply-logic-form.md)
159159
>
160160
>**Advanced Find availability**: Advanced Find is currently only available for model-driven apps using the Web Client. Advanced find is not currently available in Unified Interface clients.
161161
162+
### Saving records programmatically for required fields
163+
When a record is saved programmatically using web services, only the SystemRequired fields are enforced. Failure to set a value for SystemRequired fields will return an error. You can’t set the SystemRequired level of requirement.
164+
165+
Setting a field to Business Required means that the default behavior of a model-driven or canvas app will enforce this requirement in the app. The request will not be sent to the service if the field has no value. The app user is shown an error and prompted to add data to the required field before they can save the record. There are options within the app to override this behavior and allow operation to proceed if needed.
162166
## Calculated or Rollup
163167

164168
You can set a custom field to be a **Calculated** or a **Rollup** field. Fields that are not calculated or rollup fields are sometimes referred to as *simple* fields.

powerapps-docs/maker/common-data-service/create-edit-field-solution-explorer.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Create and edit fields for Common Data Service using Power Apps solution explorer | MicrosoftDocs"
33
ms.custom: ""
4-
ms.date: 05/18/2018
4+
ms.date: 07/22/2020
55
ms.reviewer: ""
66
ms.service: powerapps
77
ms.suite: ""
@@ -82,9 +82,11 @@ You can set additional options depending on your choice of **Data type**. More i
8282
There are three field requirement options:
8383
- **Optional**: The record can be saved even if there is no data in this field.
8484
- **Business Recommended**: The record can be saved even if there is no data in this field. However, a blue symbol appears next to the field to indicate it is important.
85-
- **Business Required**: The record can’t be saved if there is no data in this field.
85+
- **Business Required**: The record can’t be saved if there is no data in this field.
86+
8687
> [!NOTE]
87-
> Be careful when you make fields business required. People will resist using the application if they can’t save records because they lack the correct information to enter into a required field. People may enter incorrect data simply to save the record and get on with their work. You can use business rules or form scripts to change the requirement level as the data in the record changes as people work on it. More information [Create business rules and recommendations to apply logic in a form](../model-driven-apps/create-business-rules-recommendations-apply-logic-form.md)
88+
> - When a record is saved programmatically using web services, only the SystemRequired fields are enforced. Failure to set a value for SystemRequired fields will return an error. You can’t set the SystemRequired level of requirement. <br />Setting a field to Business Required means that the default behavior of a model-driven or canvas app will enforce this requirement in the app. The request will not be sent to the service if the field has no value. The app user is shown an error and prompted to add data to the required field before they can save the record. There are options within the app to override this behavior and allow operation to proceed if needed.
89+
> - Be careful when you make fields business required. People will resist using the application if they can’t save records because they lack the correct information to enter into a required field. People may enter incorrect data simply to save the record and get on with their work. You can use business rules or form scripts to change the requirement level as the data in the record changes as people work on it. More information [Create business rules and recommendations to apply logic in a form](../model-driven-apps/create-business-rules-recommendations-apply-logic-form.md)
8890
8991
## Field Data types
9092

0 commit comments

Comments
 (0)