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 | $"Kaixo {FirstName}," | Testu-kate baten barruan txertatutako formulak |
. | Propietate hautatzailea | Graduatzailea1.Balioa 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 && Slider1.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 | |
zehatza | Kide-operadoreak | Galeria1.Gordetako elementuetan zehatza hautatua | Bilduma edo taula bati dagokiona |
zehatza | "Windows" zehazki "Windows sistema eragilean leihoak bistaratzeko..." | Azpikatearen proba (maiuskulak/minuskulak bereizten ditu) | |
urtean | Galeria1.Selected SavedItems-en | Bilduma edo taula bati dagokiona | |
urtean | "The" in "Teklatua eta monitorea..." | Azpikatearen proba (maiuskulak/minuskulak ez ditu bereizten) | |
@ | Desanbiguazio eragilea | Nire taula[@fieldname] | Eremuen desanbiguazioa |
@ | [@MyVariable] | Desanbiguazio orokorra | |
, [hizkuntzaren mendekoa] |
Zerrenda bereizlea | Bada (X < 10, "Baxua", "Ona" ) { X: 12, Y: 32 } [1, 2, 3] |
Banatzen du:
|
; [hizkuntzaren mendekoa] |
Formulen kateamendua | Bildu(T, A); Nabigatu(S1, "") | Funtzioen deiak bereizi portaera-propietateetan. Kateamendu-eragilea hizkuntzaren araberakoa da. |
As | Operadore gisa | AllCustomers Bezero gisa | Baliogabetzea ThisItem eta ThisRecord galerietan eta erregistro-eremuko funtzioak. As erabilgarria da izen zehatz eta hobea emateko eta bereziki garrantzitsua da habiaraturiko eszenatokietan. |
Norbera | Autooperatzailea | Norbera.Bete | Uneko kontrolaren propietateetarako sarbidea eskaintzen du |
Gurasoa | Operadore nagusia | Gurasoa.Bete | Kontrol-edukiontzi baten propietateetarako sarbidea |
Elementu hau | ThisItem operadorea | Elementu hau.Izena | Galeriarako edo inprimakien kontrolerako eremuetarako sarbidea |
Erregistro hau | 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:
Sortu edo inportatu Inbentarioa izeneko bilduma bat eta erakutsi galerian, Irudiak eta testua galerian erakutsi ataleko lehenengo prozeduran azaltzen den moduan.
Ezarri galeriako Elementuak propietatea honako formula honetan:
Iragazkia (Inbentarioa, "E" ProductName-n)Galeriak produktu guztiak erakusten ditu Callisto izan ezik, produktu horren izena delako zuk zehaztutako hizkia ez daukan bakarra.
Aldatu galeriako Elementuak propietatea honako formula honetara:
Iragazkia (Inbentarioa, "E" zehatza Produktuaren izena)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 |
---|---|---|
Elementu hau | Galeria kontrola Editatu formularioa kontrola Erakutsi formularioa kontrola |
Uneko erregistroaren izen lehenetsia a-n Galeria edo formaren kontrola. |
Erregistro hau | Guztientzako, Iragazkia, Horrekin, Batuketa eta beste erregistro-esparrua funtzioak | Egungo erregistroaren izen lehenetsia ForAll eta beste erregistroen irismenaren funtzioak. |
Izen gisa | Galeria kontrola Guztientzako, Iragazkia, Horrekin, Burketa eta erregistro-esparruko beste funtzio batzuk |
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 erregistro-esparrua duten funtzioetan erabiltzen da. 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 da eta inplizituta dago 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 hautazkoa da 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-esparruko funtzioekin ere erabil daiteke izena lehenetsia 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.
- Concat bi aldiz erabiltzen da, lehendabizi zutabeak eta gero errenkadak muntatzeko, a Char(10) a sartuz lerro berri bat sortzeko.
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. |
Auto operatzailea | 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 operadore | 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. |
Norbere eta Gurasoa eragileak dira, eta ez kontroletako 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 - Bakarra izango dela bermatuta dagoen izena, sortu ondoren aldatzen ez dena, normalean ez du zuriunerik edo bestelako karaktere berezirik onartzen eta hizkuntza ezberdinetan kokatzen ez dena. 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 - Erabiltzeko erraza den eta azken erabiltzaileek ikusteko asmoa duten 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.