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

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

  • Статия

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

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

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

Бележка

  • Само потребителите на Power Apps в същия наемател могат да имат достъп до вграденото приложение.
  • Вграждането на приложения за платно в родно настолно приложение не се поддържа. Това изключва интеграции от първа страна, като например 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=/providers/Microsoft.PowerApps/apps/[AppID]

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

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

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

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

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

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

  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"/>

Посочете стойности за ширината и височината на рамката и заменете идентификационния номер на приложението си [AppID].

Бележка

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

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

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

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

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

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

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).