Operatory i identyfikatory w Power Apps

Dotyczy: aplikacje kanwy aplikacje oparte na modelu

Niektóre z tych operatorów są zależne od języka autora. Aby uzyskać więcej informacji na temat obsługi języków w aplikacjach kanwy, zobacz Aplikacje globalne.

operatory in i exactin

Za pomocą operatorów in i exactin można wyszukiwać ciągi w źródle danych, takim jak kolekcja lub zaimportowana tabela. Operator in określa dopasowania niezależnie od wielkości liter, a operator exactin określa dopasowania na podstawie tej samej wielkości liter. Oto przykład:

1. Utwórz lub zaimportuj kolekcję o nazwie Zapasy i wyświetl ją w galerii zgodnie z opisem w pierwszej procedurze zawartej w temacie Wyświetlanie obrazów i tekstu w galerii.

2. Ustaw właściwość Items galerii za pomocą tej formuły:
   Filter(Inventory, "E" in ProductName)

   W galerii zostaną wyświetlone wszystkie produkty z wyjątkiem Callisto, ponieważ nazwa tego produktu jest jedyną, która nie zawiera wskazanej litery.

3. Zmień właściwość Items galerii za pomocą tej formuły:
   Filter(Inventory, "E" exactin ProductName)

   W galerii pojawi się tylko Europa, ponieważ tylko w tej nazwie występuje wskazana wielka litera.

Operatory ThisItem, ThisRecord i As

Kilka kontrolek i funkcji stosuje formuły do poszczególnych rekordów tabeli. Aby odwołać się do konkretnego rekordu w formule, należy użyć jednej z następujących opcji:

Operator ThisItem

Na przykład w następującej kontrolce Gallery właściwość Items ma ustawioną wartość Pracownicy źródło danych (na przykład tabelę Pracownicy w przykładzie "Northwind Traders):

Employees

Pierwsza pozycja w galerii to szablon, który jest replikowany dla każdego pracownika. Formuła na tym szablonie używa narzędzia ThisItem, aby odwołać się do bieżącego elementu:

ThisItem.Picture

Podobnie formuła nazwy zawiera także ThisItem:

ThisItem.'First Name' & " " & ThisItem.'Last Name'

Operator ThisRecord

ThisRecord jest używany w funkcjach mających zakres rekordów. Można na przykład użyć funkcji Filter z właściwością Items galerii, aby były widoczne tylko imiona z M:

Filter( Employees, StartsWith( ThisRecord.Employee.'First Name', "M" ) )

ThisRecord jest opcjonalny i implikowany przy użyciu pól bezpośrednio, na przykład w tym przypadku można napisać:

Filter( Employees, StartsWith( 'First Name', "M" ) )

Mimo że jest to opcjonalne, użycie ThisRecord może poprawiać czytelność formuł i może być wymagane w niejednoznacznych sytuacjach, gdy nazwa pola może być również nazwą relacji. ThisRecord jest opcjonalne, a ThisItem jest zawsze wymagany.

Użyj ThisRecord, aby odwołać się do całego rekordu za pomocą funkcji Patch, Collect i innych funkcji dotyczących zakresu rekordu. Na przykład poniższa formuła ustawia status wszystkich nieaktywnych pracowników na aktywny:

With( { InactiveEmployees: Filter( Employees, Status = 'Status (Employees)'.Inactive ) },
      ForAll( InactiveEmployees,
              Patch( Employees, ThisRecord, { Status: 'Status (Employees)'.Active } ) ) )

Jako operator

Użyj operatora As jako nazwy rekordu w galerii lub funkcji zakresu rekordów zastępując je domyślne ThisItem lub ThisRecord. Nazwa rekordu może ułatwiać zrozumienie formuł i może być wymagana w sytuacjach zagnieżdżonych w celu uzyskania dostępu do rekordów w innych zakresach.

Można na przykład zmodyfikować właściwość Items w galerii, aby użyć As w celu zidentyfikowania pracy z Pracownikiem:

Employees As Employee

Formuły obrazu i nazwy są dostosowywane, aby używać tej nazwy dla bieżącego rekordu:

Employee.Picture

Employee.'First Name' & " " & Employee.'Last Name'

As może być również używane z funkcjami zakresu rekordów w celu zastąpienia nazwy domyślnej ThisRecord. Możemy zastosować to do naszego poprzedniego przykładu, aby wyjaśnić rekord, z którym pracujemy:

With( { InactiveEmployees: Filter( Employees, Status = 'Status (Employees)'.Inactive ) },
      ForAll( InactiveEmployees As Employee,
              Patch( Employees, Employee, { Status: 'Status (Employees)'.Active } ) ) )

Zagnieżdżanie galerii i funkcji zakresu rekordów ThisItem i ThisRecord zawsze odnosi się do wewnętrznego najstarszego zakresu, natomiast pozostawienie rekordów w zakresach zewnętrznych nie jest dostępne. Użyj As, aby udostępnić wszystkie zakresy rekordów, nadając każdemu unikalną nazwę.

Na przykład ta formuła tworzy wzór szachownicy jako ciąg tekstowy, zagnieżdżając dwie funkcje ForAll:

Concat(
    ForAll( Sequence(8) As Rank,
        Concat(
            ForAll( Sequence(8) As File,
                    If( Mod(Rank.Value + File.Value, 2) = 1, " X ", " . " )
            ),
            Value
        ) & Char(10)
    ),
    Value
)

Ustaw kontrolkę Label i ustaw dla jej właściwości Text, aby wyświetlała następującą formułę:

Przyjrzyjmy się teraz, co się tu dzieje:

• W tym celu należy zaszeregować nienazwanej tabeli z 8 ponumerowanych rekordów z funkcji Sequence. Pętla jest dla każdego wiersza planszy, która jest zwykle określana jako Ranga i dlatego nadamy jej taką nazwę.
• Dla każdego wiersza iterujemy kolejną nienazwaną tabelę z 8 kolumnami i podajemy wspólną nazwę Plik.
• Jeśli Rank.Value + File.Value to liczba nieparzysta, w polu jest wyświetlona X, a w innym przypadku kropka. Ta część formuły zawiera odwołanie do dwóch pętli ForAll, które można wykonać przy użyciu operatora As.
• Concat jest używany dwa razy, najpierw w celu utworzenia kolumn, a następnie wierszy z dodanym Char(10), aby utworzyć nowy wiersz.

Podobny przykład jest możliwy w zagnieżdżonych kontrolkach Gallery zamiast funkcji ForAll. Zacznijmy od pionowej galerii Rangi. W tej kontrolce galerii elementy będą zawierać formułę Elementy z:

Sequence(8) as Rank

W tej galerii umieścimy poziomą galerię Pliku, która będzie replikowana dla każdej Rangi, dla której właściwość Items zawiera:

Sequence(8) as File

W tej galerii dodamy również kontrolkę Label, która będzie replikowana dla każdego Pliku i każdej Rangi. Dopasujemy rozmiar tak, aby wypełniał całą przestrzeń i użyjemy właściwości Fill, aby zapewnić kolor według tej formuły:

If( Mod( Rank.Value + File.Value, 2 ) = 1, Green, Beige )

Operatory Self i Parent

Istnieją trzy sposoby odwołania się do kontrolki i jego właściwości w formule:

Self i Parent są operatorami, a nie własnościami w samych kontrolkach. Odwoływanie się do Parent.Parent, Self.Parent lub Parent.Self nie jest obsługiwane.

Nazwy identyfikatorów

Nazwy zmiennych, Yródeł danych, kolumn i innych obiektów mogą zawierać dowolny kod Unicode.

Użyj cudzysłowów pojedynczych w nazwie, która zawiera spację lub inny znak specjalny.
Użyj dwóch cudzysłowów pojedynczych razem, aby przedstawić pojedyńczy cudzysłów w nazwie. Nazwy, które nie zawierają znaków specjalnych, nie wymagają pojedynczych cudzysłowów.

Oto kilka przykładowych nazw kolumn, które możesz napotkać w tabeli, oraz sposób ich reprezentowania w formule:

Podwójne cudzysłowy są używane do oznaczania ciągów tekstowych.

Nazwy wyświetlane i nazwy logiczne

Niektóre źródła danych, takie jak SharePoint i Microsoft Dataverse mają dwie różne nazwy, aby odwołać się do tej samej tabeli lub kolumny z danymi:

• Nazwa logiczna — nazwa, która zapewnia unikatowość, nie zmienia się po utworzeniu, zazwyczaj nie zezwala na spacje lub inne znaki specjalne i nie jest zlokalizowana w różnych językach. W rezultacie nazwa może być tajemnicza. Te nazwy są używane przez profesjonalnych deweloperów. Na przykład: cra3a_customfield. Nazwę tę może również nazywać Nazwa schematu lub nazwa.

• Wyświetlana nazwa — Nazwa, która jest przyjazna dla użytkownika i przewidziana do oglądania przez użytkowników końcowych. Zmiana nazwy nie może być unikatowa, ale może zawierać spacje i dowolny znak Unicode oraz może być zlokalizowana w różnych językach. Zgodnie z powyższym przykładem, wyświetlaną nazwą może być Pole niestandardowe ze spacją między słowami.

Ponieważ łatwiejsze jest zrozumienie nazw wyświetlanych, aplikacje kanwy sugerują je jako wybory i nie sugerują nazw logicznych. Chociaż nazwy logiczne nie są sugerowane, nadal można ich używać, jeśli są wpisywane pośrednio.

Załóżmy na przykład, że dodałeś Pole niestandardowe do tabeli w Dataverse. Nazwa logiczna zostanie dla Ciebie przypisana przez system, który możesz modyfikować tylko podczas tworzenia pola. Wyniki mogą wyglądać podobnie do następujących:

Podczas tworzenia odwołania do pola kont, sugestia zostanie wykorzystana jako Pole niestandardowe, ponieważ jest to wyświetlana nazwa. Należy użyć pojedynczych cudzysłowów, ponieważ ta nazwa zawiera spację:

Po wybraniu sugestii „Pole niestandardowe” jest wyowietlane na pasku formuł i pobierane są następujące dane:

Chociaż nie jest to sugerowane, można też użyć nazwy logicznej dla tego pola. To spowoduje, że pobierane będą te same dane. Nie jest wymagany pojedynczy cudzysłów, ponieważ nazwa nie zawiera spacji ani znaków specjalnych:

W tle są zachowywane mapowania między wyświetlanymi nazwami używanymi w formułach i podstawowymi nazwami logicznymi. Ponieważ do interakcji ze źródłem danych muszą być używane nazwy logiczne, to odwzorowanie służy do automatycznej konwersji bieżącej nazwy wyświetlanej na nazwę logiczną i to właśnie widać w ruchu sieciowym. To mapowanie jest również używane do konwersji z powrotem na nazwy logiczne w celu przełączenia się na nowe nazwy wyświetlane, na przykład, jeśli nazwa wyświetlana ulegnie zmianie lub producent w innym języku edytuje aplikację.

Uściślanie nazwy

Ponieważ nazwy wyświetlane nie są niepowtarzalne, ta sama nazwa wyświetlana może pojawić się więcej niż raz w tej samej tabeli. W takim przypadku nazwa logiczna zostanie dodana na końcu wyświetlana nazwa w nawiasach dla jednej z nazw, które kolidują ze sobą. Opierając się na powyższym przykładzie, jeśli istnieje drugie pole z tą samą wyświetlana nazwa Pola niestandardowego o nazwie logicznej cra3a_customfieldalt, zostałyby wyświetlona sugestia:

Ciągi rozsyłania nazw są dodawane w innych sytuacjach, gdy występują konflikty nazw, na przykład nazwy tabeli, opcje i inne elementy Dataverse.

Operator uściślania

Niektóre funkcje, takie jak Filter, AddColumns i Sum, tworzą zakresy rekordów umożliwiające uzyskiwanie dostępu do pól tabeli podczas przetwarzania poszczególnych rekordów. Nazwy pól dodane za pomocą zakresu rekordów przesłaniają te same nazwy z innych miejsc w aplikacji. W takim przypadku dostęp do wartości znajdujących się poza zakresem rekordów można uzyskać za pomocą operatora uściślania @:

• Aby uzyskać dostęp do wartości z zagnieżdżonych zakresów rekordów, zastosuj operator @ z nazwą używanej tabeli, korzystając ze wzorca:
  Tabela[@FieldName]
• Aby uzyskać dostęp do wartości globalnych, takich jak źródła danych, kolekcje i zmienne kontekstowe, użyj wzorca [@NazwaObiektu] (bez oznaczenia tabeli).

Aby zapoznać się z dodatkowymi informacjami i przykładami, zobacz Zakresy rekordów.