إنشاء القوالب - Twenty Documentation

بدلًا من إنشاء ملفات الكيانات يدويًا، استخدم أداة القوالب التفاعلية:

yarn twenty dev:add

ستطلب منك اختيار نوع الكيان وتُرشدك عبر الحقول المطلوبة، ثم تُنشئ ملفًا جاهزًا للاستخدام يحتوي على universalIdentifier ثابت واستدعاء defineEntity() الصحيح. يمكنك أيضًا تمرير نوع الكيان مباشرة لتخطي المطالبة الأولى:

yarn twenty dev:add object
yarn twenty dev:add logicFunction
yarn twenty dev:add frontComponent

أنواع الكيانات المتاحة

نوع الكيان	أمر	الملف المُولَّد
كائن	`yarn twenty dev:add object`	`src/objects/\<name>.ts`
الحقل	`yarn twenty dev:add field`	`src/fields/\<name>.ts`
دالة منطقية	`yarn twenty dev:add logicFunction`	`src/logic-functions/\<name>.ts`
مكوّن أمامي	`yarn twenty dev:add frontComponent`	`src/front-components/\<name>.tsx`
دور	`yarn twenty dev:add role`	`src/roles/\<name>.ts`
مهارة	`yarn twenty dev:add skill`	`src/skills/\<name>.ts`
وكيل	`yarn twenty dev:add agent`	`src/agents/\<name>.ts`
عرض	`yarn twenty dev:add view`	`src/views/\<name>.ts`
عنصر قائمة التنقّل	`yarn twenty dev:add navigationMenuItem`	`src/navigation-menu-items/\<name>.ts`
تخطيط الصفحة	`yarn twenty dev:add pageLayout`	`src/page-layouts/\<name>.ts`
علامة تبويب تخطيط الصفحة	`yarn twenty dev:add pageLayoutTab`	`src/page-layout-tabs/\<name>.ts`
عنصر قائمة الأوامر	`yarn twenty dev:add commandMenuItem`	`src/command-menu-items/\<name>.ts`
حقل العرض	`yarn twenty dev:add viewField`	`src/view-fields/\<name>.ts`
موفر الاتصال	`yarn twenty dev:add connectionProvider`	`src/connection-providers/\<name>.ts`

ما الذي تُنشئه أداة القوالب

لكل نوع كيان قالب خاص به. على سبيل المثال، يسأل yarn twenty dev:add object عن:

الاسم (مفرد) — مثل invoice
الاسم (جمع) — مثل invoices
التسمية (مفرد) — تُستمد تلقائيًا من الاسم (مثل Invoice)
التسمية (جمع) — تُملأ تلقائيًا (مثل Invoices)
إنشاء عرض وعنصر تنقّل؟ — إذا أجبت بنعم، فستُنشئ أداة القوالب أيضًا عرضًا مطابقًا ورابط شريط جانبي للكائن الجديد.

أنواع الكيانات الأخرى لها مطالبات أبسط — فمعظمها يطلب اسمًا فقط. نوع الكيان field أكثر تفصيلاً: يطلب اسم الحقل وتسمية الحقل ونوعه (من قائمة بكل أنواع الحقول المتاحة مثل TEXT وNUMBER وSELECT وRELATION وغيرها)، ومعرّف universalIdentifier للكائن الهدف.

مسار خرج مخصّص

استخدم العلم --path لوضع الملف المُولَّد في موقع مخصّص:

yarn twenty dev:add logicFunction --path src/custom-folder

⌘I