Objekt Host v Power Apps
Platí pro:
aplikace Canvas Modelem řízené aplikace
Objekt Host v Power Apps poskytuje informace o aktuálním hostiteli, na kterém je aplikace spuštěna.
Description
Objekt Hostitel poskytuje informace o hostitelském zařízení, operačním systému a přehrávači, na kterém je spuštěna aplikace. Host je podobný objektu App a každá aplikace má přístup k těmto informacím.
Jedno z nejlepších využití objektu Hostitel je ladění aplikace, které nefunguje správně na konkrétním zařízení nebo v konkrétním prohlížeči. Pomocí textových vlastností tohoto objektu zobrazíte informace v uživatelském rozhraní aplikace s ovládacím prvkem Textový popisek nebo zaprotokolujete informace do databázové tabulky nebo do Application Insights.
Je lákavé použít objekt Hostitel k přizpůsobení aplikace konkrétnímu zařízení nebo prohlížeči. Toto je nebezpečné, protože Power Apps je navržen pro provoz na širokém spektru hardwarových a softwarových platforem a vaše logika na základě objektu Hostitel jim nemusí odpovídat všem a časem se změní. Lepší přístup je použít informace, které jsou více abstraktní a nejsou vázány na konkrétní hardware a software. Použijte například vlastnost Size ovládacího prvku Obrazovka pro přizpůsobení obrazovky tak, aby zobrazovala méně informací nebo reorganizaci informací, když běží na menším zařízení, jako je telefon.
Chcete-li získat přístup k objektu Hostitel v Power Apps Studio, rozbalte objekt Aplikace v horní části podokna Stromové zobrazení a poté vyberte Hostitel. V tomto příkladu objekt Host nemá žádné vlastnosti, které přijímají vzorce.
Poznámka:
Objekt hostitele je aktuálně dostupný pouze na vlastních stránkách a v aplikacích plátna.
Vlastnost BrowserUserAgent
Textová vlastnost BrowserUserAgent obsahuje úplný řetězec uživatelského agenta, který prohlížeč používá k identifikaci při spuštění aplikace.
Řetězec uživatelského agenta prohlížeče může být například:
- Mozilla/5.0 (Windows NT 10.0; Win64; x64)
- AppleWebKit/537.36 (KHTML, like Gecko)
- Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78
Poznámka:
Pokud spustíte Power Apps v nativní aplikaci nebo pomocí funkce pro zabalení v Power Apps, aplikace je prezentována prostřednictvím ovládacího prvku prohlížeče, který dodá řetězec uživatelského agenta.
Vlastnost OSType
Vlastnost OSType poskytuje název operačního systému, ve kterém je aplikace spuštěna. OSType je určeno z řetězce uživatelského agenta odeslaného prohlížečem do Power Apps. Následují příklady běžných hodnot pro OSType:
| Hodnota |
|---|
| Okna |
| Mac OS |
| iOS |
| Android |
| Linux |
| ... |
Poznámka:
Nepoužívejte OSType ke změně prostředí nebo funkcí aplikace na základě nahlášeného operačního systému.
Text OSType lze použít v libovolném vzorci, například ho zobrazit ve vlastnosti text popisku:
Label1.Text: "You're running " & Host.OSType
Vlastnost SessionID
Vlastnost SessionID vrátí GUID, který identifikuje aktuální relaci. Tyto informace uveďte při hlášení problémů správci.
Poznámka:
V integrovaných scénářích, jako je např Power Apps v Power BI, vlastnost SessionID vrátí ID základní relace Power Apps, nikoli ID relace Power BI.
Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."
Vlastnost TenantID
Vlastnost TenantID poskytuje globálně jedinečný identifikátor (GUID), který určuje tenanta Microsoft Entra spojeného s aktuálně ověřeným uživatelem.
Poznámka:
Podobně jako SessionID v integrovaných scénářích, jako je např. Power Apps v Power BI, ID tenanta je tenant použitý pro ověření relace Power Apps.
Label1.Text: Host.TenantID
Vlastnost Version
Vlastnost Version poskytuje identifikaci a číslo verze přehrávače Power Apps. Podobně jako u BrowserUserAgent může být vráceno více než jedno číslo verze oddělené mezerami.
Poznámka:
Vlastnost Version je při práci v Power Apps Studio vždy prázdný řetězec.
Label1.Text: Host.Version
Vlastnost OfflineEnabled
Vlastnost OfflineEnabled poskytuje běhový režim aplikace v přehrávači Power Apps. U aplikací, které nejsou povoleny pro režim offline, je vlastnost vždy false. U aplikací, které jsou povoleny pro režim offline, je vlastnost false na webu, ale true v iOS, Android a Windows.
Poznámka:
I když aplikace plátna nefunguje bez připojení k síti, vlastnost OfflineEnabled zůstává true v Power Apps Studio pro aplikace plátna, které byly povoleny pro použití offline.
Label1.Text: Host.OfflineEnabled
Příklady
- Vytvořte novou aplikaci plátna.
- Přidejte ovládací prvek Textový popisek a nastavte jeho vlastnost
Textna"Host.BrowserUserAgent: " & Host.BrowserUserAgent. - Přidejte ovládací prvek Textový popisek a nastavte jeho vlastnost
Textna"Host.OSType: " & Host.OSType. - Přidejte ovládací prvek Textový popisek a nastavte jeho vlastnost
Textna"Host.SessionID: " & Host.SessionID. - Přidejte ovládací prvek Textový popisek a nastavte jeho vlastnost
Textna"Host.TenantID: " & Host.TenantID. - Přidejte ovládací prvek Textový popisek a nastavte jeho vlastnost
Textna"Host.Version: " & Host.Version. - Přidejte ovládací prvek Textový popisek a nastavte jeho vlastnost
Textna"Host.OfflineEnabled: " & Host.OfflineEnabled.
Spusťte svou aplikaci na různých zařízeních a v různých prohlížečích a uvidíte výsledky podobné těm níže.
Power Apps Studio v systému Windows s prohlížečem Edge
Host.Version je při práci vždy prázdný Power Apps Studio.
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:
Nativní mobilní přehrávač Power Apps na iOS
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)
Webový přehrávač Power Apps v systému Windows s prohlížečem Firefox
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)
Webový přehrávač Power Apps v systému iOS s prohlížečem Safari
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)