استخدام FetchXML للاستعلام عن البيانات

مكتمل

FetchXML هي لغة استعلام طورتها Microsoft لتمكينك من إجراء عمليات استعلام معقدة ضد بيانات Microsoft Dataverse. فهو يوفر خيارات تصفية أكثر بكثير من موصلات OData ويسمح لك برؤية تسميات البيانات المرجعية، مثل تسميات مجموعة الخيارات أو حقول البحث.

يمكنك تشغيل استعلامات FetchXML باستخدام الطرق التالية:

• واجهة API للويب فِي Dataverse

• خدمة المؤسسة

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

مثال عن استعلام FetchXML

يسترد نموذج الاستعلام التالي حقول accountid وname من جدول الحساب:

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
   </entity>
</fetch>

إذا كنت بحاجة إلى تصفية هذه البيانات، على سبيل المثال حسب الولاية، فيمكنك القيام بشيء مثل نموذج الاستعلام التالي:

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
      <filter type='and'>
        <condition attribute='address1_stateorprovince' operator='eq' value='WA' />
      </filter>
   </entity>
</fetch>

أدوات للمساعدة فِي بناء استفساراتك

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

هناك أداة أخرى بارزة أنشأها المجتمع تسمى FetchXML Builder. باستخدام هذه الأداة، يمكنك إنشاء FetchXML بطرق لا يستطيع البحث المتقدم القيام بها (التجميعات والصلات الخارجية والاستعلامات "ليس لها" والسمات من الكيانات المرتبطة متعددة المستويات). كما يوفر أيضًا مجموعة كبيرة من الميزات الأخرى، والتي يمكنك العثور عليها على موقعه على الإنترنت: FetchXML Builder.

المزيد من الموارد

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