Compartilhar via

Definir chaves alternativas para fazer referência a registros

  • Artigo

Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Definir chaves alternativas usando o portal do Power Apps

Com as chaves alternativas, você poderá garantir uma forma eficiente e precisa de integrar dados de sistemas externos. É especialmente importante nos casos quando um sistema externo não armazena as IDs do registro (GUIDs) que identifiquem exclusivamente registros. As chaves alternativas não são GUIDs e você pode usá-las para identificar exclusivamente os registros. Você deve oferecer um nome exclusivo à chave alternativa. Você pode usar um ou mais campos de entidade para definir a chave. Por exemplo, para identificar um registro de conta com uma chave alternativa, você poderá usar o nome da conta e o número da conta. Você pode definir chaves alternativas sem escrever código ou pode defini-las programaticamente. Observe que, embora você possa definir as chaves alternativas na interface do usuário (IU), elas só poderão ser usadas programaticamente, em código.

Alguns dos benefícios do recurso de chaves alternativas incluem:

  • Pesquisa de registros mais rápida.

  • Operações de dados em massa mais robustas.

  • Programação simplificada com dados importados de sistemas externos sem IDs do registro.

Importante

  • Você não pode usar um campo que está em uso por registros existentes como um chave alternativa. Isso resultará em um erro de registros duplicados.
  • Campos com segurança em nível de campo habilitada não podem ser usados como uma chave alternativa. Mais informações: Segurança em nível de campo para controlar o acesso

Para saber mais sobre a programação de chaves alternativas, consulte:
Definir chaves alternativas para uma entidade
Usar uma chave alternativa para criar um registro

Definir chaves alternativas

  1. Abra o gerenciador de soluções.
  2. Vá para Componentes>Entidades>Entidade <X>>Chaves.
  3. Selecione Novo.
  4. No formulário, preencha os campos necessários (Nome para Exibição e Nome) e depois selecione e adicione os campos à chave.
  5. Salve a chave.

O exemplo abaixo usa o campo Número da Conta na definição da chave alternativa.

Definir chave alternativa para a entidade de conta.

Observação

Você pode definir até cinco chaves diferentes para uma entidade.

Confira também

Criar e editar recursos da Web
Definir chaves alternativas para uma entidade (Guia do Desenvolvedor)Usar uma chave alternativa para criar um registro (Guia do Desenvolvedor)