السابق

التالي

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

مكتمل

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

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

• عنوان API Dataverse للويب

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

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

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

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

<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>  

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

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

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

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

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

متابعة