الدالتان Launch وParam

ينطبق على: تطبيقات اللوحة

يقوم بتشغيل صفحة ويب أو تطبيق كانفاس ويوفر الوصول إلى معلمات الإطلاق.

تشغيل

إطلاق صفحة ويب أو تطبيق لوحة. تدعم الوظيفة:

• العنوان (مطلوب)، عنوان URL لصفحة الويب الخاصة بتطبيق اللوحة.
• المعلمات (اختيارية)، القيم المسماة لتمريرها إلى صفحة الويب أو تطبيق اللوحة. في تطبيق اللوحة، يمكن قراءة المعلمات باستخدام وظيفة Param.
• target (اختياري)، علامة تبويب المستعرض التي يتم فيها تشغيل صفحة الويب أو تطبيق اللوحة.

لا يمكن استخدام الإطلاق إلا في صيغ السلوك.

عنوان

يتم تشغيل صفحات ويب عبر عنوان URL. على سبيل المثال:

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

يمكنك تشغيل تطبيقات اللوحة باستخدام ارتباط ويب أو URI‎ التطبيق (معرف التطبيق الذي يتضمن البادئة /providers/Microsoft.PowerApps/apps/). للعثور على هذه القيم لتطبيق:

1. انتقل إلى Power Apps.

2. من جزء التنقل الأيسر، حدد التطبيقات.

3. حدد تطبيقك.

4. حدد التفاصيل من القائمة العليا.
   يُمكنك أيضًا تحديد ... (أوامر إضافية) ثم حدد التفاصيل من القائمة المنسدلة.

   

5. انسخ ارتباط الويب.

   

يمكن استخدام ارتباط الويب في أي صفحة ويب وسيقوم بتشغيل تطبيق اللوحة. كما يمكن استخدامها مع Launch. على سبيل المثال:

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

لا يمكن تشغيل التطبيقات الأصلية على الجهاز مباشرة. قد تكون هناك خيارات غير مباشرة متاحة في بعض الأنظمة الأساسية، مثل تطبيق أصلي يقوم بتثبيت مخطط URL مخصص أو التسجيل باستخدام متصفح الويب لتقديم خيار لمواقع ويب معينة.

المعلمات

يمكن أن يمرر التشغيل المعلمات إلى صفحة الويب أو تطبيق اللوحة. يمكن توفير المعلمات بطريقتين:

• قائمة وسيطات لأزواج قيمة الاسم. على سبيل المثال:

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

• سجل قيم الحقول. على سبيل المثال:

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

  يمكن أن يكون هذا النموذج أسهل للعمل معه لأنه يجعل الارتباط بين الاسم والقيمة أكثر وضوحًا. يعتبر هذا هو النموذج الوحيد الذي يدعم وسيطة LaunchTarget الاختيارية.

يتم ترميز العنوان والمعلمات قبل تمريره لاستبدال بعض الأحرف غير الأبجدية الرقمية بـ % ورقم ست عشري كما لو تم استخدا وظيفة EncodeUrl في كل منها.

عند بدء تشغيل صفحة ويب، يمكن تضمين سلسلة استعلام من المعلمات في نهاية عنوان URL. ستتم أضافه إيه معلمات اضافيه يتم توفيرها لوظيفة Launch إلى نهاية سلسله الاستعلام. لا تعمل سلاسل الاستعلام عند تشغيل تطبيق اللوحة.

عند تشغيل تطبيق على جهاز محمول حيث يتم تشغيل هذا التطبيق بالفعل، لن يتم تحديث المعلمات في التطبيق قيد التشغيل. يلزم إعادة تحميل التطبيق لتحديث المعلمات.

استهداف

استخدم وسيطة LaunchTarget لتحديد نافذه المستعرض الهدف التي سيتم فتح صفحه الويب أو التطبيق فيها. استخدم إحدى قيم تعداد LaunchTarget التالية أو توفير النافذة المخصصة الاسم.

الجديد هو التعداد الافتراضي عند التشغيل في مستعرض ويب مع الاستبدال والاسم كخيارات متاحة. في مشغل محمول، يعتبر الخيار جديد الخيار الافتراضي لصفحات الويب التي تتضمن الاسم كخيار متوفر، في حين سيتم استبدال تطبيق اللوحة الحالي دائمًا بتطبيق لوحة آخر.

Param

تسترد وظيفة Param معلمة تم تمريرها إلى التطبيق عند إطلاقه. إذا لم يتم تمرير المعلمة المسماة، فإن وظيفة Param تقوم بإرجاع فارغ.

• عند تشغيل تطبيق اللوحة من تطبيق لوحة آخر، استخدم وسيطات المعلمة لوظيفة Launch. سيتم ترميز أسماء المعلمات وقيمها تلقائيًا بعنوان URL.
• عند تشغيل تطبيق لوحة من صفحه ويب، أضف معلمات إلى سلسلة الاستعلام الخاصة بارتباط ويب تطبيق اللوحة. ويتضمن هذا إضافة &parametername=parametervalue بافتراض أنه قد تم بدء سلسلة الاستعلام بالفعل لـ tenantId. على سبيل المثال، قد تؤدي إضافة &First%20Name=Vicki&category=3 تمرير معلمتين: First Name مع قيمة "Vicki" وcategory مع قيمة "3" (نوع القيمة هو نص). يجب أن يكون ترميز اسم المعلمة وقيمتها إذا كانت تحتوي على مسافات أو أحرف خاصة، على غرار استخدام وظيفة EncodeURL.
• أسماء المعلمات حساسة لحالة الأحرف.
• سيتم تلقائيًا ترميز أسماء وقيم Param لاستخدامها في تطبيقك.
• لا تتغير قيم المعلمات ما لم يُعاد تحميل التطبيق. لا يؤدي استخدام تشغيل على جهاز محمول حيث يعمل التطبيق بالفعل إلى تحديث المعلمات.
• حتى إذا كانت المعلمة تحتوي علي رقم، سيكون النوع الذي تم إرجاعه بواسطة Param هو سلسلة نصية دائمًا. سيحدث التحويل إلى أنواع أخرى تلقائيًا أو يستخدم تحويلات صريحة مثل وظيفة Value للتحويل صراحةً إلى رقم.

بناء الجملة

Launch ( العنوان [، ParameterName1 ، ParameterValue1 ، ... ] )

• العنوان - مطلوب. عنوان صفحه ويب أو معرف تطبيق لتشغيله.
• ParameterNames - اختياري. اسم المعلمة.
• ParameterValues - اختياري. قيم المعلمة المقابلة لتمريرها إلى التطبيق أو صفحه الويب.

Launch ( العنوان ، { [ ParameterName1: ParameterValue1 ، ... ] } [، LaunchTarget ] )

• العنوان - مطلوب. عنوان صفحه ويب أو معرف تطبيق لتشغيله.
• ParameterNames - اختياري. اسم المعلمة.
• ParameterValues - اختياري. قيم المعلمة المقابلة لتمريرها إلى التطبيق أو صفحه الويب.
• LaunchTarget - اختياري. قيمة تعداد LaunchTarget أو اسم مخصص.

Param( اسم المعلمة)

• اسم المعلمة - مطلوب. تم تمرير اسم المعلمة إلى التطبيق.

المعلمات المحجوزة

يتم حجز الكلمات الأساسية التالية للاستخدام الداخلي (بصرف النظر عن الحالة)، ولا ينبغي استخدامها كمعلمة مخصصة في وظيفة Param():

• amp%3Bauthmode
• amp%3Benableonbehalfof
• amp%3Bhidenavbar
• amp%3Blocale
• appmetadataversion
• authmode
• channeltype
• cordovapath
• correlationid
• debug
• 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
• المصدر
• sourcetime
• standaloneconsent
• teamid
• teamtype
• tenantId
• النسق
• uselocalpackagehostresources
• userteamrole

الأمثلة

التشغيل البسيط

من تطبيق لوحة إلى صفحة ويب:

من تطبيق لوحة إلى تطبيق لوحة

قم بتحديث معرف التطبيق واسم الشاشة ورقم السجل حسب الاقتضاء.

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:

أمثله خطوه بخطوه لـ Launch وParam

تم استخدام قالب تخطيط كمبيوتر لوحي عرض المنتج للأمثلة التالية. لإنشاء تطبيق باستخدام هذا القالب، اتبع الخطوات من مقالة إنشاء تطبيق وحدد قالب عرض المنتج. كما يمكنك استخدام التطبيق الخاص بك.

مثال - تشغيل

1. انتقل إلى Power Apps.

2. من جزء التنقل الأيسر، حدد التطبيقات.

3. حدد تطبيقك ثم حدد تحرير.

4. حدد إدراج من القائمة، ثم حدد Label.

5. انقل التسمية إلى أسفل يمين الشاشة.

6. من جزء الخصائص على الجانب الأيسر، حدد اللون على أنه أبيض وقم بتعيين سمك الحد عند 1.

7. حدد خاصية Text من الجانب الأيمن وأدخل نصًا كـ أجهزة كمبيوتر لوحية لسطح المكتب في الأخبار.

8. من قائمه الخصائص في الجزء الأيسر العلوي، حدد OnSelect.

9. أدخل صيغة كـ Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). يمكنك أيضًا استخدام أي عنوان URL ومعلمة وكلمات رئيسية أخرى من اختيارك.

   

10. احفظ التطبيق وانشره.

11. قم بتشغيل التطبيق.

12. حدد تسمية أجهزة الكمبيوتر اللوحية لسطح المكتب في الأخبار لإطلاق الأخبار باستخدام الكلمات الأساسية أجهزة الكمبيوتر اللوحية لسطح المكتب من Microsoft.

مثال - Param

1. انتقل إلى Power Apps.

2. من جزء التنقل الأيسر، حدد التطبيقات.

3. حدد تطبيقك ثم حدد تحرير.

4. حدد إدراج من القائمة، ثم حدد Label.

5. انقل التسمية إلى أسفل يمين الشاشة.

6. حدد خاصية Text للتسمية من أعلى اليسار.

7. أدخل صيغة كـ Param("browser"). يمكنك أيضا استخدام معلمه مختلفه من اختيارك.

   

8. احفظ التطبيق وانشره.

9. انسخ ارتباط ويب للتطبيق الخاص بك من Power Apps.

10. افتح في مستعرض جديد.

11. قم بلصق "ارتباط ويب التطبيق" في المستعرض وقم بإلحاقه بـ &browser=Microsoft%20Edge في النهاية.

    

12. عند تشغيل تطبيقك، يعرض التصنيف قيمة المعلمة التي تم تمريرها.

    

13. اغلق عارض التطبيق وقم بتحرير التطبيق.

14. حدد التطبيقمن طريقه عرض الشجرة علي شريط التنقل الأيمن.

15. حدد خاصية StartScreen‎ في أعلى اليسار.

16. أدخل الصيغة كـ If( Param("screen") = "techspecs", TechSpecs ).

    

    إذا كانت الدالة في خاصية StartScreen تتحقق مما إذا كانت المعلمة تساوي قيمة معينة، في هذه الحالة تكون القيمة techspecs. وعند التطابق، تُرسل عنصر تحكم الشاشة TechSpecs إلى الخاصية StartScreen.

    ‏‫ملاحظة‬

    استبدل اسم عنصر التحكم TechSpecs في اسم الدالة If باسم عنصر تحكم شاشة في تطبيقك في حال عدم استخدامك قالب تطبيق عرض المنتج.

17. احفظ التطبيق وانشره.

18. افتح في مستعرض جديد.

19. قم بلصق "ارتباط ويب التطبيق" في المستعرض وقم بإلحاقه بـ &screen=techspecs في النهاية.

    

20. يتم تشغيل التطبيق مباشرة مع TechSpecs على أنه startscreen.

(راجع أيضًا)

مرجع صيغة تطبيق اللوحة