Veri türleri

Bilgiler, elektronik tablonun hücrelerine çok benzer şekilde küçük ve ayrı değerler olarak Microsoft Power Fx aracılığıyla akar. Örneğin, bir Doğum Günü alanı ve Yıl Dönümü alanındaki veriler yılı, ayı ve günü içeren bir Tarih değeri olarak akar. Uygulama, bu değerleri biçimlendirmeyi, her biri için uygun girişleri sınırlandırmayı ve veritabanıyla değerleri paylaşmayı bilir. Doğum günleri ile yıl dönümleri insanlar için farklıdır ancak sistem ikisini de aynı şekilde işler. Bu durumda, Tarih bir veri türü örneğidir.

Bu makalede, Power Fx'in desteklediği veri türleriyle ilgili ayrıntılar açıklanmaktadır. Dış veriler dile getirildiğinde kaynaktaki her veri türü Power Fx için bir veri türüne eşlenir.

Bu veri türlerinin çoğu benzerdir ve Metin olarak işlenen Köprü alanı gibi, aynı temel gösterime sahiptir. Ek veri türleri, formlarda ve diğer denetimlerde daha iyi varsayılan deneyimler sağlar.

Blank

Tüm veri türleri boş değere sahip olabilir (yani değersiz olabilir). "Null" terimi genellikle bu kavram için ilgili veritabanlarında kullanılır.

Değişkeni veya alanı boş olarak ayarlamak için Blank işlevini Set veya Patch işleviyle kullanın. Örneğin, Set( x, Blank() ) x genel değişkenindeki tüm değerleri kaldırır.

IsBlank işlevini kullanarak boş değeri test edin. Coalesce işlevini kullanarak olası boş değerleri boş olmayan değerlerle değiştirin.

Tüm veri türleri boş değerini desteklediğinden, Boolean ve İki seçenek veri türleri, etkin olarak üç olası değere sahiptir.

Metin, Köprü, Görüntü ve Ortam

Bu veri türlerinin dördü de bir Unicode metin dizesine dayanır.

Katıştırılmış metin

Bir formüldeki katıştırılmış metin dizeleri çift tırnak işareti içine alınır. Metin dizesindeki tek bir çift tırnağı göstermek için iki çift tırnağı birlikte kullanın. Örneğin, aşağıdaki formülü bir Düğme denetiminin OnSelect özelliğinde kullanmak:

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

düğmeye basıldığında bir başlığın açılmasına neden olur. Burada birinci ve sonuncu çift tırnaklar metin dizesini sınırladıkları için atlanır ve Merhaba, Dünya! ifadesinin yanlarındaki yinelenen çift tırnak işaretleri yerine tek bir çift tırnak işareti gelir:

Tek tırnak işaretleri, özel karakter içeren ve bir metin dizesi içinde hiç önemi olmayan tanımlayıcı adlar için kullanılmaz.

Görüntü ve Ortam kaynakları

Dosya menüsünden, uygulama kaynağı olarak görüntü, video ve ses dosyaları ekleyebilirsiniz. İçeri aktarılan dosyanın adı uygulamada kaynak adı olur. Bu grafikte, nwindlogo adlı Northwind Traders logosu bir uygulamaya eklenmiştir:

Bu kaynağı bir uygulamada kullanmak için bir Görüntü denetiminin Görüntü özelliğinde belirtin:

Görüntüler ve diğer ortamlar için URI'lar

Etiket denetiminin Metin özelliğini nwindlogo olarak ayarlayarak son örneği daha ayrıntılı inceleyebilirsiniz. Etiket bir metin dizesi gösterir:

Power Fx, ister bulutta olsun ister uygulama kaynağı olarak eklenmiş olsun her görüntüye veya ortam dosyasına bir URI metin dizesiyle başvurur.

Örneğin, bir görüntünün Görüntü özelliği yalnızca uygulama kaynaklarını değil, web üzerindeki görüntülere bağlantıları da kabul eder. Örneğin "https://northwindtraders.com/logo.jpg". Özellik veri URI şemasını kullanan satır içi görüntüleri de kabul eder. Örneğin:

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

URI, iki mor dörtgenin ölçeklenmiş bir sürümünü görüntüler:

Görüntü denetiminin Görüntü özelliğini kamera denetiminin Fotoğraf özelliğine ayarladığınızda Kamera denetiminde yakalanan en son görüntüyü gösterebilirsiniz. Uygulama görüntüyü bellekte tutar ve kamera denetiminin Fotoğraf özelliği görüntüye bir URI başvurusu döndürür. Örneğin, bir resim çektiğinizde kameranın Fotoğraf özelliği "appres://blobmanager/7b12ffa2ea4547e5b3812cb1c7b0a2a0/1" döndürebilir.

Veritabanında depolanan bir görüntü veya başka bir ortam dosyasına başvurmak için bir URI kullanın. Bu şekilde, uygulama gerekene kadar gerçek verileri almaz. Örneğin, bir Microsoft Dataverse varlığı içindeki bir ek "appres://datasources/Contacts/table/..." döndürebilir. Kamera örneğinde olduğu gibi, görüntü denetiminin Görüntü özelliğini ikili verileri alan bu başvuruya ayarlayarak bu görüntüyü görüntüleyebilirsiniz.

Görüntü gibi bir ortam veri türünü bir veritabanına kaydettiğinizde, uygulama URI başvurusunu değil, gerçek görüntüyü veya ortam verilerini gönderir.

Boyut limitleri

Metin dizeleri ve URI'lar olarak, bu veri türlerinin uzunlukları üzerinde ön tanımlı limiti yoktur.

Bu veri türlerinin başvurduğu ikili verilerin de boyut üzerinde ön tanımlı limiti yoktur. Örneğin, şimdi "appres://..." olarak başvurulan kamera denetimi aracılığıyla yakalanan bir görüntü cihazın kamerasının işleyebileceği kadar yüksek çözünürlüklü olabilir. Ortam dosyalarının çözünürlük, kare hızı ve diğer öznitelikleri veri türüyle sınırlı değildir ancak ortamı yürütmek ve yakalamak için kullanılan belirli denetimlerin kendi sınırları olabilir.

Ancak tüm veri boyutları uygulamada kullanılabilir bellek miktarına bağlıdır. Masaüstü bilgisayarda çalışan tarayıcılar genellikle 100 megabayttan fazla veri destekler. Ancak telefon gibi bir cihazda kullanılabilir bellek miktarı çok daha az olabilir ve bu miktar genellikle 30-70 megabayt aralığındadır. Uygulamanızın bu sınırlar içinde çalışıp çalışmayacağını belirlemek için uygulamayı çalıştıracağınız tüm cihazlarda yaygın senaryoları test edin.

En iyi uygulama olarak, verileri yalnızca gerektiği kadar bellekte tutun. Görüntüleri olabildiğince kısa sürede veritabanına yükleyin; görüntüleri yalnızca uygulamanın kullanıcısı bunları istediğinde indirin.

Sayı ve Para Birimi

Sayı ve Para Birimi veri türleri IEEE 754 çift duyarlıklı kayan noktalı standardını kullanır. Bu standart, üzerinde çalışılabilecek geniş bir sayı aralığı asğlar: –1,79769 x 10³⁰⁸ - 1,79769 x 10³⁰⁸. Gösterilebilen en küçük değer 5 x 10^–324.

Power Fx, –9.007.199.254.740.991 (–(2⁵³ – 1)) ile 9.007.199.254.740.991 (2⁵³ – 1) (dahildir) arasında tamsayıları tam olarak temsil edebilir. Bu aralık veritabanlarının yaygın olarak kullandığı 32 bit (veya 4 bit) tamsayı veri türlerinden büyüktür. Ancak Power Fx, 64 bit (veya 8 bayt) tamsayı veri türlerini temsil edemez. Sayıyı bir metin alanında depomak veya sayının metin alanında kopyasını oluşturmak için hesaplanan sütun kullanabilirsiniz. Böylece, sayı Power Fx'te Metin veri türüne eşlenir. Bu şekilde, bu değerleri saklayabilir, görüntüleyebilir ve girebilirsiniz ve eşit olup olmadıklarını görmek için karşılaştırabilirsiniz. Ancak bu biçimdeyken değerler üzerinde sayısal hesaplamalar gerçekleştiremezsiniz.

Kayan nokta aritmetiği yaklaşık bir işlemdir, yani belgelenen örneklerin çoğunda beklenmeyen sonuçlar verebilir. 55 / 100 * 100 formülünün tam olarak 55 döndürmesini, (55 / 100 * 100) - 55 formülünün tam olarak sıfır döndürmesini bekleyebilirsiniz. Ancak, ikinci formül, küçük bir değer olmasına rağmen sıfır olmayan 7,1054 x 10^–15 değerini döndürür. Bu küçük fark normalde sorun oluşturmaz ve uygulama sonuçları gösterirken bu sonucu yuvarlar. Ancak küçük farklılıklar sonraki hesaplamalarda birleşip yanlış yanıtı verebilir.

Veritabanı sistemleri genellikle, ondalık matematik kullanarak para birimlerini depolar ve hesaplamalar gerçekleştirir. Bu, daha küçük bir aralık sunsa da hassasiyeti artırır. Varsayılan olarak Power Fx, kayan nokta değerlerinin içinde ve dışında para birimlerini eşler. Bu nedenle sonuç, yerel ondalık veri türünde yapılan hesaplamalardan farklı olabilir. Bu tür bir tutarsızlık sorunlara neden olursa bu bölümün önceki kısımlarında açıklanan büyük tamsayılarda olduğu gibi, bu değerlerle Metin olarak çalışabilirsiniz.

Tarih, Saat ve Tarih Saat

Saat dilimleri

Tarih/saat değerleri bu kategorilere ayrılır:

• Kullanıcının Saat Diliminde: Bu değerler UTC (Eşgüdümlü Evrensel Saat) biçiminde depolanır ancak uygulama kullanıcısının saat dilimi uygulamanın bu değerleri nasıl göstereceğini ve uygulama kullanıcının bunları nasıl belirttiğini etkiler. Örneğin, aynı an Kanada'daki bir kullanıcıyla Japonya'daki bir kullanıcı için farklıdır.
• Saat diliminden bağımsız: Uygulama bu değerleri saat diliminden bağımsız olarak, aynı şekilde gösterir ve uygulama kullanıcısı aynı şekilde belirtir. Aynı an Kanada'daki bir kullanıcıyla Japonya'daki bir kullanıcı için aynıdır. Uygulamalarının farklı saat dilimlerinde çalıştırılmasını beklemeyen uygulama yazarları bu değerleri genel olarak daha basit oldukları için kullanırlar.

Bu tabloda bazı örnekler verilmiştir:

Power Apps'te kullanıldığında Kullanıcının saat diliminde tarih/saatler için Power Fx tarayıcının veya cihazın saat dilimini kullanır, ancak model temelli uygulamalar kullanıcının Dataverse ayarını kullanır. Bu ayarlar genellikle eşleşir ancak bu ayarlar farklıysa sonuçlar farklı olur.

Yerel saati UTC'ye ve UTC'yi yerel saate dönüştürmek için DateAdd ve TimeZoneInformation işlevlerini kullanın. Bu işlevlerin örneklerini belgenin sonunda bulabilirsiniz.

Sayısal eşdeğerleri

Power Fx, Kullanıcının saat diliminde veya Saat diliminden bağımsız olmasına bakılmaksızın tüm tarih/saat değerlerini UTC biçiminde saklar ve hesaplar. Uygulama değerleri gösterirken ve uygulama kullanıcısı belirlediğinde, bu değerleri uygulama kullanıcının saat dilimine göre çevirir.

Power Fx, veri kaynağında Saat diliminden bağımsız bir değer okuduğunda veya veri kaynağına böyle bir değer yazdığında uygulama, otomatik olarak uygulama kullanıcısının saat dilimine göre değeri otomatik olarak ayarlar. Uygulama bu değeri uygulamadaki diğer tüm tarih/saat değerleriyle tutarlı olarak UTC değeri olarak kabul eder. Bu dengeleme nedeniyle özgün Saat diliminden bağımsız değer, uygulama kullanıcının saat dilimine göre UTC değerini ayarladığında görünür.

Tarih/saat değeri için temel sayısal değere erişerek Value işlevini kullanarak bu davranışı daha yakından gözlemleyebilirsiniz. Bu işlev, tarih/saat değerini 1 Ocak 1970 00:00:00,000 UTC anından itibaren geçen milisaniyelerin sayısı olarak döndürür.

Her tarih/saat değeri UTC olarak tutulduğundan, Date işlevi UTC cinsinden bir tarih döndürdüğünden, Value( Date( 1970, 1, 1 ) ) formülü dünyanın çoğu bölgesinde sıfır döndürmez. Örneğin, formül, UTC'den sekiz saat farklı olan bir saat diliminde 28.800.000 döndürür. Bu sayı, sekiz saatteki milisaniye sayısını yansıtır.

Yukarıdaki örneğimize dönelim:

UNIX saatlerini dönüştürme

Unix saatleri 1 Ocak 1970 00:00:00 UTC anından itibaren geçen saniye sayısını yansıtır. Power Fx, saniye yerine milisaniye kullandığından 1000 ile çarparak veya 1000'e bölerek ikisi arasında dönüşüm gerçekleştirebilirsiniz.

Örneğin, Unix saati 9 Eylül 2001 01:46:40 UTC anını 1.000.000.000 olarak gösterir. Bu tarih/saat değerini metin olarak göstermek için bu sayıyı milisaniyeye dönüştürmek üzere 1000 ile çarpın ve bir Text işlevinde kullanın. Text( 1000000000 * 1000, DateTimeFormat.UTC ) formülü 2001-09-09T01:46:40.000Z dizesini döndürür.

Ancak UTC'den -7 saat farklı bir saat diliminde (UTC'nin 7 saat batısında) DateTimeFormat.LongDateTime24 biçimini kullandığınızda bu işlev 8 Eylül 2001 Cumartesi 18:46:40 döndürür. Bu sonuç Tarih Saat değerini yerel saat dilimine göre doğru olarak gösterir.

Saati Unix biçimine dönüştürmek için Value ile elde edilen sonucu 1000'e bölün:
RoundDown( Value( UnixTime ) / 1000, 0 )

Daha ayrıntılı hesaplamalar veya Power Apps'te görüntülemek için Tarih değerinde Unix saat gerekliyse şu formülü kullanın:
DateAdd( Date( 1970,1,1 ), UnixTime, Seconds )

SQL Server

SQL Server Tarih Saat, Tarih Saat2 ve diğer tarih/saat veri türlerine sahiptir. Bu veri türleri saat dilimi dengelemesi içermez ve bulundukları saat dilimini göstermez. Power Fx, bu değerlerin UTC'de depolandığını varsayar ve bunları Kullanıcının saat dilimi olarak kabul eder. Bu değerlerin saat diliminden bağımsız olmaları gerekiyorsa TimeZoneOffset işlevini kullanarak UTC çevirilerini düzeltin.

Power Fx, bir değeri uygulamanın iç UTC temsiline dönüştürmek için Datetimeoffset alanlarına eklenen saat dilimi bilgilerini kullanır. Uygulama, verileri yazarken her zaman saat dilimi (sıfır saat dilimi dengesi) olarak UTC kullanır.

Power Fx, SQL Server'daki Saat veri türünün değerlerini ISO 8601 süre biçiminde metin dizeleri olarak okur ve yazar. Örneğin bu dize biçimini ayrıştırmanız ve "PT2H1M39S" metin dizesini bir Saat değerine dönüştürmek için Time işlevini kullanmanız gerekir:

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)

Tarih ve saat bilgilerini karıştırma

Tarih, Saat ve Tarih Saat farklı adlara sahip olsa da hepsi tarih ve saat hakkında aynı bilgileri tutar.

Tarih değeri saat bilgisini de içerebilir. Bu bilgi genellikle gece yarısıdır. Saat değeri tarih bilgilerini taşıyabilir. Bu bilgi genellikle 1 Ocak 1970'tir. Dataverse saat bilgilerini Yalnızca Tarih alanıyla birlikte depolar ancak varsayılan olarak yalnızca tarih bilgilerini gösterir. Benzer şekilde Power Fx, bazen varsayılan biçimleri ve denetimleri belirlemek için bu veri türleri arasında ayrım yapar.

Saat dilimi ve diğer dönüştürmeler karışık sonuçlara yol açabileceğinden tarih ve saat değerlerini doğrudan eklemek ve çıkarmak önerilmez. Önce, tarih/saat değerlerini milisaniyeye dönüştürmek için Value işlevini kullanıp uygulama kullanıcısının saat dilimini dikkate alabilir ya da bu değerlerden birini eklemek veya çıkarmak için DateAdd ve DateDiff işlevlerini kullanabilirsiniz.

Seçenek kümeleri ve İki seçenek

Seçenek kümeleri ve iki seçenek veri türleri uygulama kullanıcısının seçmesi için iki veya daha fazla seçenek sunar. Örneğin, Sipariş Durumu seçenek kümesi Yeni, Sevk Edildi, Faturalandı ve Kapatıldı seçeneklerini sunabilir. İki seçenek veri türü yalnızca iki seçenek sunar.

Bu veri türlerinin ikisi de etiketlerini bir metin dizesi bağlamında gösterir. Örneğin, denetimin Metin özelliği seçenek kümesine başvuran bir formüle ayarlanırsa bir etiket denetimi sipariş durumu seçeneklerinden birini gösterir. Seçenek etiketleri farklı konumlardaki uygulama kullanıcıları için yerelleşmiş olabilir.

Bir uygulama kullanıcısı bir seçeneği belirlediğinde ve bu değişikliği kaydettiğinde, uygulama verileri, dilden bağımsız bir gösterimde depolayan veritabanına iletir. Bir seçenek kümesindeki seçenek bir sayı olarak aktarılır ve depolanır ve iki seçenek veri türündeki bir seçenek, bir Boolean değeri olarak iletilir ve depolanır.

Etiketler yalnızca görüntüleme amacıyla kullanılır. Bir dile özgü olduklarından etiketlerle doğrudan karşılaştırma yapamazsınız. Bunun yerine, her seçenek kümesinin temeldeki sayı veya Boolean değeriyle çalışan bir numaralandırması vardır. Örneğin, şu formülü kullanamazsınız:

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

Ancak şu formülü kullanabilirsiniz:

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

Genel seçenek kümeleri (varlıklar tarafından paylaşılır) için seçenek kümesi numaralandırmasındaki ad, genel seçenek kümesi adıyla eşleşir. Yerel seçenek kümeleri (bir varlık kapsamındadır) için ad varlığın adını içerebilir. Birden çok varlık aynı ada sahip seçenek kümelerine sahipse bu davranış çakışmaları önler. Örneğin, Firmalar varlığı bir OrderStatus seçenek kümesine sahip olabilir ve adı OrderStatus (Accounts) olabilir. Bu ad bir veya daha fazla boşluk ve parantez içerir; bu nedenle, bir formülde bu ada başvurursanız, başına ve sonuna tek tırnak işareti eklemeniz gerekir.

Ayrıca iki seçenek değerleri de Boolean değeri gibi davranabilir. Örneğin, TaxStatus adlı iki seçenek değeri Vergiye Tabi ve Vergiye Tabi Değil etiketlerine sahip olabilir. Bu etiketler sırasıyla doğru ve yanlış değerlerine karşılık gelir. Gösterim amacıyla, şu formülü kullanamazsınız:

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

Buna denk olan şu formülü de kullanabilirsiniz:

If( ThisItem.Taxable, ...