Anpassen von Entitätsattributmetadaten
Veröffentlicht: November 2016
Gilt für: Dynamics CRM 2015
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 |
|---|---|---|
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. |
|
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 verwenden und zu Microsoft Dynamics CRM Online 2015-Update 1 aktualisiert haben, unterstützen alle Datums- und Zeitattribute jetzt Werte ab dem 01.01.1753 um 00:00 Uhr. |
|
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. |
|
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. |
|
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. |
|
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:
|
|
Suche |
Ein Attribut, das erstellt wird, wenn eine Entitätsbeziehung mithilfe der Message CreateOneToManyRequest erstellt wird. |
|
Mehrere Textzeilen |
Ein Memoattribut. Wird als Textfeldfeld in einem Formular angezeigt. Die maximale Länge beträgt 1048576 Zeichen. |
|
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:
|
|
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. |
|
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. |
|
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. |
|
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 CRM noch Verweise auf „Lync“, CRM agiert jedoch mit Skype for Business.
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 |
|---|---|
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
Erweitern des Metadatenmodells
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
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright