استعلامات القوائم المُصفاة

يمكنك تصفية نتائج استعلامك. في الأمثلة التالية، لدينا جدول يسمى students، والذي يحتوي على حقول وعلاقات مثل createdAt و firstName و email و age.

استخدام الفلاتر في الاستعلامات

استعلم عن قائمة السجلات التي تمت تصفيتها. لاحظ معامل الفلتر.

الطلب

query MyQuery1 {
  students(
    filter: {
      createdAt: {
        gt: "2025-12-01T13:00:00.000Z"
      },
      email: {
        contains: "williams"
      }
    }
  ) {
    items {
      id
      createdAt
      firstName
      email
    }
  }
}

الاستجابة

{
  "data": {
    "students": {
      "items": [
        {
          "id": "97fb89ac-e0ad-44f5-b671-24a1b751287c",
          "createdAt": "2025-12-02T05:03:17.180675Z",
          "firstName": "John",
          "email": "john.williams@example.com"
        },
        {
          "id": "e25c4955-7ea7-4a83-a3de-d4c7427cc9fa",
          "createdAt": "2025-12-04T14:18:15.955194Z",
          "firstName": "Robert",
          "email": "robert.williams@example.com"
        }
      ]
    }
  }
}

الفلاتر الشرطية

تستخدم الفلاتر الشرطية مفاتيح AND و OR.

استخدام AND

عند تحديد AND، يجب أن تُرجع جميع كائنات الفلتر قيمة صواب (truthy).

الطلب

query MyQuery1 {
  students(
    filter: {
      AND: {
        email: {
          contains: "johnson"
        },
        isActive: {
          not_equals: false
        }
      }
      }
  ) {
    items {
      id
      createdAt
      firstName
      email
      isActive
    }
  }
}

الاستجابة

{
  "data": {
    "students": {
      "items": [
        {
          "id": "13fcb5bf-a8a4-4e55-860f-74f425944ec0",
          "createdAt": "2025-12-04T20:30:58.586321Z",
          "firstName": "Mary",
          "email": "mary.johnson@example.com",
          "isActive": true
        }
      ]
    }
  }
}

استخدام OR

عند تحديد OR، يجب أن يُرجع كائن فلتر واحد على الأقل قيمة صواب (truthy).

الطلب

query MyQuery1 {
  students(
    filter: {
      OR: {
        firstName: {
          equals: "Mary"
        },
        lastName: {
          equals: "Williams"
        }
      }
    }
  ) {
    items {
      id
      createdAt
      firstName
      email
      isActive
    }
  }
}