Формат CSV - GetQR Docs

Для массового создания используется простой CSV-файл: одна строка заголовка, а затем по одной строке на каждый QR-код с названием и целевым URL. На этой странице перечислены правила, которые GetQR проверяет при загрузке файла.

Пример файла

bulk-qr-template.csv

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.

Создание файла в таблице

Создайте два столбца

В первой строке введите name в столбце A и url в столбце B.

Добавьте по строке на каждый код

Заполните название и ссылку в каждой строке, всего до 100 строк.

Сохраните в CSV

Экспортируйте или сохраните лист в формате CSV. В Excel выберите CSV UTF-8. В Google Таблицах выберите File > Download > Comma-separated values.

Сохранение в 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.

При нумерации строк заголовок считается строкой 1, поэтому первая строка данных — строка 2, как и в вашей таблице.

Частые проблемы

Заголовок выглядит правильно, но ошибка заголовка всё равно появляется

Заголовок должен быть написан строчными буквами и содержать только два столбца. Name,URL или name,url,notes не подойдут. Также проверьте, нет ли в таблице пустых столбцов справа от url.

Ссылка, которая работает в браузере, помечена как INVALID

Возможно, ссылка содержит пробел или использует схему, отличную от http или https. Замените пробелы на %20 или удалите их и используйте полный веб-адрес.

Некоторые названия сократились

Названия длиннее 40 символов обрезаются до 40. Если хотите сами выбрать формулировку, сократите их в файле.

Что дальше

Создание QR-кодов из CSV

Загрузите файл и запустите пакет.

Обзор массового создания

Ограничения и принцип работы массового создания.

​Пример файла

​Правила

​Правила для URL

​Повторяющиеся названия

​Запятые и кавычки

​Создание файла в таблице

​Ошибки проверки

​Ошибки файла

​Ошибки строк

​Частые проблемы

​Что дальше

Создание QR-кодов из CSV

Обзор массового создания

Пример файла

Правила

Правила для URL

Повторяющиеся названия

Запятые и кавычки

Создание файла в таблице

Ошибки проверки

Ошибки файла

Ошибки строк

Частые проблемы

Что дальше