Hostiteľský objekt v Power Apps
Vzťahuje sa na:
aplikácie plátna aplikácie s podporou modelov
Objekt Host v Power Apps poskytuje informácie o aktuálnom hostiteľovi, na ktorom je aplikácia spustená.
Description
Objekt Hostiteľ poskytuje informácie o hostiteľskom zariadení, operačnom systéme a prehrávači, na ktorom je spustená aplikácia. Hostiteľ je podobný objektu aplikácie a každá aplikácia má prístup k týmto informáciám.
Jedným z najlepších spôsobov využitia Host je ladiť aplikáciu, ktorá nefunguje správne na konkrétnom zariadení alebo v konkrétnom prehliadači. Pomocou textových vlastností tohto objektu môžete zobraziť informácie v používateľskom rozhraní aplikácie pomocou ovládacieho prvku Textový štítok alebo zaznamenať informácie do databázovej tabuľky alebo do Application Insights.
Je lákavé použiť Host na prispôsobenie aplikácie konkrétnemu zariadeniu alebo prehliadaču. Je to nebezpečné, pretože Power Apps je navrhnutý na spustenie na širokom spektre hardvérových a softvérových platforiem a logika vášho hostiteľa nemusí zodpovedať všetkým a časom sa budú meniť. Lepší prístup je použiť informácie, ktoré sú viac abstraktné a nie sú viazané na konkrétny hardvér a softvér. Napríklad pomocou vlastnosti Veľkosť ovládača Obrazovka prispôsobte obrazovku tak, aby zobrazovala menej informácií, alebo ich reorganizujte, keď beží na menšom zariadení, ako je telefón.
Ak chcete získať prístup k objektu Hostiteľ v Power Apps Studio, rozbaľte objekt Aplikácia v hornej časti tablu Stromové zobrazenie a potom vyberte Hostiteľ. V tomto príklade objekt Hostiteľ nemá žiadne vlastnosti, ktoré akceptujú vzorce.
Poznámka
Hostiteľský objekt je momentálne dostupný iba na vlastných stránkach a aplikáciách plátna.
Vlastnosť BrowserUserAgent
Vlastnosť textu BrowserUserAgent obsahuje úplný reťazec používateľského agenta, ktorý prehliadač používa na identifikáciu pri spustení aplikácie.
Napríklad reťazec používateľského agenta prehliadača môže byť:
- Mozilla/5.0 (Windows NT 10.0; Win64; x64)
- AppleWebKit/537.36 (KHTML, ako Gecko)
- Chrome/109.0.0.0 Safari/537.36 Edg/109.0.1518.78
Poznámka
Ak používate Power Apps v natívnej aplikácii alebo používate funkciu zabalenie v Power Apps, aplikácia sa prezentuje prostredníctvom ovládací prvok prehliadača, ktorý poskytuje reťazec používateľského agenta.
Vlastnosť OSType
Vlastnosť OSType poskytuje názov operačného systému, v ktorom je aplikácia spustená. OSType je určený z reťazca používateľského agenta odoslaného prehliadačom na adresu Power Apps. Nasledujú príklady bežných hodnôt pre OSType:
| Hodnota |
|---|
| Okná |
| Mac OS |
| iOS |
| Android |
| Linux |
| ... |
Poznámka
Nepoužívajte OSType na zmenu prostredia alebo funkcií vašej aplikácie na základe nahláseného operačného systému.
Text OSType možno použiť v ľubovoľnom vzorci, napríklad ho zobraziť vo vlastnosti textu štítka:
Label1.Text: "You're running " & Host.OSType
Vlastnosť ID relácie
Vlastnosť SessionID vracia GUID, ktorý identifikuje aktuálnu reláciu. Tieto informácie uveďte pri nahlasovaní problémov správcovi.
Poznámka
Vo vstavaných scenároch, ako napríklad Power Apps v Power BI, vlastnosť SessionID vracia základné Power Apps ID relácie, nie Power BI ID relácie.
Label1.Text: $"Provide session ID { Host.SessionID } to your administrator."
Vlastnosť TenantID
Vlastnosť TenantID poskytuje globálne jedinečný identifikátor (GUID), ktorý špecifikuje Microsoft Entra nájomníka spojeného s aktuálne overeným používateľom.
Poznámka
Podobne ako v prípade ID relácie, vo vstavaných scenároch, ako napríklad Power Apps v Power BI, ID nájomníka je nájomník používaný pre Power Apps overenie relácie.
Label1.Text: Host.TenantID
Vlastnosť verzie
Vlastnosť Verzia poskytuje identifikáciu a číslo verzie Power Apps prehrávača. Podobne ako v prípade BrowserUserAgent môže byť vrátených viac ako jedno číslo verzie oddelené medzerami.
Poznámka
Vlastnosť Verzia je pri práci v Power Apps Studio vždy prázdny reťazec.
Label1.Text: Host.Version
Vlastnosť OfflineEnabled
Vlastnosť OfflineEnabled poskytuje režim spustenia aplikácie v prehrávači Power Apps . V prípade aplikácií, ktoré nie sú povolené pre režim offline, je vlastnosť vždy false. V prípade aplikácií, ktoré sú povolené pre režim offline je vlastnosť nepravda na webe, ale pravdivá na iOS, Android a Windows.
Poznámka
Aj keď aplikácia plátna nefunguje bez sieťového pripojenia, vlastnosť OfflineEnabled zostáva pravdivá v Power Apps Studio pre aplikácie plátna, ktoré boli povolené na používanie offline.
Label1.Text: Host.OfflineEnabled
Príklady
- Vytvorte novú aplikáciu Canvas.
- Pridajte ovládací prvok Textový štítok a nastavte vlastnosť
Textna"Host.BrowserUserAgent: " & Host.BrowserUserAgent. - Pridajte ovládací prvok Textový štítok a nastavte vlastnosť
Textna"Host.OSType: " & Host.OSType. - Pridajte ovládací prvok Textový štítok a nastavte vlastnosť
Textna"Host.SessionID: " & Host.SessionID. - Pridajte ovládací prvok Textový štítok a nastavte vlastnosť
Textna"Host.TenantID: " & Host.TenantID. - Pridajte ovládací prvok Textový štítok a nastavte vlastnosť
Textna"Host.Version: " & Host.Version. - Pridajte ovládací prvok Textový štítok a nastavte vlastnosť
Textna"Host.OfflineEnabled: " & Host.OfflineEnabled.
Spustite svoju aplikáciu na rôznych zariadeniach a v rôznych prehliadačoch a uvidíte výsledky podobné tým, ktoré sú uvedené nižšie.
Power Apps Studio v systéme Windows s prehliadačom Edge
Host.Version je pri práci v Power Apps Studio vždy prázdny.
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:
Power Apps natívny mobilný prehrávač zapnutý 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)
Power Apps webový prehrávač v systéme Windows s Firefox prehliadačom
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)
Power Apps webový prehrávač na iOS s prehliadačom 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)