المخططات المخصصة

عندما تحتاج إلى قراءة شيء من وثيقة لا يوجد في المخططات النظامية، تقوم بتعريف مخططك الخاص.

متى يكون ذلك منطقيًا

• وثيقة من مورد واحد بتخطيط غير قياسي.
• تخصص صناعي: تذاكر الوزن، بروتوكولات الاختبار، بطاقات الوقود.
• حقل تحتاجه في نظامك ولا يظهر في أي مكان آخر.

توقع أن الوثيقة من المخطط الخاص لا يمكن إرسالها إلى المحاسبة أو تصديرها إلى تنسيقات المحاسبة — هذه تقرأ حقول الفاتورة الثابتة. يبقى JSON و XML و YAML و CSV و Excel و PDF. في التقارير، يتم احتساب فقط الوثيقة التي تحتوي على حقل عددي TotalAmount.

كيفية التعريف

من خلال المحرر في علامة التبويب المخططات. يتم كتابة ذلك في مخطط JSON — كائن مع properties، لكل حقل type و description، والقوائم مثل array مع items. من يعرف المعايير لن يتفاجأ؛ ومن لا يعرف، يبدأ من النموذج (فاتورة، فاتورة مع ضريبة القيمة المضافة، إيصال، قائمة تسليم، الحد الأدنى) أو من نسخة المخطط النظامي. تحمل حقول النماذج أسماء إنجليزية مثل المخططات النظامية، لذا يمكن لنموذج المراقبة العثور على الوصف؛ أوصاف الحقول هي بلغة واجهة المستخدم ويمكن إعادة كتابتها.

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

وصف الحقل هو دليل للنموذج

هذه هي أهم نقطة في الصفحة كلها. لا يتم استخدام description فقط للإنسان، بل يقرأه النموذج أيضًا. الفرق بين "رقم الطلب" و "رقم الطلب يبدأ بـ Z- ويتكون من ستة أرقام، وغالبًا ما يكون في الزاوية العلوية اليمنى بجوار الرمز الشريطي" هو فرق كبير في النجاح.

الحدود

عدد الحقول يخضع للتعريفة: 80 في Free و Starter، 160 في Business، 240 في Scale. يتم احتساب الحقول المتداخلة وحقول العناصر أيضًا. تُرسل الأسماء والأوصاف إلى النموذج مع كل وثيقة، لذا يعني المخطط الأطول معالجة أكثر تكلفة.

التجريب

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

التغييرات والحذف

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