Импорт данных в Ficher

Импорт данных в Ficher состоит из трех этапов:
1. Выбор источника;
2. Предпросмотр типов данных в источнике;
3. Сопоставление колонок или создание новой таблицы.

Зачем импортировать данные в Ficher?

В процессе работы с контентом игры в Ficher вы можете столкнутся с разными кейсами, которые потребуют добавить данные из внешних источников. Вот несколько примеров:

1. Вы переезжаете из других табличных сервисов в Ficher. Например, хотите конфигурировать игру не в Google Sheets, а в нашем редакторе, но сохранив наработки из прошлого табличного инструмента.
2. У вас есть большой объем данных, который необходимо перенести в Ficher. При этом делать это вручную трудо- и времязатратно – вам нужен автоматизированный процесс.
3. Вы ведете расчеты и массовые изменения ячеек в Excel или Google Sheets, но конфиг находится в Ficher. Например, импорт данных позволит быстро и автоматизированно перенести данные после расчетов в наш редактор.
4. Вы хотите откатить состояние таблиц к предыдущим значениям и у вас есть бэкап-файл (JSON из экспорта) – в этом поможет перезапись данных при импорте.

Примеры использования импорта

Работа с формулами вне Ficher

Работая с формулами в Google Sheets или Excel при создании игр, геймдизайнеры часто пользуются функцией массового применения формул (протягивание формулы на всю колонку). Это позволяет быстро проводить расчеты и заменять данные, если, например, нужно поменять формулу и применить ее на большой диапазон ячеек.

Так как Ficher пока не имеет функционала по работе с формулами, то пользователи могут импортировать данные из табличных редакторов - быстро делать массовые расчеты в сторонних инструментах, а затем в пару кликов добавлять их в Ficher.

Если нужно внести правки в формулу и изменить данные в табличных редакторах, то при повторном импорте в Ficher данные обновятся (при условии, что верно сопоставлены импортируемые колонки и колонки, в которые добавляется контент).

Импорт большого объема данных

Часто документы геймдизайнеров содержат большой объем данных (количество таблиц и ячеек в них может быть неограниченно). При переезде в Ficher из Google Sheets или Excel переносить все данные вручную будет нецелесообразно – затраты времени и сил могут быть колоссальными. В этом случае импорт данных позволит автоматизировать процесс, а все что нужно от пользователя – проверить корректность сопоставления данных и задать названия таблицам и колонкам (по необходимости).

Правила импорта

Вы можете загрузить в наш редактор данные в нескольких форматах, но к каждому из них есть определенные требования:

✔ Google Sheets (ссылкой на таблицу или на отдельный диапазон ячеек).

Требования:
• первая строка в выбранном диапазоне или во всей таблице должна содержать заголовки колонок на английском языке;
• первая колонка – id (c cоответствующим заголовком и числовыми значениями в ячейках, которые не должны повторяться). Важно! В таблице обязательно должна быть колонка id, соответствующая требованиям, указанным ранее. Без нее импорт будет невозможен;
• не должно быть объединенных ячеек;
• нужная информация размещена только в ячейках (комментарии к ячейкам будут проигнорированы).

⚠️ Загрузка данных из файла Google Sheets не может пройти без доступа к нему. Чтобы у парсера Ficher был доступ к этому файлу, в настройках доступа выдайте права редактора на почту [email protected].

Для этого вставьте почту в окошко, показанное на скриншоте. Следующим шагом укажите право “Редактор” и нажмите “Открыть доступ”.

Вот что должно получиться:

Чтобы наверняка правильно подготовить таблицу из Google Sheets к импорту в Ficher, вы можете использовать наш шаблон по ссылке.

✔ JSON

Требования:
• структура файла - массив;
• каждый элемент массива должен содержать ключ id (числовые значения в них не должны повторяться);
• корректный синтаксис без ошибок;
• лимит объема файла - 8 МБ.

Шаблон JSON-файла для корректного импорта в Ficher по ссылке.

✔ CSV/TSV (файлы, экспортированные из табличных редакторов)

Требования:
• первая строка таблицы - заголовки колонок на английском;
• первая колонка - id (c cоответствующим заголовком и числовыми значениями в ячейках, которые не должны повторяться). Важно! В таблице обязательно должна быть колонка id, соответствующая требованиям, указанным ранее. Без нее импорт будет невозможен;
• не должно быть объединенных ячеек;
• нужная информация размещена только в ячейках (комментарии к ячейкам будут проигнорированы).
• Лимит объема файла - 8 МБ.

Шаблон CSV и TSV-файла для корректного импорта в Ficher.

Варианты импорта

Вы можете импортировать в Ficher как целую таблицу, так и отдельный диапазон ячеек. Также при импорте вы можете загрузить данные в новую таблицу или дополнить ими уже существующую таблицу.

1. Импорт части таблицы из Google Sheets

Зачем импортировать часть данных?
Такой вариант добавления контента подойдет, если вам нужно добавить в таблицу Ficher недостающие данные из других табличных инструментов (например, если нужно добавить только одну колонку) или же дополнить данные в Ficher после исправления во внешнем табличном редакторе (не нужно полностью перезаливать таблицу - достаточно добавить только измененные колонки (примеры подобных кейсов). Также вы можете перенести часть данных из Google Sheets в новую таблицу Ficher.

Как загрузить часть таблицы
Чтобы импортировать часть таблицы из Google Sheets (например, отдельные колонки), выделите их и скопируйте ссылку на диапазон.

Как получить ссылку на диапазон ячеек в Google Sheets
В файле выделите нужные для импорта ячейки. Щелкните по выбранной области правой кнопкой мыши, чтобы вызвать контекстное меню. Выберите пункт “Показать другие действия с ячейкой”, в появившемся меню выберите “Получить ссылку на этот диапазон”.

Таким образом ссылка появится в вашем буфере обмена, что позволит вставить ее (Ctrl+V) в поле для импорта по ссылке.

2. Загрузка целой таблицы из Google Sheets

Импорт целой таблицы в Ficher проходит по ссылке. Важно соблюдать все требования подготовки таблиц для корректного импорта.

⚠️ Обратите внимание: парсер Ficher не сможет импортировать многостраничные файлы из Google Sheets. Чтобы корректно перенести данные, вставляйте ссылку из адресной строки на каждую отдельную страницу из загружаемого файла. Чтобы получить ссылку на отдельную таблицу из файла, откройте нужную страницу документа и скопируйте ссылку из адресной строки браузера.

Пошаговый гайд по импорту в Ficher

1. Импорт в новую таблицу в Ficher

Шаг 1: зайдите в проект в редакторе Ficher, в который хотите загрузить данные. В правом верхнем углу нажмите на "Импорт".

В появившемся окне загрузите файл указанного формата или вставьте ссылку на таблицу/диапазон ячеек таблицы в Google Sheets. Нажмите "Далее".

Шаг 2: в окне отобразятся распознанные колонки загружаемой таблицы, которые будут созданы в будущей таблице в Ficher. Также парсер автоматически определит тип колонки по ее содержимому, в том числе и колонку id. Вы можете изменить тип колонки, если требуется.

По умолчанию все колонки автоматически будут загружаться в Ficher – это можно заметить по заполненным чек-боксам рядом с ними. Но вы можете снять чек-боксы с тех колонок, которые не нужно импортировать.

Убедитесь, что типы данных соответствуют тому, что содержится в колонках, а затем нажмите “Далее”.

Шаг 3: на этом этапе вам необходимо выбрать, куда загружать данные. Справа в поле “Выбранная таблица в Ficher” нажмите на выпадающий список и выберите “Создать таблицу”.

Шаг 4: после появится окно, где потребуется ввести название для новой таблицы (это обязательный этап). Когда название введено, нажмите “Далее”.

После успешного импорта появится окно:

После нажатия на “Отлично” импортированная таблица автоматически откроется.

2. Импорт в существующую таблицу в Ficher

Повторите Шаг 1 (ссылка) и Шаг 2 (ссылка) из гайда по импорту в новую таблицу.

Шаг 3: выберите таблицу, куда будут добавлены данные. Справа в поле “Выбранная таблица в Ficher” нажмите на выпадающий список и выберите необходимую вам таблицу. В нашем примере это “prices”.

Вы можете добавить данные в новые колонки или дополнить уже имеющиеся в Ficher колонки.

Вариант 1. Для добавления данных в новые колонки, выберите “Создать новую колонку” в выпадающем списке в поле с выбором колонки в таблице Ficher.

⚠️Как работает функция “Перезаписать данные” (на скрине выше)

Если вы делаете активным чек-бокс возле “Перезаписать данные”, то данные в таблице Ficher, куда производится импорт, полностью удалятся, а на их место добавятся колонки из импортируемого файла.

Если вам необходимо дополнить таблицу в Ficher, а не перезаписать, или же обновить данные в уже имеющихся колонках, то чек-бокс делать активным не нужно.

Примеры реализации:

• Как будет выглядеть таблица, если перезаписать данные (удалились прошлые колонки и добавились новые, так как мы выбрали “Создать новую колонку”):

• Как будет выглядеть таблица, если оставить неактивным чек-бокс “Перезаписать данные” (добавились новые колонки из импортируемого файла, не изменяя старые).

Вариант 2. Для добавления данных в уже существующие колонки в Ficher, обязательно сопоставьте колонки с теми, что уже есть в таблице:
• В рабочей области справа выберите нужные колонки и типы соответственно колонкам, которые хотите импортировать.
• Убедитесь, что типы данных соответствуют содержанию колонок.

⚠️ Обратите внимание на чек-бокс “Перезаписать данные”: установив его, колонки из таблицы в Ficher удалятся, а на их месте появятся данные из импортированного файла (подойдет, если нужно полностью заменить содержимое таблицы). Оставив чек-бокс неактивным, данные, которые есть в таблице Ficher, не будут удалены, а обновятся в соответствии с импортированными (удобно, если нужно загрузить правки из внешнего табличного редактора).

Шаг 4: когда убедитесь в правильности сопоставленных колонок и данных, нажмите “Далее”. После успешного импорта появится такое окно:

Возможные ошибки

Основные ошибки при импорте данных в Ficher связаны с:
• некорректностью колонки id (содержит повторяющиеся значения, нечисловые данные или колонка отсутствует вовсе);
• некорректностью JSON (массив содержит ошибки, файл не соответствует формату);
• некорректностью содержимого таблиц (дублируются названия колонок, отсутствуют данные или часть необходимых данных).

Что делать, если отобразилась ошибка?
• Убедитесь, что файл (загружаемый напрямую или по ссылке) соответствует требованиям. Также в тексте ошибки, которая появляется на экране, чаще всего содержатся рекомендации по их устранению.
• Повторите шаги импорта, при этом убедитесь, что вы корректно сопоставили колонки при импорте в существующую таблицу.