إضافة فلتر لزمن التعديل باستخدام AlexaCRM وديناميكس API

2 دقائق

في عالم البرمجة وتطوير التطبيقات، قد نحتاج في بعض الأحيان إلى تصفية البيانات المسترجعة من قواعد البيانات بحسب وقت تعديلها. هذا الأمر يعد مهمًا للعديد من التطبيقات، خاصةً تلك التي تحتاج إلى التعامل مع بيانات متجددية مثل السجلات الخاصة بالعملاء أو الوثائق. في هذا المقال، سنستعرض كيفية استخدام حزمة AlexaCRM/dynamics-webapi-toolkit لتحقيق ذلك من خلال إضافة فلتر إلى تاريخ التعديل "modifiedon".

جدول المحتوى

تقديم حزمة AlexaCRM/dynamics-webapi-toolkit

حزمة AlexaCRM/dynamics-webapi-toolkit تعتبر من الأدوات المفيدة للمطورين الذين يعملون مع منصة Dynamics CRM. هذه الحزمة تمنح المطورين إمكانية التفاعل مع بيانات CRM بطرق مرنة وسلسة. ومن بين الخصائص التي نحتاج إليها في التطبيقات التجارية هي القدرة على استرجاع السجلات التي تم تعديلها في فترة زمنية محددة، وهو ما سوف نتركز عليه في هذا المقال.

إضافة فلتر لتاريخ التعديل “modifiedon”

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

$pagingInfo = new \AlexaCRM\Xrm\Query\PagingInfo();
$pagingInfo->Count = 10;
$client = ClientFactory::createOnlineClient(
    'https://some-microsoft-crm.com',
    'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
    'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
);
$query = new QueryByAttribute('contact');
$query->ColumnSet = new \AlexaCRM\Xrm\ColumnSet(columnSet(true));
$query->PageInfo = $pagingInfo;
$result = $client->RetrieveMultiple($query);

الحاجة هنا هي إضافة فلتر يرتكز على تاريخ التعديل "modifiedon". إذا كنت تريد فقط السجلات التي تم تعديلها في الأيام الأخيرة، فستحتاج إلى حساب التاريخ المناسب. الصيغة التي يتم استخدامها لتاريخ "modifiedon" هي الشكل القياسي ISO 8601 مثل "2025-07-22T10:57:01Z".

كيفية إضافة فلتر الزمان

لتطبيق الفلتر بنجاح، يجب استخدام دالة AddAttributeValue بالشكل الصحيح. إذا نظرنا إلى الكود الموجود، سنجد أن هناك خللًا شائعًا يحدث عند محاولة تطبيق الفلتر. الخطوة الأساسية هي التأكد من أن صيغة الفلتر تتبع القواعد الصحيحة الخاصة بالطلب. على سبيل المثال:

$query->AddAttributeValue("modifiedon", 'ge ' . $twoDaysAgoDateTimeFormat);

نلاحظ أن هذا المتغير $twoDaysAgoDateTimeFormat يجب أن يحتوي على قيمة التاريخ بتنسيق مناسب. إذا كان الفلتر يفشل، فالسبب قد يعود إلى تنسيق التاريخ أو طريقة بناء الاستعلام.

هناك أيضًا طريقة أخرى قد تستخدمها وهي كالتالي:

$query->AddAttributeValue("modifiedon ge", $twoDaysAgoDateTimeFormat);

إلا أن هذا الأسلوب غير صحيح كذلك. الطريق الأمثل هو التأكد من عدم إضافة الكلمات المفتاحية (ge) داخل اسم السمة نفسها بل ينبغي تركها كجزء من القاعدة في استعلام الفلتر.

التأكد من خروج البيانات المطلوبة

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

استنتاج

عند العمل مع حزمة AlexaCRM/dynamics-webapi-toolkit، يعد استخدام وصفات الفلترة لتواريخ التعديل "modifiedon" جزءًا أساسيًا من البرمجة، مما يساعد على تحقيق دقة أكبر في معالجة البيانات. باستخدام التقنيات الصحيحة، يمكنك استرجاع السجلات الأكثر دلالة لمستخدمينك أو لنفسك بشكل فعال.

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