Share via

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

  • Мақала

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

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

Іске қосу

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

  • Мекенжай (міндетті), веб-беттің URL мекенжайы немесе кенеп қолданбасының қолданба URI (қолданба идентификаторы /providers/Microsoft.PowerApps/apps/ префиксі).
  • Параметрлер (міндетті емес), веб-бетке немесе кенеп бағдарламасына өткізетін аталған мәндер. Кенеп бағдарламасында параметрлерді Param функциясы арқылы оқуға болады.
  • Мақсат (міндетті емес), веб-бет немесе кенеп бағдарламасы іске қосылатын шолғыш қойыншасы.

Launch функциясын тек мінез-құлық формулаларында пайдалануға болады.

Мекенжай

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

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

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

  1. Power Apps өту.

  2. Сол жақ навигация тақтасынан Бағдарламалар тармағын таңдаңыз.

  3. Бағдарламаны таңдаңыз.

  4. Жоғарғы мәзірден Мәліметтер тармағын таңдаңыз.
    Сондай-ақ ... (Қосымша пәрмендер) тармағын таңдауға, содан кейін ашымалы мәзірден Мәліметтер тармағын таңдауға болады.

    Қолданба мәліметтері опциясы.

  5. Веб-сілтемені немесе бағдарлама идентификаторын көшіріңіз.

    Веб сілтемесі және қолданба идентификаторы бар қолданба мәліметтері.

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

Бағдарлама идентификаторынLaunch функциясы арқылы пайдалануға болады, бірақ алдына /providers/Microsoft.PowerApps/apps/ префиксін қою керек. Мысалы:

Launch( "/providers/Microsoft.PowerApps/apps/f342faaf-5f82-4ace-a64b-7c1b01499231" )

Құрылғыдағы нативтік бағдарламаларды тікелей іске қосу мүмкін емес. Кейбір платформаларда тікелей емес опциялар қолжетімді болуы мүмкін: мысалы, теңшелетін 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 Сипаттамасы
New Веб-бет немесе бағдарлама жаңа терезеде немесе қойыншада ашылады.
Replace Веб-бет немесе бағдарлама ағымдағы терезені немесе қойыншаны ауыстырады.
аты Санамалау мәнінің орнына терезеге немесе қойыншаға атау беру үшін жеке мәтін жолын пайдаланыңыз. Self — тек Launch функциясы пайдаланатын ішкі атау. Ол пайдаланушыларыңыз көретін терезенің атауына әсер етпейді немесе онымен бірдей болмайды. Осындай атауы бар терезе немесе қойынша бұрыннан бар болса, оның мазмұны ауыстырылады. Әйтпесе, жаңа терезе немесе қойынша жасалады. name "_" астын сызу таңбасымен басталмауы керек.

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

Ескертпе

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

Param

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

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

Ескертпе

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

Синтаксис

Launch( Address [, ParameterName1, ParameterValue1, ... ] )

  • Address – Міндетті. Веб-беттің мекенжайы немесе іске қосатын бағдарламаның идентификаторы.
  • ParameterName(s) – Міндетті емес. Параметр атауы.
  • ParameterValue(s) – Міндетті емес. Бағдарламаға немесе веб-бетке өткізетін сәйкес параметр мәндері.

Launch( Address, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

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

Param( ParameterName )

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

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

Келесі кілтсөздер ішкі пайдалану үшін сақталған (жағдайға қарамастан) және 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

Мысалдар

Оңай іске қосу

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

Формула Сипаттама
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", count: 1 } )		 Баламалы жазба нотациясын пайдаланатын алдыңғы мысалдармен бірдей. Жаңа терезе немесе қойынша ашылады.
Launch( "http://bing.com/search",
{ q: "Power Apps", count: 1 },
LaunchTarget.Replace )		 Алдыңғы мысалдармен бірдей, веб-шолғышта іске қосылса, ағымдағы терезені немесе қойыншаны нәтижемен ауыстырады.
Launch( "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 функциясының қарапайым мысалдары көрсетілген:

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

Launch және Param функцияларының қадамдық мысалдары

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

Мысал - Launch

  1. Power Apps өту.

  2. Сол жақ навигация тақтасынан Бағдарламалар тармағын таңдаңыз.

  3. Бағдарламаны таңдаңыз, содан кейін Өңдеу пәрменін таңдаңыз.

  4. Мәзірден Кірістіру пәрменін таңдаңыз, содан кейін Белгі тармағын таңдаңыз.

  5. Белгіні экранның төменгі оң жағына жылжытыңыз.

  6. Оң жақтағы сипаттар тақтасынан Түс ретінде ақ ақ түсін таңдаңыз және Жиек қалыңдығы параметрін 1 мәніне орнатыңыз.

  7. Оң жақтан Мәтін сипатын таңдаңыз және Жаңалықтардағы Surface планшеттері мәтінін енгізіңіз.

  8. Жоғарғы сол жақтағы сипаттар тізімінен OnSelect сипатын таңдаңыз.

  9. Формуланы Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets") түрінде енгізіңіз. Сондай-ақ өзіңіз таңдаған кез келген басқа URL мекенжайын, параметрді және кілтсөздерді пайдалана аласыз.

    Іске қосу мысалы.

  10. Бағдарламаны сақтаңыз және жариялаңыз.

  11. Бағдарламаны ойнатыңыз.

  12. Microsoft Surface планшеттері деген кілтсөздері бар жаңалықтарды іздеуді іске қосу үшін Жаңалықтардағы Surface планшеттері белгісін таңдаңыз.

Шайпұл

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

Мысал - Param

  1. Power Apps өту.

  2. Сол жақ навигация тақтасынан Бағдарламалар тармағын таңдаңыз.

  3. Бағдарламаны таңдаңыз, содан кейін Өңдеу пәрменін таңдаңыз.

  4. Мәзірден Кірістіру пәрменін таңдаңыз, содан кейін Белгі тармағын таңдаңыз.

  5. Белгіні экранның төменгі оң жағына жылжытыңыз.

  6. Жоғарғы сол жақтан белгі үшін Мәтін сипатын таңдаңыз.

  7. Формуланы Param("browser") түрінде енгізіңіз. Сондай-ақ өзіңіз таңдаған басқа параметрді пайдалана аласыз.

    Парам үлгісі.

  8. Бағдарламаны сақтаңыз және жариялаңыз.

  9. Бағдарламаңыз үшін Power Apps ішінен веб-сілтемені көшіріңіз.

  10. Жаңа шолғышты ашыңыз.

  11. Бағдарлама веб-сілтемесін шолғышқа қойыңыз және соңында &browser=Microsoft%20Edge үстеңіз.

    Веб мекенжайы.

  12. Бағдарлама іске қосылғанда, белгі өткізілген параметр мәнін көрсетеді.

    Парам үлгісінің белгісі.

  13. Бағдарлама ойнатқышын жауып, бағдарламаны өңдеңіз.

  14. Сол жақ навигациядағы тармақ көрінісінен Бағдарлама тармағын таңдаңыз.

  15. Жоғарғы сол жақтағы StartScreen сипатты таңдаңыз.

  16. Формуланы If( Param("screen") = "techspecs", TechSpecs ) ретінде енгізіңіз.

    Шарлау үшін параметр үлгісі.

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

    Ескертпе

    TechSpecs басқару атауын If функциясында, егер сіз өз қолданбаңыздағы экранды басқару элементінің атауымен ауыстырыңыз Өнім көрмесі қолданба үлгісін пайдаланбайсыз.

  17. Бағдарламаны сақтаңыз және жариялаңыз.

  18. Жаңа шолғышты ашыңыз.

  19. Бағдарлама веб-сілтемесін шолғышқа қойыңыз және соңында &screen=techspecs үстеңіз.

    TechSpecs экранының веб мекенжайы.

  20. Қолданба TechSpecs бастау экраны ретінде тікелей іске қосылады.

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

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