Freigeben über


property-Element

Der property-Knoten definiert ein bestimmtes konfigurierbares Datenelement, das von der Komponente vom Microsoft Dataverse erwartet wird.

Verfügbar für

Modellgesteuerte und Canvas-Apps

Eigenschaften

Name des Dataflows Description Type Erforderlich Verfügbar für
default-value Der Standardkonfigurationswert, der der Komponente bereitgestellt wird. In modellbasierten Apps ist diese Eigenschaft nur für Eingaben erlaubt, da die gebundenen Parameter eine zugehörige Spalte erwarten. string Optional Modellbasierte Apps
description-key Wird in den Anpassungsbildschirmen als lokalisierte Zeichenfolge verwendet, die die Beschreibung der Eigenschaft beschreibt. string Optional Modellgesteuerte und Canvas-Apps
display-name-key Wird in den Anpassungsbildschirmen als lokalisierte Zeichenfolge verwendet, die den Namen der Eigenschaft beschreibt. string Ja Modellbasierte Apps
name Name der Eigenschaft. string Ja Modellgesteuerte und Canvas-Apps
of-type-group Name von type-group, wie im Manifest definiert string Optional Modellbasierte Apps
of-type Definiert den Datentyp der Eigenschaft Siehe Verwendung von of-type Optional Modellgesteuerte und Canvas-Apps
pfx-default-value Der PFX-Standardausdruckswert, der der Komponente bereitgestellt wird. Siehe Verwendung von pfx-default-value Optional Canvas-Apps
Erforderlich Ob die Eigenschaft erforderlich ist oder nicht boolesch Optional Modellbasierte Apps
usage Die Verwendungseigenschaft gibt an, ob die Eigenschaft eine Spalte darstellen soll, die die Komponente ändern kann (gebunden), schreibgeschützt ist (Eingabe) oder Werte ausgibt gebunden, Eingabe oder Ausgabe Ja Modellbasierte Apps

Anmerkungen

Dieser Abschnitt enthält Anleitungen zur Verwendung der Property-Elementattribute.

Verwendung von of-type

Der Wert der Eigenschaft of-type muss einer der folgenden sein:

Wert Beschreibung des Dataflows
Währungen Geldbeträge zwischen -922.337.203.685.477 und 922.337.203.685.477 können in dieser Spalte verwendet werden.
DateAndTime.DateAndTime Zeigt Datum und Uhrzeit an.
DateAndTime.DateOnly Zeigt nur das Datum an.
Dezimal Es können bis zu 10 Dezimalstellen für Werte zwischen -100.000.000.000 und -100.000.000.000 in dieser Spalte verwendet werden.
Enumeration Aufzählungsdatentyp
FP Es können bis zu fünf Dezimalstellen für Werte zwischen -100.000.000.000 und -100.000.000.000 in dieser Spalte verwendet werden.
Lookup.Simple Erlaubt eine einzelne Referenz zu einer bestimmten Tabelle. Alle benutzerdefinierten Suchen haben diesen Typ.
Mehrere Bis zu 1.048.576 Textzeichen können in dieser Spalte enthalten sein.
MultiSelectOptionSet Sie können Formulare (Haupt-, Schnell-Erstellung und Schnell-Ansicht) und E-Mail-Vorlagen anpassen, indem Sie Choices-Spalten hinzufügen. Wenn Sie Auswahlspalten hinzufügen, können Sie mehrere Werte angeben, die dem Benutzer zur Auswahl zur Verfügung stehen. Wenn Benutzer das Formular ausfüllen, können sie einen, mehrere oder alle Werte in einer Dropdownliste auswählen.
Object Objektdatentyp. Kann nur mit Ausgabeeigenschaften verwendet werden.
OptionSet Diese Spalte bietet eine Reihe von Optionen. Jede Option verfügt über einen Zahlenwert und eine Bezeichnung. Wenn diese Spalte zu einem Formular hinzugefügt wird, zeigt sie ein Steuerelement an, mit dem der Benutzer nur eine Option auswählen kann.
SingleLine.Email Dadurch wird die Zeichenfolgezeit im für E-Mails gültigen Format gespeichert. Sofort einsatzbereite Steuerelemente der einheitlichen Oberfläche machen daraus automatisch anklickbare Links.
SingleLine.Phone Dadurch wird die Zeichenfolgezeit im für Telefone gültigen Format gespeichert. Sofort einsatzbereite Steuerelemente der einheitlichen Oberfläche machen daraus automatisch anklickbare Links.
SingleLine.Text Diese Option zeigt einfach Text an.
SingleLine.TextArea Diese Formatoption kann verwendet werden, um mehrere Textzeilen anzuzeigen. Aber mit einem Limit von 4000 Zeichen ist die Spalte „Mehrere Zeilen Text“ die bessere Wahl, wenn große Textmengen erwartet werden.
SingleLine.Ticker Dadurch wird die Zeichenfolgezeit im für Ticker gültigen Format gespeichert. Sofort einsatzbereite Steuerelemente der einheitlichen Oberfläche machen daraus automatisch anklickbare Links.
SingleLine.URL Der erwartete Text, um einen Hyperlink bereitzustellen, um die angegebene Seite zu öffnen. Sofort einsatzbereite Steuerelemente der einheitlichen Oberfläche stellen automatisch „https://“ Eingabewerten voran, die nicht mit einem gültigen Protokoll beginnen. Nur die Protokolle HTTP, HTTPS, FTP, FTPS, OneNote und TEL werden in dieser Spalte erwartet.
TwoOptions Diese Spalte bietet zwei Optionen. Jede Option hat den Zahlenwert 0 oder 1, entsprechend dem Wert "true" oder "false". Darüber hinaus verfügt jede Option über eine Beschriftung, sodass die Werte „true“ und „false“ als „Ja“/„Nein“, „Heiß“/„Kalt“, „EIN“/„AUS“ oder in beliebiger anderer Weise angezeigt werden können.
Whole.None Diese Option zeigt einfach eine Zahl an.

Warnung

Wenn die manifest.xml Datei enthält mindestens ein DataSet, dann Eigenschaften vom Typ Lookup.Simple sollte auch in die eingewickelt werden Datensatz Element.

Wertelemente, die nicht unterstützt werden

Folgende of-type-Eigenschaftswerte werden derzeit nicht unterstützt:

Wert Description
Lookup.Customer Erlaubt eine einzelne Referenz zu einem Konto- oder einem Kontaktdatensatz. Diese Lookups sind für die Tabellen Verkaufschance, Fall, Angebot, Auftrag und Rechnung verfügbar. Diese Tabellen haben auch separate Lookups für Konten und Kontakte, die Sie verwenden können, wenn Ihre Kunden immer nur einen Typ haben. Sie können auch beide anstelle der Kundensuche verwenden.
Lookup.Owner Erlaubt eine einzelne Referenz zu einem Team- oder einem Benutzerdatensatz. Alle team- oder benutzereigenen Tabellen verfügen darüber.
Lookup.PartyList Erlaubt mehrere Referenzen zu mehreren Tabellen. Diese Suchen finden sich in der E-Mail-Tabelle in den Spalten An und Cc. Sie werden auch in den Tabellen „Telefon“ und „Termin“ verwendet.
Lookup.Regarding Erlaubt eine einzelne Referenz zu mehreren Tabellen. Diese Suchen finden sich in der in Aktivitäten verwendeten relevanten Spalte.
Statusgrund Eine Systemspalte mit Optionen, die weitere Details zur Statusspalte bereitstellen. Jede Option ist einer der verfügbaren Statusoptionen zugeordnet. Sie können die Optionen hinzufügen oder bearbeiten.
Status Eine Systemspalte mit Optionen, die normalerweise einem aktiven und einem inaktiven Status entsprechen. Einige Systemspalten haben weitere Optionen, aber alle angepassten Spalten haben nur die Statusoptionen „Aktiv“ und „Inaktiv“.
Whole.Duration Diese Formatoption kann verwendet werden, um eine Liste von Daueroptionen anzuzeigen. Die Daten, die in der Datenbank gespeichert werden, sind jedoch immer eine Zahl von Minuten. Die Spalte sieht wie eine Dropdownliste aus und bietet Optionen wie 1 Minute, 15 Minuten, 30 Minuten bis zu 3 Tage. Benutzer können diese Optionen auswählen. Sie können aber auch einfach eine Anzahl von Minuten eingeben, die dann zu diesem Zeitraum aufgelöst wird.
Whole.Language Mit dieser Option wird eine Liste mit den Sprachen angezeigt, die für Ihre Organisation verfügbar sind. Die Werte werden als Dropdownliste mit Sprachennamen angezeigt, die Daten sind jedoch als Zahl mit LCID-Codes gespeichert. Sprachcodes sind vierstellige oder fünfstellige Gebietsschema-IDs. Gültige Gebietsschema-ID-Werte finden Sie unter Gebietsschema-ID-Diagramm (LCID).
Whole.TimeZone Mit dieser Option wird eine Liste von Zeitzonen wie (GMT-12:00) Internationale Datumsgrenze (Westen) und (GMT-08:00) Pacific Time (USA und Kanada) angezeigt. Jede dieser Zonen wird als Zahl gespeichert. Beispielsweise für die Zeitzone (GMT-08: 00) Pacific Time (USA und Kanada) lautet der TimeZoneCode „4“.

Hinweis

Dateispalten werden derzeit nicht unterstützt. Weitere Informationen: Dateispalten

Verwendung von pfx-default-value

Verwenden Sie den pfx-default-value-Eigenschaftswert, um Ereignisse und Eigenschaften mithilfe von Power Fx-Ausdrücken anstelle statischer Standardwerte auszuwerten. Sie können dies für Folgendes verwenden:

  • Die Größe des Steuerelements dynamisch anpassen
  • Auf Konnektoren zugreifen
  • Beispieldaten bereitstellen
  • Theme-Eigenschaften referenzieren
  • Benutzerdefinierte Ereignisse

Hinweis

  • Sie können einen beliebigen Power Fx-Ausdruck verwenden, müssen jedoch beim Importieren des Steuerelements sicherstellen, dass der Ausdruck gültig ist.
  • Wenn Sie innere Anführungszeichen oder andere Sonderzeichen verwenden, schließen Sie den Wert in einfache Anführungszeichen ein. Beispiel: pfx-default-value='"Test"'
  • Sie können auf andere Steuerelemente (einschließlich Bildschirme) und deren Eigenschaften verweisen. Schreiben Sie diese Referenzen als: %ControlName.ID%.ControlProperty. Beispiel: pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • Schreiben Sie Aufzählungen wie DisplayType und ScreenTransition als: %EnumName.RESERVED%.EnumValue. Beispiel: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • Wenn pfx-default-value enthalten ist, hat es Vorrang vor default-value.

Übergeordnete Elemente

Element Description
control Definiert den Namespace, die Version und die Anzeigeinformationen der Komponente.

Beispiel

<property name="myFirstProperty" display-name-key="myFirstProperty_Display_Key"
description-key="myFirstProperty_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

Manifestschemareferenz des Power Apps component framework
Power Apps component framework-API-Referenz
Power Apps component framework Übersicht

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).