Launch және Param функциялар

Мыналарға қолданылады: Canvas қолданбалары

Веб-бет немесе кенеп бағдарламасын іске қосады және іске қосу параметрлеріне қатынасты қамтамасыз етеді.

Launch

Веб-бет немесе кенеп бағдарламасын іске қосады. Функция мыналарды қолдайды:

Мекенжай (міндетті), кенеп қолданбасының веб-бетінің URL мекенжайы.
Параметрлер (қосымша), веб-бетке немесе кенеп қолданбасына өту үшін аталған мәндер. Мәтін мазмұны бойынша мәтінді оқуға болады Param .
Target (қосымша), веб-бетті немесе кенеп қолданбасын іске қосатын шолғыш қойындысы.

Launch Оны тек мінез-құлық сөздерінде ғана қолдануға болады.

Ескертпе

Егер Launch формула Power Apps бағдарламасын ашу үшін пайдаланылса және бағдарлама соңғы пайдаланушыға көрінбесе, бағдарламаны браузердің қалқымалы терезе блокаторы бұғаттағанын немесе браузер пайдаланушының жаңа экранға өткіңіз келетінін сұрайтын диалогтық терезеге жауабын күтіп тұрғанын тексеру ұсынылады.
Тек https: PowerBI бағдарламасындағы Power Apps Visual бағдарламасында пайдалану Launch кезінде URI қолдау көрсетіледі.

Мекенжай

Веб-беттер URL мекенжайы арқылы іске қосылады. Мысалы:

Launch( "https://bing.com" )

Кенеп қолданбаларын Веб сілтемесі немесе Қолданба URI (қолданба идентификаторы /providers/Microsoft.PowerApps/apps/). Бағдарлама үшін осы мәндерді табу үшін:

Power Apps өту.
Сол жақ навигация тақтасынан Бағдарламалар тармағын таңдаңыз.
Бағдарламаны таңдаңыз.
Жоғарғы мәзірден Мәліметтер тармағын таңдаңыз.
Сондай-ақ ... (Қосымша пәрмендер) тармағын таңдауға, содан кейін ашымалы мәзірден Мәліметтер тармағын таңдауға болады.
Көшіру Веб сілтеме.

Веб-сілтемені кез келген веб-бетте пайдалануға болады және кенеп бағдарламасын іске қосады. Сондай-ақ, оны функциямен Launch де пайдалануға болады. Мысалы:

Launch( "https://apps.powerapps.com/e/{environment id}/a/{app id}?tenantId={tenantId}" )

Құрылғыдағы нативтік бағдарламаларды тікелей іске қосу мүмкін емес. Кейбір платформаларда тікелей емес опциялар қолжетімді болуы мүмкін: мысалы, теңшелетін URL схемасынан нативтік бағдарламаны орнату немесе белгілі бір веб-сайттар үшін опцияны ұсыну үшін веб-шолғыш арқылы тіркелу.

Параметрлер

Launch Параметрлерді веб-бетке немесе кенеп қолданбасына жібере алады. Параметрлерді екі жолмен қамтамасыз етуге болады:

Ат-мән жұптарының аргументтер тізімі. Мысалы:
```
Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
```
Өріс мәндерінің жазбасы. Мысалы:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Бұл пішімен жұмыс істеу оңайырақ болуы мүмкін, өйткені ол ат пен мән арасындағы байланысты анығырақ етеді. Бұл міндетті емес LaunchTarget аргументін қолдайтын жалғыз пішін.

Әрқайсысында % функциясы пайдаланылғандай белгілі бір әліпбилік-сандық емес таңбаларды таңбасымен және он алтылық санмен ауыстыру үшін өткізу алдында мекенжай мен параметрлер URL кодталады.

Веб-бетті іске қосқанда, URL мекенжайының соңында параметрлердің сұрау жолын қосуға болады. Ұсынылған Launch барлық қосымша параметрлер сұрау жолының соңына қосылады. Кенеп бағдарламасын іске қосқанда сұрау жолдары жұмыс істемейді.

Қолданба әлдеқашан жұмыс істеп тұрған мобильді құрылғыда қолданбаны іске қосқан кезде параметрлер іске қосылған қолданбада жаңартылмайды. Параметрлерді жаңарту үшін қолданбаны қайта жүктеу қажет.

Межелі орын

Веб-бетті немесе бағдарламаны ашатын мақсатты шолғыш терезесін көрсету үшін LaunchTarget аргументін пайдаланыңыз. Келесі LaunchTarget санамалау мәндерінің біреуін пайдаланыңыз немесе теңшелетін терезе атауын беріңіз.

Іске қосуМақсатты жиын	Сипаттамасы
Жаңа	Веб-бет немесе бағдарлама жаңа терезеде немесе қойыншада ашылады.
Ауыстыру	Веб-бет немесе бағдарлама ағымдағы терезені немесе қойыншаны ауыстырады.
аты	Жиын мәнінің орнына, терезені немесе қойындыны атау үшін өз мәтін жолыңызды пайдаланыңыз. Self - бұл тек функция қолданатын Launch ішкі атау. Ол пайдаланушыларыңыз көретін терезенің атауына әсер етпейді немесе онымен бірдей болмайды. Осындай атауы бар терезе немесе қойынша бұрыннан бар болса, оның мазмұны ауыстырылады. Әйтпесе, жаңа терезе немесе қойынша жасалады. name астын сызу "_" таңбасымен басталуы мүмкін емес.

Жаңа бұл Replace және аты бар веб-шолғышта іске қосылған кездегі әдепкі нөмір. қолжетімді опциялар ретінде. Мобильді ойнатқышта, Жаңа – атауы қолжетімді опция болып табылатын веб-беттер үшін әдепкі болып табылады; ал ағымдағы кенеп бағдарламасы әрдайым басқа кенеп бағдарламасымен алмастырылады.

Ескертпе

Ендірілген сценарийлерде LaunchTarget функциясын Жаңа опциясынан басқа мәнмен пайдалануға (мысалы, Power BI немесе SharePoint) қолдау көрсетілмейді және күтпеген нәтиже беруі мүмкін. Болашақта бұл мінез-құлық өзгеруі немесе қате тудыруы мүмкін.

Param

Функция Param іске қосылған кезде қолданбаға берілетін параметрді қалпына келтіреді. Егер аталған параметр берілмесе, Paramбос мәнді қайтарады.

Кенеп бағдарламасын басқа кенеп бағдарламасынан іске қосқанда, функцияға Параметр аргументтерін Launch пайдаланыңыз. Параметр атаулары және мәндері автоматты түрде URL кодталады.
Кенеп бағдарламасын веб-беттен іске қосқанда, кенеп бағдарламасының веб-сілтемесіне сұрау жолын қосыңыз. &parametername=parametervalue үшін сұрау жолы бастылып қойылған болса, бұл үшін tenantId қосу керек. Мысалы, &First%20Name=Vicki&category=3 қосу екі параметрді өткізетін еді: First Name мәні бар "Vicki" және category мәні (мән түрі — "3") мәні бар . Бос орындарды немесе арнайы таңбаларды қамтыса, параметр атауы және мән URL кодталуы керек, мысалы, EncodeURL функциясын пайдалану арқылы.
Param Зат есімдер - зат есімдер.
Param Аттар мен мәндер бағдарламада пайдалану үшін URL мекенжайы автоматты түрде декодталады.
Параметр мәндері қолданба қайта жүктелмейінше өзгермейді. Қолданба іске қосылған мобильді құрылғыда пайдалану Launch параметрлерді жаңартпайды.
Егер параметрде сан болса да, қайтарылған Param түрі әрқашан мәтін жолы болады. Басқа түрлерге түрлендіру автоматты түрде орын алады немесе санға ашық түрде түрлендіру үшін Value функциясы сияқты ашық түрлендірулерді пайдаланыңыз.

Ескертпе

арнаулы беттер үшін бет қабылдайтын жалғыз параметрлер: recordId және entityName.

Синтаксис

Launch( Мекен-жайы [, ParameterName1, ParameterValue1, ... ] )

Мекенжай – Міндетті. Веб-беттің мекенжайы немесе іске қосатын бағдарламаның идентификаторы.
Параметр атаулары – Қосымша. Параметр атауы.
ПараметрМәндері – Қосымша. Бағдарламаға немесе веб-бетке өткізетін сәйкес параметр мәндері.

Launch( Мекен-жайы, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

Мекенжай – Міндетті. Веб-беттің мекенжайы немесе іске қосатын бағдарламаның идентификаторы.
Параметр атаулары – Қосымша. Параметр атауы.
ПараметрМәндері – Қосымша. Бағдарламаға немесе веб-бетке өткізетін сәйкес параметр мәндері.
LaunchTarget – Қосымша. LaunchTarget санамалау мәні немесе теңшелетін атау.

Param( Параметр атауы )

ПараметрАты - Міндетті. Бағдарламаға өткізілетін параметр атауы.

Сақталған параметрлер

Келесі кілт сөздер (жағдайға қарамастан) ішкі пайдалану үшін сақталады және () функциясында реттелетін параметр Param ретінде қолданылмауы керек:

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
күйін келтіру
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
нұсқау
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
тіл
орналасқан жер
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
сайт
skipappmetadata
skipiframecreation
skiplaunchappcache
бастапқы
бастапқы уақыт
standaloneconsent
teamid
teamtype
tenantId
режим
uselocalpackagehostresources
userteamrole

Мысалдар

Қарапайым Launch

Кенеп бағдарламасынан веб-бетке:

Формула	Сипаттамасы
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Веб-бетті ашады https://bing.com/search?q=Power%20Apps&count=1. Жаңа терезе немесе қойынша ашылады.
Launch( "http://bing.com/search", { q: "Power Apps", саны: 1 } )	Баламалы жазба нотациясын пайдаланатын алдыңғы мысалдармен бірдей. Жаңа терезе немесе қойынша ашылады.
Launch( "http://bing.com/search", { q: "Power Apps", саны: 1 }, LaunchTarget.Replace )	Алдыңғы мысалдармен бірдей, веб-шолғышта іске қосылса, ағымдағы терезені немесе қойыншаны нәтижемен ауыстырады.
Launch( "http://bing.com/search", { q: "Power Apps", саны: 1 }, "Іздеу нәтижелері" )	Алдыңғы мысалмен бірдей, Іздеу нәтижелері атты терезенің немесе қойыншаның мазмұнын жасайды немесе ауыстырады.

Кенеп бағдарламасынан кенеп бағдарламасына

Бағдарлама идентификаторын, экран атауын және жазба нөмірін тиісті болса жаңартыңыз.

Launch( "/providers/Microsoft.PowerApps/apps/YOUR-APP-ID",
        { Navigate: "Second Screen", Record: 34 }
)

Веб-беттен кенеп бағдарламасына

Бағдарлама идентификаторын, клиент идентификаторын, экран атауын және жазба нөмірін тиісті болса жаңартыңыз.

<html>
  <body>
    <a
      href="https://apps.powerapps.com/play/e/YOUR-APP-ENVIRONMENT-ID/a/YOUR-APP-ID?tenantId=YOUR-TENANT-ID&Navigate=Second%20Screen&Record=34"
    >
      Launch canvas app
    </a>
  </body>
</html>

Қарапайым Param

Кенеп бағдарламасын веб-беттен немесе басқа кенеп бағдарламасынан іске қосу үшін жоғарыдағы қарапайым іске қосу мысалдары функцияның Param қарапайым мысалдарын көрсетеді:

Формула	Сипаттамасы	Нәтиже
Param( «Навигация» )	Navigate параметрі бағдарлама іске қосылғанда және қайтарылғанда берілген.	"Екінші экран"
Param( «Жазба» )	Record параметрі бағдарлама іске қосылғанда берілген. Функцияға сан Launch ретінде берілгенімен, оның нәтижесі Param басқа түрлеріне жанама немесе ашық түрлендірілуі мүмкін мәтін жолы болады.	"34"
Param( «Пайдаланушы» )	User параметрі берілмеген. *IsBlank* функциясымен тексеруге болатын blank мәні қайтарылады.	бос

Қадамдық мысалдар мен LaunchParam

Келесі мысалдарда Өнімді көрсету планшет орналасу үлгісі пайдаланылған. Осы үлгімен бағдарлама жасау үшін бағдарлама жасау мақаласындағы қадамдарды орындаңыз және Өнімді көрсету үлгісін таңдаңыз. Сондай-ақ жеке бағдарламаңызды пайдалана аласыз.

Мысал - Launch

Power Apps өту.
Сол жақ навигация тақтасынан Бағдарламалар тармағын таңдаңыз.
Бағдарламаны таңдаңыз, содан кейін Өңдеу пәрменін таңдаңыз.
Мәзірден Кірістіру пәрменін таңдаңыз, содан кейін Белгі тармағын таңдаңыз.
Белгіні экранның төменгі оң жағына жылжытыңыз.
Оң жақтағы сипаттар тақтасынан Түс ретінде ақ ақ түсін таңдаңыз және Жиек қалыңдығы параметрін 1 мәніне орнатыңыз.
Оң жақтан Мәтін сипатын таңдаңыз және Жаңалықтардағы Surface планшеттері мәтінін енгізіңіз.
Жоғарғы сол жақтағы сипаттар тізімінен OnSelect сипатын таңдаңыз.
Формуланы Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets") түрінде енгізіңіз. Сондай-ақ өзіңіз таңдаған кез келген басқа URL мекенжайын, параметрді және кілтсөздерді пайдалана аласыз.

.�
Бағдарламаны сақтаңыз және жариялаңыз.
Бағдарламаны ойнатыңыз.
Microsoft Surface планшеттері деген кілтсөздері бар жаңалықтарды іздеуді іске қосу үшін Жаңалықтардағы Surface планшеттері белгісін таңдаңыз.

Шайпұл

Масштабтау үшін функцияда қолмен енгізілген кілт сөздерді Launchайнымалылармен алмастыра аласыз.

Мысал - Param

Power Apps өту.
Сол жақ навигация тақтасынан Бағдарламалар тармағын таңдаңыз.
Бағдарламаны таңдаңыз, содан кейін Өңдеу пәрменін таңдаңыз.
Мәзірден Кірістіру пәрменін таңдаңыз, содан кейін Белгі тармағын таңдаңыз.
Белгіні экранның төменгі оң жағына жылжытыңыз.
Жоғарғы сол жақтан белгі үшін Мәтін сипатын таңдаңыз.
Формуланы Param("browser") түрінде енгізіңіз. Сондай-ақ өзіңіз таңдаған басқа параметрді пайдалана аласыз.

.�
Бағдарламаны сақтаңыз және жариялаңыз.
Бағдарламаңыз үшін Power Apps ішінен веб-сілтемені көшіріңіз.
Жаңа шолғышты ашыңыз.
Бағдарлама веб-сілтемесін шолғышқа қойыңыз және соңында &browser=Microsoft%20Edge үстеңіз.
Бағдарлама іске қосылғанда, белгі өткізілген параметр мәнін көрсетеді.
Бағдарлама ойнатқышын жауып, бағдарламаны өңдеңіз.
Сол жақ навигациядағы тармақ көрінісінен Бағдарлама тармағын таңдаңыз.
Жоғарғы сол жақтағы StartScreen сипатты таңдаңыз.
Формула ретінде енгізіңіз If( Param("screen") = "techspecs", TechSpecs ).

Егер in StartScreen қасиеті параметрдің белгілі бір мәнге тең екендігін тексерсе, бұл жағдайда techspecs мәні. Және ол сәйкес келсе, TechSpecs экранды басқару элементін StartScreen сипатына қайтарады.

Ескертпе

TechSpecs басқару атауын Егер функциясында, егер сіз өз қолданбаңыздағы экран басқару элементінің атауымен ауыстырыңыз Өнім көрмесі қолданба үлгісін пайдаланбайсыз.
Бағдарламаны сақтаңыз және жариялаңыз.
Жаңа шолғышты ашыңыз.
Бағдарлама веб-сілтемесін шолғышқа қойыңыз және соңында &screen=techspecs үстеңіз.
Қолданба TechSpecs бастау экраны ретінде тікелей іске қосылады.

Келесіні де қараңыз:

Кенеп қолданбасының формула сілтемесі

Кері байланыс

Бет пайдалы болды ма?

Last updated on 2025-03-04

Бөлісу құралы:

Launch және Param функциялар

Launch

Мекенжай

Параметрлер

Межелі орын

Param

Синтаксис

Сақталған параметрлер

Мысалдар

Қарапайым Launch

Кенеп бағдарламасынан веб-бетке:

Кенеп бағдарламасынан кенеп бағдарламасына

Веб-беттен кенеп бағдарламасына

Қарапайым Param

Қадамдық мысалдар мен LaunchParam

Мысал - Launch

Мысал - Param

Келесіні де қараңыз:

Кері байланыс

Қосымша ресурстар