Launch және Param функциялары
Мыналарға қолданылады: Canvas қолданбалары
Веб-бет немесе кенеп бағдарламасын іске қосады және іске қосу параметрлеріне қатынасты қамтамасыз етеді.
Іске қосу
Веб-бет немесе кенеп бағдарламасын іске қосады. Функция мыналарды қолдайды:
- Мекенжай (міндетті), кенеп қолданбасының веб-бетінің URL мекенжайы.
- Параметрлер (қосымша), веб-бетке немесе кенеп қолданбасына өту үшін аталған мәндер. Кенеп бағдарламасында параметрлерді Param функциясы арқылы оқуға болады.
- Target (қосымша), веб-бетті немесе кенеп қолданбасын іске қосатын шолғыш қойындысы.
Іске қосу тек мінез-құлық формулаларында пайдалануға болады.
Ескертпе
Іске қосу формуласы Power Apps ашу үшін пайдаланылса және қолданба соңғы пайдаланушыға көрінбесе, қолданбаны шолғыштың қалқымалы терезе блокаторы бұғаттағанын немесе браузер күткенін тексеру ұсынылады. пайдаланушының жауап жаңа экранға өткісі келетінін сұрайтын диалогтық терезеге.
Мекенжай
Веб-беттер 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 аргументін қолдайтын жалғыз пішін.
Әрқайсысында EncodeUrl функциясы пайдаланылғандай белгілі бір әліпбилік-сандық емес таңбаларды %
таңбасымен және он алтылық санмен ауыстыру үшін өткізу алдында мекенжай мен параметрлер URL кодталады.
Веб-бетті іске қосқанда, URL мекенжайының соңында параметрлердің сұрау жолын қосуға болады. Launch функциясына берілген кез келген қосымша параметрлер сұрау жолының соңына қосылады. Кенеп бағдарламасын іске қосқанда сұрау жолдары жұмыс істемейді.
Қолданба әлдеқашан жұмыс істеп тұрған мобильді құрылғыда қолданбаны іске қосқан кезде параметрлер іске қосылған қолданбада жаңартылмайды. Параметрлерді жаңарту үшін қолданбаны қайта жүктеу қажет.
Межелі орын
Веб-бетті немесе бағдарламаны ашатын мақсатты шолғыш терезесін көрсету үшін LaunchTarget аргументін пайдаланыңыз. Келесі LaunchTarget санамалау мәндерінің біреуін пайдаланыңыз немесе теңшелетін терезе атауын беріңіз.
LaunchTarget enum | Сипаттамасы |
---|---|
Жаңа | Веб-бет немесе бағдарлама жаңа терезеде немесе қойыншада ашылады. |
Ауыстыру | Веб-бет немесе бағдарлама ағымдағы терезені немесе қойыншаны ауыстырады. |
аты | Санамалау мәнінің орнына терезеге немесе қойыншаға атау беру үшін жеке мәтін жолын пайдаланыңыз. Self — тек Launch функциясы пайдаланатын ішкі атау. Ол пайдаланушыларыңыз көретін терезенің атауына әсер етпейді немесе онымен бірдей болмайды. Осындай атауы бар терезе немесе қойынша бұрыннан бар болса, оның мазмұны ауыстырылады. Әйтпесе, жаңа терезе немесе қойынша жасалады. name астын сызу "_" таңбасымен басталуы мүмкін емес. |
Жаңа бұл Replace және аты бар веб-шолғышта іске қосылған кездегі әдепкі нөмір. қолжетімді опциялар ретінде. Мобильді ойнатқышта, Жаңа – атауы қолжетімді опция болып табылатын веб-беттер үшін әдепкі болып табылады; ал ағымдағы кенеп бағдарламасы әрдайым басқа кенеп бағдарламасымен алмастырылады.
Ескертпе
- Ендірілген сценарийлерде LaunchTarget функциясын Жаңа опциясынан басқа мәнмен пайдалануға (мысалы, Power BI немесе SharePoint) қолдау көрсетілмейді және күтпеген нәтиже беруі мүмкін. Болашақта бұл мінез-құлық өзгеруі немесе қате тудыруы мүмкін.
Param
Param функциясы іске қосылғанда бағдарламаға өткізілген параметрді шығарып алады. Аталған параметр өткізілмеген болса, Param функциясы blank мәнін қайтарады.
- Кенеп бағдарламасын басқа кенеп бағдарламасынан қосқанда, Launch функциясында Parameter аргументтерін пайдаланыңыз. Параметр атаулары және мәндері автоматты түрде URL кодталады.
- Кенеп бағдарламасын веб-беттен іске қосқанда, кенеп бағдарламасының веб-сілтемесіне сұрау жолын қосыңыз.
tenantId
үшін сұрау жолы бастылып қойылған болса, бұл үшін¶metername=parametervalue
қосу керек. Мысалы,&First%20Name=Vicki&category=3
қосу екі параметрді өткізетін еді:"Vicki"
мәні барFirst Name
және"3"
мәні (мән түрі — мәтін) мәні барcategory
. Бос орындарды немесе арнайы таңбаларды қамтыса, параметр атауы және мән URL кодталуы керек, мысалы, EncodeURL функциясын пайдалану арқылы. - Параметр атауларында регистр ескеріледі.
- Параметр атаулары және мәндері бағдарламада пайдалану үшін автоматты түрде URL кодсыздандырылады.
- Параметр мәндері қолданба қайта жүктелмейінше өзгермейді. Қолданба әлдеқашан жұмыс істеп тұрған мобильді құрылғыда Іске қосу пайдалану параметрлерді жаңартпайды.
- Тіпті параметр санды қамтыса да, Param қайтаратын түр әрқашан мәтін жолы болады. Басқа түрлерге түрлендіру автоматты түрде орын алады немесе санға ашық түрде түрлендіру үшін Value функциясы сияқты ашық түрлендірулерді пайдаланыңыз.
Ескертпе
арнаулы беттер үшін бет қабылдайтын жалғыз параметрлер: recordId және entityName.
Синтаксис
Іске қосу( Мекенжай [, ParameterName1, ParameterValue1 , ... ] )
- Мекенжай – Міндетті. Веб-беттің мекенжайы немесе іске қосатын бағдарламаның идентификаторы.
- Параметр атаулары – Қосымша. Параметр атауы.
- ПараметрМәндері – Қосымша. Бағдарламаға немесе веб-бетке өткізетін сәйкес параметр мәндері.
Іске қосу( Мекенжай, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )
- Мекенжай – Міндетті. Веб-беттің мекенжайы немесе іске қосатын бағдарламаның идентификаторы.
- Параметр атаулары – Қосымша. Параметр атауы.
- ПараметрМәндері – Қосымша. Бағдарламаға немесе веб-бетке өткізетін сәйкес параметр мәндері.
- LaunchTarget – Қосымша. LaunchTarget санамалау мәні немесе теңшелетін атау.
Парам( Параметр атауы )
- ПараметрАты - Міндетті. Бағдарламаға өткізілетін параметр атауы.
Сақталған параметрлер
Келесі кілтсөздер ішкі пайдалану үшін сақталған (жағдайға қарамастан) және Param() функциясында реттелетін параметр ретінде пайдаланылмауы керек:
- amp%3Bauthmode
- amp%3Benableonbehalfof
- amp%3Bhidenavbar
- amp%3Blocale
- appmetadataversion
- authmode
- channeltype
- cordovapath
- correlationid
- debug
- delegatelaunchurl
- delegatelaunchurl
- disablepreviewredirect
- embedderorigin
- enableonbehalfof
- groupid
- hideappsplash
- hidenavbar
- hint
- hostclienttype
- hostmode
- iframecontainerid
- isfullscreen
- ispreviewmode
- loader
- loaderType
- тіл
- орын
- packagekind
- packageproperties
- playerresourcespath
- playersessionid
- powerappslanguage
- screencolor
- sdkversion
- торап
- skipappmetadata
- skipiframecreation
- skiplaunchappcache
- ресурс
- бастапқы уақыт
- standaloneconsent
- teamid
- teamtype
- tenantId
- тақырып
- uselocalpackagehostresources
- userteamrole
Мысалдар
Оңай іске қосу
Кенеп бағдарламасынан веб-бетке:
Формула | Сипаттама |
---|---|
Іске қосу( "http://bing.com/search", "q", "Power Apps", "count", 1 ) |
Веб-бетті ашады https://bing.com/search?q=Power%20Apps&count=1. Жаңа терезе немесе қойынша ашылады. |
Іске қосу("http://bing.com/search", { q: "Power Apps", count: 1 } ) |
Баламалы жазба нотациясын пайдаланатын алдыңғы мысалдармен бірдей. Жаңа терезе немесе қойынша ашылады. |
Іске қосу("http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace ) |
Алдыңғы мысалдармен бірдей, веб-шолғышта іске қосылса, ағымдағы терезені немесе қойыншаны нәтижемен ауыстырады. |
Іске қосу( "http://bing.com/search", { q: "Power Apps", count: 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 функциясының қарапайым мысалдары көрсетілген:
Формула | Сипаттама | Нәтиже |
---|---|---|
Парам («Шарлау») | Navigate параметрі бағдарлама іске қосылғанда және қайтарылғанда берілген. | "Екінші экран" |
Парам («Жазба») | Record параметрі бағдарлама іске қосылғанда берілген. Тіпті ол Launch функциясына сан ретінде өткізілгенмен, Param беретін нәтиже басқа түрлерге жанама түрде немесе ашық түрде түрлендіруге болатын мәтін жолы болады. | "34" |
Парам («Пайдаланушы») | User параметрі берілмеген. IsBlank функциясымен тексеруге болатын blank мәні қайтарылады. | бос |
Launch және Param функцияларының қадамдық мысалдары
Келесі мысалдарда Өнімді көрсету планшет орналасу үлгісі пайдаланылған. Осы үлгімен бағдарлама жасау үшін бағдарлама жасау мақаласындағы қадамдарды орындаңыз және Өнімді көрсету үлгісін таңдаңыз. Сондай-ақ жеке бағдарламаңызды пайдалана аласыз.
Мысал - Launch
Power Apps өту.
Сол жақ навигация тақтасынан Бағдарламалар тармағын таңдаңыз.
Бағдарламаны таңдаңыз, содан кейін Өңдеу пәрменін таңдаңыз.
Мәзірден Кірістіру пәрменін таңдаңыз, содан кейін Белгі тармағын таңдаңыз.
Белгіні экранның төменгі оң жағына жылжытыңыз.
Оң жақтағы сипаттар тақтасынан Түс ретінде ақ ақ түсін таңдаңыз және Жиек қалыңдығы параметрін 1 мәніне орнатыңыз.
Оң жақтан Мәтін сипатын таңдаңыз және Жаңалықтардағы Surface планшеттері мәтінін енгізіңіз.
Жоғарғы сол жақтағы сипаттар тізімінен OnSelect сипатын таңдаңыз.
Формуланы
Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets")
түрінде енгізіңіз. Сондай-ақ өзіңіз таңдаған кез келген басқа URL мекенжайын, параметрді және кілтсөздерді пайдалана аласыз.Бағдарламаны сақтаңыз және жариялаңыз.
Бағдарламаны ойнатыңыз.
Кілт сөздермен жаңалықтар іздеуді бастау үшін Жаңалықтардағы беткі планшеттер Microsoft белгісін таңдаңыз.
Шайпұл
Масштабтау мүмкіндігі үшін қолмен Launch функциясындағы енгізілетін кілтсөздерді айнымалылармен ауыстыруға болады.
Мысал - Param
Power Apps өту.
Сол жақ навигация тақтасынан Бағдарламалар тармағын таңдаңыз.
Бағдарламаны таңдаңыз, содан кейін Өңдеу пәрменін таңдаңыз.
Мәзірден Кірістіру пәрменін таңдаңыз, содан кейін Белгі тармағын таңдаңыз.
Белгіні экранның төменгі оң жағына жылжытыңыз.
Жоғарғы сол жақтан белгі үшін Мәтін сипатын таңдаңыз.
Формуланы
Param("browser")
түрінде енгізіңіз. Сондай-ақ өзіңіз таңдаған басқа параметрді пайдалана аласыз.Бағдарламаны сақтаңыз және жариялаңыз.
Бағдарламаңыз үшін Power Apps ішінен веб-сілтемені көшіріңіз.
Жаңа шолғышты ашыңыз.
Бағдарлама веб-сілтемесін шолғышқа қойыңыз және соңында
&browser=Microsoft%20Edge
үстеңіз.Бағдарлама іске қосылғанда, белгі өткізілген параметр мәнін көрсетеді.
Бағдарлама ойнатқышын жауып, бағдарламаны өңдеңіз.
Сол жақ навигациядағы тармақ көрінісінен Бағдарлама тармағын таңдаңыз.
Жоғарғы сол жақтағы StartScreen сипатты таңдаңыз.
Формула ретінде енгізіңіз
If( Param("screen") = "techspecs", TechSpecs )
.Егер in StartScreen сипаты параметрдің белгілі бір мәнге тең екендігін тексерсе, бұл жағдайда techspecs мәні. Және ол сәйкес келсе, TechSpecs экранды басқару элементін StartScreen сипатына қайтарады.
Ескертпе
TechSpecs басқару атауын If функциясында, егер сіз өз қолданбаңыздағы экранды басқару элементінің атауымен ауыстырыңыз Өнім көрмесі қолданба үлгісін пайдаланбайсыз.
Бағдарламаны сақтаңыз және жариялаңыз.
Жаңа шолғышты ашыңыз.
Бағдарлама веб-сілтемесін шолғышқа қойыңыз және соңында
&screen=techspecs
үстеңіз.Қолданба TechSpecs бастау экраны ретінде тікелей іске қосылады.