Partekatu honen bidez:

Kodearen irakurgarritasuna

Izendatzeko konbentzioak

Izendapen-konbentzio orokorrak

Atal honek "camel case" eta "Pascal case" izendapen-konbentzioak deskribatzen ditu. Termino horiek ezagutzen badituzu, aurrera egin dezakezu.

Gamelu-zorroa

Kontrol eta aldagaietarako camel case erabili beharko zenuke. Gamelu kasua aurrizki minuskulaz hasten da, objektu edo aldagai izenetako hutsune guztiak kentzen ditu eta lehenengoaren ondoren hitz bakoitzaren lehen letra maiuskulaz idazten du. Adibidez, testu-sarrerako kontrol baten izena txtUserEmailAddress izan liteke.

Pascal kasua

Pascal kasua erabili beharko zenuke datu-iturrietarako. Pascal kasuari batzuetan "gamelu kasu larria" deitzen zaio. Gamelu kasuaren antzera, hutsune guztiak kentzen ditu eta hitzen lehen letra maiuskulaz idazten du. Hala ere, gamelu kasuak ez bezala, Pascal kasuak ere lehenengo hitza larriz idazten du. Adibidez, PowerApps -en ohiko datu-iturri bat Microsoft Office 365 Erabiltzaileak konektorea da, eta zure kodean Office365Erabiltzaileak izena du.

Pantaila-izenak

Pantaila-izenek pantailaren helburua islatu behar dute, aplikazio konplexuetan nabigatzea errazagoa izan dadin Power Apps Studio.

Ez da hain agerikoa pantaila-izenak pantaila-irakurgailuek ozen irakurtzen dituztela, eta horiek beharrezkoak dira ikusmen-irisgarritasun-beharrak dituzten erabiltzaileentzat. Beraz, ezinbestekoa da hizkuntza arrunta erabiltzea pantailak izendatzeko eta izenek hutsuneak eta laburdurarik ez izatea. Era berean, izena "Pantaila" hitzarekin amaitzea gomendatzen dizugu, izena iragartzean testuingurua uler dadin.

Hona hemen adibide on batzuk:

  • Home_Screen edo Home Screen
  • Search_Screen edo Search Screen

Deskribatutako eredua jarraitzen duten pantaila-izen zerrenda erakusten duen pantaila-argazkia

Adibide hauek pantaila-izen ulergaitzagoak dira:

  • Home
  • LoaderScreen
  • EmpProfDetails
  • Thrive Help

Kontrolen izenak

Oihaleko kontrol-izen guztiek gamelu-kasua erabili behar dute. Hiru karaktereko mota-deskribatzaile batekin hasi behar dute, eta ondoren kontrol-helburua. Ikuspegi honek kontrol mota identifikatzen laguntzen du eta formulak eraikitzea eta bilaketa errazten du. Adibidez, lblUserName -k adierazten du kontrola etiketa bat dela.

Hurrengo taulan kontrol arrunten laburdurak ageri dira.

Kontrolaren izena Laburdura
Etiketa eraikina
Button btn
Kameraren kontrola kamera
Mihisea ahal
Card txartela
Diagramak kr
Kontrol-laukia txek
Bilduma zutabea
Konbinazio-koadroa cmb
Osagaia cmp
Edukiontzia iruzurra
Datak dte
Goitibeherako zerrenda drp
Inprimakia frm
Galeria neska
Taldekatu taldea
Goiburua HDR
HTML testua htm
Icon ikonoa
Image irudia
Informazio botoia informazioa
Label lbl
Esteka esteka
Zerrenda-koadroa zerrenda
Mikrofonoa mikrofono
Microsoft Stream str
Orrialdearen atalaren forma seg
Boligrafoaren sarrera boligrafo
Power BI lauza PBI
Garapen-barra barra
Balorazioak rtg
Testu aberastuaren editorea rte
Formak (laukizuzena, zirkulua, etab.) shp
Graduatzailea sld
Fitxen zerrenda mahaia
Table mahaia
Testuzko sarrera txt
Tenporizadorea tmr
Txandakatu tgl
Video bideoa

Kontrolen zerrenda zehatza eta haien propietateak deskribatuta daude Kontrolen erreferentzian.

Oharra

Kontrol-izenak bakarrak izan behar dira aplikazio osoan. Kontrol bat pantaila anitzetan berrerabiltzen bada, pantaila-izen laburrak atzizki bat izan beharko luke. Adibidez, galBottomNavMenuHS, non "HS"-k "Hasierako Pantaila" esan nahi duen. Ikuspegi honek errazagoa egiten du kontrol horri erreferentzia egitea formuletan pantaila ezberdinetan.

Hona hemen adibide txar batzuk:

  • zipcode
  • Next

Kontrolak modu koherentean izendatzen dituzunean, aplikazioa garbiagoa da nabigazio-ikuspegian, eta kodea ere garbiagoa da.

Nabigazio-ikuspegiaren pantaila-argazkia, kontrol-izenak ereduari jarraituz erakusten dituena

Datu-iturrien izenak

Datu-iturri bat aplikazioari gehitzen diozunean, izena ezin da aldatu aplikazioan. Power Apps Izena iturburu-konektoretik edo konexiotik eratorritako datu-entitateetatik heredatzen da.

Hona hemen zenbait adibideak:

  • Iturburu-konektoretik heredatutako izena: Zure kodean Office 365 Erabiltzaileak konektoreari Office365Erabiltzaileak izena ematen zaio.
  • Konexiotik eratorritako datu-entitateak: SharePoint izeneko Microsoft Employees zerrenda bat itzultzen da SharePoint konektoretik. Beraz, zure kodeko datu-iturriaren izena Employees da. Aplikazio berak konektore bera ere erabil dezake izeneko zerrenda batera sartzeko. Power Apps SharePoint SharePoint Contractors Kasu honetan, kodeko datu-iturriaren izena Contractors da.

Konektoreei eta konexioei buruzko informazio gehiago lortzeko, ikus mihise aplikazioen konektoreen ikuspegi orokorra Power Apps.

Ekintza estandarreko konektoreak

Funtzioak erakusten dituzten ekintza-konektore estandarretan, hala nola LinkedIn-en, datu-iturriaren izenak eta haren eragiketek Pascal maiuskulak erabiltzen dituzte. Adibidez, LinkedIn datu-iturriaren izena LinkedIn da eta ListCompanies izeneko eragiketa bat du.

ClearCollect(
    colCompanies,
    LinkedIn.ListCompanies()
)

Konektore pertsonalizatuak

Konexio pertsonalizatuak, zure enpresak sortutako zerbitzuetara edo negozio-lerroetako APIetara konektatzeko erabiltzen direnak. Zure inguruneko edozein egilek sor ditzake. Datu-iturriaren izenarentzat eta haren eragiketetarako Pascal letra larriak erabiltzea gomendatzen dugu. Kontuan izan konektore pertsonalizatuaren izena eta PowerApps -n agertzen den modua desberdinak izan daitezkeela.

Demagun MS Auction Item Bid API izeneko konektore pertsonalizatu honen adibidea.

MS Auction Item Bid API izeneko konektore baten pantaila-argazkia

Baina konektore honetatik konexio bat sortu eta zure PowerApps aplikazioari datu-iturri gisa gehitzen diozunean, honela agertzen da AuctionItemBidAPI.

AuctionItemBidAPI izena duela erakusten duen konektore baten pantaila-argazkia

Arrazoia jakiteko, testua duen izenburu atributu bat bilatu dezakezu OpenAPI fitxategiaren barruan Auction Item Bid API.

"info": {
    "version": "v1",
    "title": "Auction Item Bid API"
},

Power Apps atributu-balio honetako hutsune guztiak kentzen ditu eta zure datu-iturburuaren izen gisa erabiltzen du.

Eskupekoa

Atributu honen balioa Pascal letra larriz idatzitako izen batera aldatzea gomendatzen dizugu, adibidez, AuctionItemBidAPI , eta zure konexio pertsonalizatuaren izen gisa erabiltzea. Horrela, ez da nahasmendurik egongo. Aldatu balio hau konektore pertsonalizatua sortzeko fitxategia inportatu aurretik. OpenAPI

Oharra

Fitxategi bat inportatu beharrean hutsetik sortu aukera erabiltzen baduzu, OpenAPI konektore pertsonalizatuaren izena eskatuko dizu. PowerApps Izen hau konektore pertsonalizatuaren izen gisa eta OpenAPI fitxategiaren barruko izenburu atributuaren balio gisa erabiliko da. Gauzak koherenteak eta sinpleak izan daitezen, ziurtatu Pascal letra larriz idatzitako izen bat erabiltzen duzula, adibidez, AuctionItemBidAPI .

Excel datu-taulak

PowerApps Excel-eko kalkulu-orrietako datuetara konektatzeko, DataTables erabiltzen du Microsoft Excel -n. Kontuan izan puntu hauek Excel dokumentuak datu-iturri gisa sortzen dituzunean:

  • Eman zure DataTable-ei izen deskriptiboak. Izena aplikazioan dago, konektatzeko kodea idazten duzunean. Power Apps
  • Erabili DataTable bat lan-orri bakoitzeko.
  • Eman izen bera DataTable-ari eta lan-orriari.
  • Erabili zutabe-izen deskriptiboak DataTable-etan.
  • Erabili Pascal karkasa. DataTable izenaren hitz bakoitzak letra larriz hasi behar du, adibidez, EmployeeLeaveRequests.

Aldagai-izenak

Mihise-aplikazioetako aldagaien izendapen-konbentzioak garrantzitsuak dira zure proiektuen irakurgarritasuna, koherentzia eta argitasuna mantentzeko. Power Apps Ez dago estandar zorrotzik betearazten den arren, mihise-aplikazio osoan izendatzeko konbentzio koherente bat hartzeak errazagoa egin diezazuke zuk eta beste kolaboratzaileek aldagaiak ulertzea, erabiltzea eta kudeatzea.

  • Erabili gamelu kasua, non hitz bakoitzaren lehen letra larriz idazten den, lehenengo hitza izan ezik.
  • Aukeratu aldagaiaren helburua edo edukia argi deskribatzen duten izen esanguratsu eta deskriptiboak. Saihestu temp edo var1 bezalako izen generikoegiak. Horren ordez, erabili izen deskriptiboak, hala nola, userEmail edo totalAmount.
  • Aldagai mota adierazteko, kontuan hartu aurrizkiak edo atzizkiak erabiltzea. Adibidez:
    • strUserName testu/kate aldagai baterako
    • numTotalAmount zenbakizko aldagai baterako
    • boolIsEnabled aldagai boolear baterako
    • locVarName tokiko aldagaietarako/testuinguru aldagaietarako
    • gblVarLoginUser aldagai globaletarako
  • Erabaki aldagaiak singularrean edo pluralean izendatu behar diren eta jarraitu konbentzio horri. Adibidez, erabili etengabe userCount edo users.
  • Saihestu funtzio edo gako-hitzekin gatazkan egon daitezkeen erreserbatutako hitzak edo izenak erabiltzea. Power Apps Erreserbatutako hitzen zerrenda ikusteko, begiratu dokumentazioari. Power Apps
  • Aldagaiaren erabilerari edo esparruari buruzko testuingurua ematen duten aurrizkiak erabiltzea kontuan hartu. Adibidez:
    • frm formulario aldagaietarako
    • col bildumarako
    • var helburu orokorreko aldagaietarako
  • Saihestu karaktere bereziak. Izenak alfanumeriko eran idatzi eta karaktere bereziak edo hutsuneak saihestu. Letrei eta zenbakiei eutsi.

Power Apps testuinguru-aldagaiek eta aldagai globalek izen berdinak parteka ditzaten. Honek nahasmena sor dezake, zure formulek testuinguru-aldagaiak lehenespenez erabiltzen baitituzte desanbiguazio-operadorea erabiltzen ez bada behintzat.

Egoera hau saihestu konbentzio hauek jarraituz:

  • Testuinguru-aldagaiak aurrizki gisa jarri loc.
  • Aldagai globalak aurrizki gisa jarri gbl.
  • Aurrizkiaren ondorengo izenak aldagaiaren asmoa/helburua adierazi beharko luke. Hitz bat baino gehiago erabil daitezke eta ez da beharrezkoa karaktere bereziekin bereiztea, hala nola espazioekin edo azpimarratxoekin, hitz bakoitzaren lehen letra maiuskulaz idazten bada.
  • Erabili Camel zorroa. Aldagaien izenak letra minuskulaz aurrizki batekin hasi, eta gero izenburuko hitz bakoitzaren lehen letra maiuskulaz idatzi.

Adibide hauek arau eta konbentzioei jarraitzen diete:

  • Aldagai globala:gblFocusedBorderColor

  • Testuinguru aldagaia:locSuccessMessage

  • Esparru aldagaia:scpRadius

Adibide hauek ez dituzte estandarrak betetzen eta zailagoak dira ulertzeko:

  • dSub
  • rstFlds
  • hideNxtBtn
  • ttlOppCt
  • cFV
  • cQId

Saihestu EID bezalako aldagai-izen labur eta kriptikoak. Use EmployeeId horren ordez.

Aplikazio batean aldagai asko daudenean, aurrizkia formula barran idatz dezakezu eskuragarri dauden aldagaien zerrenda ikusteko. Aldagaiak izendatzeko jarraibide hauek jarraitzen badituzu, erraz aurki ditzakezu formula-barran aplikazioa garatzen duzun heinean. Azken finean, ikuspegi honek aplikazioen garapen azkarragoa dakar.

Bildumen izenak

  • Bildumaren edukiaren deskribapena egin. Pentsatu bildumak zer duen eta/edo nola erabiltzen den, eta jarri izena dagokion moduan.
  • Bildumak col aurrizkiarekin hasi behar dira.
  • Aurrizkiaren ondorengo izenak bildumaren asmoa edo xedea adierazi beharko luke. Hitz bat baino gehiago erabil daitezke eta ez da beharrezkoa hutsune edo azpimarra bidez bereiztea, hitz bakoitzaren lehen letra larriz idazten bada.
  • Erabili Camel zorroa. Bilduma-izenak letra minuskulaz col aurrizki batekin hasi, eta ondoren izenburuko hitz bakoitzaren lehen letra maiuskulaz idatzi.

Adibide hauek bilduma-izenetarako konbentzioak jarraitzen dituzte:

  • colMenuItems
  • colThriveApps

Adibide hauek ez dituzte bilduma-izenaren arauak betetzen:

  • orderscoll
  • tempCollection

Eskupekoa

Aplikazioan bilduma asko daudenean, aurrizkia formula barran idatz dezakezu eskuragarri dauden bilduma guztien zerrenda ikusteko. Aldagaiei dagokienez, zure bildumak izendatzeko jarraibide hauek jarraitzen badituzu, erraz aurkituko dituzu formula-barran aplikazioa garatzen duzun heinean. Azken finean, ikuspegi honek aplikazioen garapen azkarragoa dakar.

Iruzkinak eta dokumentazioa

Aplikaziorako kodea idazterakoan, arreta jarri iruzkin argiak gehitzean. Iruzkinek zure kodea geroago ulertzen laguntzen dizute eta hurrengo garatzailearentzat proiektuan lan egitea errazten dute.

Power Apps Bi iruzkin estilo onartzen ditu kodea argiagoa izan dadin: lerroko iruzkinak, lerro bakarreko oharretarako barra bikoitzak (//) erabiltzen dituztenak, eta blokeko iruzkinak, lerro anitzeko oharretarako /* eta */ erabiltzen dituztenak.

Lerroko iruzkinak

Gehitu barra bikoitz bat (//) Power Apps ko kode-lerro orori, lerroaren gainerakoa iruzkin bihurtzeko.

Erabili lerro-iruzkinak hurrengo kode-lerroak zer egiten duen azaltzeko. Probak egiteko kode lerro bat aldi baterako desgaitzeko ere erabil ditzakezu.

Hona hemen lerro-iruzkin baten adibidea.

// ClearCollect function populates the Expenses2 collection with sample data
ClearCollect(
    Expenses2,
    // Entry 1: Client hosted meet and greet
    {
        Title: "Client hosted meet and greet:",
        ID: "4"
        // additional properties  
    }
)

Blokeatu iruzkinak

/* eta */ arteko testua bloke-iruzkin bat da. Bloke-iruzkinek hainbat lerro estali ditzakete, lerro-iruzkinek lerro bakarra hartzen duten bitartean.

Erabili bloke-iruzkinak azalpen luzeagoetarako, adibidez, kode-moduluaren goiburua dokumentatzeko. Probak edo arazketa prozesuan zehar hainbat kode lerro aldi baterako desgaitzeko ere erabil ditzakezu.

Kodea hobeto antolatzeko, gehitu iruzkinak Testua formateatu funtzioa erabili ondoren. Honek laguntzen du zure iruzkinak kode bloke baten aurretik badatoz.

/*
    Patch Operation to Insert Data:
    - Inserts a new employee record into the 'Employee' entity.
    - Adds corresponding department details to the 'Department' entity.
    Note: Ensure that foreign key relationships and dependencies are maintained for data integrity.
*/
Patch(
    Employee,
    Defaults(Employee),
    {
        FirstName: "John",
        LastName: "Doe",
        Position: "Software Developer"
    }
)

Testua formateatzeko funtzioak arau hauek jarraitzen ditu iruzkinetarako:

  1. Propietate bat bloke-iruzkin batekin hasten bada, hurrengo kode-lerroa gehitzen zaio.
  2. Propietate bat lerro-iruzkin batekin hasten bada, hurrengo kode-lerroa ez zaio gehitzen. Bestela, kodea komentatuta geratzen da.
  3. Propietatearen beste leku batean dauden lerro eta bloke iruzkinak aurreko kode lerroari gehitzen zaizkio.

Ez kezkatu iruzkin gehiegi edo luzeegiak gehitzeaz. Power Apps bezero aplikazioaren paketea sortzean iruzkin guztiak kentzen ditu, beraz, iruzkinek ez dute paketearen tamainan eragiten edo aplikazioaren deskargak edo kargatzeko denborak moteltzen.

Aplikazio-diseinatzaile modernoa iruzkinekin

Power Apps-en, komenigarria da iruzkinak egiteko funtzioak erabiltzea bai Power Apps Studio bai aplikazio-diseinatzaile modernoan.

Iruzkinak gehitzeko Power Apps Studio-n, erabili metodo hauek:

  1. Egin klik eskuineko botoiarekin Zuhaitz Ikuspegiko edozein elementuren elipsian ("...").
  2. Egin klik eskuineko botoiarekin mihise-eremuko osagai batean.
  3. Hautatu pantailaren goiko eskuineko izkinan dagoen komando-barran dagoen "Iruzkinak" botoia.

Lankide bat iruzkin batean aipatzen duzunean, erabili "@" ikurra eta ondoren haren izena. Honek jakinarazpen-mezu elektroniko bat bidaltzen dio etiketatzen duzun pertsonari. Etiketatutako erabiltzaileak aplikaziorako sarbiderik ez badu, Power Apps -ek aplikazioa berarekin partekatzeko eskatzen dizu.

Gastuen aplikazio baten pantaila-argazkia, iruzkin batean @ ikurra duela aipatutako pertsona bat erakusten duena.

Indentazioa eta formatua

In Power Apps, koska eta formatuak zure aplikazioa argi eta antolatuta mantentzen laguntzen dute. Jardunbide egokiak jarraitzeak formulak eta kontrolak errazago irakurtzen ditu.

Formula-barra

Koska

Power Apps ez du koska zorrotza behartzen, baina hutsuneak erabil ditzakezu formulen atal desberdinak bereizteko. Sakatu espazio-barra hainbat aldiz koska bat sortzeko.

Lerro-jauziak

Formula luzeak lerro anitzetan banatu, errazago irakurtzeko. Sakatu Sartu formula-barran lerro-jauzi bat gehitzeko.

Erabili testua formatuan jartzeko komandoa

Formula-barrako "Testua formateatu" komandoak koska, tartea eta lerro-jauziak gehitzen dizkio zure kodeari. Power Apps Erabili "Testua formateatu" komandoa mihise-aplikazioan kodeketa-estilo koherentea mantentzeko eta akatsak saihesteko.

Power Apps Studio -ren pantaila-argazkia, Testua formatu komandoa nabarmenduta duela.

Hurrengo urratsa

Kodearen optimizazioa

  • Last updated on