Compartilhar via


Personalizar metadados do atributo de entidades

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Use a classe AttributeMetadata para recuperar os atributos existentes. Esta classe é retornada pela mensagem RetrieveAttributeRequest. A classe AttributeMetadata é herdada do abstrato da classe MetadataBase.

Use a classe específica para cada tipo de atributo com a mensagem CreateAttributeRequest para atualizar atributos ou criar atributos personalizados.

Observação

Você pode acessar atributos personalizados de forma programática depois de criar, mas deverá adicioná-los ao formulário de entidade e publicar antes que os usuários possam ver.

Tipos de atributo

A tabela a seguir lista cada tipo de Attribute que você pode trabalhar. Cada atributo herda da classes AttributeMetadata.

Classe

Etiqueta do aplicativo

Descrição

BooleanAttributeMetadata

Duas opções

Um atributo booleano. Você pode especificar o texto para ambas as opções. Quando adicionado a um formulário, as propriedades de campo controlam se o atributo é exibido como dois botões de opções, uma caixa de seleção ou uma lista.

DateTimeAttributeMetadata

Data e Hora

Um atributo de data e hora. Você pode especificar o comportamento para armazenar valores de data e hora com ou sem informações de fuso horário, e o formato para definir o formato de exibição dos valores. Mais Informações: Comportamento e formato do atributo de data e hora

Observação

Se você estiver usando o Atualização 1 do Microsoft Dynamics CRM Online 2015 ou o Microsoft Dynamics 365 (local), todos os atributos de data e hora agora oferecerão suporte a valores a partir de 1/1/1753 00:00.

DecimalAttributeMetadata

Número Decimal

Um atributo decimal. Você pode especificar o nível de precisão em até dez casas decimais e os valores mínimo e máximo de -100.000.000.000 a 100.000.000.000.

DoubleAttributeMetadata

Número de Ponto Flutuante

Um atributo duplo. Você pode especificar o nível de precisão em até cinco casas decimais e os valores mínimo e máximo de -100.000.000.000 a 100.000.000.000.

Observação

DoubleAttributeMetadata substitui FloatAttributeMetadata usado no Microsoft Dynamics CRM 4.0.

ImageAttributeMetadata

Imagem

Um atributo de imagem. Cada entidade pode ter um atributo de imagem. Determinadas entidades do sistema incluem atributos de imagem e novos atributos de imagem não podem ser adicionados às entidades do sistema que não possuem. É possível adicionar um atributo de imagem para entidades personalizadas

Todos os atributos de imagem tem SchemaName "EntityImage" e LogicalName "entityimage". Os atributos de imagem personalizados não usam o prefixo de personalização do fornecedor de soluções no nome.Para obter mais informações:Imagens de entidade.

IntegerAttributeMetadata

Número Inteiro

Um atributo inteiro. Você pode especificar os valores máximo e mínimo de -2.147.483.648 a 2.147.483.647.

O atributo pode ser formatado para criar os seguintes tipos de campos usando a enumeração IntegerFormat:

  • Duração: Exibe uma lista suspensa que contenha intervalos de tempo. Um usuário pode selecionar um valor da lista ou digitar um valor inteiro que representa o número de minutos.

  • Fuso horário: Exibe uma lista suspensa que contém uma lista com fusos horários.

  • Idioma: Exibe uma lista suspensa que contém uma lista de idiomas que foi habilitado para a organização. Se nenhum outro idioma foi habilitado, o idioma base será a única opção. O valor salvo está no valor LCID para o idioma.

LookupAttributeMetadata

Consulta

Um atributo criado quando um relacionamento entre entidades é criado usando a mensagem CreateOneToManyRequest.

MemoAttributeMetadata

Várias Linhas de Texto

Um atributo de memorando. Exibe como campo da caixa de texto em um formulário. O comprimento máximo é de 1048576 caracteres.

MoneyAttributeMetadata

Moeda

Um atributo monetário. Você pode especificar os valores máximo e mínimo entre -922.337.203.685.477 e 922.337.203.685.477.

O nível de precisão pode ser definido usando a propriedade PrecisionSource:

  • Quando a precisão for definida para zero (0), o valor MoneyAttributeMetadata.Precision é usado.

  • Quando a precisão é definida para um (1), o valor Organization.PricingDecimalPrecision é usado.

  • Quando a precisão é definida para dois (2), o valor TransactionCurrency.CurrencyPrecision é usado.

PicklistAttributeMetadata

Conjunto de Opções

Um picklistattribute. Esse atributo fornece um conjunto de opções que é exibido na lista suspensa. Você pode criar o atributo picklist para que possa conter suas próprias opções ou usar um conjunto de opções global.

StateAttributeMetadata

Status

O atributo de estado é criado automaticamente quando a entidade é criada.

Observação

As opções disponíveis para esse atributo são somente leitura.

StatusAttributeMetadata

Razão do Status

O atributo status é criado automaticamente quando a entidade é criada. Cada uma das opções precisa ser associada ao atributo StateAttributeMetadata para a entidade. Use a mensagem InsertStatusValueRequest para atualizar as opções disponíveis para esse atributo.

Observação

Cada StatusOption deve referenciar um valor de atributo de estado específico porque os valores de status dependem de um valor de estado específico.

StringAttributeMetadata

Linha Única de Texto

Consulte Formatos StringAttributeMetadata.

Formatos StringAttributeMetadata

Os atributos de cadeia de caracteres podem ser formatados para permitir que os links iniciem telefonemas usando o Lync ou Skype. Essa alteração exige que uma nova propriedade FormatName seja adicionada à classe StringAttributeMetadata e a substituição da propriedade Format.

Observação

O Lync teve seu nome alterado para Skype for Business. No momento, você ainda verá referências a “Lync” no Microsoft Dynamics 365, mas o Dynamics 365 funcionará com o Skype for Business.

Usando a enumeração StringFormat para definir o formato para StringAttributeMetadata.Format é preterido. Em vez disso, use a classe StringFormatName para definir o valor de StringAttributeMetadata.FormatName.

Isso permite a configuração do valor de formato do PhoneNumber, que não existe na enumeração StringFormat.

Para compatibilidade inversa, você pode definir um valor para controlar como o atributo é formatado usando a propriedade Format ou FormatName. O código existente continuará a funcionar se você usar somente Format, mas não será possível formatar um atributo como um número de telefone sem usar FormatName. Se as propriedades são definidas, o valor definido usando FormatName é aquele que será aplicado.

A classe StringFormatName contém os seguintes membros; cada membro retorna uma cadeia de caracteres com o mesmo valor que o nome do membro:

Nome e valor do membro

Descrição

Email

O campo do formulário validará o valor de texto como um endereço de email e criará um link de mailto no campo.

PhoneNumber

O campo de formulário conterá um link para iniciar um telefonema usando o Skype ou Lync.

PhoneticGuide

Apenas para uso interno.

Text

O formulário exibirá uma caixa de texto.

TextArea

O formulário exibirá um campo de área de texto.

TickerSymbol

O formulário exibirá um link que abrirá para exibir uma cotação para o símbolo de ação de estoque.

URL

O formulário exibirá um link para abrir a URL.

VersionNumber

Apenas para uso interno.

Confira Também

Usar o serviço da Organização com metadados do Dynamics 365
Trabalhar com metadados de atributos
Comportamento e formato do atributo de data e hora
Mensagens dos metadados do atributo da entidade
Exemplo: Trabalhar com metadados de atributos
Artigo técnico: Using Option Set Options with the REST Endpoint - JScript
Exemplo: Despejar metadados do atributo em um arquivo
Exemplo: Despejar metadados da lista de seleção de atributos em um arquivo
Exemplo: converter comportamento de data e hora

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais