İşleçler ve Tanımlayıcılar

Microsoft Power Fx uygulamasındaki operatörler aşağıda açıklanmıştır. Bu işleçlerden bazıları yazarın diline bağlıdır. Daha fazla bilgi edinmek için bkz. Genel uygulamalar.

in ve exactin işleçleri

Veri kaynağındaki (örneğin, koleksiyon veya içeri aktarılan tablo) bir dizeyi bulmak için in ve exactin işleçlerini kullanın. in işleci, büyük/küçük harfe bakılmaksızın eşleşmeleri tanımlar ve exactin işleci yalnızca büyük/küçük harf kullanımının aynı olması halinde eşleşmeleri tanımlar. Bir örnek aşağıda verilmiştir:

1. Stok adlı bir koleksiyonu oluşturun veya içeri aktarın ve Galeride görüntü ve metin gösterme bölümündeki ilk yordamda açıklandığı şekilde galeride gösterin.

2. Galerinin Items özelliğini şu formül olarak ayarlayın:
   Filter(Inventory, ProductName'de "E")

   Belirttiğiniz harfi içermeyen tek ürün olması nedeniyle galeride Callisto dışındaki tüm ürünler gösterilir.

3. Galerinin Items özelliğini şu formül olarak ayarlayın:
   Filter(Inventory, "E" exactin ProductName)

   Belirttiğiniz harfi, belirttiğiniz büyük/küçük harf düzeninde içeren tek ad olması nedeniyle galeride yalnızca Europa gösterilir.

ThisItem, ThisRecord ve As işleçleri

Birkaç denetim ve işlev, bir tablonun bağımsız kayıtlarına formüller uygular. Bir formülde tek bir kayda başvuruda bulunmak için aşağıdakilerden birini kullanın:

ThisItem işleci

Örneğin aşağıdaki Galeri denetiminde, Items özelliği Çalışanlar ceri kaynağına (Northwind Traders örneğindeki Çalışanlar varlığı gibi) ayarlıdır:

Employees

Galerideki ilk öğe, her çalışan için çoğaltılan bir şablondur. Şablonda, resim için formül, geçerli öğeye başvuruda bulunmak için ThisItem'ı kullanır:

ThisItem.Picture

Benzer şekilde, ad formülü de bu ThisItem'ı kullanılır:

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

ThisRecord işleci

ThisRecord , kayıt kapsamına sahip işlevlerdekullanılır. Örneğin, yalnızca M ile başlayan adları göstermek için galerinin Items özelliğinde Filter işlevini kullanabiliriz:

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

ThisRecord isteğe bağlıdır ve alanları doğrudan kullanarak ima edilir, örneğin, bu durumda şunu yazabilirdik:

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

İsteğe bağlı olsa da, ThisRecord işlevinin kullanılması formüllerin daha kolay anlaşılmasını sağlar ve bir alan adının aynı zamanda ilişki adı olabileceği belirsiz durumlarda gerekli olabilir. ThisRecord isteğe bağlıdır, ancak ThisItem her zaman gereklidir.

Patch, Collect ve diğer kayıt kapsamı işlevleriyle kaydın tamamına başvuruda bulunmak için ThisRecord'u kullanın. Örneğin, aşağıdaki formül etkin olmayan tüm çalışanların durumunu etkin olarak ayarlar:

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

As işleci

Varsayılan ThisItem veya ThisRecord'u geçersiz kılarak bir galerideki bir kaydı veya kayıt kapsamı işlevini adlandırmak için As işlecini kullanın. Kaydın adlandırılması, formüllerinizin anlaşılmasını kolaylaştırabilir ve diğer kapsamlardaki kayıtlara erişmek için iç içe durumlarda gerekli olabilir.

Örneğin, galerimizin Items özelliğini, bir Çalışanla çalıştığımızı belirlemek için As kullanacak şekilde değiştirebilirsiniz:

Employees As Employee

Resim ve ad formülleri, geçerli kayıt için bu adı kullanacak şekilde ayarlanır:

Employee.Picture

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

As , varsayılan adı ThisRecord değiştirmek için kayıt kapsamı işlevleriyle de kullanılabilir. Bunu, çalıştığımız kaydı açıklığa kavuşturmak için önceki örneğimize uygulayabiliriz:

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

Galerileri ve kayıt kapsamı işlevlerini iç içe geçirme sırasında, ThisItem ve ThisRecord her zaman en içteki kapsamı gösterir ve dış kapsamlardaki kayıtları kullanılamaz durumda bırakır. Her bir kapsama benzersiz ad vererek tüm kayıt kapsamlarını kullanılabilir hale getirmek için As'yi kullanın.

Örneğin, bu formül iki ForAll işlevini iç içe geçirerek bir metin dizesi olarak bir satranç tahtası modeli üretir:

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 
)

BirLabel denetiminin Text özelliğini bu formüle ayarladığınızda şu gösterilir:

Burada meydana gelenleri yakından inceleyelim:

• Sequence işlevinden numaralı 8 kayıttan oluşan adsız bir tabloyu yinelemekle başlayacağız. Bu döngü, genellikle Rank olarak adlandırılır ve panonun her satırı için kullanılır; bu yüzden bir ad veriyoruz.
• Her satır için adsız bir 8 sütun tablosunu yineliyoruz ve ortak File adını veriyoruz.
• Rank.Value + File.Value tek bir sayı ise, karesi bir X işareti, aksi takdirde bir nokta alır. Formülün bu kısmı As işleci kullanılarak mümkün olan, her iki ForAll döngülerine başvuruda bulunur.
• Concat , önce sütunları ve ardından satırları birleştirmek için iki kez kullanılır ve yeni bir satır oluşturmak için bir Char(10) atılır.

Benzer bir örnek, ForAll işlevleri yerine içe içe Gallery denetimleriyle mümkün olabilir. Rank için dikey galeriden başlayalım. Bu gallery denetiminde şu Itemsformülü bulunur:

Sequence(8) as Rank

Bu galeride, her Rank ile çoğaltılacak File için Items özelliğiyle yatay bir galeri yerleştireceğiz:

Sequence(8) as File

Ve son olarak, bu galeride her bir File ve Rank için çoğaltılacak bir Label denetimi ekleyeceğiz. Tüm alanı dolduracak şekilde boyutlandıracağız ve bu formüle renk sağlamak için Fill özelliğini kullanacağız:

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

Self ve Parent işleçleri

Bir denetime ve bir formül içindeki özelliklerine başvurmanın üç yolu vardır:

Self veüst öğe işleçlerdir ve denetimlerin kendilerindeki özellikler değildir. Parent.Parent, Self.Parent veya Parent.Self başvuruları desteklenmez.

Tanımlayıcı adları

Değişkenlerin, veri kaynaklarının, sütunların ve diğer nesnelerin adları herhangi bir Unicode içerebilir.

Boşluk veya başka bir özel karakter içeren bir adı tek tırnak içine alın.
Adda tek bir tek tırnak işaretini göstermek için iki tek tırnak işaretini birlikte kullanın. Özel karakter içermeyen adlar için tek tırnak işareti gerekir.

Bir tabloda karşılaşabileceğiniz bazı örnek sütun adları ve bunların bir formülde nasıl temsil edildiği aşağıda açıklanmaktadır:

Çift tırnak işaretleri metin dizelerini belirlemek için kullanılır.

Adları ve mantıksal adları görüntüleme

SharePoint ve Microsoft Dataverse gibi bazı veri kaynaklarında aynı tablo veya veri sütununa başvuran iki farklı ad bulunur:

• Mantıksal ad - Benzersiz olduğu garanti edilen, oluşturulduktan sonra değişmeyen, genellikle boşluklara veya diğer özel karakterlere izin vermeyen ve farklı dillere yerelleştirilmeyen bir ad. Sonuç olarak, ad şifreli olabilir. Bu adlar profesyonel geliştiriciler tarafından kullanılır. Örneğin, cra3a_customfield. Bu ad, şema adı veya yalnızca ad olarak da adlandırılabilir.

• görünen ad- Kullanıcı dostu olan ve son kullanıcılar tarafından görülmesi amaçlanan bir ad. Bu ad benzersiz olmayabilir, zamanla değişebilir, boşluklar ve herhangi bir Unicode karakteri içerebilir ve farklı dillerde yerelleştirilebilir. Yukarıdaki örneğe karşılık gelen görünen ad sözcükler arasında boşluk olan Özel Alan olabilir.

Görünen adların anlaşılması daha kolay olduğundan Power Fx, bunları seçimler olarak önerir ve mantıksal adlar önermez. Mantıksal adlar önerilmese de, dolaylı olarak yazıldıklarında kullanılabilirler.

Örneğin, Dataverse'teki bir varlığa Özel Alan eklediğinizi varsayalım. Sistem tarafından size yalnızca alanı oluştururken değiştirebileceğiniz bir mantıksal ad atanır. Sonuç aşağıdakine benzer olabilir:

Firmalar alanına başvuru yazarken bu görünen ad olduğundan "Özel Alan" kullanılması önerilir. Bu adda bir boşluk olduğundan tek tırnak işareti kullanılmalıdır:

Öneri seçildikten sonra formül çubuğunda "Özel Alan" gösterilir ve veriler alınır:

Önerilmese de bu alan için mantıksal adı da kullanabiliriz. Bu, aynı verilerin alınmasına neden olur. Bu ad boşluk veya özel karakter içermediğinden tek tırnak gerekmez:

Perde arkasında, formüllerde görülen görünen adlar ile temel mantıksal adlar arasındaki eşleme korunur. Mantıksal adların veri kaynağı ile etkileşim için kullanılması gerektiğinden bu eşleme, geçerli görünen adın otomatik olarak mantıksal ada dönüştürülmesi için kullanılır ve ağ trafiğinde görünen eşlemedir. Örneğin, bir görünen ad değişirse veya farklı bir dildeki geliştirici uygulamayı düzenlerse bu eşleme aynı zamanda yeni görünen adlara geçiş yapmak için de kullanılır.

Ad kesinleştirme

Görünen adlar benzersiz olmadığından aynı görünen ad aynı varlıkta birden fazla görüntülenebilir. Bu durumda mantıksal ad çakışan adlardan biri için parantez içinde görünen adın sonuna eklenir. Yukarıdaki örneğe göre, cra3a_customfieldalt mantıksal adını içeren Özel Alan ile aynı görünen ada sahip ikinci bir alan varsa öneriler gösterilir:

Ad kesinleştirme dizeleri, varlıkların, seçenek kümelerinin ve diğer Dataverse öğelerinin adları gibi ad çakışmalarının oluştuğu diğer durumlarda eklenir.

Kesinleştirme işleci

Filter, AddColumns ve Sum gibi bazı işlevler, her kayıt işlenirken tablo alanlarına erişime yönelik kayıt kapsamları oluşturur. Kayıt kapsamıyla eklenen alan adları, uygulamanın başka yerlerindeki aynı adları geçersiz kılar. Bu durumda @ kesinleştirme işlecini kullanarak kayıt kapsamının dışındaki değerlere erişebilirsiniz:

• İç içe kayıt kapsamlarındaki değerlere erişmek için şu deseni kullanarak üzerinde çalışılan tablonun adıyla birlikte @ işlecini kullanın:
  Tablo[@FieldName]
• Veri kaynakları, koleksiyonlar ve bağlam değişkenleri gibi genel değerlere erişmek için [@ObjectName] desenini (tablo gösterimi olmadan) kullanın.

Daha fazla bilgi ve örnek için bkz. kayıt kapsamları.