Share via

Fusionar filas de tablas con la API web

  • Artículo

Cuando encuentre registros duplicados, puede combinarlos en uno usando Merge Action.

Nota

Solo se pueden combinar los siguientes tipos de entidad:

Acción Combinar

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

Nombre Tipo Descripción Opcional
Target crmbaseentity El destino de la operación de combinar. No
Subordinate crmbaseentity El registro de entidad desde el que se combinarán datos. No
UpdateContent crmbaseentity Atributos de entidad adicionales que se establecerán durante la operación de combinación. Sí
PerformParentingChecks Booleano Indica si se debe comprobar si la información principal es diferente para los dos registros de entidad. No

La fusión moverá todos los datos útiles del registro Subordinate a Target. Cualquier dato existente en el registro Target no se sobrescribirá. Después se desactiva el registro Subordinate. Para llevar a cabo esta operación, el autor de la llamada debe tener privilegios y derechos de acceso a los dos registros identificados como Target y Subordinate.

Use una solicitud POST para enviar datos con el fin de fusionar registros. Este ejemplo combina dos registros de entidad 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.0/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 por 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

La tabla fusionar comportamiento para incident (caso) es diferente de las tablas account, contact, o lead.

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

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

    Las operaciones de fusión para otras tablas se realizan con un contexto de seguridad de usuario del sistema. Debido a que las operaciones de combinación de incidentes se realizan en el contexto de seguridad del usuario, este debe tener los privilegios de seguridad para realizar cualquiera de las acciones, como la reorganización dinámica de relación jerárquica para los registros relacionados, que realiza la operación de combinación.

    Si el usuario que fusiona registros no tiene privilegios para todas las acciones incluidas en la operación de fusión, la operación de fusión no se realizará correctamente y volverá al estado original.

Consulte también

Usar acciones de la API web
Combinar registros duplicados
MergeRequest Class
Guía de administración: fusionar datos
Dynamics 365 para servicio: fusionar casos

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).