Импорт и экспорт CSV
Нужны, когда тексты уходят на правку наружу: в таблицу, переводчику, во внешний сервис. Обе вкладки — на экране Словарь HL.
Экспорт
Вкладка «Экспорт», кнопка «Скачать .csv». Что в файле:
- кодировка UTF-8 с BOM — Excel открывает без плясок;
- разделитель — точка с запятой;
- первая строка:
UF_CODE, дальше все языковые колонки; - защита от формул: ячейка, начинающаяся с
=,+,-,@, табуляции или переноса строки, получает апостроф в начале.
Последнее — не придирка. Без апострофа Excel считает такую ячейку формулой, и фраза «-15% на всё» превращается в ошибку вычисления или, хуже, в исполняемое выражение при открытии файла на чужой машине.
Импорт
Вкладка «Импорт», выберите файл, «Загрузить переводы».
Требования к файлу:
| Первая строка | заголовки. UF_CODE обязателен, остальные колонки — только языковые. Лишняя колонка остановит импорт |
| Разделитель | точка с запятой |
| Расширение | .csv или .txt |
| Кодировка | определяется сама. BOM убирается, файл в Windows-1251 перекодируется, и об этом будет сказано в отчёте |
| Размер | до 8 МБ и до 20 000 строк |
Ограничение на размер — не каприз: файл больше упирается в таймаут, и вы вместо понятного сообщения получаете оборванную страницу на середине импорта.
Что происходит с записями
Код уже есть — запись обновится только по переданным языкам. Колонки, которых в файле нет, не затираются. То есть можно выгрузить весь словарь, отдать переводчику один язык и залить обратно только его.
Кода нет — добавится новая запись.
Один код повторяется в файле — дубля не будет, обработается один раз.
В отчёте видно, сколько строк пропущено: пустой код или ошибка добавления.
Одна особенность, о которой узнают поздно
Перевод, залитый импортом, не снимает отметку «оригинал изменился».
Логика такая: модуль не может отличить залитый перевод устаревшей фразы от залитого перевода, сделанного до правки оригинала. Поэтому отметку он оставляет, а снимаете вы — кнопкой «Перевод проверен» на экране Обслуживание.
Если об этом не знать, список устаревших переводов после большого импорта выглядит так, будто импорт не сработал. Сработал.
Подробнее про отметку — Очередь и «оригинал изменился».