Asociar y anular la asociación de filas de tabla mediante la API web

Artículo
08/05/2024

Puede asociar registros individuales en las filas de la tabla con otros registros usando las relaciones existentes entre las definiciones de la tabla. En OData, los Relaciones se expresan como propiedades de navegación.

Puede descubrir qué propiedades de navegación existen en el documento $Metadata Service. Consulte Propiedades de navegación de la API web. Para las tablas existentes, consulte la Dataverse Referencia de tipos de entidad de la API web ; para cada tipo de entidad, consulte las propiedades de navegación con valor único y con valor de colección enumeradas.

La siguiente tabla describe los tres tipos de relaciones entre tablas en Dataverse.

Type	Descripción	Ejemplo
Uno a varios	Un registro puede tener muchos registros asociados.	Un registro account puede tener muchos registros contact en la propiedad de navegación valorada como colección `contact_customer_accounts`.
Varios a uno	Muchos registros se pueden asociar a un registro. Varios a uno es una imagen reflejada de una relación Uno a varios. Sólo hay una relación.	Muchos registros contact se pueden asociar a un solo registro account usando la propiedad de navegación valorada como colección `parentcustomerid_account`.
Varios a varios	Muchos registros se pueden asociar a muchos registros.	Cada uno podría incluir referencias a la definición de a security role (role) . systemuser Ambas tablas tienen una propiedad de navegación con valor de colección `systemuserroles_association` .

Para los registros existentes en el lado varios de una relación Uno a varios o Varios a uno, puede asociar el registro estableciendo una referencia Uri al otro registro. La forma más fácil y común de hacer esto es agregar anotación al nombre de la propiedad de navegación de valor único y luego establecer el valor como Uri en el otro registro en una solicitud. @odata.bind PATCH

Por ejemplo, para asociar un registro contact a un account utilizando la propiedad de navegación de un solo valor parentcustomerid_account:

Solicitud:

PATCH [Organization Uri]/api/data/v9.2/contacts(cf9eaaef-f718-ed11-b83e-00224837179f) 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)"
}

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(cf9eaaef-f718-ed11-b83e-00224837179f)

Como se describe en Asociar filas de tabla en la creación, los nuevos registros también se pueden asociar con registros existentes de la misma manera.

Si desea desasociar, simplemente puede establecer el valor en nulo.

Solicitud:

PATCH [Organization Uri]/api/data/v9.2/contacts(cf9eaaef-f718-ed11-b83e-00224837179f) 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
}

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(cf9eaaef-f718-ed11-b83e-00224837179f)

Al desasociar de esta manera, no necesita incluir la anotación @odata.bind. Puede simplemente usar el nombre de la propiedad de navegación de un solo valor:

Solicitud:

PATCH [Organization Uri]/api/data/v9.2/contacts(cf9eaaef-f718-ed11-b83e-00224837179f) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

{
  "parentcustomerid_account": null
}

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(cf9eaaef-f718-ed11-b83e-00224837179f)

Más información: Actualización básica

Otros métodos

Hay otras formas de lograr los mismos resultados descritos anteriormente con propiedades de navegación de un solo valor.

Puedes usar la siguiente solicitud PUT para fijar el valor de la propiedad de navegación de un solo valor parentcustomerid_account:

Solicitud:

PUT [Organization Uri]/api/data/v9.2/contacts(cf9eaaef-f718-ed11-b83e-00224837179f)/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)"
}

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Nota

Nota: Debe usar una URL absoluta al establecer el valor para @odata.id.

Para eliminar la referencia, también puede utilizar esta solicitud DELETE:

Solicitud:

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

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Con OData, ambos lados de una relación de muchos a muchos tienen propiedades de navegación con valores de colección. Para uno a muchos y muchos a uno Relaciones, la tabla del lado 'Uno' tiene una propiedad de navegación con valor de colección. No hay ninguna diferencia en cómo trabajas con cualquiera de estos tipos de Relaciones mientras usas propiedades de navegación con valores de colección. Esta sección describe cómo trabajar con propiedades de navegación con valores de colección con cualquier tipo de relación.

Agregar un registro a una colección

El siguiente ejemplo muestra cómo agregar un registro contact a la colección account contact_customer_accounts , que es parte de una relación de uno a muchos.

Solicitud:

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(cf9eaaef-f718-ed11-b83e-00224837179f)"
}

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0

El siguiente ejemplo muestra cómo agregar un registro role a la colección systemuser systemuserroles_association , que es una relación de muchos a muchos.

Solicitud:

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)"
}

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Quitar un registro de una colección

El siguiente ejemplo muestra cómo eliminar un registro contact a la colección accountcontact_customer_accounts donde el valor contactid del contacto es cf9eaaef-f718-ed11-b83e-00224837179f.

Solicitud:

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

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0

La siguiente solicitud también funciona:

Solicitud:

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(cf9eaaef-f718-ed11-b83e-00224837179f) HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

Respuesta:

HTTP/1.1 204 NoContent
OData-Version: 4.0

Consulte también

Ejemplo de operaciones básicas de la API web (C#)
Ejemplo de operaciones básicas de la API web (JavaScript del lado del cliente)
Realizar operaciones mediante la API web
Componer solicitudes HTTP y administrar errores
Consultar datos mediante la API web
Crear una fila de tabla usando la API web
Recuperar una fila de tabla usando la API web
Actualizar y eliminar filas de tablas usando la API web
Usar funciones de la API web
Usar acciones de la API web
Ejecute las operaciones por lotes mediante API web
Suplantar a otro usuario utilizando la API web
Realizar operaciones condicionales mediante la API web

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).

Compartir a través de

Asociar y anular la asociación de filas de tabla mediante la API web

Uso de propiedades de navegación de un solo valor

Asociar con una propiedad de navegación de un solo valor

Desasociar con una propiedad de navegación de un solo valor

Otros métodos

Uso de propiedades de navegación valoradas como colección

Agregar un registro a una colección

Quitar un registro de una colección

Consulte también

Recursos adicionales