Merge branch 'master' into 2110535

Author: tapanm-MSFT

powerapps-docs/developer/common-data-service/create-auto-number-attributes.md

@@ -1,7 +1,7 @@
 ---
-title: "Create auto-number attributes (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
-description: "Learn about creating auto-number attribute in the same way you create a string attribute using the StringAttributeMetadata class except that you use the new AutoNumberFormat property. Use the AutoNumberFormat property to define a pattern that includes sequential numbers and random strings by composing placeholders, which indicates the length and type of values that are generated."
-keywords: "Auto-number attributes" # 115-145 characters including spaces. This abstract displays in the search result.
+title: "Create autonumber attributes (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
+description: "Learn about creating autonumber attribute in the same way you create a string attribute using the StringAttributeMetadata class except that you use the new AutoNumberFormat property. Use the AutoNumberFormat property to define a pattern that includes sequential numbers and random strings by composing placeholders, which indicates the length and type of values that are generated."
+keywords: "Autonumber attributes" # 115-145 characters including spaces. This abstract displays in the search result.
 ms.custom: ""
 ms.date: 07/24/2019
 ms.reviewer: "pehecke"
@@ -16,28 +16,28 @@ search.app:
   - PowerApps
   - D365CE
 ---
-# Create auto-number attributes
+# Create autonumber attributes
 
 [!INCLUDE[cc-data-platform-banner](../../includes/cc-data-platform-banner.md)]
 
-With Microsoft Dataverse, you can add an auto-number attribute for any entity. Currently, you can add the attribute programmatically. There is no user interface to add this type of attribute. The topic explains how you can programmatically create an auto-number attribute and set a seed value for sequential elements. In addition, the topic shows how to set the sequence number for the next record if you need to reset the seed at any time later.
+With Microsoft Dataverse, you can add an autonumber attribute for any entity. Currently, you can add the attribute programmatically. The topic explains how you can programmatically create an autonumber attribute and set a seed value for sequential elements. In addition, the topic shows how to set the sequence number for the next record if you need to reset the seed at any time later.
 > [!NOTE]
 >The setting of the seed is optional. There is no need to call the seed if you don’t need to reseed.
 
 
-You can create an auto-number attribute in the same way you create a string attribute using the **StringAttributeMetadata** class except that you use the new **AutoNumberFormat** property. Use the **AutoNumberFormat** property to define a pattern that includes sequential numbers and random strings by composing placeholders, which indicates the length and type of values that are generated. The random strings help you to avoid duplicates or collisions, especially when offline clients trying to create auto-numbers.
+You can create an autonumber attribute in the same way you create a string attribute using the **StringAttributeMetadata** class except that you use the new **AutoNumberFormat** property. Use the **AutoNumberFormat** property to define a pattern that includes sequential numbers and random strings by composing placeholders, which indicates the length and type of values that are generated. The random strings help you to avoid duplicates or collisions, especially when offline clients trying to create autonumbers.
 
-When creating an auto-number attribute, the **StringAttributeMetadata.FormatName** property or the **StringAttributeMetadata.Format** property values must be Text. Since these are the default values you will typically not set this property. You cannot create an auto-number attribute that uses any other special kind of format such as Email, Phone, TextArea, Url or any other [existing formats](https://msdn.microsoft.com/library/microsoft.xrm.sdk.metadata.stringformatname.aspx).
+When creating an autonumber attribute, the **StringAttributeMetadata.FormatName** property or the **StringAttributeMetadata.Format** property values must be Text. Since these are the default values you will typically not set this property. You cannot create an autonumber attribute that uses any other special kind of format such as Email, Phone, TextArea, Url or any other [existing formats](https://msdn.microsoft.com/library/microsoft.xrm.sdk.metadata.stringformatname.aspx).
 
 The sequential segment is generated by SQL and hence uniqueness is guaranteed by SQL.
 
 > [!NOTE]
->You can modify an existing format text attribute to be an auto-number format.
+>You can modify an existing format text attribute to be an autonumber format.
 
-In the legacy web client, when adding a control on a form bound to an auto-number attribute, the control is disabled automatically and behaves as read-only in the form where end-users cannot edit the control. In the Unified Interface, controls bound to an auto-number attribute need to explicitly be set as disabled. If you do not set the initial attribute value on the form, the value is set only after you save the entity. Auto-numbering can be applied to attribute field values in views, grids and so on.
+In the legacy web client, when adding a control on a form bound to an autonumber attribute, the control is disabled automatically and behaves as read-only in the form where end-users cannot edit the control. In the Unified Interface, controls bound to an autonumber attribute need to explicitly be set as disabled. If you do not set the initial attribute value on the form, the value is set only after you save the entity. Autonumbering can be applied to attribute field values in views, grids and so on.
 
 ### Examples
-The following examples show how to create a new auto-number attribute named **new\_SerialNumber** for a custom entity named **new\_Widget** which will have a value that looks like this: **WID-00001-AB7LSFG-20170913070240**.
+The following examples show how to create a new autonumber attribute named **new\_SerialNumber** for a custom entity named **new\_Widget** which will have a value that looks like this: **WID-00001-AB7LSFG-20170913070240**.
 Using the Organization service with SDK assemblies **CreateAttributeRequest** and **StringAttributeMetadata** classes:
 
 ```csharp
@@ -155,28 +155,28 @@ The table shows the string length value for the random and sequential placeholde
   <tr>
     <td><code>{RANDSTRING:MIN_LENGTH}</code></td>
     <td>The value of <b>MIN_LENGTH</b> is between 1 and 6.</td>
-     <td>When you save the entity, the auto-number attribute generates the random string with the defined length if the value is between 1 and 6. If you use the <b>MIN_LENGTH</b> value as 7 or beyond 7, you get to see an Invalid Argument error.</td>
+     <td>When you save the entity, the autonumber attribute generates the random string with the defined length if the value is between 1 and 6. If you use the <b>MIN_LENGTH</b> value as 7 or beyond 7, you get to see an Invalid Argument error.</td>
   </tr>
   <tr>
     <td><code>{SEQNUM:MIN_LENGTH}</code></td>
     <td>The minimum value of the <b>MIN_LENGTH</b> is 1. The number continues to increment beyond the minimum length.</td>
-    <td>When you save the entity, the auto-number attribute works fine and continue to work fine for larger values of <b>MIN_LENGTH</b>.</td></table>
+    <td>When you save the entity, the autonumber attribute works fine and continue to work fine for larger values of <b>MIN_LENGTH</b>.</td></table>
 
-For sequential value placeholders, the **MIN_LENGTH** is a minimum length. If you set the value to be 2, the initial value will be 01, and the 100th entity value will be 100. The number will continue to increment beyond the minimum length. The value in setting the length for sequential values is to establish a consistent length for the auto-generated value by adding additional 0s to the initial value. It will not limit the absolute value. Random value placeholders will always be the same length.
+For sequential value placeholders, the **MIN_LENGTH** is a minimum length. If you set the value to be 2, the initial value will be 01, and the 100th entity value will be 100. The number will continue to increment beyond the minimum length. The value in setting the length for sequential values is to establish a consistent length for the autogenerated value by adding additional 0s to the initial value. It will not limit the absolute value. Random value placeholders will always be the same length.
 
 Because the sequential values can get larger than the minimum length allotted for them, you should not adjust the **StringAttributeMetadata.MaxLength** property to match the length of your formatted value. There is little value in doing this and it could cause an error in the future if the value exceeds the **MaxLength** value. Make sure you leave enough room for a realistic range of sequential values.
 
 > [!NOTE]
 > There is no validation of the placeholder values when you create the attribute. The error appears only when you try to save an entity instance that uses an incorrectly configured **AutoNumberFormat** value.
-> For example, if you specify the length of the random string more than 6, the first person creating a new entity instance gets an **Invalid Argument** error when they first try to save the entity containing the new auto-number attribute.
+> For example, if you specify the length of the random string more than 6, the first person creating a new entity instance gets an **Invalid Argument** error when they first try to save the entity containing the new autonumber attribute.
 
-## Update auto-number attributes
+## Update autonumber attributes
 
-If you create an auto-number attribute with an incorrect configuration or you want to modify an existing auto-number attribute, you can update the attribute the **AutoNumberFormat** value.
+If you create an autonumber attribute with an incorrect configuration or you want to modify an existing autonumber attribute, you can update the attribute the **AutoNumberFormat** value.
 
-The following code snippet explains you to retrieve, modify, and update the auto-number attribute.
+The following code snippet explains you to retrieve, modify, and update the autonumber attribute.
 
-To modify an existing auto-number attribute, you must retrieve the attribute using the **RetrieveAttributeRequest** class.
+To modify an existing autonumber attribute, you must retrieve the attribute using the **RetrieveAttributeRequest** class.
 
 ```csharp
 // Create the retrieve request
@@ -190,14 +190,14 @@ RetrieveAttributeRequest attributeRequest = new RetrieveAttributeRequest
 RetrieveAttributeResponse attributeResponse = (RetrieveAttributeResponse)_serviceProxy.Execute(attributeRequest);
 ```
 
-After retrieving the auto-number attribute, you need to modify and update the attribute.
+After retrieving the autonumber attribute, you need to modify and update the attribute.
 
 ```csharp            
-//Modify the retrieved auto-number attribute
+//Modify the retrieved autonumber attribute
 AttributeMetadata retrievedAttributeMetadata = attributeResponse.AttributeMetadata;
 retrievedAttributeMetadata.AutoNumberFormat = "CAR-{RANDSTRING:5}{SEQNUM:6}"; //Modify the existing attribute by writing the format as per your requirement 
 
-// Update the auto-number attribute            
+// Update the autonumber attribute            
 UpdateAttributeRequest updateRequest = new UpdateAttributeRequest
                         {
                             Attribute = retrievedAttributeMetadata,
@@ -209,10 +209,10 @@ _serviceProxy.Execute(updateRequest);
 
 ## Set a seed value
 
-By default, all auto-number sequential values start with 1000 and use 0 as the prefix depending on the length. In this way, the length of the value is always same. If you want to change the initial value, you need to change the initial seed value using the API below to set the next number that are used for the sequential segment.
+By default, all autonumber sequential values start with 1000 and use 0 as the prefix depending on the length. In this way, the length of the value is always same. If you want to change the initial value, you need to change the initial seed value using the API below to set the next number that are used for the sequential segment.
 
 For example, when the length of the sequential number is 5, you may want to start with an initial value of 10000 instead of the default value of 00001. 
-If you want to choose a different starting value after creating the auto-numbering attribute, use the **SetAutoNumberSeed** message. Use the **SetAutoNumberSeedRequest** class when using the SDK assemblies and **SetAutoNumberSeed** action when using the Web API.
+If you want to choose a different starting value after creating the autonumbering attribute, use the **SetAutoNumberSeed** message. Use the **SetAutoNumberSeedRequest** class when using the SDK assemblies and **SetAutoNumberSeed** action when using the Web API.
 
 The **AutoNumberSeed** message has the following parameters:
 
@@ -221,13 +221,13 @@ The **AutoNumberSeed** message has the following parameters:
 |:----------|:----------|:----------|
 |EntityName|string|The logical name of the entity that contains the attribute you want to set the seed on.|
 |AttributeName|string|The logical name of the attribute you want to set the seed on.|
-|Value|int|Next auto-number value for the attribute.|
+|Value|int|Next autonumber value for the attribute.|
 
 > [!NOTE]
 > Setting the seed only changes the **current number value** for the specified attribute in the current environment. It does not imply a common **start value** for the attribute. The seed value is not included in a solution when installed in a different environments. To set the starting number after a solution import, use **SetAutoNumberSeed** message in the target environment.
 
 ### Examples
-The following samples set the seed to 10000 for an auto-number attribute named **new\_SerialNumber** for a custom entity named **new\_Widget**.
+The following samples set the seed to 10000 for an autonumber attribute named **new\_SerialNumber** for a custom entity named **new\_Widget**.
 
 Using the Organization service with SDK assemblies **SetAutoNumberSeedRequest** class:
 ```csharp
@@ -268,7 +268,7 @@ OData-Version: 4.0
 
 ### Auto Number Manager
 
-**[Auto Number Manager](https://www.xrmtoolbox.com/plugins/Rappen.XrmToolBox.AutoNumManager/)** for XrmToolBox is a community driven tool for Dataverse that provides a UI to set, update and remove auto number format on new or existing attributes.
+**[Auto Number Manager](https://www.xrmtoolbox.com/plugins/Rappen.XrmToolBox.AutoNumManager/)** for XrmToolBox is a community driven tool for Dataverse that provides a UI to set, update and remove autonumber format on new or existing attributes.
 Please see the [Developer tools](developer-tools.md) topic for community developed tools and [anm.xrmtoolbox.com](https://anm.xrmtoolbox.com) for more information about Auto Number Manager.
 
 > [!NOTE]

powerapps-docs/developer/common-data-service/entity-metadata.md

@@ -15,19 +15,14 @@ ms.tgt_pltfrm: na
 ms.workload: na
 ms.date: 10/31/2018
 ms.author: jdaly
+ms.reviewer: phecke
 search.audienceType: 
   - developer
 search.app: 
   - PowerApps
   - D365CE
 ---
-<!-- 
-Was Mike Carter
-This topic was not migrated it was written for Power Apps 
 
-Overlap with content in https://docs.microsoft.com/dynamics365/customer-engagement/developer/introduction-entities
-
--->
 # Entity metadata
 
 [!INCLUDE[cc-data-platform-banner](../../includes/cc-data-platform-banner.md)]
@@ -44,13 +39,12 @@ Each entity has a unique name defined when it is created. This name is presented
 |`LogicalName`|All lower-case version of the schema name. i.e. account|
 |`LogicalCollectionName`|All lower-case version of the collection schema name. i.e. accounts|
 |`EntitySetName`|Used to identify collections with the Web API. By default, it is the same as the logical collection name.<br />It is possible to change the Entity Set name by programmatically updating the metadata. But this should only be done before any Web API code is written for the entity. More information: [Web API types and operations > Change the name of an entity set](/dynamics365/customer-engagement/developer/webapi/web-api-types-operations#change-the-name-of-an-entity-set)|
-
-> [!NOTE]
+>[!NOTE]
+>`EntitySetName` is automatically generated by changing the `EntityName` to the plural of that name. Example: EntityName: Car EntitySetName: Cars. When manually creating a new entity the `EntitySetName` can be changed. System created `EntitySetName`(s) will always be the plural of the `EntityName` and these cannot be changed through the client interface or APIs. This includes system entities as well as entitles created for many to many relationship intersects.<p/>
 > When you create a custom entity, the name you choose will be prepended with the customization prefix value of the solution publisher associated with the solution that the entity was created within. Other than the entity set name, you cannot change the names of an entity after it is created. If you want consistent names for metadata items in your solution, you should create them in the context of a solution you create associated with a solution publisher that contains the customization prefix you want to use. More information : [Solution publisher](/power-platform/alm/solution-concepts-alm#solution-publisher)
 
 Each entity also has three properties that can display localized values:
 
-
 |Name  |Description  |
 |---------|---------|
 |`DisplayName`|Typically, the same as the schema name, but can include spaces. i.e. Account|

powerapps-docs/developer/common-data-service/org-service/entity-operations-query-data.md

@@ -2,7 +2,7 @@
 title: "Query data using the Organization service (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
 description: "Introduces the different ways to query data using Microsoft Dataverse SDK assemblies." # 115-145 characters including spaces. This abstract displays in the search result.
 ms.custom: ""
-ms.date: 10/31/2018
+ms.date: 12/10/2020
 ms.reviewer: "pehecke"
 ms.service: powerapps
 ms.topic: "article"
@@ -41,6 +41,8 @@ Both of these methods will return an <xref:Microsoft.Xrm.Sdk.EntityCollection> t
 
 > [!NOTE]
 > To ensure best performance, each query request can return a maximum of 5000 entity records. To return larger result sets you must request additional pages.
+>
+> All filter conditions for string values are case insensitive.  
 
 ### Null attribute values are not returned
 

powerapps-docs/developer/common-data-service/org-service/samples/validate-record-state.md

@@ -20,7 +20,7 @@ search.app:
 
 [!INCLUDE[cc-data-platform-banner](../../../../includes/cc-data-platform-banner.md)]
 
-This sample shows how to validate a change of state of an entity and set a state of an entity. You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/ValidateandExecuteSavedQuery).
+This sample shows how to validate a change of state of an entity and set a state of an entity. You can download the sample from [here](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/ValidateAndSetRecordState).
 
 ## How to run this sample