Mesclar linhas de tabela usando a API Web

Ao encontrar registros duplicados, você pode combiná-los em um usando a Ação de Mesclagem.

Observação

Somente os seguintes tipos de entidade podem ser mesclados:

Ação de mesclagem

Merge é uma ação não associada que aceita quatro parâmetros:

Name Tipo Description Opcional
Target crmbaseentity O destino da operação de mesclagem. No
Subordinate crmbaseentity O registro da entidade a partir do qual mesclar os dados. No
UpdateContent crmbaseentity Mais atributos de entidade a serem definidos durante a operação de mesclagem. Yes
PerformParentingChecks booleano Indica se deve verificar se as informações pai são diferentes para os dois registros de entidade. No

A mesclagem move quaisquer dados úteis do registro Subordinate para o registro Target. Os dados existentes no Target registro não são substituídos. Em seguida, o Subordinate registro é desativado. Para executar essa operação, o chamador deve ter privilégios e direitos de acesso a ambos os registros identificados como o Target e o Subordinate.

Use uma solicitação POST para enviar dados para mesclar registros. Este exemplo mescla dois registros de entidade de conta ao atualizar a propriedade accountnumber do registro que permanecerá após a mesclagem.

Solicitação:

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

Como os tipos de propriedade Target, Subordinate e UpdateContent não são definidos explicitamente pelo parâmetro, você deve incluir a anotação @odata.type para especificar o tipo.

Resposta:

HTTP/1.1 204 No Content
OData-Version: 4.0

Comportamento de mesclagem para incidente

O comportamento de mesclagem para a tabela incident (case) é diferente das tabelas account, contact ou lead.

  • Os dados de parâmetro não são usados.

  • A mesclagem é executada no contexto de segurança do usuário

    As operações de mesclagem para outras tabelas são executadas com um contexto de segurança do usuário do sistema. Como as operações de mesclagem de incidentes são executadas no contexto de segurança do usuário, o usuário deve ter os privilégios de segurança para executar qualquer uma das ações, como reatribuir o registro pai de registros relacionados, que a operação de mesclagem executa.

    Se o usuário que está mesclando registros não tiver privilégios para todas as ações contidas na operação de mesclagem, a operação de mesclagem falhará e reverterá para o estado original.

Consulte também

Use ações da API Web
Mesclar registros duplicados
Classe MergeRequest
Guia de Administração: Mesclar dados
Dynamics 365 para Serviço: mesclar ocorrências

  • Última atualização em