Launch ve Param işlevleri

Şunlar için geçerlidir: Tuval uygulamaları

Bir Web sayfasını veya bir tuval uygulamasını başlatır ve başlatma parametrelerine erişim sağlar.

Launch

Bir Web sayfası veya bir tuval uygulaması başlatır. İşlev aşağıdakileri destekler:

• Adres (gerekli), web sayfasının URL'si veya Tuval uygulamasının Uygulama URI'sı (/providers/Microsoft.PowerApps/apps/ önekiyle uygulama kimliği).
• Parametreler (isteğe bağlı); web sayfasına veya tuval uygulamasına geçirilecek adlandırılmış değerler. Tuval uygulamasında, parametreler Param işleviyle okunabilir.
• Hedef (isteğe bağlı); web sayfasının veya tuval uygulamasının açılacağı tarayıcı sekmesi.

Launch yalnızca davranış formüllerinde kullanılabilir.

Adres

Web sayfaları bir URL adresi aracılığıyla başlatılır. Örneğin:

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

Tuval uygulamalarını Web bağlantısı veya Uygulama URI'sı (/providers/Microsoft.PowerApps/apps/ önekiyle uygulama kimliği) ile başlatabilirsiniz. Bir uygulamanın bu değerlerini bulmak için:

1. Şuraya git: Power Apps.

2. Sol gezinti bölmesinde, Uygulamalar'ı seçin.

3. Uygulamanızı seçin.

4. Üst menüden Ayrıntılar'ı seçin.
   Ayrıca ... (Daha Fazla Komut) seçeneğini kullanabilir ve ardından açılan menüden Ayrıntılar'ı seçebilirsiniz.

   

5. Web bağlantısını veya Uygulama Kimliğini kopyalayın.

   

Web bağlantısı, herhangi bir web sayfasında kullanılabilir ve tuval uygulamasını başlatacaktır. Ayrıca, Launch ile kullanılabilir.

Uygulama Kimliği, Launch işleviyle birlikte kullanılabilir ancak önek olarak /providers/Microsoft.PowerApps/apps/ eklenmelidir. Örneğin:

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

Cihazdaki yerel uygulamalar doğrudan başlatılamaz. Özel bir URL düzeni yükleyen veya belirli web siteleri için bir seçenek sunmak üzere web tarayıcısıyla kayıt yapan yerel uygulama gibi bazı platformlarda kullanılabilen dolaylı seçenekler olabilir.

Parametreler

Launch, parametreleri web sayfasına veya tuval uygulamasına geçirebilir. Parametreler iki şekilde sağlanabilir:

• Ad değer çiftleri için bir bağımsız değişken listesi. Örneğin:

  Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
  

• Alan değerlerinin kaydı. Örneğin:

  Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
  

  Ad ve değer arasındaki ilişkilendirmeyi daha anlaşılır hale getirdiğinden bu formla çalışmak daha kolay olabilir. Bu, isteğe bağlı LaunchTarget bağımsız değişkenini destekleyen tek formdur.

Adres ve parametreler, alfa sayısal olmayan bazı karakterleri % ve her birinde EncodeUrl işlevi kullanılmış gibi onaltılık bir sayı ile değiştirmek üzere geçirilmeden önce URL ile kodlanır.

Bir web sayfası başlatıldığında, URL adresinin sonuna parametrelerin sorgu dizesi eklenebilir. Launch için sağlanan ek parametreler, sorgu dizesinin sonuna eklenecektir. Sorgu dizeleri bir tuval uygulaması başlatılırken çalışmaz.

O uygulamanın zaten çalıştığı bir mobil cihazda uygulama başlatılırken, çalışan uygulamada parametreler yenilenmez. Parametrelerin yenilenmesi için uygulamanın yeniden yüklemesi gerekir.

Hedef

Web sayfasının veya uygulamanın açılacağı hedef tarayıcı penceresini belirtmek için LaunchTarget bağımsız değişkenini kullanın. Aşağıdaki LaunchTarget sabit liste değerlerinden birini kullanın veya özel bir pencere adı sağlayın.

Kullanılabilir seçeneklerin Replace ve name olduğu bir web tarayıcısında çalıştırırken New varsayılan sabit liste değeridir. Mobil oynatıcıda, kullanılabilir seçeneğin ad olduğu web sayfaları için Yeni varsayılandır. Mevcut tuval uygulaması her zaman başka bir tuval uygulamasıyla değiştirilir.

Param

Param işlevi, uygulama başlatıldığında uygulamaya geçirilen bir parametreyi alır. Adlandırılmış parametre geçirilmediyse Param, boş değer döndürür.

• Bir tuval uygulamasını başka bir tuval uygulamasından başlatırken, Launch işlevine Parameter bağımsız değişkenlerini kullanın. Parametre adları ve değerleri otomatik olarak URL olarak kodlanır.
• Bir tuval uygulamasını bir web sayfasından başlatırken, tuval uygulaması web bağlantısınınsorgu dizesine parametreler ekleyin. Bu, tenantId için sorgu dizesinin zaten başlatılmış olduğu varsayılarak &parametername=parametervalue eklemeyi içerir. Örneğin, &First%20Name=Vicki&category=3 eklemek iki parametre geçirir: "Vicki" değeriyle First Name ve "3" değeriyle category (değer türü metin'dir). Parametre adı ve değer, EncodeURL işlevini kullanmaya benzer şekilde, boşluk veya özel karakterler içeriyorsa URL kodlamalı olmalıdır.
• Parametre büyük ve küçük harf duyarlıdır.
• Parametre adları ve değerlerinin, uygulamanızda kullanılmak üzere, otomatik olarak URL kodu çözülür.
• Uygulama yeniden yüklenmeden parametre değerleri değişmez. Uygulamanın zaten çalıştığı bir mobil cihazda Başlat'ın kullanılması parametreleri yenilemez.
• Parametre bir sayı içerse bile Param tarafından döndürülen tür her zaman bir metin dizesi olur. Diğer türlere dönüştürme işlemi otomatik olarak gerçekleşir veya açık şekilde bir sayıya dönüştürmek için Value işlevi gibi açık dönüşümleri kullanır.

Sözdizimi

Launch( Adres [, ParametreAdı1, ParametreDeğeri1, ... ] )

• Adres: Gerekli. Bir web sayfasının adresi veya başlatılacak bir uygulamanın kimliği.
• ParameterName(s) – İsteğe bağlı. Parametre adı.
• ParameterValue(s) – İsteğe bağlı. Uygulamaya veya web sayfasına geçirilecek ilgili parametre değerleri.

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

• Adres: Gerekli. Bir web sayfasının adresi veya başlatılacak bir uygulamanın kimliği.
• ParameterName(s) – İsteğe bağlı. Parametre adı.
• ParameterValue(s) – İsteğe bağlı. Uygulamaya veya web sayfasına geçirilecek ilgili parametre değerleri.
• LaunchTarget – İsteğe bağlı. LaunchTarget sabit liste değeri veya özel ad.

Param( ParametreAdı )

• ParameterName - Gerekli. Uygulamaya geçirilen parametrenin adı.

Ayrılmış parametreler

Aşağıdaki anahtar sözcükler dahili kullanım için ayrılmıştır (vakadan bağımsız) ve Param() işlevinde özel parametre olarak kullanılmamalıdır:

• amp%3Bauthmode
• amp%3Benableonbehalfof
• amp%3Bhidenavbar
• amp%3Blocale
• appmetadataversion
• authmode
• channeltype
• cordovapath
• correlationid
• hata ayıkla
• delegatelaunchurl
• delegatelaunchurl
• disablepreviewredirect
• embedderorigin
• enableonbehalfof
• groupid
• hideappsplash
• hidenavbar
• hint
• hostclienttype
• hostmode
• iframecontainerid
• isfullscreen
• ispreviewmode
• yükleyici
• loaderType
• locale
• konum
• packagekind
• packageproperties
• playerresourcespath
• playersessionid
• powerappslanguage
• screencolor
• sdkversion
• site
• skipappmetadata
• skipiframecreation
• skiplaunchappcache
• kaynak
• sourcetime
• standaloneconsent
• teamid
• teamtype
• tenantId
• tema
• uselocalpackagehostresources
• userteamrole

Örnekler

Basit Launch

Tuval uygulamasından web sayfasına:

Tuval uygulamasından tuval uygulamasına

Uygulama kimliğini, ekran adını ve kayıt numarasını uygun şekilde güncelleştirin.

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

Web sayfasından tuval uygulamasına

Uygulama kimliğini, kiracı kimliğini, ekran adını ve kayıt numarasını uygun şekilde güncelleştirin.

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

Basit Param

Tuval uygulamasını web sayfasından veya başka bir tuval uygulamasından başlatmaya yönelik yukarıdaki basit başlatma örnekleri Param işlevinin basit örneklerini gösterir:

Launch ve Param için adım adım örnekler

Aşağıdaki örnekler için Ürün Tanıtımı tablet düzeni şablonu kullanılmıştır. Bu şablonla bir uygulama oluşturmak için uygulama oluşturma makalesindeki adımları izleyin ve Ürün Tanıtımı şablonunu seçin. Kendi uygulamanızı da kullanabilirsiniz.

Örnek - Launch

1. Şuraya git: Power Apps.

2. Sol gezinti bölmesinde, Uygulamalar'ı seçin.

3. Uygulamanızı ve daha sonra Düzenle'yi seçin.

4. Menüden Ekle'yi seçin ve ardından Etiket'i seçin.

5. Etiketi ekranın sağ alt tarafına taşıyın.

6. Sağ taraftaki özellikler bölmesinden, Renk olarak beyaz seçeneğini belirleyin ve Kenarlık kalınlığını1 olarak ayarlayın.

7. Sağ taraftan Text özelliğini seçin ve metni Haberlerde Surface tabletler olarak girin.

8. Sol üstteki özellik listesinden, OnSelect'i seçin.

9. Formülü şu şekilde girin: Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Ayrıca, istediğiniz herhangi bir URL'yi, parametreyi veya anahtar sözcüğü de kullanabilirsiniz.

   

10. Uygulamayı kaydedin ve yayımlayın.

11. Uygulamayı yürütün.

12. Microsoft Surface tabletler anahtar sözcükleriyle haber araması başlatmak için Haberlerde Surface tabletler etiketini seçin.

Örnek - Param

1. Şuraya git: Power Apps.

2. Sol gezinti bölmesinde, Uygulamalar'ı seçin.

3. Uygulamanızı ve daha sonra Düzenle'yi seçin.

4. Menüden Ekle'yi seçin ve ardından Etiket'i seçin.

5. Etiketi ekranın sağ alt tarafına taşıyın.

6. Etiket için sol üstten Text özelliğini seçin.

7. Formülü şu şekilde girin: Param("browser"). Ayrıca, seçtiğiniz farklı bir parametreyi de kullanabilirsiniz.

   

8. Uygulamayı kaydedin ve yayımlayın.

9. Uygulamanız için web bağlantısınıPower Apps'ten kopyalayabilirsiniz.

10. Yeni bir tarayıcı açın.

11. Uygulama web bağlantısını tarayıcıya yapıştırın ve sonuna &browser=Microsoft%20Edge ekleyin.

    

12. Uygulamanız başladığında, etiket geçirilen parametre değerini gösterir.

    

13. Uygulama yürütücüsünü kapatın ve uygulamayı düzenleyin.

14. Sol gezintideki Ağaç görünümünden bir Uygulama seçin.

15. Sol üstteki StartScreen özelliğini seçin.

16. Formülü şu şekilde girin: If( Param("screen") = "techspecs", TechSpecs ).

    

    StartScreen özelliğindeki If işlevi, parametrenin belirli bir değere (bu durumda techspecs) eşit olup olmadığını denetler. Eşleşiyorsa TechSpecs screen denetimini StartScreen özelliğine döndürür.

    Not

    Ürün Gösterimi uygulama şablonunu kullanmıyorsanız If işlevindeki TechSpecs denetim adını kendi uygulamanızdaki screen denetimi adıyla değiştirin.

17. Uygulamayı kaydedin ve yayımlayın.

18. Yeni bir tarayıcı açın.

19. Uygulama web bağlantısını tarayıcıya yapıştırın ve sonuna &screen=techspecs ekleyin.

    

20. Uygulama doğrudan StartScreen'de TechSpecs ile başlatılır.

Ayrıca bkz.

Tuval uygulaması formül başvurusu