> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تنسيق CSV

> كيف تجهّز ملف CSV للإنشاء الجماعي: الترويسة المطلوبة، والصفوف، وقواعد عناوين URL، وأخطاء التحقّق.

يقرأ الإنشاء الجماعي ملف CSV بسيطًا: صف ترويسة واحد، ثم صف لكل رمز QR يحتوي على اسم وعنوان URL للوجهة. تسرد هذه الصفحة القواعد التي يتحقّق منها GetQR عند رفع الملف.

## ملف نموذجي

```csv bulk-qr-template.csv theme={null}
name,url
Spring Menu,https://getqr.com/spring
Store #14,https://getqr.com/store-14
Table 7,example.com/menu?table=7
"Downtown, Main St",https://example.com/stores/downtown
```

يمكنك أيضًا تنزيل نقطة البداية هذه من التطبيق: في خطوة **Add links**، انقر على **Download CSV template**.

## القواعد

| الجزء | القاعدة |
| - | - |
| الملف | يجب أن يكون ملف `.csv`. لا تُقبل ملفات Excel والتنسيقات الأخرى. |
| الترويسة | يجب أن يكون الصف الأول `name,url` تمامًا: بأحرف صغيرة، وبهذا الترتيب، دون أعمدة أخرى. |
| الصفوف | حتى 100 صف غير فارغ. تُتجاهل الصفوف الفارغة. |
| `name` | مطلوب. يصبح اسم رمز QR. حتى 40 حرفًا؛ تُقتطع الأسماء الأطول إلى 40 حرفًا. |
| `url` | مطلوب. عنوان ويب يبدأ بـ `http://` أو `https://`. |

### قواعد عناوين URL

* إذا حذفت البروتوكول، يضيف GetQR `https://`. يصبح `example.com/menu` هو `https://example.com/menu`.
* يجب أن يتضمّن العنوان نطاقًا حقيقيًا يحتوي على نقطة، مثل `example.com`.
* لا مسافات أو علامات جدولة أو فواصل أسطر.
* تعمل روابط الويب فقط. تُرفض `mailto:` و`ftp://` و`javascript:` وعناوين البريد الإلكتروني العادية.

### الأسماء المكرّرة

لا يلزم أن تكون الأسماء فريدة. إذا كان لصفين الاسم نفسه (بغض النظر عن الأحرف الكبيرة والصغيرة)، يرقّم GetQR التكرارات: `Menu` و`Menu 2` و`Menu 3`.

### الفواصل وعلامات الاقتباس

إذا احتوى الاسم على فاصلة، فضعه بين علامتي اقتباس مزدوجتين، كما في `"Downtown, Main St"`. تقوم تطبيقات جداول البيانات بذلك نيابةً عنك عند الحفظ بتنسيق CSV.

## إنشاء الملف في جدول بيانات

**1. أعدّ عمودين**

في الصف الأول، اكتب `name` في العمود A و`url` في العمود B.

**2. أضف صفًا لكل رمز**

املأ اسمًا ورابطًا في كل صف، حتى 100 صف.

**3. احفظ بتنسيق CSV**

صدّر الورقة أو احفظها بتنسيق CSV. في Excel، اختر **CSV UTF-8**. في Google Sheets، اختر **File > Download > Comma-separated values**.

> [!TIP]
>
> الحفظ بترميز UTF-8 يحافظ على الحروف العربية والحروف المشكّلة وغيرها من الأحرف غير الإنجليزية في أسمائك سليمة.

## أخطاء التحقّق

### أخطاء الملف

توقف هذه الأخطاء الملف بأكمله. أصلح الملف وارفعه مجددًا.

| الرسالة | ما يجب فعله |
| - | - |
| Choose a CSV file. Other file types are not supported. | احفظ الملف بتنسيق `.csv`، وليس `.xlsx` أو `.numbers`. |
| The CSV header must be exactly name,url in that order. | اجعل الصف الأول `name,url` تمامًا. تحقّق من الأحرف الكبيرة أو الأعمدة الإضافية أو غياب الترويسة. |
| Add at least one non-empty data row to the CSV. | يحتوي الملف على ترويسة دون صفوف. أضف اسمًا ورابطًا واحدًا على الأقل. |
| A CSV can contain at most 100 non-empty rows. | قسّم القائمة إلى ملفات يحتوي كل منها على 100 صف كحد أقصى. |
| This CSV is malformed and could not be read. | أعد تصدير الملف من تطبيق جداول البيانات. ابحث عن علامات اقتباس غير مغلقة. |

### أخطاء الصفوف

تُعلِّم هذه الأخطاء صفوفًا منفردة. يمكنك إصلاحها وإعادة الرفع، أو المتابعة بالصفوف الصالحة فقط.

| الشارة أو الرسالة | السبب |
| - | - |
| **MISSING** / Name is required | خلية `name` فارغة. |
| **MISSING** / URL is required | خلية `url` فارغة. |
| **INVALID** / Enter a valid HTTP(S) URL | يخالف الرابط إحدى [قواعد عناوين URL](#url-rules). |

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

## المشكلات الشائعة

> **تبدو الترويسة صحيحة لكنني لا أزال أحصل على خطأ الترويسة**
>
> يجب أن تكون الترويسة بأحرف صغيرة وأن تحتوي على عمودين فقط. تفشل `Name,URL` أو `name,url,notes`. تحقّق أيضًا من وجود أعمدة فارغة على يمين `url` في جدول البيانات.

> **رابط يعمل في متصفحي معلَّم بـ INVALID**
>
> قد يحتوي الرابط على مسافة، أو يستخدم بروتوكولًا غير http أو https. رمّز المسافات بـ `%20` أو احذفها، واستخدم عنوان ويب كاملًا.

> **اختُصرت بعض الأسماء**
>
> تُقتطع الأسماء التي تتجاوز 40 حرفًا إلى 40 حرفًا. اختصرها في الملف إذا كنت تريد اختيار الصياغة بنفسك.

## الخطوات التالية

> **[إنشاء رموز QR من ملف CSV](/ar/bulk/create-from-csv)**
>
> ارفع ملفك وابدأ الدفعة.

> **[نظرة عامة على الإنشاء الجماعي](/ar/bulk/overview)**
>
> الحدود وآلية عمل الإنشاء الجماعي.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.