pac canvas

العمل مع ملفات .msapp في Power Apps.

[هذا المقال عبارة عن وثائق نسخة مسبقة وهو عرضة للتغيير.]

Important

• pack يتم إهمال الأمرين وunpack.
• للتحكم في المصدر في تطبيق اللوحة، استخدم Power Platform Git Integration.
• create يتوفر الأمر بشكل عام.

Commands

Command	Description
pac canvas create	إنشاء تطبيق لوحة من موصل مخصص
pac canvas download	تنزيل تطبيق اللوحة كملف .msapp
pac canvas list	سرد تطبيقات اللوحة
pac canvas pack	(معاينة) حزم المصادر في ملف msapp
pac canvas unpack	(معاينة) استخراج ملف msapp في المصادر

pac canvas create

إنشاء تطبيق لوحة من موصل مخصص

سيقوم هذا الأمر بإنشاء .msapp تطبيق لوحة بناء على تعريف OpenAPI لموصل مخصص موجود. سيحتوي التطبيق على شاشات وتخطيط عنصر تحكم ورمز Power Fx تم إنشاؤه استنادا إلى كيفية تعريف إجراءات الموصل المخصص، مع شكل وأسلوب معرفين مسبقا. يمكن استخدام التطبيق لممارسة الإجراءات المحددة في الموصل المخصص مباشرة.

يمكن للمصنعين استيراد ما تم .msapp إنشاؤه إلى Power Apps Studio لتشغيل التطبيق، أو لإجراء تعديلات وإجراء المزيد من التخصيصات. قم باستيراد التطبيق الذي تم إنشاؤه إلى Power Apps Studio بالانتقال إلى File>Open>Browse داخل Studio.

Examples

توضح الأمثلة التالية استخدام pac canvas create الأمر .

• إنشاء تطبيق لوحة استنادا إلى تعريف واجهة برمجة التطبيقات المفتوحة حسب اسم العرض
• إنشاء تطبيق لوحة استنادا إلى تعريف Open API حسب المعرف

إنشاء تطبيق لوحة استنادا إلى تعريف واجهة برمجة التطبيقات المفتوحة حسب اسم العرض

ينشئ هذا المثال تطبيق لوحة (كملف *.msapp) استنادا إلى تعريف Open API باستخدام اسم العرض للموصل.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

إنشاء تطبيق لوحة استنادا إلى تعريف Open API حسب المعرف

ينشئ هذا المثال تطبيق لوحة (كملف *.msapp) استنادا إلى تعريف Open API باستخدام معرف الموصل.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

إما connector-display-name أو connector-id مطلوبة.

المعلمات المطلوبة ل canvas create

--msapp

المسار إلى ملف .msapp الذي سيتم إنشاؤه

معلمات اختيارية ل canvas create

--connector-display-name

اسم العرض للموصل لإنشاء Power App منه.

--connector-id

معرف الموصل لإنشاء Power App منه.

--environment

معرف البيئة الهدف أو عنوان URL. القيمة الافتراضية هي بيئة ملف تعريف مصادقة Dataverse النشط حاليا.

Remarks

الاعتبارات والقيود:

• يجب أن يكون الموصل المخصص المشار إليه مع connector-display-name المعلمات أو connector-id جزءا من الحل.
• بعد استيراد التطبيق إلى Studio، لن يكون هناك اقتران بالموصل المخصص. يجب أن يضيف صانع يدويا مرجعا إلى الموصل المخصص الذي تم إنشاء التطبيق منه قبل تشغيل التطبيق. راجع إضافة اتصالات البيانات إلى تطبيقات اللوحة للحصول على الخطوات. حتى يتم ذلك، قد ترى أخطاء الصيغة في التطبيق والتي سيتم حلها بمجرد إضافة مرجع الموصل. يجب أن يتطابق اسم الموصل المخصص الذي تضيفه إلى التطبيق مع اسم العرض للموصل المخصص المشار إليه في canvas create الأمر.
• سيحتوي التطبيق على شاشة واحدة لكل POST إجراء والإجراء GET الذي يحدده الموصل.
  • الأفعال الأخرى المتوفرة في الموصلات المخصصة غير مدعومة.
• يتم إنشاء عناصر التحكم المعروضة على شاشة كل إجراء ديناميكيا استنادا إلى كيفية تعريف أنواع الإدخال والإخراج لكل إجراء. أنواع معينة من الإدخال والإخراج المحددة في الموصل المخصص غير مدعومة من قبل canvas create. سينشئ الأمر تحذيرات في وحدة التحكم عند مواجهتها. Specific cases:
  • صفائف الكائنات وصفائف الصفائف غير معتمدة كمدخلات
  • لا يتم إنشاء عناصر التحكم للكائنات أو الصفائف المتداخلة بعد عمق 20
  • أنواع "الملف" و"التنسيق الثنائي" غير معتمدة للإدخل أو الإخراج.

pac canvas download

تنزيل تطبيق اللوحة كملف .msapp

المعلمات المطلوبة ل canvas download

--name -n

تطبيق اللوحة بالضبط أو اسم جزئي أو معرف التطبيق

معلمات اختيارية ل canvas download

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--extract-to-directory -d

اسم الدليل لاستخراج تطبيق اللوحة إلى

--file-name -f

اسم الملف (عادة مع ملحق .msapp). إذا لم يتم توفير الملف، يتم حفظه في الدليل الحالي باستخدام 'appname'.msapp

--overwrite -o

السماح بالكتابة فوق الملف

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

pac canvas list

سرد تطبيقات اللوحة

معلمات اختيارية ل canvas list

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac canvas pack

(معاينة) حزم المصادر في ملف msapp

Example

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

المعلمات المطلوبة ل canvas pack

--sources

الدليل إلى المصادر المراد حزمها

معلمات اختيارية ل canvas pack

--disable-load-from-yaml

عند تحديده، يتم تعطيل تحميل التطبيق المعبأ من ملفات *.pa.yaml في مجلد 'Src'. مدعوم فقط بتخطيط 'SourceCode'.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--layout

التخطيط المستخدم في دليل المصادر. ملاحظة: التخطيط 'التجريبي' مهجور وسيتم إزالته في إصدار مستقبلي. استخدم تخطيط 'SourceCode' للحصول على أحدث تخطيط مدعوم.

استخدم إحدى هذه القيم:

• Experimental
• SourceCode

--msapp

المسار إلى ملف .msapp

--overwrite

السماح بالكتابة فوق الملف

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

Remarks

.msapp إنشاء ملف من ملفات المصدر التي تم فك حزمها مسبقا. يمكن فتح النتيجة في Power Apps Studio بالانتقال إلى File>Open>Browse.

بعد فك حزمها، يمكن تحرير الملفات المصدر وإدارتها باستخدام أدوات خارجية مثل تعليمة Visual Studio برمجية وGitHub.

pac canvas unpack

(معاينة) استخراج ملف msapp في المصادر

Example

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

فك حزم إلى الدليل الافتراضي HelloWorld_src .

المعلمات المطلوبة ل canvas unpack

--msapp

المسار إلى ملف .msapp

معلمات اختيارية ل canvas unpack

--layout

التخطيط المستخدم في دليل المصادر. ملاحظة: التخطيط 'التجريبي' مهجور وسيتم إزالته في إصدار مستقبلي. استخدم تخطيط 'SourceCode' للحصول على أحدث تخطيط مدعوم.

استخدم إحدى هذه القيم:

• Experimental
• SourceCode

--overwrite

السماح بالكتابة فوق الملف

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--sources

الدليل إلى المصادر المراد فك حزمها

Remarks

فك حزمة .msapp الملف المصدر.

قم بتنزيل .msapp الملف من Power Apps Studio عن طريق الانتقال إلى File>Save as>This computer.

إذا لم يتم تحديد معلمة المصادر ، يتم استخدام دليل بنفس اسم الملف وموقعه .msapp مع _src اللاحقة.

Folder structure

تستخدم خصائص فك الحزم والحزمة بنية المجلد التالية:

• \src - التحكم وملفات المكونات. يحتوي هذا على المصادر.
  • *.fx.yaml - الصيغ المستخرجة control.json من الملف.

    Note

    هذا هو المكان المناسب لتحرير الصيغ.

  • CanvasManifest.json - ملف بيان يحتوي على المعلومات الموجودة عادة في العنوان والخصائص و publishInfo.
  • *.json -- الملف الخام control.json .
  • \EditorState*.editorstate.json - معلومات مخزنة مؤقتا لاستخدام Power Apps Studio.
• \DataSources - جميع مصادر البيانات التي يستخدمها التطبيق.
• \Connections - مثيلات الاتصال المحفوظة مع التطبيق والمستخدمة عند إعادة التحميل إلى Power Apps Studio.
• \الأصول - مِلَفَات الوسَائط المضمِنة فِي التَطبِيق.
• \pkgs - نسخة تم تنزيلها من المراجع الخارجية، مثل القوالب وملفات تعريف واجهة برمجة التطبيقات ومكتبات المكونات. هذه مشابهة لمراجع NuGet/NPM.
• \other - جميع الملفات المتنوعة اللازمة لإعادة إنشاء .msapp.
  • entropy.json - يتم استخراج العناصر المتطايرة (مثل الطوابع الزمنية) إلى هذا الملف. يساعد هذا على تقليل الاختلافات صاخبة في الملفات الأخرى مع ضمان أنه لا يزال بإمكاننا الذهاب ذهابا وإيابا.
  • يحتفظ بملفات أخرى من msapp، مثل ما هو موجود في \references.

File format

تستخدم الملفات .fx.yaml مجموعة فرعية من YAML. على غرار Excel، يجب أن تبدأ جميع التعبيرات بعلامة =التساوي . مزيد من المعلومات: التدقيق النحوي لصيغة Power Fx YAML

دمج التغييرات مع Power Apps Studio

عند دمج التغييرات التي يتم إجراؤها في جلستي Power Apps Studio مختلفتين:

• تأكد من أن جميع أسماء عناصر التحكم فريدة. على سبيل المثال، يمكن أن يؤدي إدراج زر في جلستين مختلفتين إلى عنصري Button1 تحكم. نوصي بتسمية عناصر التحكم بعد إنشائها بوقت قصير. لا تقبل الأداة عنصري تحكم بنفس الاسم.
• بالنسبة لهذه الملفات، قم بدمجها كما تفعل عادة:
  • \src*.fx.yaml
• إذا كانت هناك تعارضات أو أخطاء، يمكنك حذف هذه الملفات:
  • \src\editorstate*.json - تحتوي هذه الملفات على معلومات اختيارية في Power Apps Studio.
  • \other\entropy.json
• بالنسبة لأي تعارضات في هذه الملفات، لا بأس من قبول أحدث إصدار:
  • \checksum.json
• إذا كانت هناك أي تعارضات في الدمج ضمن هذه المسارات، فلن يكون الدمج آمنا. واسمحوا لنا أن نعرف ما إذا كان هذا يحدث في كثير من الأحيان؛ سنعمل على إعادة هيكلة تنسيق الملف لتجنب التعارضات.
  • \Connections*
  • \DataSources*
  • \pkgs*
  • CanvasManifest.json

Open source

أوامر اللوحة في Microsoft Power Platform CLI مفتوحة المصدر. مناقشة التحسينات، وإثارة المشكلات، والوصول إلى التعليمات البرمجية من مستودع أدوات لغة Power Apps.

See also

Microsoft Power Platform مجموعات أوامر CLI
نظرة عامة على Microsoft Power Platform CLI