Launchودالات Param

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

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

Launch

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

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

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

‏‫ملاحظة

Launch إذا تم استخدام الصيغة لفتح Power Apps ولم يكن التطبيق مرئيا للمستخدم النهائي، فمن المستحسن التحقق مما إذا كان التطبيق محظورا بواسطة أداة حظر منبثقة في المستعرض أو إذا كان المستعرض ينتظر استجابة المستخدم لمربع حوار يسأل ما إذا كان يريد الانتقال إلى شاشة جديدة.
https فقط: يتم دعم URIs عند استخدام Launch في Power Apps Visual في PowerBI.

عنوان

يتم تشغيل صفحات ويب عبر عنوان 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. ستتم إضافة أي معلمات إضافية تم توفيرها Launch إلى نهاية سلسلة الاستعلام. لا تعمل سلاسل الاستعلام عند تشغيل تطبيق اللوحة.

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

استهداف

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

قائمة تعداد LaunchTarget	‏‏الوصف
جديد‎	يتم فتح صفحة الويب أو التطبيق في نافذة أو علامة تبويب جديدة.
استبدل	تحل صفحة الويب أو التطبيق محل النافذة أو علامة التبويب الحالية.
اسم	بدلا من قيمة قائمة تعداد، استخدم السلسلة النصية الخاصة بك لتسمية النافذة أو علامة التبويب. Self هو اسم داخلي فقط تستخدمه الدالة Launch فقط. لن يكون له تأثير على عنوان النافذة التي يشاهدها المستخدمون ولن يتطابق معها. في حالة وجود نافذه أو علامة تبويب بالاسم المحدد بالفعل، سيتم استبدال محتوياتها. خلاف ذلك، سيتم إنشاء نافذة أو علامة تبويب جديدة. لا يمكن أن يبدأ الاسم بحرف الشرطة السفلية "_".

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

‏‫ملاحظة

يعد استخدام LaunchTarget مع أي قيمة غير جديد في السيناريوهات المضمنة (على سبيل المثال، Power BI أو SharePoint) اغير مدعوم وقد يتسبب في حدوث سلوك غير متوقع. قد يتغير هذا السلوك مستقبلاً، أو قد يتسبب في حدوث خطأ.

Param

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

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

‏‫ملاحظة

وبالنسبة للصفحات المخصصة، فإن المعلمات الوحيدة التي قبلتها الصفحة هي: recordId و entityName.

بناء الجملة

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

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

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

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

Param( ParameterName )

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

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

يتم حجز الكلمات الأساسية التالية (بغض النظر عن الحالة) للاستخدام الداخلي، ولا يجب استخدامها كمعلمة مخصصة في الدالة 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

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

الصيغة	‏‏الوصف
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"، العدد: 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.	خلبي

أمثلة خطوة بخطوة ل Launch و Param

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

مثل- Launch

انتقل إلى Power Apps.
من جزء التنقل الأيسر، حدد التطبيقات.
حدد تطبيقك ثم حدد تحرير.
حدد إدراج من القائمة، ثم حدد Label.
انقل التسمية إلى أسفل يمين الشاشة.
من جزء الخصائص على الجانب الأيسر، حدد اللون على أنه أبيض وقم بتعيين سمك الحد عند 1.
حدد خاصية Text من الجانب الأيمن وأدخل نصًا كـ أجهزة كمبيوتر لوحية لسطح المكتب في الأخبار.
من قائمه الخصائص في الجزء الأيسر العلوي، حدد OnSelect.
أدخل صيغة كـ Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). يمكنك أيضًا استخدام أي عنوان URL ومعلمة وكلمات رئيسية أخرى من اختيارك.
احفظ التطبيق وانشره.
قم بتشغيل التطبيق.
حدد تسمية أجهزة الكمبيوتر اللوحية لسطح المكتب في الأخبار لإطلاق الأخبار باستخدام الكلمات الأساسية أجهزة الكمبيوتر اللوحية لسطح المكتب من Microsoft.

تلميح

لقابلية التوسع، يمكنك استبدال الكلمات الأساسية التي تم إدخالها يدويا في Launch الدالة بالمتغيرات.

مثل- Param

انتقل إلى Power Apps.
من جزء التنقل الأيسر، حدد التطبيقات.
حدد تطبيقك ثم حدد تحرير.
حدد إدراج من القائمة، ثم حدد Label.
انقل التسمية إلى أسفل يمين الشاشة.
حدد خاصية Text للتسمية من أعلى اليسار.
أدخل صيغة كـ Param("browser"). يمكنك أيضا استخدام معلمه مختلفه من اختيارك.
احفظ التطبيق وانشره.
انسخ ارتباط ويب للتطبيق الخاص بك من Power Apps.
افتح في مستعرض جديد.
قم بلصق "ارتباط ويب التطبيق" في المستعرض وقم بإلحاقه بـ &browser=Microsoft%20Edge في النهاية.
عند تشغيل تطبيقك، يعرض التصنيف قيمة المعلمة التي تم تمريرها.
اغلق عارض التطبيق وقم بتحرير التطبيق.
حدد التطبيقمن طريقه عرض الشجرة علي شريط التنقل الأيمن.
حدد خاصية StartScreen‎ في أعلى اليسار.
أدخل الصيغة كـ If( Param("screen") = "techspecs", TechSpecs ).

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

‏‫ملاحظة

استبدل اسم عنصر التحكم TechSpecs في اسم الدالة If باسم عنصر تحكم شاشة في تطبيقك في حال عدم استخدامك قالب تطبيق عرض المنتج.
احفظ التطبيق وانشره.
افتح في مستعرض جديد.
قم بلصق "ارتباط ويب التطبيق" في المستعرض وقم بإلحاقه بـ &screen=techspecs في النهاية.
يتم تشغيل التطبيق مباشرة مع TechSpecs على أنه startscreen.

(راجع أيضًا)

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

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2025-10-10

مشاركة عبر

Launchودالات Param

Launch

عنوان

المعلمات

استهداف

Param

بناء الجملة

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

الأمثلة

بسيط Launch

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

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

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

بسيط Param

أمثلة خطوة بخطوة ل Launch و Param

مثل- Launch

مثل- Param

(راجع أيضًا)

الملاحظات

الموارد الإضافية