Power Apps-eko eragileak eta identifikatzaileak

Hauei aplikatzen zaie: Canvas aplikazioei Ereduetan oinarritutako aplikazioei Power Pages

Eragile horietako batzuk egilearen hizkuntzaren mende daude. Oihal-aplikazioetako hizkuntza-laguntzari buruzko informazio gehiago lortzeko, ikus Aplikazio orokorrak.

Sinboloa	Idatzi	Adibidez	Deskribapenak
'...'	Identifikatzailea	'Kontuaren izena'	Karaktere bereziak dituzten identifikatzaileak, zuriuneak barne, komatxo bakarren artean sartzen dira
"..."	Testu-katea	Kaixo mundua	Testu-kateak komatxo biren artean sartzen dira
$"..."	Kateen interpolazioa	$"Dear {FirstName},"	Testu-kate baten barruan txertatutako formulak
.	Propietate hautatzailea	Slider1.Value Color.Red Acceleration.X	Propietate bat ateratzen du taula, kontrol, seinale, edo enumerazio batetik. Atzerako bateragarritasuna lortzeko, ! ere erabil daiteke.
. [hizkuntzaren mendekoa]	Hamartarren bereizlea	1.23	Zenbakien zati osoen eta zatikiarren arteko banatzailea. Karakterea hizkuntzaren araberakoa da.
( )	Parentesiak	Iragazkia(T, A < 10) (1 + 2) * 3	Lehentasunezko ordena betearazten du, eta azpi-espresioak multzo handiagoan bildu
+	Eragile aritmetikoak	1 + 2	Batuketa
-		2 - 1	Kenketa eta ikurra
*		2 * 3	Biderketa
/		2 / 3	Zatiketa (ikus Mod funtzioa)
^		2 ^ 3	Berreketa, Power funtzioaren baliokidea
%		% 20	Ehunekoa (baliokidea hurrengora "* 1/100")
=	Konparazio-eragileak	Prezioa = 100	Honen berdina
>		Prezioa > 100	Hau baino handiagoa
>=		Prezioa >= 100	Honen berdina edo handiagoa da
<		Prezioa < 100	Hau baino txikiagoa
<=		Prezioa <= 100	Honen berdina edo txikiagoa da
<>		Prezioa <> 100	Ez da honen berdina
&	Kateak kateatzeko eragilea	"kaixo" & " " & "mundua"	Hainbat kate jarraitu azaltzea egiten du
&& edo Eta	Eragile logikoak	Prezioa < 100 && Graduatzailea1.Balioa = 20 edo Prezioa < 100 eta Slider1.Value = 20	Bateratze logikoa, eta funtzioaren baliokidea
|| edo edo		Prezioa < 100 || Slider1.Value = 20 edo Prezioa < 100 Edo Slider1.Value = 20	Bereizketa logikoa, Or funtzioaren baliokidea
! edo Ez		!(Prezioa < 100) edo Ez (Prezioa < 100)	Ezeztapen logikoa, Not funtzioaren baliokidea
exactin	Harpidetza eragileak	Gallery1.Hautatutako exactin SavedItems	Bilduma edo taula bati dagokiona
exactin		"Windows" zehaztuta “Bistaratzeko leihoak Windows eragiketa sistema...”	Azpikatearen proba (maiuskulak/minuskulak bereizten ditu)
hemen:		Gallery1.SavedItems-en hautatua	Bilduma edo taula bati dagokiona
hemen:		" Aktibatuta "Teklatuak eta monitorea..."	Azpikatearen proba (maiuskulak/minuskulak ez ditu bereizten)
@	Desanbiguazio eragilea	MyTable[@fieldname]	Eremuen desanbiguazioa
@		[@MyVariable]	Desanbiguazio orokorra
, [hizkuntzaren mendekoa]	Zerrenda bereizlea	(X < 10, "Baxua", "Ona") bada { X: 12, Y: 32 } [ 1, 2, 3 ]	Banatzen du: Funtzio deietako argumentuak erregistro bateko eremuak taula bateko erregistroak Karaktere hori hizkuntzaren araberakoa da.
; [hizkuntzaren mendekoa]	Formulen kateamendua	Collect(T, A); Navigate(S1, "")	Funtzioen deiak bereizi portaera-propietateetan. Kateamendu-eragilea hizkuntzaren araberakoa da.
gisa	Eragile gisa	Bezero gisa AllCustomers	Baliogabetzea ThisItem eta ThisRecord galerietan eta erregistro-eremuko funtzioak. Gisa izen hobea eta zehatza emateko erabilgarria da eta bereziki garrantzitsua da habiaratutako agertokietan.
Automatikoa	Norbera operadorea	Self.Fill	Uneko kontrolaren propietateetarako sarbidea eskaintzen du
Nagusia	Eragile nagusia	Parent.Fill	Kontrol-edukiontzi baten propietateetarako sarbidea
ThisItem	ThisItem eragilea	ThisItem.FirstName	Galeriarako edo inprimakien kontrolerako eremuetarako sarbidea
ThisRecord	ThisRecord operadorea	ThisRecord.FirstName	Sartu erregistro osora eta banakako eremuetara ForAll, Sum, With, eta beste erregistro irismenaren funtzioak. Ezin da gehiagotu Gisa operadorea.

Oharra

@ operadorea erregistro objektuaren mota datu iturri baten aurka balioztatzeko ere erabil daiteke. Adibidez, Collect(coll,Account@{'Account Number: 1111')

in eta exactin eragileak

Erabili hurrengoan eta exactin operadoreek kate bat aurkitzeko a datu-iturburu, adibidez, bilduma edo inportatutako taula. in eragileak bat datozenak idenfitikatzen ditu, kasua edozein izanda ere eta exactin eragileak bat datozenak identifikatzen ditu maiuskulaz berdin idatzita badaude soilik. Hona hemen adibide bat:

1. Sortu edo inportatu Inbentarioa izeneko bilduma bat eta erakutsi galerian, Irudiak eta testua galerian erakutsi ataleko lehenengo prozeduran azaltzen den moduan.

2. Ezarri galeriako Elementuak propietatea honako formula honetan:
   Iragazi(Inbentarioa, "E" hemen: ProductName)

   Galeriak produktu guztiak erakusten ditu Callisto izan ezik, produktu horren izena delako zuk zehaztutako hizkia ez daukan bakarra.

3. Aldatu galeriako Elementuak propietatea honako formula honetara:
   Iragazi(Inbentarioa, "E" exactin ProductName)

   Galeriak Europa bakarrik erakusten du bere izenak soilik daukalako zuk zehaztutako hizkia zehaztu duzun moduan (maiusukulaz edo minuskulaz).

ThisItem, ThisRecord eta As operadoreak

Kontrol eta funtzio batzuk formulak aplikatzen dituzte taula bateko banakako erregistroetan. Formula batean erregistro indibiduala erreferentzia egiteko, erabili ekintza hauetako bat:

Eragilea	Honi dagokio	Deskribapenak
ThisItem	Galeria kontrola Editatu inprimakia kontrola Bistaratu inprimakia kontrola	Uneko erregistroaren izen lehenetsia a-n Galeria edo formaren kontrola.
ThisRecord	ForAll, Iragazkia, Hurrengoarekin, Batuketa eta beste erregistroaren esparrua funtzioak	Egungo erregistroaren izen lehenetsia ForAll eta beste erregistroen irismenaren funtzioak.
Gisaizena	Galeria kontrola ForAll, Iragazkia, Hurrengoarekin, Batuketa eta beste erregistro-esparru funtzioak	Definitzen du izena uneko erregistrorako, lehenespenez ordezkatuz ThisItem edo ThisRecord. erabilera- Gisa formulak errazago ulertu eta ebazteko anbiguotasuna ebaztean.

ThisItem eragilea

Adibidez, hurrengo Galeria kontrolean, Elementuak propietatea ezarrita dago Langileak datu-iturburuan (adibidez Langileak taula Northwind Traders laginean):

Employees

Galeriako lehen elementua langile bakoitzari errepikatzen den txantiloia da. Txantiloian, irudiaren formula erabiltzen da ThisItem uneko elementua aipatzeko:

ThisItem.Picture

Era berean, izenaren formulak ere erabiltzen du ThisItem:

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

ThisRecord operadorea

ThisRecord a duten funtzioetan erabiltzen da erregistro-eremua. Adibidez, erabil dezakegu Filter funtzioa gure galeriarekin elementuak ondasun horrekin izenak bakarrik erakusteko propietatea M:

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

ThisRecord aukerakoa eta inplikatua da eremuak zuzenean erabiliz, adibidez, kasu honetan idatzi genezake:

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

Aukerakoa izan arren, erabiliz ThisRecord formulak ulertzeko errazagoak izan daitezke, eta litekeena da eremu-izen bat ere harreman-izen bat izan daitekeen egoera anbiguoetan. ThisRecord aukerakoa da bitartean ThisItem beti beharrezkoa da.

Erabili ThisRecord disko osoa erreferentea izateko Patch, Collect, eta beste erregistro irismenaren funtzioak. Adibidez, ondorengo formulak langile aktibo guztiek egoera aktiboan ezartzen dute:

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

Eragile gisa

Erabili Gisa operadorea erregistro bat galeria edo erregistro irismenaren funtzioan izendatzeko, lehenetsitakoa gaindituz ThisItem edo ThisRecord. Erregistroa izendatzeak zure formulak errazago ulertzen ditu eta beste habitate egoeretan erregistratu ahal izatea eskatzen du.

Adibidez, alda dezakezu elementuak erabiltzeko gure galeriaren jabetza Gisa Langile batekin ari garela identifikatzeko:

Employees As Employee

Irudiaren eta izenaren formulak egokitu egiten dira izen hori uneko erregistrorako erabiltzeko:

Employee.Picture

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

As erregistro-irispeneko funtzioekin ere erabil daiteke lehenetsitako izena ordezkatzeko ThisRecord. Gure aurreko adibidean aplika dezakegu lantzen ari garen erregistroa argitzeko:

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

Galeriak habiatzerakoan eta erregistro-eremuko funtzioak egitean, ThisItem eta ThisRecord beti aipatzen da barruko esparru gehien, erregistroak kanpoko esparruetan eskuragarri ez utziz. Erabili Gisa erregistro esparru guztiak eskuragarri jartzea, izen bakarra emanez.

Adibidez, formula honek xake-taula bat sortzen du testu-kate gisa bi habia eginez ForAll funtzioak:

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
)

Ezartzea Label kontrolaren Testua propietatea formula honetara, honela bistaratzen da:

Deskonektatu dezagun zer gertatzen ari den hemen:

• Honako 8 zenbakizko erregistroen izenik gabeko taula bat hasten dugu Sequence funtzioa. Begizta hau taulako errenkada bakoitzarentzat da Sailkapena eta, beraz, izen hori ematen diogu.
• Errenkada bakoitzeko, izenik gabeko beste taula bat 8 zutabekoa da eta izen arrunta ematen dugu Fitxategia.
• Bada Rank.Value + File.Value zenbaki bakoitiak dira, karratuak X, bestela, puntu bat. Formularen zati hau biak aipatzen dira Guztientzat begiztak posible dira Gisa operadorea.
• Kateatu bi aldiz erabilia, lehenik batu zutabeak eta gero errenkadak Char(10) botata sortzeko lerro berria.

Antzeko adibidea posible da habiaratutakoekin Galeria kontrolak ordez ForAll funtzioak. Has gaitezen galeria bertikalarekin Sailkapena. Galeriako kontrol honek fitxategi bat izango du elementuak formula honen:

Sequence(8) as Rank

Galeria honen barruan, galeria horizontala kokatuko dugu fitxategia, bakoitzarentzat errepikatuko da Sailkapena, elementuak jabetzakoa:

Sequence(8) as File

Azkenik, galeria honen barruan, gehitu egingo dugu Label bakoitzarentzako errepikatuko den kontrola Fitxategia eta bakoitza Sailkapena. Size egingo dugu espazio osoa betetzeko eta erabiliko dugu Fill propietateari formula hau emateko kolorea:

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

Auto eta Gurasoen operadoreak

Hiru modu daude kontrol bati eta bere propietateei formula baten barruan aipatzeko:

Metodoa	Deskribapenak
Kontrolaren izenaren arabera	Edozein kontrolak izenaren bidez erreferentzia daitezke aplikazioaren edozein lekutatik. Adibidez, Label1.Fill Izena nork duen izenaren jabetza betetzeari egiten dio erreferentzia Label1.
Norbera operadorea	pAskotan komenigarria da formula bera idazterakoan kontrol bereko beste propietate bat aipatzea. Izenaren arabera erreferentzia absolutua erabili beharrean, errazagoa eta eramangarriagoa da baten erreferentzia erlatiboa erabiltzeanorbera. Norbera operadoreak sarrera erraza ematen du uneko kontrolerako. Adibidez, Self.Fill korrontearen kontrol betetze koloreari egiten dio erreferentzia.
Guraso operadorea	Zenbait kontrolek beste kontrol batzuk izaten dituzte, adibidez Screen eta Gallery kontrolak. Bere barruan dauden kontrolen ostalaritza kontrolari deritzo guraso. Bezala Norbera operadorea, Gurasoa operadorea edukiontzien kontrolari buruzko erreferentzia erlatibo erraza eskaintzen du. Adibidez, Parent.Fill uneko kontrolerako edukiontzia den edukiaren betetzeari egiten dio erreferentzia.

Norbera eta Guraso operadoreak dira eta ez kontrolak beraien propietateak. Aipatuz Parent.Parent, Self.Parent edo Parent.Self ez da onartzen.

Identifikatzaileen izenak

Aldagaien, datu-iturburuen, zutabeen eta beste objektu batzuen izenek edozein Unicode eduki dezakete.

Erabili komatxo bakarra espazio bat edo beste karaktere berezi bat duen izenaren inguruan.
Erabili bi komatxo bakar izenean komatxo bakarra irudikatzeko. Karaktere bereziak ez dituzten izenek ez dute komatxo bakarra behar.

Hona hemen taula batean topa ditzakezun zutabe izen batzuk eta horiek formula batean nola irudikatzen diren:

Datu-base bateko zutabe baten izena	Zutabeen erreferentzia formula batean
SimpleName	SimpleName
NameWith123Numbers	NameWith123Numbers
Izena zuriuneekin	'Name with spaces'
Izena komatxo "bikoitzekin"	'Name with "double" quotes'
Izena komatxo 'bakarrekin'	'Name with ''single'' quotes'
@ ikurra duen izena	'Name with an @ at sign'

Komatxo bikoitzak erabiltzen dira testu-kateak izendatzeko.

Bistaratu izenak eta izen logikoak

Zenbait datu-iturrik, esaterako SharePoint eta Microsoft Dataverse-ek, bi izen desberdin dituzte datu-taula edo datu-zutabe berari erreferentzia egiteko:

• Izen logikoa - Izen esklusiboa, ez da sortu ondoren aldatzen, normalean ez du espaziorik edo bestelako karaktere berezirik onartzen eta ez da hizkuntza desberdinetara egokitzen. Ondorioz, izena kriptikoa izan daiteke. Izen horiek garatzaile profesionalek erabiltzen dituzte. Adibidez cra3a_customfield. Izen horri ere erreferentzia egin dakiokegu eskemaren izena edo besterik gabe izena erabiliz.

• Bistaratzeko izena - Erabilerraza den izena eta amaierako erabiltzaileek ikusteko izena. Baliteke izen hori esklusiboa ez izatea, denboran zehar aldatzea, espazioak eta Unicode karaktereak edukitzea eta hizkuntza desberdinetara egokitzea. Goiko adibideari dagokionean, bistaratzeko izena izan daiteke Pertsonalizatutako eremua hitzen arteko tartearekin.

Bistaratzeko izenak ulertzeko errazagoak direnez, Canvas aplikazioek aukera gisa proposatuko dituzte eta ez dute izen logikorik proposatuko. Izen logikoak iradokitzen ez diren arren, zeharka idatzita ere erabil daitezke.

Adibidez, imajinatu gehitu duzula Eremu pertsonalizatua Dataverse-ko taula batera. Sistemak izen logiko bat esleituko dizu, eremua sortzerakoan soilik aldatzerik izango duzuna. Emaitza honen antzekoa izango litzateke:

Kontuen eremu bati erreferentzia egiterakoan, 'Eremu pertsonalizatua' erabiltzea iradokiko da, hori baita pantailaren izena. Komatxo bakarrak erabili behar dira, izen honek espazio bat baitu:

Iradokizuna aukeratu ondoren, 'Eremu pertsonalizatua' agertzen da formula-barran eta datuak berreskuratzen dira:

Iradokitzen ez den arren, izen logikoa ere erabil genezake eremu honetarako. Datu berberak berreskuratuko ditu. Ez dira komatxo bakarrak behar, izen honek ez baitu zuriunerik edo karaktere berezirik:

Atzealdean, esleipena mantentzen da formuletan ikusitako bistaratzeko izenen eta azpiko izen logikoen artean. Izen logikoak datu-iturburuekin elkarreragiteko erabili behar direnez, esleipen hau uneko bistaratzeko izena izen logikora automatikoki bihurtzeko erabiltzen da eta hori sareko trafikoan ikusten da. Mapatze hau izen logikoetara itzultzeko ere erabiltzen da bistaratze izen berrietara aldatzeko, adibidez, bistaratze izen bat aldatzen bada edo hizkuntza bateko beste hiztun batek aplikazioa editatzen badu.

Oharra

Izen logikoak ez dira itzultzen aplikazio bat ingurune batetik bestera mugitzean. Dataverse-ko sistemaren taula eta eremu izenetan, hau ez litzateke arazoa izan behar, izen logikoak ingurune guztietan koherenteak baitira. Baina baliteke edozein eremu pertsonalizatuk, adibidez, goiko adibideko cra3a_customfield izenak, ingurune-aurrizki desberdina izatea (cra3a kasu honetan). Bistaratzeko izenak nahiago izaten dira ingurune berriko bistaratzeko izenekin pareka daitezkeelako.

Izenen desanbiguazioa

Bistaratzeko izenak bakarrak ez direnez, bistaratzeko izen bera taula berean behin baino gehiagotan ager daiteke. Hori gertatzen denean, parentesi artean dagoen bistaratze-izenaren amaieran izen logikoa gehituko da gatazkan dauden izenetako batentzat. Goiko adibidean oinarrituz, bistaratzeko izen bera (Pertsonalizatutako eremua) eta izen logiko bera (cra3a_customfieldalt) duen bigarren eremurik egonez gero, iradokizunek honako hau erakutsiko lukete:

Izenen desanbiguazio kateak izen gatazkak gertatzen diren beste egoera batzuetan gehitzen dira, hala nola, taulako izenak, aukerak eta bestelako Dataverse elementuak.

Desanbiguazio eragilea

Zenbait funtziok erregistro-esparruak sortzen dituzte, erregistro bakoitza prozesatzen ari zaren bitartean, taularen eremuetara sartzeko, adibidez Filter, AddColumns, eta Sum. Erregistro-esparruarekin gehitutako eremu-izenek aplikazioko beste leku batzuetako izen berberak gailentzen dituzte. Hori gertatzen denean, erregistroaren eremuaren kanpotik balioak atzitu ditzakezu @ desanbiguazio eragilea erabiliz:

• Habiaratutako erregistro esparruetatik balioak atzitzeko, eredu hau erabiltzen ari den taularen izena duen @ eragilea erabiliz:
  Taula[@fieldname]
• Balio orokorrak atzitzeko, hala nola datu iturriak, bildumak eta testuinguru aldagaiak, erabili eredua [@ObjectName] (taula izendapenik gabe).

Informazio gehiago eta adibideak lortzeko, ikus erregistro-esparruak.