أجزاء تعريف الحقل الوصفي
تحدد تعريفات الحقول الوصفية الجزء الذي ينطبق عليه الحقل الوصفي من متجرك والقيم التي يمكن أن يحتوي عليها. تأكد من فهمك لأجزاء تعريف الحقل الوصفي قبل القيام بالمهام التالية:
تتكون تعريفات الحقول الوصفية من الأجزاء التالية:
- الاسم: يُستخدم لتحديد الحقل الوصفي في مسؤول Shopify، مثل
اللون. - مساحة الاسم والمفتاح: المعرّف الفريد للحقل الوصفي الخاص بك. يمكنك استخدام مساحة اسم لتجميع الحقول الوصفية المتشابهة معًا، ولكن يجب أن تكون كل مساحة اسم ومفتاح فريدين. مثال على ذلك هو
custom.color. - الوصف (اختياري): يتيح لك تضمين معلومات وصفية، مثل القيم التي يجب إدخالها للحقل الوصفي.
- النوع: نوع البيانات التي يخزنها الحقل الوصفي. يمكنك تحديد نوع من قائمة الفئات والإعدادات المسبقة القابلة للبحث، مثل نص، أو ملف، أو عنوان URL.
- الفئات (في تعريفات الحقول الوصفية القياسية للمنتجات فقط): فئات المنتجات القياسية التي يرتبط بها الحقل الوصفي القياسي للمنتج.
- التحقق (اختياري): قواعد إدخال القيم، مثل حدود الأحرف، أو الحد الأدنى والحد الأقصى للقيم.
- الخيارات: الأماكن التي يتوفر فيها استخدام الحقل الوصفي. تعرّف على المزيد حول خيارات البيانات المخصصة.
على سبيل المثال، قد يكون لتعريف الحقل الوصفي لتاريخ انتهاء صلاحية المنتج مفتاح products.expiration_date، وقيمة التاريخ، ووصف أدخل التاريخ بتنسيق YYYY/MM/DD. وقد تحدد عمليات التحقق الخاصة به أن قيم التاريخ بين 2025/07/01 و 2030/12/31 هي فقط الصالحة.
لمزيد من المعلومات حول أجزاء تعريف الحقل الوصفي، راجع الجدول التالي أو الوثائق الخاصة بالمطورين للحقول الوصفية.
| الاسم | الوصف |
|---|---|
| مساحة الاسم والمفتاح | معًا، تُنشئ مساحة الاسم والمفتاح معرّفًا فريدًا للحقل الوصفي الخاص بك. يتم الفصل بينهما بنقطة ( يمكنك استخدام مساحة الاسم لتجميع الحقول الوصفية المتشابهة معًا، ولكن يجب أن تكون كل مجموعة مكونة من مساحة اسم ومفتاح فريدة من نوعها. على سبيل المثال، يمكنك استخدام مساحة الاسم products لتجميع المفتاحين expiration_date وrating للحقول الوصفية لمنتجاتك. تستخدم التعريفات القياسية مساحات أسماء ومفاتيح موحدة، بينما تستخدم التعريفات المخصصة مساحات أسماء ومفاتيح يتم إنشاؤها تلقائيًا ويمكنك تعديلها. |
| النوع |
نوع وتنسيق المعلومات التي يحتوي عليها الحقل الوصفي. يمكنك تحديد نوع من قائمة الفئات والإعدادات المسبقة القابلة للبحث عند إنشاء تعريف. على سبيل المثال، نص من سطر واحد، أو عنوان URL، أو عدد صحيح. لا يمكن للحقول الوصفية قبول سوى القيم المدعومة لنوعها. لمزيد من المعلومات حول القيم المدعومة للأنواع الشائعة من الحقول الوصفية، راجع أنواع محتويات الحقول الوصفية وقيمها. |
| الوصف (اختياري) | وصف للحقل الوصفي لمساعدتك في إدخال القيم الصحيحة. يتم عرض الوصف في صفحة مسؤول Shopify التي تضيف فيها قيمًا لحقلك الوصفي. |
| التحقق (اختياري) | إعداد يمكنك تهيئته لتقييد القيم التي يمكن أن يحتوي عليها الحقل الوصفي الخاص بك. يمكنك تعيين القيم الدنيا والقصوى، أو استخدام التعبيرات النمطية للتحكم في نطاق القيم المقبولة لحقلك الوصفي. |