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