مشاركة عبر


Trace دالة

ينطبق على: تطبيقات Canvas الخاصة بتطبيقات Copilot Studio المستندة إلى نموذج وظائف Power Platform CLI Dataverse

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

عند استخدامه في Power Apps، يظهر الإخراج من Trace في أداة Power Apps Monitor مع أنشطة التطبيق الأخرى. إذا سمحت لتطبيقك بإرسال بيانات تتبع الاستخدام إلى Azure Application Insights، يمكن أيضا استخدام الدالة Trace لإرسال معلومات إلى مورد Application Insights. Trace يمكن استخدام فقط في صيغ السلوك.

عند استخدامه مع Test Studio، Trace هو تعبير اختياري يمكن استخدامه لتوفير معلومات إضافية في نتائج الاختبار من حدث OnTestCaseComplete . Trace يتم دمج رسائل الحدث مع رسائل التأكيد التي تم تمريرها وفشلها في جدول Traces لسجل TestCaseResult . يحتوي جدول التتبعات على خاصيتين، Message وTimestamp. Trace سيتم أيضا تسجيل المعلومات المستخدمة في الاختبارات في Application Insights. لن تكون معلومات تتبع الاختبار متاحة في أداة المراقب نظرًا لتوصيل أداة المراقب بالتطبيق عند تشغيلها من Power Apps Studio.

بناء الجملة

Trace( رسالة [, TraceSeverity [, CustomRecord [, TraceOptions ] ] )

  • رسالة - مطلوب. المعلومات المطلوب تتبعها. يمكن إلزام الأرقام والتواريخ والقيم المنطقية وأي نوع بيانات آخر بالنص..
  • خطورة التتبع - اختياري. مستوى خطورة المسجلة Trace في Monitor وApplication Insights. الخيارات هي TraceSeverity.Information (افتراضي) أو TraceSeverity.Warning أو TraceSeverity.Error أو TraceSeverity.Critical.
  • سجل مخصص- اختياري. سجل يحتوي على بيانات مخصصة سيتم تسجيلها في أداة المراقب أو Application Insights.
  • خيارات التتبع - اختياري. الخيارات هي TraceOptions.None (افتراضي) وTraceOptions.IgnoreUnsupportedTypes التي ستتجاهل أنواع البيانات في CustomRecord التي لا يمكن إجراء تسلسل لها.

مثال

  1. أنشئ عنصر تحكم الزر في Power Apps Studio
  2. قم بتعيين الإجراء OnSelect إلى الصيغة التالية:
Set( x, x+1 );
Trace( x );
  1. افتح أداة المراقب في Power Apps في نافذة مستعرض أخرى عن طريق تحديد أيقونة "أدوات متقدمة" في الجزء الأيمن ثم تحديد "فتح المراقب": نقطة إدخال لأداة المراقب في Power Apps
  2. عد إلى نافذة مستعرض الاستوديو الأصلية وحدد الزر أربع مرات. استخدم Alt-click على الماوس إذا كنت في وضع التصميم.
  3. عرض أداة المراقب في Power Apps.
  4. ستحتوي شبكة Monitor على حدث لكل نقرة زر ولكل Trace استدعاء، والتي ستعرض قيمة المتغير بعد كل زيادة. انتقل إلى Trace حدث لمعرفة مكان Trace بدء، والتعبير المستخدم للرسالة، في اللوحة اليمنى: مراقبة التتبع الذي يظهر الزر الذي يتم الضغط عليه أربع مرات والزيادات المقابلة للمتغير

راجع أيضًا:

Power Apps نظرة عامة على الشاشة
Test Studio نظرة عامة
العمل مع Test Studio