مشاركة عبر

pac canvas

العمل باستخدام ملفات .msapp في Power Apps

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

مهم

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

الاوامر

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

pac canvas create

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

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

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

الأمثلة

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

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

ينشئ هذا المثال تطبيق لوحة (كملف *.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 النشط حاليا.

ملاحظات

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

  • يجب أن يكون الموصل المخصص المشار إليه مع connector-display-name المعلمات أو connector-id جزءا من الحل.
  • بعد استيراد التطبيق إلى Studio، لن يكون هناك اقتران بالموصل المخصص. يجب أن يضيف صانع يدويا مرجعا إلى الموصل المخصص الذي تم إنشاء التطبيق منه قبل تشغيل التطبيق. راجع إضافة اتصالات البيانات إلى تطبيقات اللوحة للحصول على الخطوات. حتى يتم ذلك، قد ترى أخطاء الصيغة في التطبيق والتي سيتم حلها بمجرد إضافة مرجع الموصل. يجب أن يتطابق اسم الموصل المخصص الذي تضيفه إلى التطبيق مع اسم العرض للموصل المخصص المشار إليه في canvas create الأمر.
  • سيحتوي التطبيق على شاشة واحدة لكل POST إجراء والإجراء GET الذي يحدده الموصل.
    • الأفعال الأخرى المتوفرة في الموصلات المخصصة غير مدعومة.
  • يتم إنشاء عناصر التحكم المعروضة على شاشة كل إجراء ديناميكيا استنادا إلى كيفية تعريف أنواع الإدخال والإخراج لكل إجراء. أنواع معينة من الإدخال والإخراج المحددة في الموصل المخصص غير مدعومة من قبل canvas create. سينشئ الأمر تحذيرات في وحدة التحكم عند مواجهتها. حالات محددة:
    • صفائف الكائنات وصفائف الصفائف غير معتمدة كمدخلات
    • لا يتم إنشاء عناصر التحكم للكائنات أو الصفائف المتداخلة بعد عمق 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

مثال

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

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

--msapp

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

--sources

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

ملاحظات

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

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

pac canvas unpack

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

مثال

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

pac canvas unpack --msapp HelloWorld.msapp

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

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

--msapp

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

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

--sources

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

ملاحظات

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

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

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

هيكل المجلد

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

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

      إشعار

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

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

تنسيق الملف

تستخدم الملفات .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.js
  • بالنسبة لأي تعارضات في هذه الملفات، لا بأس من قبول أحدث إصدار:
    • تشغيل \checksum.js
  • إذا كانت هناك أي تعارضات في الدمج ضمن هذه المسارات، فلن يكون الدمج آمنا. واسمحوا لنا أن نعرف ما إذا كان هذا يحدث في كثير من الأحيان؛ سنعمل على إعادة هيكلة تنسيق الملف لتجنب التعارضات.
    • \اتصالات*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

مفتوح المصدر

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

pac canvas validate

(معاينة) التحقق من صحة مصدر .pa.yaml لملف msapp غير المضغوط

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

--directory -d

المسار إلى دليل msapp المستخرج الذي يحتوي على ملفات .pa.yaml للتحقق من صحة

راجع أيضًا

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

  • Last updated on