Compartir por

Combinar filas de tabla mediante la API web

Cuando encuentre registros duplicados, puede combinarlos en uno mediante la acción combinar.

Nota:

Solo se pueden combinar los siguientes tipos de entidad:

Acción de combinación

Combinar es una acción sin enlazar que acepta cuatro parámetros:

Nombre Tipo Description Opcional
Target crmbaseentity El objetivo de la operación de combinación. No
Subordinate crmbaseentity Registro de entidad desde el que se van a combinar datos. No
UpdateContent crmbaseentity Más atributos de entidad que se van a establecer durante la operación de combinación. Sí
PerformParentingChecks Boolean Indica si se debe comprobar si la información primaria es diferente para los dos registros de entidad. No

La combinación mueve los datos útiles del Subordinate registro al Target registro. Los datos existentes en el registro Target no se sobrescriben. A continuación, se desactiva el Subordinate registro. Para realizar esta operación, la persona que realice la llamada debe tener privilegios y derechos de acceso a los registros identificados como el Target y el Subordinate.

Use una solicitud POST para enviar datos para combinar registros. En este ejemplo se combinan dos registros de entidades de cuenta mientras se actualiza la propiedad accountnumber del registro que permanecerá después de la combinación.

Solicitud:

POST [Organization URI]/api/data/v9.2/Merge HTTP/1.1
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

{
  "Target": {
    "name": "Account 1",
    "accountid": "bb8055c0-aea6-ea11-a812-000d3a55d474",
    "@odata.type": "Microsoft.Dynamics.CRM.account"
  },
  "Subordinate": {
    "name": "Account 2",
    "accountid": "c38055c0-aea6-ea11-a812-000d3a55d474",
    "@odata.type": "Microsoft.Dynamics.CRM.account"
  },
  "UpdateContent": {
    "accountnumber": "1234",
    "@odata.type": "Microsoft.Dynamics.CRM.account"
  },
  "PerformParentingChecks": false
}

Importante

Dado que los tipos de propiedad Target, Subordinate y UpdateContent no se definen explícitamente mediante el parámetro, debe incluir la anotación @odata.type para especificar el tipo.

Respuesta:

HTTP/1.1 204 No Content
OData-Version: 4.0

Fusionar comportamiento para incident

El comportamiento de combinación de la tabla incident (caso) es diferente de las tablas account, contact o lead.

  • Los datos del parámetro UpdateContent no se utilizan.

  • La combinación se realiza en el contexto de seguridad del usuario.

    Las operaciones de combinación para otras tablas se realizan con un contexto de seguridad de usuario del sistema. Dado que las operaciones de combinación de incidentes se realizan en el contexto de seguridad del usuario, el usuario debe tener los privilegios de seguridad para realizar cualquiera de las acciones, como la reparentación de registros relacionados, que realiza la operación de combinación.

    Si el usuario que está combinando registros no tiene privilegios para todas las acciones contenidas en la operación de combinación, esta fallará y se revertirá al estado original.

Consulte también

Usar acciones de la API web
Combinar registros duplicados
MergeRequest Clase
Guía de administración: Combinar datos
Dynamics 365 for Service: Casos de combinación

  • Last updated on