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

أولاً: يبدو أنك عرّفت SchoolOrderingFilter باسم الحقل o :

o = SchoolOrderingFilter(...)

لذلك عندما تقول:

الطلب الذي أقوم بتقديمه يبدو هكذا
{{API_URL}}/api/v1/schools/?offset=5&limit=3&ordering=learner_enrolled_count

أتوقع أن يكون معامل سلسلة الاستعلام o أيضًا. هل هذا يعمل: {{API_URL}}/api/v1/schools/?offset=5&limit=3&o=learner_enrolled_count ؟

ثم (الشيء الذي لست متأكدًا منه في تقريرك) أنت تقوله - حقل محسوب - ماذا تقصد بالضبط؟ أي هل هو حقل يظهر في النموذج ، أم أنها إحدى خصائص Python؟

هناك طريقة أخرى للسؤال (جزء من) ألا وهي هل يعمل order_by() في مجموعة طلبات البحث مع هذا الحقل؟ أي هل هذا العمل:

SchoolModel.objects.filter(...).order_by(learner_enrolled_count)

carltongibson هذا مثير جدا للاهتمام! لم أكن أتوقع o ليكون تعريف ordering المعلمة! لم أفهم ذلك من الوثائق 😂

استخدام المعلمة o

الشيء المثير للاهتمام هو استخدام الاستعلام
{{API_URL}}/api/v1/schools/?offset=5&limit=3&o=learner_enrolled_count

أحصل على هذه النتائج:

{
    "schools": [
        {
            "id": 6,
            "name": "Piano Gym Six",
            "courses": [
                # ...
            ],
            "learner_enrolled_count": 0
        },
        {
            "id": 8,
            "name": "Piano Gym Eight",
            "courses": [
                # ...
            ],
            "learner_enrolled_count": 0
        },
        {
            "id": 9,
            "name": "Piano Gym Nine",
            "courses": [
                # ...
            ],
            "learner_enrolled_count": 0
        }
    ]
}

الجزء المثير للاهتمام حول هذا الأمر ، الآن هو أن المدرسة الوحيدة التي أريد ترتيبها في الأعلى ليست في نتيجة البحث هذه. مما يعني أنه من المحتمل أن يكون هذا الأمر قد تم طلبه ولكن ترقيم الصفحات يوازن النتائج. ومع ذلك ، عندما استخدمت learner_enrolled_count فإنها في آخر مكان.
{{API_URL}}/api/v1/schools/?limit=3&o=learner_enrolled_count

لذلك استخدمت اختباره باستخدام -learner_enrolled_count (إزالة الإزاحة والفرز تنازليًا)
{{API_URL}}/api/v1/schools/?limit=3&o=-learner_enrolled_count
وحصلت على هذا الرد

{
    "schools": [
        {
            "id": 7,
            "name": "Piano Gym Seven",
            "courses": [
                # ...
            ],
            "learner_enrolled_count": 1
        },
        {
            "id": 1,
            "name": "Piano Gym",
            "courses": [
                # ...
            ],
            "learner_enrolled_count": 0
        },
        {
            "id": 2,
            "name": "Piano Gym Two",
            "courses": [
                # ...
            ],
            "learner_enrolled_count": 0
        }
    ]
}

يبدو أنها عملت!

المجال المحسوب

learner_enrolled_count غير موجود في النموذج نفسه. لقد استخدمت تعليقًا توضيحيًا لحساب هذا وحقنه في النتائج.

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

لا بد لي من تحسين نقطة النهاية هذه باستخدام نموذج استرجاع مثل هذا:

class SchoolModelManager(Manager):
    def getBrowseSchoolsData(self, *args, **kwargs):
        """Return all Schools that contain lessons with flash card sets.

        Does not exclude empty sets, just requires that the school has something
        to enroll in
        """
        # WARNING: This MUST be imported here otherwise the compilation fails
        #          because of circular dependencies
        from piano_gym_api.versions.v1.models.flash_card_model import FlashCardModel
        # from piano_gym_api.versions.v1.models.flash_card_model import PlaySheetMusicFlashCardModel
        # from piano_gym_api.versions.v1.models.flash_card_model import TrueOrFalseFlashCardModel
        # from piano_gym_api.versions.v1.models.flash_card_set_model import FlashCardSetModel
        from piano_gym_api.versions.v1.models.sheet_music_model import SheetMusicModel
        # import pdb
        # pdb.set_trace()

        # --------------------
        sheet_music_query_set = (SheetMusicModel.objects.all()
                                 .select_related("school"))
        play_sheet_music_flash_card_sheet_music_prefetch = Prefetch("playsheetmusicflashcardmodel__sheet_music",
                                                                    sheet_music_query_set)
        # --------------------
        flash_card_query_set = (FlashCardModel.objects.all()
                                .select_related("flash_card_set",
                                                "playsheetmusicflashcardmodel",
                                                "school",
                                                "trueorfalseflashcardmodel")
                                .prefetch_related(play_sheet_music_flash_card_sheet_music_prefetch))
        flash_card_prefetch = Prefetch("flash_card_set__flash_card", flash_card_query_set)
        # --------------------
        school_lesson_query_set = (SchoolLessonModel.objects.all()
                                   .select_related("course",
                                                   "flash_card_set",
                                                   "school")
                                   .prefetch_related(flash_card_prefetch))
        school_lesson_prefetch = Prefetch("school_lesson", school_lesson_query_set)
        # --------------------
        school_course_query_set = (SchoolCourseModel.objects.all()
                                   .select_related("school")
                                   .prefetch_related(school_lesson_prefetch))
        school_course_prefetch = Prefetch("school_course", school_course_query_set)
        # --------------------
        query_set_to_return = (SchoolModel.objects.filter(school_lesson__flash_card_set__isnull=False)
                               .distinct()
                               # .annotate(learner_enrolled_count=Count("learner_enrolled_school", distinct=True))
                               .annotate(learner_enrolled_count=Case(
                                   When(learner_enrolled_school__learner_enrolled_course__learner_enrolled_lesson__is_enrolled=True,
                                        then=1),
                                   default=0,
                                   output_field=IntegerField())
        ).prefetch_related(school_course_prefetch))

        return query_set_to_return

calculated field bit موجود في المتغير query_set_to_return . ما يفعله هو نقل count من إجمالي المتعلمين المسجلين و annotates إلى الحقل learner_enrolled_count . ليس لدي أي فكرة عما إذا كانت هذه هي الطريقة الصحيحة لتحقيق ذلك ، ولكن يبدو أنها تعمل 😂

اقتراح

أحد الاقتراحات التي أود تقديمها هو التوضيح في الوثائق ، إما باستخدام أمثلة url الفعلية للطلبات أو نص بسيط وشرح أن o في الأمثلة هو ما يتم عرضه كمعامل للطلب.

استنتاج

يبدو أنه يعمل بشكل صحيح الآن بعد أن أوضحت أن المعلمة o هي ما يتم تعيين عامل تصفية الطلب له!

إذا كان querysets الذي أقدمه لـ filter يحتوي بالفعل على حقل مشروح به - يبدو ، من الاختبار ، أنني لست ملزمًا بعمل مخصصي OrderingFilter .

لهذا السبب أعتقد أنه يمكنني استخدام OrderingFilter بسيطًا بدلاً من ذلك!

أرجوا أن تصحح لي إذا كنت مخطئا!

أعتقد أن هذا يحل حيرتي! شكرا لك!

مرحبًاloganknecht. رائع ، يبدو أنك قد نجحت في ذلك. 💃

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

سأقوم بتعديل المستندات.

شكرا لمساهمتك.

carltongibson والجميع ، شكرًا على المكتبة الرائعة!