Live publish

Author: buck1ey

powerapps-docs/developer/data-platform/customize-entity-metadata.md

@@ -17,7 +17,7 @@ search.app:
 ---
 # Customize table definitions
 
-Tables are defined by table definitions. By defining or changing the table definitions, you can control the capabilities of a able. To view the table definitions for your environment, use the metadata browser. [Download the table definitions browser](https://download.microsoft.com/download/8/E/3/8E3279FE-7915-48FE-A68B-ACAFB86DA69C/MetadataBrowser_3_0_0_5_managed.zip).
+Tables are defined by table definitions. By defining or changing the table definitions, you can control the capabilities of a table. To view the table definitions for your environment, use the metadata browser. [Download the table definitions browser](https://download.microsoft.com/download/8/E/3/8E3279FE-7915-48FE-A68B-ACAFB86DA69C/MetadataBrowser_3_0_0_5_managed.zip).
 
 [!INCLUDE[cc-terminology](includes/cc-terminology.md)]
 

powerapps-docs/developer/data-platform/entity-attribute-metadata-messages.md

@@ -22,21 +22,21 @@ A column is a container for a piece of data in a table. The term *attribute* and
 [!INCLUDE[cc-terminology](includes/cc-terminology.md)]
 
 > [!NOTE]
-> It is possible to create and update table columns using the Web API. See [Create columns](webapi/create-update-entity-definitions-using-web-api.md#create-attributes) for more details.
+> It is possible to create and update table columns using the Web API. See [Create columns](webapi/create-update-entity-definitions-using-web-api.md#create-columns) for more details.
 
 ## Table column messages 
 
 The following table lists the messages that you can use to perform actions on table columns.  
 
 |Message|Web API Operation|SDK Assembly|   
 |-------------|-----------------|-----------------|  
-|CreateAttribute</br></br>Create table columns|POST to `EntityMetadata Attributes collection-valued` navigation property with JSON definition of column. More information: [Create columns](webapi/create-update-entity-definitions-using-web-api.md#create-attributes)|<xref:Microsoft.Xrm.Sdk.Messages.CreateAttributeRequest>| 
+|CreateAttribute</br></br>Create table columns|POST to `EntityMetadata Attributes collection-valued` navigation property with JSON definition of column. More information: [Create columns](webapi/create-update-entity-definitions-using-web-api.md#create-columns)|<xref:Microsoft.Xrm.Sdk.Messages.CreateAttributeRequest>| 
 |DeleteAttribute</br></br>Delete table columns|DELETE to the URL of the column.|<xref:Microsoft.Xrm.Sdk.Messages.DeleteAttributeRequest>|  
 |DeleteOptionValue</br></br>Delete a choice from <xref:Microsoft.Xrm.Sdk.Metadata.PicklistAttributeMetadata> or <xref:Microsoft.Xrm.Sdk.Metadata.StatusAttributeMetadata> columns|<xref href="Microsoft.Dynamics.CRM.DeleteOptionValue?text=DeleteOptionValue Action" />|<xref:Microsoft.Xrm.Sdk.Messages.DeleteOptionValueRequest>|  
 |InsertOptionValue</br></br>Add a choice to a <xref:Microsoft.Xrm.Sdk.Metadata.PicklistAttributeMetadata> column|<xref href="Microsoft.Dynamics.CRM.InsertOptionValue?text=InsertOptionValue Action" />|<xref:Microsoft.Xrm.Sdk.Messages.InsertOptionValueRequest>|Add a choice to a <xref:Microsoft.Xrm.Sdk.Metadata.PicklistAttributeMetadata> column.|  
 |InsertStatusValue</br></br>Add a choice to a <xref:Microsoft.Xrm.Sdk.Metadata.StatusAttributeMetadata> column|<xref href="Microsoft.Dynamics.CRM.InsertStatusValue?text=InsertStatusValue Action" />|<xref:Microsoft.Xrm.Sdk.Messages.InsertStatusValueRequest>|  |Changes the order of the choice presented in an <xref:Microsoft.Xrm.Sdk.Metadata.PicklistAttributeMetadata> column|<xref href="Microsoft.Dynamics.CRM.OrderOption?text=OrderOption Action" />|<xref:Microsoft.Xrm.Sdk.Messages.OrderOptionRequest>|  
 |RetrieveAttribute</br></br>Retrieve table columns|Use the Web API query mentioned in [Querying EntityMetadata columns](webapi/query-metadata-web-api.md#bkmk_queryAttributesexample) to retrieve table columns.|<xref:Microsoft.Xrm.Sdk.Messages.RetrieveAttributeRequest>|  
-|UpdateAttribute</br></br>Update table columns|See [Update tables](webapi/create-update-entity-definitions-using-web-api.md#update-entities)|<xref:Microsoft.Xrm.Sdk.Messages.UpdateAttributeRequest>|  
+|UpdateAttribute</br></br>Update table columns|See [Update tables](webapi/create-update-entity-definitions-using-web-api.md#update-table-definitions)|<xref:Microsoft.Xrm.Sdk.Messages.UpdateAttributeRequest>|  
 |UpdateStateValue</br></br>Update a label for a <xref:Microsoft.Xrm.Sdk.Metadata.StateAttributeMetadata> column|<xref href="Microsoft.Dynamics.CRM.UpdateStateValue?text=UpdateStateValue Action" />|<xref:Microsoft.Xrm.Sdk.Messages.UpdateStateValueRequest>|  
 
 ### See also  

powerapps-docs/developer/data-platform/webapi/TOC.yml

@@ -1,8 +1,8 @@
 - name: Work with data using code
   href: ../work-with-data.md
-- name: Use Web API
+- name: Use the Web API
   href: overview.md
-- name: Get started
+- name: Get started using code
   items:
   - name: (C#)
     items:
@@ -24,7 +24,7 @@
     href: aad-group-team.md
 - name: Types and operations
   href: web-api-types-operations.md
-- name: Perform operations
+- name: Perform Web API operations
   items:
   - name: Get started with performing operations
     href: perform-operations-web-api.md
@@ -34,19 +34,19 @@
     items:
     - name: Query data
       href: query-data-web-api.md
-    - name: Retrieve related entities with query
+    - name: Retrieve related tables with query
       href: retrieve-related-entities-query.md
   - name: Retrieve and execute predefined queries
     href: retrieve-and-execute-predefined-queries.md
-  - name: Create an entity record
+  - name: Create a table record
     href: create-entity-web-api.md
-  - name: Retrieve an entity record
+  - name: Retrieve a table record
     href: retrieve-entity-using-web-api.md
-  - name: Update and delete entity records 
+  - name: Update and delete table records 
     href: update-delete-entities-using-web-api.md
-  - name: Associate and disassociate entities
+  - name: Associate and disassociate tables
     href: associate-disassociate-entities-using-web-api.md
-  - name: Merge entity records 
+  - name: Merge table records 
     href: merge-entity-using-web-api.md
   - name: Use functions
     href: use-web-api-functions.md
@@ -60,21 +60,21 @@
     href: perform-conditional-operations-using-web-api.md
   - name: Detect duplicate data
     href: manage-duplicate-detection-create-update.md
-  - name: Access entity data faster using partitions
+  - name: Access table data faster using partitions
     href: azure-storage-partitioning.md
-- name: Work with metadata
+- name: Work with table definitions (metadata)
   items:
-  - name: Get started with using metadata
+  - name: Use the Web API with table definitions
     href: use-web-api-metadata.md
-  - name: Query metadata
+  - name: Query table definitions
     href: query-metadata-web-api.md
-  - name: Retrieve metadata by name or MetadataId
+  - name: Retrieve table definitions by name or MetadataId
     href: retrieve-metadata-name-metadataid.md
-  - name: Create and update entity definitions
+  - name: Create and update table definitions
     href: create-update-entity-definitions-using-web-api.md 
-  - name: Create and update entity relationships
+  - name: Create and update table relationships
     href: create-update-entity-relationships-using-web-api.md
-  - name: Work with Option sets
+  - name: Work with choices (option sets)
     href: create-update-optionsets.md
 - name: Use Postman with Web API
   items:

powerapps-docs/developer/data-platform/webapi/authenticate-web-api.md

@@ -23,14 +23,11 @@ search.app:
 ---
 # Authenticate to Microsoft Dataverse with the Web API
 
-
-[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
-
 You must use OAuth as described in [Use OAuth with Dataverse](../authenticate-oauth.md).
 
 The code you write to manage authentication when using the Web API depends on the type of deployment and where your code is.  
 
-### Authenticate with JavaScript in web resources  
+## Authenticate with JavaScript in web resources
 
 When you use the Web API with JavaScript within HTML web resources, form scripts, or ribbon commands you don’t need to include any code for authentication. In each of these cases the user is already authenticated by the application and authentication is managed by the application.  
 
@@ -44,5 +41,4 @@ If you’re creating a single page application (SPA) using JavaScript you can us
 [Use OAuth with Dataverse](../authenticate-oauth.md)<br />
 [Use OAuth with Cross-Origin Resource Sharing to connect a Single Page Application](../oauth-cross-origin-resource-sharing-connect-single-page-application.md)
 
-
 [!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/data-platform/webapi/compose-http-requests-handle-errors.md

@@ -1,8 +1,8 @@
 ---
 title: "Compose HTTP requests and handle errors (Microsoft Dataverse)| Microsoft Docs"
-description: "Read about the HTTP methods and headers that form a part of HTTP requests that interact with the Web API and how to identify and handle errors returned in the response"
+description: "Read about the HTTP methods and headers that form a part of HTTP requests for the Web API, and then learn how to identify and handle errors returned in the response"
 ms.custom: ""
-ms.date: 02/07/2021
+ms.date: 04/29/2021
 ms.service: powerapps
 ms.suite: ""
 ms.tgt_pltfrm: ""
@@ -21,9 +21,10 @@ search.app:
   - PowerApps
   - D365CE
 ---
+
 # Compose HTTP requests and handle errors
 
-[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
+[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
 
 You interact with the Web API by composing and sending HTTP requests. You need to know how to set the appropriate HTTP headers and handle any errors included in the response.  
 
@@ -41,14 +42,13 @@ To access the Web API you must compose a URL using the parts in the following ta
 |Base URL|`dynamics.com.`|
 |Web API path|The path to the web API is `/api/data/`.|
 |Version|    The version is expressed this way: `v[Major_version].[Minor_version][PatchVersion]/`. The valid version for this release is `v9.1`.|
-|Resource|The name of the entity, function, or action you want to use.|
-
+|Resource|The name of the entity (table), function, or action you want to use.|
 
 The URL you will use will be composed with these parts: Protocol + Environment Name + Region + Base URL + Web API path + Version + Resource.
 
 <a name="version_compatiblity"></a>
 
-###   Version compatibility
+### Version compatibility
 
 This release introduces capabilities which are not available in previous versions. Subsequent minor versions may provide additional capabilities which will not be back ported to earlier minor versions. Your code written for v9.0 will continue to work in future versions when you reference v9.0 in the URL you use.
 
@@ -105,13 +105,13 @@ You can use additional headers to enable specific capabilities.
 
 -   To return formatted values with a query, include the odata.include-annotations preference set to `Microsoft.Dynamics.CRM.formattedvalue` using the [Prefer](https://tools.ietf.org/html/rfc7240) header. More information:[Include formatted values](query-data-web-api.md#bkmk_includeFormattedValues)  
 
--   You also use the `Prefer` header with the `odata.maxpagesize` option to specify how many pages you want to return. More information:[Specify the number of entities to return in a page](query-data-web-api.md#bkmk_specifyNumber)  
+-   You also use the `Prefer` header with the `odata.maxpagesize` option to specify how many pages you want to return. More information:[Specify the number of tables (entities) to return in a page](query-data-web-api.md#bkmk_specifyNumber)  
 
--   To impersonate another user when the caller has the privileges to do so, add the `CallerObjectId` header with the user's Azure Active Directory Object Id value of the user to impersonate. This data is in the [SystemUser entity](/reference/entities/systemuser) [AzureActiveDirectoryObjectId](/reference/entities/systemuser#BKMK_AzureActiveDirectoryObjectId) attribute. More information:[Impersonate another user using the Web API](impersonate-another-user-web-api.md).  
+-   To impersonate another user when the caller has the privileges to do so, add the `CallerObjectId` header with the user's Azure Active Directory Object Id value of the user to impersonate. This data is in the [SystemUser table/entity](/reference/entities/systemuser) [AzureActiveDirectoryObjectId](/reference/entities/systemuser#BKMK_AzureActiveDirectoryObjectId) attribute (column). More information:[Impersonate another user using the Web API](impersonate-another-user-web-api.md).  
 
 -   To apply optimistic concurrency, you can apply the [If-Match](https://tools.ietf.org/html/rfc7232#section-3.1) header with an `Etag` value. More information:[Apply optimistic concurrency](perform-conditional-operations-using-web-api.md#bkmk_Applyoptimisticconcurrency).  
 
--   To control whether an upsert operation should actually create or update an entity, you can also use the `If-Match` and [If-None-Match](https://tools.ietf.org/html/rfc7232#section-3.2) headers. More information:[Upsert an entity](update-delete-entities-using-web-api.md#bkmk_upsert).  
+-   To control whether an upsert operation should actually create or update an entity, you can also use the `If-Match` and [If-None-Match](https://tools.ietf.org/html/rfc7232#section-3.2) headers. More information:[Upsert a table (entity)](update-delete-entities-using-web-api.md#bkmk_upsert).  
 
 -   When you execute batch operations, you must apply a number of different headers in the request and with each part sent in the body. More information:[Execute batch operations using the Web API](execute-batch-operations-using-web-api.md).  
 
@@ -288,16 +288,15 @@ This can also be done using the Organization Service: [Add a Shared Variable fro
 ### See also  
 
 [Perform operations using the Web API](perform-operations-web-api.md)<br />
-[Query Data using the Web API](query-data-web-api.md)<br />
-[Create an entity using the Web API](create-entity-web-api.md)<br />
-[Retrieve an entity using the Web API](retrieve-entity-using-web-api.md)<br />
-[Update and delete entities using the Web API](update-delete-entities-using-web-api.md)<br />
-[Associate and disassociate entities using the Web API](associate-disassociate-entities-using-web-api.md)<br />
+[Query data using the Web API](query-data-web-api.md)<br />
+[Create a table (entity) using the Web API](create-entity-web-api.md)<br />
+[Retrieve a table (entity) using the Web API](retrieve-entity-using-web-api.md)<br />
+[Update and delete tables (entities) using the Web API](update-delete-entities-using-web-api.md)<br />
+[Associate and disassociate tables (entities) using the Web API](associate-disassociate-entities-using-web-api.md)<br />
 [Use Web API functions](use-web-api-functions.md)<br />
 [Use Web API actions](use-web-api-actions.md)<br />
 [Execute batch operations using the Web API](execute-batch-operations-using-web-api.md)<br />
 [Impersonate another user using the Web API](impersonate-another-user-web-api.md)<br />
 [Perform conditional operations using the Web API](perform-conditional-operations-using-web-api.md)
 
-
 [!INCLUDE[footer-include](../../../includes/footer-banner.md)]