Udostępnij przez


property, element

Węzeł właściwości definiuje określony, konfigurowalny fragment danych, którego oczekuje składnik z usługi Microsoft Dataverse.

Dostępne dla

Aplikacje oparte na modelu i kanwy

Właściwości

Name Description Typ Wymagane Dostępne dla
wartość domyślna Domyślna wartość konfiguracji dostarczona do składnika. W aplikacjach opartych na modelu ta właściwość jest dozwolona tylko dla danych wejściowych, ponieważ powiązane parametry oczekują skojarzonej kolumny. ciąg Opcjonalnie Aplikacje oparte na modelu
description-key Używane na ekranach dostosowywania jako zlokalizowane ciągi opisujące opis właściwości. ciąg Opcjonalnie Aplikacje oparte na modelu i kanwy
display-name-key Używane na ekranach dostosowywania jako zlokalizowane ciągi opisujące nazwę właściwości. ciąg Tak Aplikacje oparte na modelu
nazwa Nazwa właściwości ciąg Tak Aplikacje oparte na modelu i kanwy
grupa typów Nazwa grupy typów zgodnie z definicją w manifeście ciąg Opcjonalnie Aplikacje oparte na modelu
typu Definiuje typ danych właściwości Zobacz Używanie typu Opcjonalnie Aplikacje oparte na modelu i kanwy
pfx-default-value Domyślna wartość wyrażenia PFX dostarczona do składnika. Zobacz Używanie wartości pfx-default-value Opcjonalnie Aplikacje kanwy
required Czy właściwość jest wymagana, czy nie typ logiczny (boolowski) Opcjonalnie Aplikacje oparte na modelu
użycie Właściwość użycia określa, czy właściwość ma reprezentować kolumnę, którą składnik może zmienić (powiązana), tylko do odczytu (dane wejściowe) lub wartości wyjściowe powiązane, wejściowe lub wyjściowe Tak Aplikacje oparte na modelu

Uwagi

Ta sekcja zawiera wskazówki dotyczące używania atrybutów elementu Właściwości.

Używanie typu

Wartość of-type właściwości musi być jedną z następujących wartości:

Wartość Description Dostępne dla
Waluta Wartości pieniężne z zakresu od -922 337 203 685 477 do 922 337 203 685 477 mogą znajdować się w tej kolumnie. Aplikacje oparte na modelu i kanwy
DateAndTime.DateAndTime Wyświetla datę i godzinę. Aplikacje oparte na modelu i kanwy
DateAndTime.DateOnly Wyświetla tylko datę. Aplikacje oparte na modelu i kanwy
Decimal Do 10 punktów dziesiętnych precyzji można użyć dla wartości z zakresu od -100 000 000 000 do -100 000 000 000 może znajdować się w tej kolumnie. Aplikacje oparte na modelu i kanwy
Enum Wyliczony typ danych. Aplikacje oparte na modelu i kanwy
FP Do pięciu punktów dziesiętnych precyzji można użyć dla wartości z zakresu od -100 000 000 000 do -100 000 000 000 może znajdować się w tej kolumnie. Aplikacje oparte na modelu i kanwy
Lookup.Simple Umożliwia pojedyncze odwołanie do określonej tabeli. Wszystkie niestandardowe wyszukiwania są tego typu. Aplikacje oparte na modelu
Wielokrotny Ta kolumna może zawierać maksymalnie 1048 576 znaków tekstowych. Aplikacje oparte na modelu i kanwy
MultiSelectOptionSet Formularze (główne, szybkie tworzenie i szybki widok) i szablony wiadomości e-mail można dostosować, dodając kolumny do wyboru. Podczas dodawania kolumny wyboru można określić wiele wartości, które są dostępne dla użytkowników do wybrania. Gdy użytkownicy wypełniają formularz, mogą wybrać jedną, wiele lub wszystkie wartości wyświetlane na liście rozwijanej. Aplikacje oparte na modelu i kanwy
Object Typ danych obiektu. Może być używany tylko z właściwościami wyjściowymi. Aplikacje oparte na modelu i kanwy
OptionSet Ta kolumna zawiera zestaw opcji. Każda opcja ma wartość liczbową i etykietę. Po dodaniu do formularza w tej kolumnie zostanie wyświetlona kontrolka umożliwiająca użytkownikom wybranie tylko jednej opcji. Aplikacje oparte na modelu i kanwy
SingleLine.Email Spowoduje to zapisanie czasu ciągu w formacie prawidłowym dla wiadomości e-mail. Gotowe kontrolki ujednoliconego interfejsu automatycznie umożliwiają klikanie linków. Aplikacje oparte na modelu i kanwy
SingleLine.Phone Spowoduje to zapisanie czasu ciągu w formacie prawidłowym dla telefonu. Gotowe kontrolki ujednoliconego interfejsu automatycznie umożliwiają klikanie linków. Aplikacje oparte na modelu i kanwy
SingleLine.Text Ta opcja po prostu wyświetla tekst. Aplikacje oparte na modelu i kanwy
SingleLine.TextArea Ta opcja formatu może służyć do wyświetlania wielu wierszy tekstu. Jednak w przypadku limitu 4000 znaków kolumna Wiele wierszy tekstu jest lepszym wyborem, jeśli oczekuje się dużej ilości tekstu. Aplikacje oparte na modelu i kanwy
SingleLine.Ticker Spowoduje to zapisanie czasu ciągu w formacie prawidłowym dla znacznika. Gotowe kontrolki ujednoliconego interfejsu automatycznie umożliwiają klikanie linków. Aplikacje oparte na modelu i kanwy
SingleLine.URL Tekst powinien podać hiperlink, aby otworzyć określoną stronę. Gotowe kontrolki ujednoliconego interfejsu automatycznie poprzedzają "https://" wartościami wejściowymi, które nie zaczynają się od prawidłowego protokołu. W tej kolumnie oczekiwano tylko protokołów HTTP, HTTPS, FTP, FTPS, OneNote i TEL. Aplikacje oparte na modelu i kanwy
Dwieopcje Ta kolumna zawiera dwie opcje. Każda opcja ma wartość liczbową 0 lub 1 odpowiadającą wartości false lub true. Każda opcja ma również etykietę, aby wartości true lub false mogły być reprezentowane jako "Tak" i "Nie", "Gorące" i "Zimne", "Włączone" i "Wyłączone" lub dowolną parę etykiet, które chcesz wyświetlić. Aplikacje oparte na modelu i kanwy
Whole.None Ta opcja po prostu wyświetla liczbę. Aplikacje oparte na modelu i kanwy

Ostrzeżenie

manifest.xml Jeśli plik zawiera co najmniej jeden zestaw danych, właściwości typu Lookup.Simple powinny być również opakowane w element zestawu danych.

Elementy wartości, które nie są obsługiwane

Następujące of-type wartości właściwości nie są obecnie obsługiwane:

Wartość Description
Lookup.Customer Umożliwia pojedyncze odniesienie do rekordu konta lub kontaktu. Te wyszukiwania są dostępne dla tabel Opportunity, Case, Quote, Order i Invoice. Te tabele mają również oddzielne wyszukiwania konta i kontaktu, których można użyć, jeśli klienci są zawsze jednym typem. Możesz też dołączyć oba zamiast wyszukiwać klienta.
Lookup.Owner Umożliwia pojedyncze odwołanie do zespołu lub rekordu użytkownika. Wszystkie tabele należące do zespołu lub użytkownika mają jedną z nich.
Lookup.PartyList Umożliwia wiele odwołań do wielu tabel. Te wyszukiwania znajdują się w kolumnach Adres e-mail do i DW . Są one również używane w tabelach Phone i Appointment.
Lookup.Regarding Umożliwia pojedyncze odwołanie do wielu tabel. Te wyszukiwania znajdują się w kolumnie dotyczącej używanej w działaniach.
Przyczyna stanu Kolumna systemowa zawierająca opcje, które zawierają więcej szczegółów na temat kolumny Stan. Każda opcja jest skojarzona z jedną z dostępnych opcji stanu. Możesz dodawać i edytować opcje.
Status Kolumna systemowa zawierająca opcje, które zazwyczaj odpowiadają stanowi aktywnemu i nieaktywnego. Niektóre kolumny systemowe mają więcej opcji, ale wszystkie kolumny niestandardowe mają tylko opcje Stanu Aktywne i Nieaktywne.
Cały.Czas trwania Ta opcja formatu może służyć do wyświetlania listy opcji czasu trwania. Jednak dane przechowywane w bazie danych są zawsze liczbą minut. Kolumna wygląda jak lista rozwijana i udostępnia sugerowane opcje, takie jak 1 minuta, 15 minut, 30 minut aż do trzech dni. Osoby mogą wybrać te opcje. Jednak użytkownicy mogą również wpisać tylko kilka minut i rozpoznać ten okres czasu.
Whole.Language Ta opcja zawiera listę języków aprowizowania dla organizacji. Wartości są wyświetlane jako lista rozwijana nazw języków, ale dane są przechowywane jako liczba przy użyciu kodów LCID. Kody języków są czterocyfrowymi lub pięciocyfrowymi identyfikatorami ustawień regionalnych. Prawidłowe wartości identyfikatorów ustawień regionalnych można znaleźć na wykresie identyfikatorów ustawień regionalnych (LCID)).
Cała strefa czasowa Ta opcja wyświetla listę wybranych stref czasowych, takich jak (GMT-12:00) Międzynarodowa linia dat Zachodnia i (GMT-08:00) Czas pacyficzny (STANY ZJEDNOCZONE i Kanada). Każda z tych stref jest przechowywana jako liczba. Na przykład dla strefy czasowej (GMT-08:00) Czas pacyficzny (STANY ZJEDNOCZONE i Kanada) wartość TimeZoneCode wynosi 4.

Uwaga / Notatka

W tej chwili kolumny plik nie są obsługiwane. Więcej informacji: Kolumny plików

Używanie wartości pfx-default-value

pfx-default-value Użyj wartości właściwości, aby ocenić zdarzenia i właściwości przy użyciu wyrażeń Power Fx zamiast statycznych wartości domyślnych. W tym celu można wykonać następujące czynności:

  • Dynamiczne ustawianie rozmiaru kontrolki
  • Uzyskiwanie dostępu do łączników
  • Podaj przykładowe dane
  • Właściwości motywu odwołania
  • Zdarzenia niestandardowe

Uwaga / Notatka

  • Możesz użyć dowolnego wyrażenia Power Fx, ale upewnij się, że wyrażenie jest prawidłowe podczas importowania kontrolki.
  • Jeśli używasz cudzysłowów wewnętrznych lub innych znaków specjalnych, zawijaj wartość w pojedynczych cudzysłowach, na przykład: pfx-default-value='"Test"'
  • Możesz odwoływać się do innych kontrolek (w tym ekranów) i ich właściwości. Zapisz te odwołania jako: %ControlName.ID%.ControlProperty. Przykład: pfx-default-value='SubmitForm(%MyFormName.ID%)'
  • Napisz wyliczenia, takie jak DisplayType i ScreenTransition jako: %EnumName.RESERVED%.EnumValue. Przykład: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
  • Jeśli pfx-default-value element jest uwzględniony, pierwszeństwo ma wartość default-value.

Elementy nadrzędne

Składnik Description
kontrola Definiuje przestrzeń nazw, wersję i wyświetlanie informacji o składniku.

Example

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

Dokumentacja schematu manifestu platformy składników usługi Power Apps
Dokumentacja interfejsu API platformy składników usługi Power Apps
Omówienie struktury składników usługi Power Apps