Teilen über


Anpassen von Entitätsattributmetadaten

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Verwenden Sie die AttributeMetadata-Klasse, um vorhandene Attribute abzurufen. Diese Klasse wird von der Message RetrieveAttributeRequest zurückgegeben. Die AttributeMetadata-Klasse erbt von der abstrakten MetadataBase-Klasse.

Verwenden Sie die spezifische Klasse für jeden Attributtyp mit der Message CreateAttributeRequest, um Attribute zu aktualisieren oder um benutzerdefinierte Attribute zu erstellen.

Hinweis

Sie können auf benutzerdefinierte Attribute programmgesteuert zugreifen, nachdem Sie diese erstellen, doch Sie müssen sie einem Entitätsformular hinzufügen und veröffentlichen, bevor Benutzer sie sehen können.

Attributtypen

In der folgenden Tabelle ist jeder Typ von Attribute aufgeführt, mit dem Sie arbeiten können. Jedes Attribut erbt von der AttributeMetadata-Klasse.

Klasse

Anwendungsbezeichnung

Beschreibung

BooleanAttributeMetadata

Zwei Optionen

Ein boolesches Attribut. Sie können den Text für beide Optionen angeben. Wenn Sie zu einem Formular hinzugefügt werden, steuern die Feldeigenschaften, ob das Attribut als zwei Optionsfelder, ein Kontrollkästchen oder eine Liste angezeigt wird.

DateTimeAttributeMetadata

Datum und Uhrzeit

Ein Datums- und Uhrzeitattribut. Sie können das Verhalten so angeben, dass Datums- und Uhrzeitwerte mit oder ohne Zeitzoneninformationen gespeichert werden, und das Format so, dass das Anzeigeformat der Werte angegeben wird. Weitere Informationen: Verhalten und Format des Datums- und Uhrzeitattributs

Hinweis

Wenn Sie Microsoft Dynamics CRM Online 2015-Update 1 oder Microsoft Dynamics 365 (lokal) verwenden, unterstützen alle Datums- und Zeitattribute jetzt Werte ab dem 01.01.1753 um 00:00 Uhr.

DecimalAttributeMetadata

Dezimalzahl

Ein dezimales Attribut. Sie können den Genauigkeitsgrad auf bis zu zehn Dezimalstellen angeben und die Mindest- und Höchstwerte von -100.000.000.000 bis 100.000.000.000.

DoubleAttributeMetadata

Gleitkommazahl

Ein doppeltes Attribut. Sie können den Genauigkeitsgrad auf bis zu fünf Dezimalstellen angeben und die Mindest- und Höchstwerte von -100.000.000.000 bis 100.000.000.000.

Hinweis

DoubleAttributeMetadata ersetzt die FloatAttributeMetadata, die in Microsoft Dynamics CRM 4.0 verwendet werden.

ImageAttributeMetadata

Bild

Ein Bildattribut. Jede Entität kann über ein Bildattribut verfügen. Bestimmte Systementitäten verfügen über Bildattribute, und neue Bildattribute können Systementitäten nicht hinzugefügt werden, die diese nicht besitzen. Sie können ein Bildattribut benutzerdefinierten Entitäten hinzufügen.

Alle Bildattribute haben das „EntityImage“ SchemaName und das „EntityImage“ LogicalName . Benutzerdefinierte Bildattribute werden im Namen nicht das Anpassungspräfix für den Lösungsherausgeber verwenden.Weitere Informationen:Entitätsbilder.

IntegerAttributeMetadata

Ganze Zahl

Ein Ganzzahlattribut. Sie können den maximalen und den minimalen Wert von -2.147.483.648 bis 2.147.483.647 festlegen.

Dieses Attribut kann formatiert werden, um die folgenden Typen von Feldern mithilfe der IntegerFormat-Enumeration zu erstellen:

  • Dauer: Zeigt eine Dropdownliste an, die Zeitintervallen enthält. Ein Benutzer kann einen Wert in der Liste auswählen oder einen ganzzahligen Wert eingeben, der die Anzahl von Minuten darstellt.

  • TimeZone: Zeigt eine Dropdownliste an, die eine Liste von Zeitzonen enthält.

  • Sprache: Zeigt eine Dropdownliste an, die eine Liste von Sprachen enthält, die für die Organisation aktiviert sind. Wenn keine anderen Sprachen aktiviert sind, ist die einzige Option die Ausgangssprache. Der gespeicherte Wert ist der LCID-Wert für die Sprache.

LookupAttributeMetadata

Suche

Ein Attribut, das erstellt wird, wenn eine Entitätsbeziehung mithilfe der Message CreateOneToManyRequest erstellt wird.

MemoAttributeMetadata

Mehrere Textzeilen

Ein Memoattribut. Wird als Textfeldfeld in einem Formular angezeigt. Die maximale Länge beträgt 1048576 Zeichen.

MoneyAttributeMetadata

Währung

Ein money-Attribut. Sie können den maximalen und den minimalen Wert zwischen -922.337.203.685.477 und 922.337.203.685.477 festlegen.

Der Genauigkeitsgrad kann mithilfe der Eigenschaft PrecisionSource festgelegt werden:

  • Wenn die Genauigkeit auf null (0) festgelegt wird, wird der Wert MoneyAttributeMetadata.Precision verwendet.

  • Wenn die Genauigkeit auf eins (1) festgelegt wird, wird der Wert Organization.PricingDecimalPrecision verwendet.

  • Wenn die Genauigkeit auf zwei (2) festgelegt wird, wird der Wert TransactionCurrency.CurrencyPrecision verwendet.

PicklistAttributeMetadata

Optionssatz

Ein Auswahllistenattribut. Dieses Attribut stellt einen Satz von Optionen bereit, die in einer Dropdownliste angezeigt werden. Sie können das Auswahllistenattribut erstellen, sodass es seine eigenen Optionen enthalten oder einen globalen Optionssatz verwenden kann.

StateAttributeMetadata

Status

Das Statusattribut wird automatisch erstellt, wenn die Entität erstellt wird.

Hinweis

Die Optionen, die für dieses Attribut verfügbar sind, sind schreibgeschützt.

StatusAttributeMetadata

Statusgrund

Das Statusattribut wird automatisch erstellt, wenn die Entität erstellt wird. Jede der Optionen muss dem StateAttributeMetadata-Attribut für die Entität zugeordnet werden. Verwenden Sie die Message InsertStatusValueRequest, um Optionen zu aktualisieren, die für dieses Attribut verfügbar sind.

Hinweis

Jede StatusOption muss auf einen bestimmten Statusattributwert verweisen, da Statuswerte von einem bestimmten Zustandswert abhängen.

StringAttributeMetadata

Einzelne Textzeile

Siehe StringAttributeMetadata-Formate.

StringAttributeMetadata-Formate

Zeichenfolgenattributen können formatiert werden, um es Links zu ermöglichen, Telefonanrufe mithilfe von Lync oder Skype zu initiieren. Diese Änderung erfordert, dass eine neue FormatName-Eigenschaft der Klasse StringAttributeMetadata hinzugefügt wird und die Format-Eigenschaft veraltet.

Hinweis

Lync heißt jetzt Skype for Business. Momentan finden Sie in Microsoft Dynamics 365 noch Verweise auf „Lync“, Dynamics 365 arbeitet jedoch mit Skype for Business zusammen.

Die Verwendung der Enumeration StringFormat zum Definieren des Formats für StringAttributeMetadata.Format ist veraltet. Verwenden Sie die stattdessen die Klasse StringFormatName zum Festlegen des Werts von StringAttributeMetadata.FormatName.

Dies ermöglicht das Festlegen des Formatwerts von PhoneNumber, der in der Enumeration StringFormat nicht vorhanden ist.

Zur Abwärtskompatibilität können Sie einen Wert festlegen, um zu steuern, wie das Attribut formatiert wird, indem entweder die Format-Eigenschaft oder die FormatName-Eigenschaft verwendet wird. Ihr vorhandener Code wird weiterhin funktionieren, wenn Sie nur Format verwenden, jedoch können kein Attribut als Telefonnummer formatieren, ohne FormatName zu verwenden. Wenn beide Eigenschaften festgelegt werden, ist es der mithilfe von FormatName festgelegte Wert, der angewendet wird.

Die StringFormatName-Klasse enthält folgende Mitglieder; jedes Mitglied gibt eine Zeichenfolge mit demselben Wert wie dem Mitgliedsnamen zurück:

Mitgliedsname und Wert

Beschreibung

Email

Das Formfeld wird den Textwert als E-Mail-Adresse überprüfen und im Feld einen mailto-Link erstellen.

PhoneNumber

Das Formularfeld enthält einen Link, um einen Telefonanruf mithilfe von Lync oder Skype zu initiieren.

PhoneticGuide

Nur zur internen Verwendung.

Text

Das Formular zeigt ein Textfeld an.

TextArea

Das Formular zeigt ein Textbereichsfeld an.

TickerSymbol

Das Formular zeigt einen Link an, der sich öffnet, um ein Angebot für das Aktientickersymbol anzuzeigen.

URL

Das Formular zeigt einen Link an, um die URL zu öffnen.

VersionNumber

Nur zur internen Verwendung.

Siehe auch

Verwenden des Organisationsdienstes mit Dynamics 365-Metadaten
Verwenden von Attributmetadaten
Verhalten und Format des Datums- und Uhrzeitattributs
Meldungen für Entitätsattributsmetadaten
Beipiel: Verwenden von Attributmetadaten
Technischer Artikel: Verwenden von Optionssatz-Optionen mit dem REST-Endpunkt - Jscript
Beispiel: Setzen von Attributmetadaten in eine Datei
Beispiel: Speichern von Attributauswahllisten-Metadaten in einer Datei
Beispiel: Konvertierung des Datums- und Uhrzeitverhaltens

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright