Skip to content

Commit ee3cb95

Browse files
authored
Live publish
2 parents 6efa916 + 7476810 commit ee3cb95

File tree

4 files changed

+29
-29
lines changed

4 files changed

+29
-29
lines changed

powerapps-docs/developer/data-platform/webapi/associate-disassociate-entities-using-web-api.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Associate and disassociate tables using the Web API (Microsoft Dataverse)| Microsoft Docs"
2+
title: "Associate and disassociate table rows using the Web API (Microsoft Dataverse)| Microsoft Docs"
33
description: "Read how to add a reference to a collection-valued navigation property, remove a reference, and change an existing reference using the Web API"
44
ms.custom: ""
55
ms.date: 05/03/2021
@@ -22,7 +22,7 @@ search.app:
2222
- D365CE
2323
---
2424

25-
# Associate and disassociate tables using the Web API
25+
# Associate and disassociate table rows using the Web API
2626

2727
[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
2828

@@ -32,7 +32,7 @@ There are several methods you can use to associate and disassociate tables (enti
3232

3333
## Add a reference to a collection-valued navigation property
3434

35-
The following example shows how to associate an existing opportunity entity with the `opportunityid` value of `00000000-0000-0000-0000-000000000001` to the collection-valued `opportunity_customer_accounts` navigation property for an account entity with the `accountid` value of `00000000-0000-0000-0000-000000000002`. This is a 1:N relationship but you can perform the same operation for an N:N relationship.
35+
The following example shows how to associate an existing opportunity with the `opportunityid` value of `00000000-0000-0000-0000-000000000001` to the collection-valued `opportunity_customer_accounts` navigation property for an account with the `accountid` value of `00000000-0000-0000-0000-000000000002`. This is a 1:N relationship but you can perform the same operation for an N:N relationship.
3636

3737
**Request**
3838
```http
@@ -59,7 +59,7 @@ OData-Version: 4.0
5959

6060
## Change the reference in a single-valued navigation property
6161

62-
You can associate entities by setting the value of a single-valued navigation property using PUT request with the following pattern.
62+
You can associate rows by setting the value of a single-valued navigation property using PUT request with the following pattern.
6363

6464
**Request**
6565

@@ -83,11 +83,11 @@ OData-Version: 4.0
8383
```
8484

8585

86-
<a name="bkmk_Removeareferencetoanentity"></a>
86+
<a name="bkmk_Removeareferencetoarow"></a>
8787

88-
## Remove a reference to a table
88+
## Remove a reference to a table row
8989

90-
Use a DELETE request to remove a reference to an entity. The way you do it is different depending on whether you’re referring to a collection-valued navigation property or a single-valued navigation property.
90+
Use a DELETE request to remove a reference to a row. The way you do it is different depending on whether you’re referring to a collection-valued navigation property or a single-valued navigation property.
9191

9292
**Request**
9393
For a collection-valued navigation property, use the following.
@@ -126,23 +126,23 @@ HTTP/1.1 204 No Content
126126
OData-Version: 4.0
127127
```
128128

129-
<a name="bkmk_Associateentitiesoncreate"></a>
129+
<a name="bkmk_Associaterowsoncreate"></a>
130130

131-
## Associate tables on create
131+
## Associate table rows on create
132132

133-
As described in [Associate table rows on create](create-entity-web-api.md#associate-table-rows-on-create), you can associate the new record to existing records by setting the navigation properties using the `@odata.bind` annotation.
133+
As described in [Associate rows on create](create-entity-web-api.md#associate-table-rows-on-create), you can associate the new row to existing rows by setting the navigation properties using the `@odata.bind` annotation.
134134

135-
As described in [Create related tables in one operation](create-entity-web-api.md#bkmk_CreateRelated), new entities can be created with relationships using *deep insert*.
135+
As described in [Create related tables in one operation](create-entity-web-api.md#bkmk_CreateRelated), new tables can be created with relationships using *deep insert*.
136136

137-
## Associate and disassociate tables on update
137+
## Associate and disassociate table rows on update
138138

139-
You can set the value of single-valued navigation properties using `PATCH` to associate or disassociate records.
139+
You can set the value of single-valued navigation properties using `PATCH` to associate or disassociate rows.
140140

141-
<a name="bkmk_Associateentitiesonupdate"></a>
141+
<a name="bkmk_Associaterowsonupdate"></a>
142142

143-
### Associate tables on update
143+
### Associate table rows on update
144144

145-
You can associate entities on update using the same message described in [Basic update](update-delete-entities-using-web-api.md#bkmk_update) but you must use the `@odata.bind` annotation to set the value of a single-valued navigation property. The following example changes the account associated to an opportunity using the `customerid_account` single-valued navigation property.
145+
You can associate rows on update using the same message described in [Basic update](update-delete-entities-using-web-api.md#bkmk_update) but you must use the `@odata.bind` annotation to set the value of a single-valued navigation property. The following example changes the account associated to an opportunity using the `customerid_account` single-valued navigation property.
146146

147147
**Request**
148148

@@ -165,7 +165,7 @@ HTTP/1.1 204 No Content
165165
OData-Version: 4.0
166166
```
167167

168-
### Disassociate tables on update
168+
### Disassociate table rows on update
169169

170170
You can remove a reference to a single-valued navigation property when updating by setting the value to `null`. This method allows you to disassociate multiple references in a single operation.
171171
There are two ways to do this:
@@ -203,14 +203,14 @@ OData-Version: 4.0
203203

204204
More information: [Basic update](update-delete-entities-using-web-api.md#basic-update)
205205

206-
<a name="bkmk_Associateentitiesonupdate_multi"></a>
206+
<a name="bkmk_Associaterowsonupdate_multi"></a>
207207

208-
## Associate tables on update using collection-valued navigation property
208+
## Associate table rows on update using collection-valued navigation property
209209

210-
The following example shows how to associate multiple existing [ActivityParty](../reference/entities/activityparty.md) entities with an [Email](../reference/entities/email.md) entity using collection-valued navigation property `email_activity_parties`.
210+
The following example shows how to associate multiple existing [ActivityParty](../reference/entities/activityparty.md) with an [Email](../reference/entities/email.md) using collection-valued navigation property `email_activity_parties`.
211211

212212
> [!NOTE]
213-
> Associating multiple entities with an entity on update is a special scenario that is possible only with <xref:Microsoft.Dynamics.CRM.activityparty?text=activityparty EntityType />.
213+
> Associating multiple tables with a table on update is a special scenario that is possible only with <xref:Microsoft.Dynamics.CRM.activityparty?text=activityparty EntityType />.
214214
215215
**Request**
216216

@@ -260,4 +260,4 @@ OData-Version: 4.0
260260
[Impersonate another user using the Web API](impersonate-another-user-web-api.md)
261261
[Perform conditional operations using the Web API](perform-conditional-operations-using-web-api.md)
262262

263-
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
263+
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/data-platform/webapi/samples/cdswebapiservice.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -210,7 +210,7 @@ Sends a `DELETE` request synchronously.
210210
More information:
211211

212212
- [Basic delete](../update-delete-entities-using-web-api.md#basic-delete)
213-
- [Remove a reference to a table](../associate-disassociate-entities-using-web-api.md#remove-a-reference-to-a-table)
213+
- [Remove a reference to a table](../associate-disassociate-entities-using-web-api.md#remove-a-reference-to-a-table-row)
214214
- [Delete a single property value](../update-delete-entities-using-web-api.md#delete-a-single-property-value)
215215

216216
## DeleteAsync

powerapps-docs/developer/data-platform/webapi/update-delete-entities-using-web-api.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ OData-Version: 4.0
7272
```
7373

7474
> [!NOTE]
75-
> See [Associate and disassociate tables on update](associate-disassociate-entities-using-web-api.md#associate-and-disassociate-tables-on-update) for information about associating and disassociating entities on update.
75+
> See [Associate and disassociate tables on update](associate-disassociate-entities-using-web-api.md#associate-and-disassociate-table-rows-on-update) for information about associating and disassociating entities on update.
7676
7777
<a name="bkmk_updateWithDataReturned"></a>
7878

@@ -175,7 +175,7 @@ OData-Version: 4.0
175175
```
176176

177177
> [!NOTE]
178-
> This can’t be used with a single-valued navigation property to disassociate two entities. For an alternative approach, see [Remove a reference to a table](associate-disassociate-entities-using-web-api.md#bkmk_Removeareferencetoanentity).
178+
> This can’t be used with a single-valued navigation property to disassociate two entities. For an alternative approach, see [Remove a reference to a table](associate-disassociate-entities-using-web-api.md#bkmk_Removeareferencetoarow).
179179
180180
<a name="bkmk_upsert"></a>
181181

powerapps-docs/developer/data-platform/webapi/web-api-basic-operations-sample.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,9 +40,9 @@ This sample is divided into the following sections, containing Dataverse Web API
4040
|Code section|Associated conceptual topics|
4141
|------------------|----------------------------------|
4242
|[Section 1: Basic create and update operations](#bkmk_section1)|[Basic create](create-entity-web-api.md#bkmk_basicCreate) <br /> [Create with data returned](create-entity-web-api.md#bkmk_createWithDataReturned) <br /> [Basic update](update-delete-entities-using-web-api.md#bkmk_update) <br /> [Update with data returned](update-delete-entities-using-web-api.md#bkmk_updateWithDataReturned)|
43-
|[Section 2: Create with association](#bkmk_section2)|[Associate entities on create](associate-disassociate-entities-using-web-api.md#bkmk_Associateentitiesoncreate)|
43+
|[Section 2: Create with association](#bkmk_section2)|[Associate entities on create](associate-disassociate-entities-using-web-api.md#bkmk_Associaterowsoncreate)|
4444
|[Section 3: Create related entities (deep insert)](#bkmk_section3)|[Create related entities in one operation](create-entity-web-api.md#bkmk_CreateRelated)|
45-
|[Section 4: Associate and disassociate existing entities](#bkmk_section4)|[Associate and disassociate entities using the Web API](associate-disassociate-entities-using-web-api.md)|
45+
|[Section 4: Associate and disassociate existing entities](#bkmk_section4)|[Associate and disassociate table rows using the Web API](associate-disassociate-entities-using-web-api.md)|
4646
|[Section 5: Delete entities (sample cleanup)](#bkmk_section5)|[Basic delete](update-delete-entities-using-web-api.md#bkmk_delete)|
4747

4848
> [!NOTE]
@@ -861,8 +861,8 @@ DELETE https://[Organization URI]/api/data/v9.0/opportunities(7cf77a42-5f0e-e611
861861
[Create an entity using the Web API](create-entity-web-api.md)<br />
862862
[Retrieve an entity using the Web API](retrieve-entity-using-web-api.md)<br />
863863
[Update and delete entities using the Web API](update-delete-entities-using-web-api.md)<br />
864-
[Associate and disassociate entities using the Web API](associate-disassociate-entities-using-web-api.md)<br />
864+
[Associate and disassociate table rows using the Web API](associate-disassociate-table rows-using-web-api.md)<br />
865865
[Web API Basic Operations Sample (C#)](samples/cdswebapiservice-basic-operations.md)<br />
866866

867867

868-
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
868+
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]

0 commit comments

Comments
 (0)