Andmetüübid

Teave liigub läbi rakenduse Microsoft Power Fx väikestes vooga väärtustes, mis sarnaneb väga arvutustabeli lahtritega. Näiteks toimiksid andmed väljades Birthday (Sünnipäev) ja Anniversary (Aastapäev) sarnaselt Date (Kuupäev) väärtusele, kus on aasta, kuu ja päeva toodud. Rakendus teab, kuidas neid väärtusi vormindada, piirata sisendit igale sobivale ja jagada väärtusi andmebaasiga. Inimeste jaoks erinevad sünnipäevad tähtpäevadest, kuid süsteem tegeleb nendega täpselt samal viisil. Sel juhul on Date (Kuupäev) näide andmetüübist.

Selles artiklis kirjeldatakse andmetüüpe, mida Power Fx toetab. Välisandmete toomisel keelde vastendatakse iga selle allika andmetüüp Power Fx-i andmetüübiga.

Paljud neist andmetüüpidest on sarnased ja neil on sama aluseks olev esitus, näiteks välja Hyperlink (Hüperlink) käsitletakse, kui väli Text (Tekst). Täiendavad andmetüübid pakuvad vormidel ja muudes juhtelementides paremaid vaikekogemusi.

Tühi

Kõigi andmetüüpide väärtuseks võib olla tühi (teisisõnu väärtuseta). Terminit "null" kasutatakse sageli andmebaasides selle kontseptsiooni kirjeldamiseks.

Kasutage funktsiooni Blank (Tühi) koos funktsioonidega Set (Määra) ja Patch (Plaaster), et määrata tühjale suvandile väärtus või väli. Näiteks valem Set( x, Blank() ) eemaldab igast väärtusest globaalmuutuja x.

Tühja väärtuse testimiseks kasutage funktsiooni isBlank (On tühi). Asendage võimalikud tühjad väärtused, täidetud väärtustega, kasutades funktsiooni Coalesce (Koaleeru).

Kuna kõik andmetüübid toetavad tühje väärtusi, on andmetüüpidel Boolean (Tõeväärtus) ja Two option (Kaks võimalust) efektiivselt kolm võimalikku väärtust.

Tekst, hüperlink, pilt ja meedia

Kõik neli nendest andmetüüpidest põhinevad Unicode'i tekstisõnel.

Manustatud tekst

Valemis sisalduvad manustatud tekstisõned on kahekordsetes jutumärkides. Kasutage kahekahekordseid jutumärke koos, et tähistada ühte kahekordsete jutumärkide vahel olevat tekstisõnet. Näiteks kasutades juhtelemendi Button (Nupp) atribuudi OnSelect järgmist valemit.

Notify( "Jane said ""Hello, World!""" )

tulemuseks on banner (kui nuppu on vajutatud), kus esimesed ja viimased kahekordsed jutumärgid jäetakse välja (kuna need piiritlevad tekstisõnet) ja korduvad kahekordsed jutumärgid ümber lause Tere, maailm! asendatakse ühe kahekordsete jutumärkidega.

Ühekordseid jutumärke ei kasutata identifikaatorite nimede puhul, mis sisaldavad erimärke ja millel pole tekstisõne puhul tähtsust.

Pildi ja meedia ressursid

Menüü File (Fail) kaudu saate lisada pildi-, video -ja helifaile rakenduse ressurssidena. Imporditud faili nimi saab rakenduse ressursi nimeks. Sellel pildil on rakendusele lisatud Northwind Traders logo nimega nwindlogo.

Selle ressursi kasutamiseks rakenduses määrake juhtelemendi Image (Pilt) atribuut Pilt.

Piltide ja muu meedia URId

Viimasesse näitesse saab veidi sügavamale minna, kui seate juhtelemendi Label (Silt) atribuudi Tekst väärtuseks nwindlogo. Sildil kuvatakse tekstisõne:

Power Fx viitab igale pildile või muule meediumifailile (olgu see siis pilves või lisatud rakenduse ressursina) URI tekstistringi abil.

Näiteks pildi juhtelemendi juhtelemendi atribuut Image (Pilt) ei aktsepteeri mitte ainult rakenduse ressursse, vaid ka veebipiltide linke, näiteks "https://northwindtraders.com/logo.jpg". Atribuut aktsepteerib ka tekstisiseseid pilte, mis kasutavad andmete URI-skeemi, nagu käesolevas näites.

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAkAAAAFAQMAAACtnVQoAAAABlBMVEUAAAB0J3UMNU6VAAAAAXRSTlMAQObYZgAAABRJREFUCNdjUGJgCGVg6GgAkkA2AA8/AffqCEBsAAAAAElFTkSuQmCC"

See URI kuvab kahe lilla teemanti skaleeritud versiooni.

Juhtelemendiga Camera (Kaamera) viimati pildistatud foto kuvamiseks määrake pildi juhtelemendi atribuut Pilt kaamera juhtelemendi atribuudile Photo (Foto). Rakendus hoiab pilti mälus ja kaamera juhtelemendi atribuut Photo tagastab pildi URI-viite. Näiteks võite pildistada ja kaamera atribuut Photo (Foto) tagastab "appres://blobmanager/7b12ffa2ea4547e5b3812cb1c7b0a2a0/1".

Kasutage URI-i, et viidata mõnda andmebaasi salvestatud pildile või mõnele muule meediumifailile. Sel viisil ei too rakendus tegelikke andmeid enne, kui on vaja. Näiteks Microsoft Dataverse olemi manus võib tagastada "appres://datasources/Contacts/table/..." nagu ka kaamera näite puhul saate selle pildi kuvada, kui määrate pildi juhtelemendi atribuudi Image (Pilt) viidele, mis tagastab binaarsed andmed.

Kui salvestate meediumi andmetüübi (nt pildi), andmebaasi, saadab rakendus tegeliku pildi või meediumi andmed, mitte URI-viite.

Suuruse piirid

Tekstisõne ja URI puhul pole neil andmetüüpidel eelseatud pikkuse piiri.

Binaarsed andmed, mis viitavad nendele andmetüüpidele, ei sisalda samuti eelseatud pikkuse piiri. Näiteks kaamera juhtelemendiga pildistatud pilt, mis on nüüd viidatud kui "appres://..." võib olla nii kõrge resolutsiooniga, kui seadme kaamera seda võimaldab. Meediumifailide eraldusvõime, kaadrisagedus ja muud atribuudid ei ole andmetüübiga piiratud, kuid meediumide esitamiseks ja hõivamiseks mõeldud spetsiifilistel juhtelementidel võivad olla oma piirangud.

Kõik andmete suurused sõltuvad siiski rakenduse vabast mälust. Lauaarvutites töötavad brauserid toetavad tavaliselt üle 100 megabaidi andmeid. Siiski võib seadmes, näiteks telefonis, saadaolev mälumaht olla tunduvalt väiksem, tavaliselt vahemikus 30-70 megabaiti. Selleks, et teha kindlaks, kas teie rakendus töötab nendes piirides, katsetage ühiseid stsenaariume kõigis seadmetes, kus see peaks töötama.

Parima tavana hoidke andmeid mälus ainult nii kaua kui vaja. Laadi pildid andmebaasi nii kiiresti kui võimalik. Laadige pildid alla ainult siis, kui rakenduse kasutaja neid pärib.

Arv ja valuuta

Andmetüübid Number (Arv) ja Currency (Valuuta) kasutavad IEEE 754 kahekordset ujuvpunkti standardit. See standard pakub töö jaoks suure hulga arve, vahemikus –1,79769 x 10³⁰⁸ kuni 1,79769 x 10³⁰⁸. Väikseim esindatav väärtus on 5 x 10^{– 324}.

Power Fx võib täpselt tähistada täisarve vahemikus –9 007 199 254 740 991 (–(2⁵³ – 1)) kuni 9 007 199 254 740 991 (2⁵³ – 1) kaasa arvatud. See vahemik on suurem kui 32-bitine (või 4-baidine) täisarv, mida andmebaasid tavaliselt kasutavad. Power Fx ei saa aga tähistada 64-bitise (või 8-bitise) täisarvu andmetüüpe. Võimalik, et soovite salvestada numbri tekstiväljale või kasutada arvutatud veergu, et teha numbrist tekstiväljal koopia, nii et see vastendataks Power Fx-i andmetüübiks Tekst. Sel viisil saate neid väärtusi talletada, kuvada ja sisestada ning neid võrrelda, et määratleda, kas need on võrdsed, kuid sellel vormil ei saa nendega arvutusi teha.

Ujuvkomakohaga aritmeetilised tehted on ligikaudsed, mistõttu võib esineda ootamatuid tulemusi mitmete dokumenteeritud näidetega. Võib eeldada, et valem 55/100*100 tagastab täpselt 55 ja (55/100*100)-55 tagastab täpselt nulli. Uuem valem tagastab väärtuse 7,1054 x 10^–15, mis on väike, kuid mitte null. See väike erinevus ei tekita tavaliselt probleeme ja rakendus ümardab selle tulemi kuvamisel. Samas väikesed erinevused võivad kuhjuda järgnevates arvutustes ja tuua lõpptulemuseks vale vastuse.

Andmebaasi süsteemid hoiustavad sageli valuutasid ja teostavad arvutusi, kasutades kümnendkoha matemaatikat, mis pakub väiksemat vahemikku, kuid suuremat kontrolli täpsuse üle. Power Fx-i rakendused vastendavad vaikimisi ujukomaarvu väärtustes valuutasid; seetõttu võib tulemus erineda arvutustest, mis on tehtud kohaliku kümnendarvu andmetüübiga. Kui sellist tüüpi lahknevused põhjustavad probleeme, võite töötada nendega Text (Tekst) tüübina, nagu ka suurte täisarvudega, nagu on kirjeldatud varasemalt käesolevas jaotises.

Kuupäev, kellaaeg ja kuupäevaga kellaaeg

Ajavööndid

Kuupäeva/kellaaja väärtused kuuluvad järgmistesse kategooriatesse.

• Kasutaja ajavöönd : väärtused hoiustatakse ajatsooniga UTC (koordineeritud maailmaaeg), kuid rakenduse kasutaja ajavöönd mõjutab kuidas rakendus väärtusi kuvab ja kuidas rakenduse kasutaja neid määrab. Näiteks Kanadas kuvatakse sama ajahetk Kanadas asuvale kasutajale teisiti kui Jaapanis.
• Ajavööndist sõltumatu : rakendus kuvab väärtused ühtemoodi ja rakenduse kasutaja määrab need samamoodi, olenemata ajavööndist. Sama ajahetk kuvatakse kasutajale Kanadas samamoodi nagu kasutajale Jaapanis. Rakenduse autorid, kes ei eelda, et rakendused töötavad erinevates ajavööndites, kasutavad neid väärtusi, kuna need on üldiselt lihtsamad.

Järgmises tabelis on toodud mõned näited.

Kui seda kasutatakse Power Appsis kasutaja ajavööndi kuupäeva/kellaaja jaoks, kasutab Power Fx brauseri või seadme ajavööndit, kuid mudelipõhised rakendused kasutavad Dataverse'i kasutaja sätet. Need sätted kattuvad tavaliselt, kuid tulemused sõltuvad sellest, kas need sätted on erinevad.

Kasutage funktsioone DateAdd (Lisatud kuupäev) ja TimeZoneInformation (Ajatsooni teave), et teisendada kohalik ajatsoon UTC-tsooni ja vastupidi. Näited leiate nende funktsioonide dokumentide lõpus.

Arvulised ekvivalendid

Power Fx talletab ja arvutab kõik kuupäeva/kellaaja väärtused, kui kasutaja ajavöönd või ajavööndist sõltumatu on UTC järgi. Rakendus tõlgib väärtused, mis põhinevad rakenduse kasutaja ajavööndil, kui väärtused on kuvatud ja kui rakenduse kasutaja need määrab.

Kui Power Fx loeb andmeallikast ajavööndist sõltumatu väärtuse või kirjutab sellise väärtuse andmeallikasse, korrigeerib rakendus automaatselt väärtust, et kompenseerida rakenduse kasutaja ajavööndit. Rakenduses käsitletakse väärtust UTC-väärtusena, mis on kooskõlas kõigi muude rakenduse kuupäeva/kellaaja väärtustega. Selle hüvitise tõttu kuvatakse algse Time zone independent (Ajatsoonist sõltumatu) väärtus juhul, kui rakendus kohandab rakenduse kasutaja ajavööndi UTC väärtust.

Saate seda käitumist põhjalikumalt jälgida, kasutades funktsiooni Value (Väärtus), et pääseda ligi kuupäeva/kellaaja väärtuse aluseks olevale numbrilisele väärtusele. See funktsioon tagastab kuupäeva/kellaaja väärtuse, mis on millisekundites alates 1. jaanuarist 1970 00:00:00.000 UTC.

Kuna iga kuupäeva/kellaaja väärtust hoitakse UTC ajatsoonist, ei tagasta valem Value( Date( 1970, 1, 1 ) ) nulli enamuses maailma osades, kuna funktsioon Date (Kuupäev) tagastab kuupäeva UTC-kujul. Näiteks tagastaks valem 28 800 000 ajavööndis, mis erineb UTC-st kaheksa tunni võrra. See arv näitab kaheksat tundi millisekundites.

Tulles tagasi ülal toodud näite juurde.

UNIX-i kellaaegade teisendamine

UNIX-i kellaajad kajastavad sekundite arvu alates 1. jaanuarist 1970 00:00:00 UTC. Kuna Power Fx kasutab sekundite asemel millisekundeid, saate väärtusi teisendada, korrutades või jagades need tuhandega.

Näiteks UNIX aeg 1 000 000 000 näitab 9. septembrit 2001, kella 01:46:40. Kuupäeva/kellaaja väärtuse kuvamiseks tekstina korrutage see arv 1000-ga, et teisendada see millisekunditeks, ja seejärel kasutage seda funktsioonis Tekst. Valem Text( 1000000000 * 1000, DateTimeFormat.UTC ) tagastab sõne 2001-09-09T01:46:40.000Z.

Kuid funktsioon tagastab laupäev, 8. september, 2001 18:46:40, kui kasutate ajavööndi formaati DateTimeFormat.LongDateTime24, mis on – 7 tundi nihkega UTC (7 tundi UTC-st läänes) järgi. Tulemus näitab DateTime (Kellaajaga kuupäev) väärtust õigesti kohaliku ajavööndi järgi.

UNIX kellaajaks teisendamiseks jagage Value (Väärtus) tulemust 1000-ga.
RoundDown( Value( UnixTime ) / 1000, 0 )

Kui teil on vaja Date (Kuupäev) väärtuse puhul vaja kuvada UNIX kellaaeg edasisteks arvutusteks või rakenduses Power Apps kuvamiseks, kasutage seda valemit.
DateAdd( Date( 1970,1,1 ), UnixTime, Seconds )

SQL Server

SQL Server toetab Datetime, Datetime2 ja muid kuupäeva/kellaaja andmetüüpe, mis ei sisalda ajavööndi nihet ja ei viita sellele, millises ajavööndis nad on. Power Fx eeldab, et need väärtused salvestatakse UTC-ajavööndis ja käsitletakse neid kui kasutaja ajavööndit. Kui väärtused on mõeldud olema ajatsoonist sõltumatud, parandatakse UTC-tõlgeteks kasutades funktsiooni TimeZoneOffset (Ajatsooninihe).

Power Fx kasutab väärtuse teisendamisel rakenduse sisemiseks UTC-esituseks väljadel Datetimeoffset sisalduvat ajavöönditeavet. Rakendused kasutavad andmete kirjutamisel ajavööndina alati UTC-d (null ajavööndi nihe).

Power Fx loeb ja kirjutab SQL Serveri aja andmetüübi Aeg väärtused tekstistringidena ISO 8601 kestuse vormingus. Näiteks peate sõne vormingut kohandama ja kasutama funktsiooni Time (Aeg), et teisendada tekstisõnet "PT2H1M39S" väärtuseks Time (Aeg).

With( 
    Match( "PT2H1M39S", "PT(?:(?<hours>\d+)H)?(?:(?<minutes>\d+)M)?(?:(?<seconds>\d+)S)?" ),
    Time( Value( hours ), Value( minutes ), Value( seconds ) )
)
// Result: 2:01 AM (as shown in a label control, use the Text function to see the seconds)

Kuupäeva ja kellaaja teabe segamine

Suvanditel Date (Kuupäev), Time (Aeg) ja DateTime (Kuupäev kellaajaga) on erinevad nimed, kuid neil kõigil on sama teave kuupäevade ja kellaaegade kohta.

Date (Kuupäev) väärtus võib sisaldada sellega seotud aja teavet, mis on tavaliselt kesköö. Time (Aeg) väärtus võib sisaldada ajakohast teavet, mis on tavaliselt 1. jaanuar 1970. Dataverse hoiustab ka ajateabe väljal Date Only (Ainult kuupäev), kuid kuvab vaikimisi ainult kuupäeva teavet. Samuti eristab Power Fx mõnikord neid andmetüüpe, et määrata vaikevormid ja juhtelemendid.

Kuupäeva ja kellaaja väärtuste lisamine ja lahutamine ei ole soovitatav, kuna ajavöönd ja muud teisendused võivad põhjustada segadust. Kasutage funktsiooni Value (Väärtus), et teisendada kuupäeva/kellaaja väärtused millisekunditeks ja arvestada rakenduse kasutaja ajavööndit või kasutage funktsioone DateAdd (Lisa kuupäev) ja DateDiff (Kuupäeva erinevus), et lisada või lahutada ühest neist väärtustest.

Suvandikomplekti ja kaks võimalust

Suvandikomplekti ja kahe võimalusega andmetüübid annavad rakenduse kasutajale valimiseks kaks või rohkem valikut. Näiteks suvandikomplekt Order Status (Tellimuse olek) sisaldab valikuid New (Uus), Shipped (Saadetud), Invoiced (Arve esitatud) ja Closed (Suletud). Kahe võimalusega andmetüüp pakub ainult kahte valikut.

Mõlemad andmetüübid näitavad oma silte tekstisõne kontekstis. Näiteks sildi juhtelement kuvab ühe tellimuse oleku suvanditest juhul, kui juhtelemendi atribuut Text (Tekst) on seatud valemi järgi, mis viitab suvandikomplektile. Suvandite sildid võidakse lokaliseerida rakenduste kasutajatele erinevates kohtades.

Kui rakenduse kasutaja valib suvandi ja salvestab selle muudatuse, edastab rakendus andmed andmebaasi, mis talletab andmeid kujul, mis ei sõltu keelest. Suvandikomplekt suvand edastatakse ja salvestatakse arvuna ning kahe võimalusega andmetüübi suvand edastatakse ja salvestatakse tõeväärtusena.

Sildid on mõeldud ainult kuvamiseks. Silte ei saa otse omavahel võrelda, sest nad on keelespetsiifilised. Selle asemel on igal suvandikomplektil loend, mis töötab aluseks oleva numbri või tõeväärtusega. Selle valemi abil ei saa teha näiteks järgmist.

If( ThisItem.OrderStatus = "Active", ...

Aga võite kasutada järgmist valemit.

If( ThisItem.OrderStatus = OrderStatus.Active, ...

Globaalsete suvandikomplektide (mida olemid jagavad) korral vastab suvandikomplekti nime loend globaalse suvandikomplekti nimele. Kohalike suvandikomplektide (mis hõlmavad olemit) korral võib nimi sisaldada olemi nime. See käitumine väldib konflikte, kui mitmel olemil on sama nimega suvandikomplektid. Näiteks võib olemil Accounts (Ettevõtted) olla suvandikomplekt OrderStatus (Tellimuse olek) ja selle nimi olla OrderStatus (Accounts). See nimi sisaldab ühte või mitut tühikut ja sulgu, nii et peate valemis viidates ümbritsema seda ühekordsete jutumärkidega.

Lisaks võivad kahe võimalusega väärtused käituda tõeväärtustena. Näiteks kahe võimalusega väärtus nimega TaxStatus (Maksu olek) võib sisaldada silte Taxable (Maksustatav) ja Non-Taxable (Mittemaksustatav), mis vastavad tõeväärtustele tõene ja väär. Näitamiseks võite kasutada järgmist valemit.

If( ThisItem.Taxable = TaxStatus.Taxable, ...

Võite kasutada ka seda samaväärset valemit:

If( ThisItem.Taxable, ...