Споделяне чрез

Интегриране на приложение за платно в уеб сайтове и други услуги

  • Статия

Приложенията, които изграждате, често са най-полезни, когато са достъпни точно там, където хората вършат своята работа. Чрез вграждане на приложения за платно в iframe, можете да интегрирате тези приложения в уебсайтове и други услуги, като например Power BI или SharePoint.

В тази тема ще ви покажем как да зададете параметри за вграждане в приложението; след това ще вградим нашето приложение за поръчка на активи в уебсайт.

Табло на Power BI с вградено приложение.

Бележка

  • Само потребителите на Power Apps в същия наемател могат да имат достъп до вграденото приложение.
  • Вграждането на приложения за платно в нито едно собствено настолно приложение не се поддържа, което включва Andrioid и iOS. Това изключва интеграции на първа страна, като например Power Apps в Teams.

Можете също да интегрирате приложения за платно в SharePoint Online без използване на рамка. Повече информация: Използване на Power Apps уеб частта.

Задайте параметри на URI за вашето приложение

Ако имате приложение, което искате да вградите, първата стъпка е да зададете параметри за Uniform Resource Identifier (URI), така че iframe да знае къде да намери приложението. URI е в следната форма:

https://apps.powerapps.com/play/[AppID]?source=iframe

За потребители на GCC

https://apps.gov.powerapps.us/play/[AppID]?source=iframe

Важно

От август 2019 г. форматът на URI се промени от https://web.powerapps.com/webplayer до https://apps.powerapps.com/play. Моля, актуализирайте всички вградени iframes, за да използвате новия URI формат. Позоваванията на предишния формат ще бъдат пренасочени към новия URI, за да се гарантира съвместимост.

Предишен формат:

https://web.powerapps.com/webplayer/iframeapp?source=iframe& appId=/доставчици/Microsoft.PowerApps/apps/[AppID]

Единственото, което трябва да направите, е да замените идентификационния номер на приложението си за [AppID] в URI (включително '[' & ']'). Ще ви покажем как да получите тази стойност скоро, но първо тук са всички параметри, налични в URI:

  • [идентификатор на приложението] - Предоставя идентификатора на приложението, което трябва да се стартира.
  • tenantid - е незадължителен параметър за поддръжка на достъп на гости и определя от кой клиент да отвори приложението.
  • screenColor - се използва за осигуряване на по-добро изживяване при зареждане на приложения за вашите потребители. Този параметър е във формат RGBA (червена стойност, зелена стойност, синя стойност, алфа) и контролира цвета на екрана, докато приложението се зарежда. Най-добре е да го зададете на същия цвят като иконата на приложението ви.
  • source - не засяга приложението, но ви предлагаме да добавите описателно име, което да препраща към източника на вграждането.
  • И накрая, можете да добавите всякакви персонализирани параметри, които искате, като използвате функцията Param() и тези стойности могат да бъдат използвани от вашето приложение. Те се добавят в края на URI, като например [AppID]?source=iframe&param1=value1&param2=value2. Тези параметри се четат само по време на стартирането на приложението. Ако трябва да ги промените, трябва да рестартирате приложението. Обърнете внимание, че само първият елемент след [appid] трябва да има „?“; след това използвайте "&", както е показано тук.

Получаване на ИД на приложението

Идентификационният номер на приложението е достъпен на powerapps.com. За приложението, което искате да вградите:

  1. Вpowerapps.com , в разделаApps (Приложения ) щракнете или докоснете многоточието ( . . . . ), след което Details (Подробности).

    Преминаване към подробности за приложението.

  2. Копирайте ИД наприложението.

    Копирайте ИД на приложението от подробностите.

  3. Заместете стойността [AppID] в URI. За нашето приложение за поръчка на активи URI изглежда така:

    https://apps.powerapps.com/play/76897698-91a8-b2de-756e-fe2774f114f2?source=iframe

Може да се наложи да разрешите изскачащи прозорци в браузъра, когато вградите приложение в уебсайта си, което използва функцията Launch() , за да стартира уеб страница или приложение.

Вградете приложението си в уебсайт

Вграждането на приложението ви сега е толкова лесно, колкото добавянето на рамка към HTML кода за вашия сайт (или всяка друга услуга, която поддържа iframes, като например Power BI или SharePoint):

<iframe width="[W]" height="[H]" src="https://apps.powerapps.com/play/[AppID]?source=website&screenColor=rgba(165,34,55,1)" allow="geolocation; microphone; camera"/>

Задайте стойности за ширината и височината на iframe и заместете ID на вашето приложение [AppID].

Бележка

Включете allow="geolocation; microphone; camera" в своя iframe HTML код, за да позволите на приложенията ви да използват тези възможности в Google Chrome.

Следното изображение показва приложението за поръчка на активи, вградено в примерния уебсайт на Contoso.

Уебсайт Contoso с вградено приложение.

Имайте предвид следните точки за удостоверяване на потребителите на приложението ви:

  • Ако уебсайтът ви използва Microsoft Entra удостоверяване въз основа на идентификатор, не е необходимо допълнително влизане.
  • Ако вашият уебсайт използва някакъв друг механизъм за вход или не е удостоверен, вашите потребители виждат подкана за влизане в iframe. След като влязат, те ще могат да стартират приложението, докато авторът на приложението го сподели с тях.

Както можете да видите, вграждането на приложения е просто и мощно. Вграждането ви позволява да привеждате приложения точно до местата, на които работите вие и вашите клиенти - уебсайтове, Power BI табла за управление, SharePoint страници и други.