Taulukon rivien yhdistäminen ja erottaminen WWW-ohjelmointirajapinnan avulla

Voit liittää taulukon riveillä olevia yksittäisiä tietueita muihin tietueisiin käyttämällä taulukon määritelmien välisiä suhteita. ODatassa suhteet ilmaistaan siirtymisominaisuuksissa.

Voit selvittää, mitkä siirtymisominaisuudet ovat $metadata -palveluasiakirjassa. Katso WWW-ohjelmointirajapinnan siirtymisominaisuudet. Jos kyseessä on olemassa oleva Dataverse-taulukko, katso WWW-ohjelmointirajapinnan entiteettityyppiviittaus kunkin entiteettityypin kohdalla luetteloidut yksiarvoiset ja kokoelmaarvoiset siirtymisominaisuudet.

Seuraavassa taulukossa kuvataan taulukoiden väliset kolme suhdetyyppiä Dataversessa.

Type	Kuvaus	Esimerkki
Yksi-moni	Yhteen tietueeseen voi liittyä useita dokumentteja.	Tilitietueessa voi olla useita yhteyshenkilötietueita`contact_customer_accounts`.
Moni-yhteen	Yhteen tietueeseen voidaan liittää useita tietueita. Monesta yhteen on peilikuva yhdestä moneen -suhteesta. On vain yksi suhde.	Yksittäiseen tilitietueeseen voidaan liittää useita yhteystietotietueita`parentcustomerid_account` avulla.
Monta moneen	Moniin tietueisiin voidaan liittää useita tietueita.	Jokainen käyttöoikeusrooli (rooli) voi sisältää viittauksia systemuser-määritykseen. Kummassakin taulukossa on `systemuserroles_association`.

Aiemmin luoduissa tietueissa, jotka ovat yksi-moneen tai monta-yhteen -suhteen monta-puolella, voit liittää tietueen asettamalla Uri-viittauksen toiseen tietueeseen. Helpoin ja yleisin tapa tehdä tämä on liittää @odata.bind huomautus yksiarvoisen siirtymisominaisuuden nimeen ja määrittää sitten arvoksi Uri pyynnön toiseen tietueeseen PATCH .

Voit esimerkiksi liittää yhteystietotietueen tiliin käyttämällä parentcustomerid_account yksiarvoista siirtymisominaisuutta:

Pyytää:

PATCH [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
  "parentcustomerid_account@odata.bind": "accounts(ce9eaaef-f718-ed11-b83e-00224837179f)"
}

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)

Kuten kohdassa Taulukon rivien yhdistäminen luomisen yhteydessä on kuvattu, uudet tietueet voidaan liittää myös olemassa oleviin tietueisiin samalla tavalla.

Jos haluat tehdä eristysmäärityksen, voit määrittää arvoksi tyhjäarvon.

Pyytää:

PATCH [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
  "parentcustomerid_account@odata.bind": null
}

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)

Kun eristät tällä tavalla, sinun ei tarvitse sisällyttää huomautusta @odata.bind . Voit käyttää yksiarvoisen siirtymisominaisuuden nimeä:

Pyytää:

PATCH [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
  "parentcustomerid_account": null
}

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)

Lisätietoja: Peruspäivitys

Muut menetelmät

On myös muita tapoja saavuttaa samat tulokset, jotka kuvattiin aiemmin yksiarvoisilla siirtymisominaisuuksilla.

Voit määrittää yksiarvoisen siirtymisominaisuuden PUT arvon seuraavan parentcustomerid_account pyynnön avulla:

Pyytää:

PUT [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/parentcustomerid_account/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
  "@odata.id": "[Organization URI]/api/data/v9.2/accounts(ce9eaaef-f718-ed11-b83e-00224837179f)"
}

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Note

Huomautus: Sinun on käytettävä absoluuttista URL-osoitetta, kun määrität -arvoa @odata.id.

Voit poistaa viittauksen myös käyttämällä tätä DELETE pyyntöä:

Pyytää:

DELETE [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/parentcustomerid_account/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0

OData:n avulla molemmilla puolilla monta-moneen-suhteessa on kokoelma-arvoisia navigointiominaisuuksia. Yksi moneen- ja monta yhteen -yhteyksissä "Yksi"-puolen taulukossa on kokoelma-arvoinen siirtymisominaisuus. Näiden suhteiden käyttämisessä kokoelmanarvoisia siirtymisominaisuuksia käytettäessä ei ole eroa. Tässä osiossa kuvataan, miten voit käsitellä kokoelmanarvoisia siirtymisominaisuuksia kaikentyyppisissä yhteyksissä.

Tietueen lisääminen kokoelmaan

Seuraavassa esimerkissä näytetään, miten yhteyshenkilötietue lisätään tilikokoelmaancontact_customer_accounts , joka on osa yksi moneen -suhdetta.

Pyytää:

POST [Organization Uri]/api/data/v9.2/accounts(ce9eaaef-f718-ed11-b83e-00224837179f)/contact_customer_accounts/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
  "@odata.id": "[Organization URI]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)"
}

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Seuraavassa esimerkissä näytetään, miten lisätään roolitietue systemusersystemuserroles_association-kokoelmaan, joka on monta moneen -suhde.

Pyytää:

POST [Organization Uri]/api/data/v9.2/systemusers(34dcbaf5-f718-ed11-b83e-00224837179f)/systemuserroles_association/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
  "@odata.id": "[Organization URI]/api/data/v9.2/roles(886b280c-6396-4d56-a0a3-2c1b0a50ceb0)"
}

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Tietueen poistaminen kokoelmasta

Seuraavassa esimerkissä näytetään, miten yhteystietotietue poistetaan tilikokoelmastacontact_customer_accounts , jossa yhteyshenkilön contactid arvo on 00aa00aa-bb11-cc22-dd33-44ee44ee44ee.

Pyytää:

DELETE [Organization Uri]/api/data/v9.2/accounts(ce9eaaef-f718-ed11-b83e-00224837179f)/contact_customer_accounts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Seuraava pyyntö toimii myös:

Pyytää:

DELETE [Organization Uri]/api/data/v9.2/accounts(ce9eaaef-f718-ed11-b83e-00224837179f)/contact_customer_accounts/$ref?$id=[Organization URI]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

Vastaus:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Katso myös

Palaute

Onko tästä sivusta apua?

Last updated on 2025-10-23

Jaa

Taulukon rivien yhdistäminen ja erottaminen WWW-ohjelmointirajapinnan avulla

Yksiarvoisten siirtymisominaisuuksien käyttäminen

Liitä yksiarvoiseen navigointiominaisuuteen

Erottaminen yksiarvoisen siirtymisominaisuuden avulla

Muut menetelmät

Kokoelman arvoisten siirtymisominaisuuksien käyttäminen

Tietueen lisääminen kokoelmaan

Tietueen poistaminen kokoelmasta

Katso myös

Palaute

Lisäresursseja