Power Apps'te konak nesnesi

Şunlar için geçerlidir: Tuval uygulamaları Model temelli uygulamalar

Power Apps'teki Konak nesnesi, uygulamayı çalıştıran geçerli ana bilgisayar hakkında bilgi sağlar.

Veri Akışı Açıklaması

Ana bilgisayar nesnesi bir uygulamayı çalıştıran ana bilgisayar cihazı, işletim sistemi ve yürütücü hakkında bilgi sağlar. Ana bilgisayar, Uygulama nesnesine benzer ve her uygulamanın bu bilgiye erişimi vardır.

Ana bilgisayar nesnesinin en iyi kullanımlarından biri, belirli bir cihazda veya belirli bir tarayıcıyla düzgün çalışmayan bir uygulamada hata ayıklamaktır. Text label denetimiyle uygulamanın kullanıcı arabiriminde bilgi görüntülemek ya da bilgileri bir veritabanı tablosuna veya Application Insights'a kaydetmek için bu nesnenin metin özelliklerini kullanın.

Bir uygulamayı belirli bir cihaza veya tarayıcıya uyarlamak için Ana Bilgisayar'ı kullanmaya çalışır. Bu, Power Apps geniş bir donanım ve yazılım platformları yelpazesinde çalışmak üzere tasarlandığından ve Ana Bilgisayar tabanlı mantığınız hepsini dikkate almayabileceği için tehlikelidir ve zaman içinde değişebilir. Daha soyut ve belirli donanım ve yazılıma bağlı olmayan bilgileri kullanmak daha iyi bir yaklaşımdır. Örneğin bir ekranı daha az öğe gösterecek veya telefon gibi daha küçük bir cihazda çalışırken bilgileri yeniden düzenleyecek şekilde ayarlamak için Screen denetiminin Size özelliğini kullanın.

Power Apps Studio'da Ana bilgisayar nesnesine erişmek için Ağaç görünümü bölmesinin üst kısmındaki Uygulama nesnesini genişletin ve ardından Ana bilgisayar'ı seçin. Bu örnekte, Konak nesnesinin formülleri kabul eden hiçbir özelliği yoktur.

Not

Konak nesne şu anda yalnızca özel sayfalarda ve tuval uygulamalarında kullanılabilir.

BrowserUserAgent özelliği

BrowserUserAgent metin özelliği, tarayıcının uygulamayı çalıştırırken kendisini tanımlamak için kullandığı tam kullanıcı arasıcısı dizesini içerir.

Örneğin, bir tarayıcı kullanıcı aracısı dizesi aşağıdaki gibi olabilir:

• Mozilla/5.0 (Windows NT 10.0; Win64; x64)
• AppleWebKit/537.36 (KHTML, Gecko gibi)
• Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78

Not

Yerel bir uygulamada Power Apps çalıştırıyorsanız veya Power Apps'teki sarma özelliğini kullanıyorsanız uygulama, bir kullanıcı aracısı dizesi sağlayan bir tarayıcı kontrolü aracılığıyla sunulur.

OSType özelliği

OSType özelliği, uygulamanın çalıştığı işletim sisteminin adını sağlar. OSType, tarayıcı tarafından Power Apps'e gönderilen kullanıcı aracısı dizesinden belirlenir. Aşağıda OSType ortak değerlerine ilişkin örnekler verilmektedir:

Değer
Pencereler
Mac OS
iOS
Android
Linux
...

Not

Raporlanan işletim sistemine dayalı olarak uygulamanızın deneyimini veya işlevselliğini değiştirmek için OSType kullanmayın.

OSType metni, etiketin text özelliğinde göstermek gibi herhangi bir formülde kullanılabilir:

Label1.Text: "You're running " & Host.OSType

SessionID özelliği

SessionID özelliği, geçerli oturumu tanımlayan GUID'i döndürür. Sorunları yöneticinize bildirirken bu bilgileri ekleyin.

Not

Power BI'de Power Apps gibi katıştırılmış senaryolarda SessionID özelliği, Power BI oturum kimliğini değil temeldeki Power Apps oturum kimliğini döndürür.

Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."

TenantID özelliği

TenantID özelliği, kimliği doğrulanmış geçerli kullanıcıyla ilişkili Microsoft Entra kiracısını belirten Genel Benzersiz Tanımlayıcıyı (GUID) sağlar.

Not

SessionID ile aynı şekilde, Power BI'da Power Apps gibi katıştırılmış senaryolarda, kiracı kimliği Power Apps oturumu kimlik doğrulaması için kullanılan kiracıdır.

Label1.Text: Host.TenantID

Sürüm özelliği

Sürüm özelliği Power Apps yürütücünün kimliğini ve sürüm numarasını sağlar. BrowserUserAgent'a benzer şekilde, boşluklarla ayrılmış birden çok sürüm numarası döndürülebilir.

Not

Sürüm özelliği Power Apps Studio'da çalışırken her zaman boş bir dizedir.

Label1.Text: Host.Version

OfflineEnabled özelliği

OfflineEnabled özelliği, Power Apps oynatıcıdaki uygulamanın çalışma zamanı modunu sağlar. Çevrimdışı için etkinleştirilmemiş uygulamalar için özellik her zaman yanlıştır. Çevrimdışı için etkinleştirilen uygulamalar için özellik web'de yanlıştır ancak iOS, Android ve Windos'ta doğru olur.

Not

Bir tuval uygulaması ağ bağlantısı olmadan çalışmasa bile OfflineEnabled özelliği, çevrimdışı kullanım için etkinleştirilen tuval uygulamalarında için Power Apps Studio'da doğru olarak kalır.

Label1.Text: Host.OfflineEnabled

Örnekler

1. Yeni bir Tuval uygulaması oluşturun.
2. Bir Text label denetimi ekleyin ve Text özelliğini "Host.BrowserUserAgent: " & Host.BrowserUserAgent olarak ayarlayın.
3. Bir Text label denetimi ekleyin ve Text özelliğini "Host.OSType: " & Host.OSType olarak ayarlayın.
4. Bir Text label denetimi ekleyin ve Text özelliğini "Host.SessionID: " & Host.SessionID olarak ayarlayın.
5. Bir Text label denetimi ekleyin ve Text özelliğini "Host.TenantID: " & Host.TenantID olarak ayarlayın.
6. Bir Text label denetimi ekleyin ve Text özelliğini "Host.Version: " & Host.Version olarak ayarlayın.
7. Bir Text label denetimi ekleyin ve Text özelliğini "Host.OfflineEnabled: " & Host.OfflineEnabled olarak ayarlayın.

Uygulamanızı farklı cihazlarda ve farklı tarayıcılarla çalıştırdığınızda aşağıdakine benzer sonuçlar görürsünüz.

Edge tarayıcısı ile Windows'ta Power Apps Studio

Host.Version, Power Apps Studio'da çalışırken her zaman boştur.

Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36 Edg/116.0.1938.76
Host.OSType: Windows
Host.SessionID: ee2eed1a-8455-4e68-a433-a709302d0c71
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: 

iOS'ta Power Appsyerel mobil yürütücü

Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 PowerApps/e1c23ff9-4822-4e75-a003-01c91407a4d2
Host.OSType: Windows
Host.SessionID: 3ebec22f-ee2e-412a-b3eb-45d97db34863
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Native/3.23084.8(iOS)

Windows'ta Firefox tarayıcıyla Power Apps web yürütücüsü

Host.BrowserUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/117.0
Host.OSType: Windows
Host.SessionID: 283309a4-d88b-4b2a-88de-73b47d1b62d0
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(Windows)

iOS'ta Safari tarayıcıyla Power Apps web yürütücüsü

Host.BrowserUserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1
Host.OSType: iOS
Host.SessionID: a09a946d-ce71-4c1f-bd35-519c79849c8d
Host.TenantID: 5da56e5c-97b6-468f-a448-a6e432c48269
Host.Version: PowerApps-Web/3.23084.6(iOS)