Personalizar metadatos de atributos de entidad

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Use la clase AttributeMetadata para recuperar atributos existentes. Esta clase se obtiene mediante el mensaje RetrieveAttributeRequest. La clase AttributeMetadata hereda de la clase abstracta MetadataBase.

Use la clase específica para cada tipo de atributo con el mensaje CreateAttributeRequest para actualizar atributos o crear atributos personalizados.

Nota

Puede acceder mediante programación a los atributos personalizados tras crearlos, pero debe agregarlos a un formulario de entidad y publicarlos para que los usuarios puedan verlos.

Tipos de atributos

La siguiente tabla muestra los distintos tipos de Attribute disponibles. Cada atributo hereda de la clase AttributeMetadata.

Clase	Etiqueta en la aplicación	Descripción
BooleanAttributeMetadata	Dos opciones	Atributo booleano. Puede especificar el texto de las dos opciones. Cuando se añade a un formulario, las propiedades de campo controlan si el atributo se muestra como dos botones de opción, una casilla o una lista.
DateTimeAttributeMetadata	Fecha y hora	Atributo de fecha y hora. Puede especificar el comportamiento para almacenar valores de fecha y hora con o sin información de zona horaria, y el formato para definir el formato de visualización de los valores. Más información: Comportamiento y formato del atributo de fecha y hora Nota Si usa Actualización 1 de Microsoft Dynamics CRM Online 2015 o Microsoft Dynamics 365 (local), todos los atributos de fecha y hora ahora admiten valores de hasta 1/1/1753 12:00 AM.
DecimalAttributeMetadata	Número decimal	Atributo decimal. Puede especificar el nivel de precisión con hasta diez decimales, y los valores mínimo y máximo entre -100.000.000.000 y 100.000.000.000.
DoubleAttributeMetadata	Número de punto flotante	Atributo doble. Puede especificar el nivel de precisión con hasta cinco decimales, y los valores mínimo y máximo entre -100.000.000.000 y 100.000.000.000. Nota La clase DoubleAttributeMetadata reemplaza a la clase FloatAttributeMetadata que se usaba en Microsoft Dynamics CRM 4.0.
ImageAttributeMetadata	Imagen	Atributo de imagen. Cada entidad puede tener un atributo de imagen. Determinadas entidades del sistema tienen atributos de imagen y no se pueden agregar nuevos atributos de imagen a las entidades del sistema que no las tienen. Puede agregar un atributo de imagen a las entidades personalizadas. Todos los atributos de imagen tienen ‘EntityImage’ en la propiedad SchemaName y ‘entityimage’ en la propiedad LogicalName. En el nombre de los atributos de imagen personalizados no se usa el prefijo de personalización del editor de soluciones.Más información:Imágenes de entidad.
IntegerAttributeMetadata	Número entero	Atributo entero. Puede especificar los valores mínimo y máximo entre -2.147.483.648 y 2.147.483.647. Se puede dar formato a este atributo para crear los siguientes tipos de campos mediante la enumeración de IntegerFormat: Duración: muestra una lista desplegable que contiene intervalos de tiempo. El usuario puede seleccionar un valor de la lista o escribir un valor entero que represente el número de minutos. Zona horaria: muestra una lista desplegable de zonas horarias. Idioma: muestra una lista desplegable con los idiomas que se hayan habilitado para la organización. Si no se ha activado ningún otro idioma, el idioma base será la única opción. El valor guardado es el valor del LCID del idioma.
LookupAttributeMetadata	Búsqueda	Atributo que se crea al crear una relación entre entidades con el mensaje CreateOneToManyRequest.
MemoAttributeMetadata	Varias líneas de texto	Atributo de memorando. Muestra un campo con un cuadro de texto en un formulario. La longitud máxima es de 1048576 caracteres.
MoneyAttributeMetadata	Divisa	Atributo monetario. Puede especificar los valores mínimo y máximo entre -922.337.203.685.477 y 922.337.203.685.477. El nivel de precisión se puede establecer mediante la propiedad PrecisionSource: Cuando la precisión se establece en cero (0), se usa el valor de MoneyAttributeMetadata.Precision. Cuando la precisión se establece en uno (1), se usa el valor de Organization.PricingDecimalPrecision. Cuando la precisión se establece en dos (2), se usa el valor de TransactionCurrency.CurrencyPrecision.
PicklistAttributeMetadata	Conjunto de opciones	Atributo de lista desplegable. Este atributo proporciona un conjunto de opciones que se muestran en una lista desplegable. Puede crear el atributo de lista desplegable de modo que contenga sus propias opciones o usar un conjunto de opciones globales.
StateAttributeMetadata	Estado	El atributo de estado se crea automáticamente al crear la entidad. Nota Las opciones disponibles para este atributo son de solo lectura.
StatusAttributeMetadata	Razón para el estado	El atributo de estado se crea automáticamente al crear la entidad. Cada una de las opciones debe asociarse al atributo StateAttributeMetadata de la entidad. Use el mensaje InsertStatusValueRequest para actualizar las opciones disponibles para este atributo. Nota Cada StatusOption debe hacer referencia a un valor de atributo de estado específico porque los valores de los estados dependen de un valor de estado específico.
StringAttributeMetadata	Línea única de texto	Vea Formatos de StringAttributeMetadata.

Formatos de StringAttributeMetadata

Se puede dar formato a los atributos de cadena para permitir que los vínculos inicien llamadas de teléfono mediante Lync o Skype. Este cambio requiere que se agregue una nueva propiedad FormatName a la clase StringAttributeMetadata y que la propiedad Format quede obsoleta.

Nota

Ahora, Lync se denomina Skype Empresarial. Actualmente, todavía se pueden ver referencias a “Lync” en Microsoft Dynamics 365, pero Dynamics 365 funcionará con Skype Empresarial.

El uso de la enumeración StringFormat para definir el formato de StringAttributeMetadata.Format ha quedado obsoleto. En su lugar, use la clase StringFormatName para establecer el valor de StringAttributeMetadata.FormatName.

Esto permite establecer el valor del formato de PhoneNumber, que no existe en la enumeración StringFormat.

Para la compatibilidad con versiones anteriores, puede establecer un valor para controlar cómo se formatea el atributo usando la propiedad Format o FormatName. El código existente seguirá funcionando si solo usa Format, pero no podrá dar formato a un atributo como número de teléfono sin usar FormatName. Si se establecen ambas propiedades, se aplicará el valor establecido mediante FormatName.

La clase StringFormatName contiene los siguientes miembros, cada uno de los cuales devuelve una cadena con el mismo valor que el nombre del miembro:

Nombre y valor del miembro	Descripción
Email	El campo de formulario validará el valor de texto como dirección de correo electrónico y creará un vínculo mailto en el campo.
PhoneNumber	El campo de formulario contendrá un vínculo para iniciar una llamada de teléfono mediante Lync o Skype.
PhoneticGuide	Solo para uso interno.
Text	El formulario mostrará un cuadro de texto.
TextArea	El formulario mostrará un campo de área de texto.
TickerSymbol	El formulario mostrará un vínculo que se abrirá para mostrar la cotización del valor bursátil correspondiente al símbolo.
URL	El formulario mostrará un vínculo para abrir la dirección URL.
VersionNumber	Solo para uso interno.

Ver también

Usar el servicio de la organización con metadatos de Dynamics 365
Trabajar con metadatos de atributos
Comportamiento y formato del atributo de fecha y hora
Mensajes de metadatos de atributos de entidad
Ejemplo: Trabajar con metadatos de atributos
Artículo técnico: Uso del conjunto de opciones con el extremo de REST - JScript
Ejemplo: volcar metadatos de atributo en un archivo
Ejemplo: volcar metadatos de lista desplegable de atributo a un archivo
Ejemplo: Convertir el comportamiento de fecha y hora

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright