Operatorer och identifierare

Operatorerna som Microsoft Power Fx beskrivs nedan. En del av de här operatorerna är beroende av författarens språk. Mer information finns i Globala program.

operatorerna in och exactin

Använd operatörerna in och exactin för att hitta en sträng i en datakälla, som en samling eller en importerad tabell. In-operatorn identifierar matchningar oavsett skiftläge och exactin-operatorn identifierar bara matchningar om skiftläget är detsamma. Här är ett exempel:

1. Skapa eller importera en samling med namnet Lager och visa den i ett galleri, enligt beskrivningen i den första proceduren i Visa bilder och text i ett galleri.

2. Ställ in galleriets egenskap Items på följande formel:
   Filter (Lager, "E" i ProductName)

   Galleriet visar alla produkter utom Callisto, eftersom namnet på den här produkten är den enda som inte innehåller den angivna bokstaven.

3. Ändra galleriets egenskap Items till den här formeln:
   Filter (Lager, "E" exakt ProductName)

   Galleriet visar bara Europa, eftersom det bara är det namnet som innehåller bokstaven som du angav i det skiftläget du angav.

ThisItem, ThisRecord och Som operatörer

Några kontroller och funktioner använder formler för enskilda poster i en tabell. Använd något av följande om du vill referera till en enskild post i en formel:

ThisItem-operator

I följande gallerikontroll är t.ex. egenskapen Objekt inställd på datakällan Anställda (t.ex. entiteten Anställda som ingår i exemplet Northwind Traders):

Employees

Det första objektet i galleriet är en mall som replikeras för varje medarbetare. I mallen använder formeln för bilden ThisItem för att referera till det aktuella objektet:

ThisItem.Picture

På samma sätt använder formeln för namnet även ThisItem:

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

ThisRecord-operator

ThisRecord används i funktioner som har ett postomfång. Vi kan t.ex. använda funktionen Filter med galleriets egenskap Items för att endast visa förnamn som börjar på M:

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

ThisRecord är valfritt och underförstått genom att använda fälten direkt, till exempel, i det här fallet, kunde vi ha skrivit:

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

Även om det är valfritt kan användning av ThisRecord göra formler lättare att förstå och kan krävas i tvetydiga situationer där ett fältnamn också kan vara ett relationsnamn. ThisRecord är valfritt medan ThisItem alltid krävs.

Använd ThisRecord för att referera till hela posten med Patch, Collect och andra postomfattningsfunktioner. Följande formel anger till exempel statusen för alla inaktiva medarbetare till aktiv:

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

Som operator

Använd Som operator om du vill namnge en post i en galleri- eller postomfattningsfunktion och åsidosätta standardnamnet ThisItem eller ThisRecord. Att namnge posten kan göra dina formler lättare att förstå och kan krävas i kapslade situationer för att få tillgång till poster i andra omfattningar.

Du kan t.ex. ändra egenskapen Items i vårt galleri om du vill använda Som för att identifiera att vi arbetar med en medarbetare:

Employees As Employee

Formlerna för bilden och namnet justeras för att använda det här namnet för den aktuella posten:

Employee.Picture

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

As kan också användas med postomfångsfunktioner för att ersätta standardnamnet ThisRecord. Vi kan tillämpa detta på vårt föregående exempel för att klargöra vilken post vi arbetar med:

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

När du kapslar in gallerier och postomfattningsfunktioner refererar ThisItem och ThisRecord alltid till den innersta omfattningen lämnar poster i yttre omfattningar otillgängliga. Använd Som för att tillgängliggöra alla postomfattningar genom att ge alla ett unikt namn.

Med den här formeln skapas till exempel ett schackmönster som en textsträng genom att kapsla två ForAll-funktioner:

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 
)

Att ange en Label-kontrolls egenskap Text till denna formel visar:

Låt oss packa upp vad som händer här:

• Vi börjar med att iterera en namnlös tabell med åtta numrerade poster från funktionen Sequence. Denna loop gäller för varje rad på brädet, som vanligtvis kallas för rang, så vi ger den detta namn.
• För varje rad itererar vi en annan namnlös tabell med åtta kolumner, och vi ger det allmänna namnet Fil.
• Om Rank.Value + File.Value är ett udda tal, får fyrkanten ett X, annars en punkt. Den här delen av formeln refererar till båda ForAll-loopar, vilket möjliggörs genom att använda operatorn Som.
• Concat används två gånger, först för att sätta ihop kolumnerna och sedan raderna, med en Char(10) inkastad för att skapa en ny rad.

Ett liknande exempel är möjligt med kapslade Gallery-kontroller i stället för ForAll-funktioner. Vi börjar med det vertikala galleriet för Rang. Den här gallerikontrollen har följande objekt-formel:

Sequence(8) as Rank

I det här galleriet placerar vi ett horisontellt galleri för filen, som replikeras för varje rang, med en Itemsegenskap som är:

Sequence(8) as File

I det här galleriet lägger vi slutligen till en Label-kontroll som ska replikeras för varje fil och varje rang. Vi gör så att det fyller hela utrymmet och använder egenskapen Fill för att ange färgen med formeln:

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

Self- och Parent-operatorer

Det finns tre sätt att referera till en kontroll och dess egenskaper i en formel:

Self och Parent är operatorer och inte egenskaper för själva kontrollerna. Referera till Parent.Parent, Self.Parent eller Parent.Self stöds inte.

Namn på identifierare

Namnen på variabler, datakällor, kolumner och andra objekt kan innehålla Unicode.

Använd enkla citattecken runt ett namn som innehåller blanksteg eller specialtecken.
Använd två enda citat tillsammans för att representera en enda offert i namnet. Namn som inte innehåller specialtecken kräver inga enstaka citattecken.

Här följer några exempel på kolumnnamn som du kan stöta på i en tabell och hur de visas i en formel:

Dubbla citattecken används för att Ange textsträngar.

Visningsnamn och logiska namn

Vissa datakällor, t.ex. SharePoint och Microsoft Dataverse har två olika namn som refererar till samma tabell eller datakolumn:

• Logiskt namn - Ett namn som garanterat är unikt, som inte ändras efter att det har skapats, som vanligtvis inte tillåter mellanslag eller andra specialtecken och som inte är lokaliserat till olika språk. På grund av detta kan namnet vara kryptiskt. Dessa namn används av professionella utvecklare. Till exempel cra3a_customfield. Namnet kan också kallas schemanamn eller endast namn.

• Visningsnamn – Ett namn som är användarvänligt och avsett att ses av slutanvändare. Det här namnet kanske inte är unikt, kan ändras över tid, kan innehålla blanksteg och eventuella Unicode-tecken och kan lokaliseras till olika språk. Motsvarande exemplet ovan kan visningsnamnet vara ett anpassat fält med blanksteg mellan orden.

Eftersom visningsnamnen är lättare att förstå föreslår Power Fx dem som alternativ och inte logiska namn. Även om logiska namn inte föreslås kan de fortfarande användas om de skrivs indirekt.

Anta till exempel att du har lagt till ett anpassat fält i en entitet i Dataverse. Ett logiskt namn tilldelas av systemet som du endast kan ändra när du skapar fältet. Resultatet skulle se ut ungefär så här:

När du redigerar en referens till ett fält med konton kommer förslaget att användas som "anpassat fält", eftersom det är visningsnamnet. Enkla offerter måste användas eftersom det finns ett blanksteg i det här namnet:

När du har valt förslaget visas "anpassat fält" i formelfältet och data hämtas:

Även om det inte föreslås kan vi också använda det logiska namnet för det här fältet. Detta resulterar i att samma data hämtas. Inga enskilda offerter krävs eftersom det här namnet inte innehåller blanksteg eller specialtecken:

I bakgrunden upprätthålls en mappning mellan de visningsnamn som visas i formler och de underliggande logiska namnen. Eftersom logiska namn måste användas för att interagera med datakällan används den här mappningen för att konvertera från det aktuella visningsnamnet till det logiska namnet automatiskt och det är det som visas i nätverkstrafiken. Mappningen används också för att konvertera tillbaka till logiska namn för att växla till nya visningsnamn, till exempel om ett visningsnamn ändras eller en tillverkare på ett annat språk redigerar programmet.

Namndisambiguering

Eftersom visningsnamnen inte är unika kan samma visningsnamn visas mer än en gång i samma entitet. När detta inträffar läggs det logiska namnet till i slutet av visningsnamn inom parentes för ett av namnen som står i konflikt. Bygger på exemplet ovan, om det fanns ett andra fält med samma visningsnamn av anpassat fält med ett logiskt namn på cra3a_customfieldalt då visas förslagen:

Strängar på namndisambiguering läggs till i andra situationer när namnkonflikter uppstår, t.ex. namnen på entiteter, alternativuppsättningar och andra Dataverse-objekt.

Disambigueringsoperator

Vissa funktioner skapar postområden för att få åtkomst till fälten i tabellen när posterna bearbetas, t.ex. Filter, AddColumns och Sum. Fältnamn som lagts till med postområdet åsidosätter samma namn från andra ställen i programmet. När det händer så kan du fortfarande komma åt värden från utanför omfattningsposten med disambigueringsoperatorn @:

• Om du vill komma åt värden från kapslade postområden använder du operatorn @ med namnet på den tabell som bearbetas, och med hjälp av följande mönster:
  Tabell[@FieldName]
• Om du vill komma åt globala värden, som datakällor, samlingar och kontextvariabler, använder du mönstret [@ObjectName] (utan tabellbeteckning).

Mer information och exempel finns i postomfång.