Справка · Журналы и сделки

Как импортировать журнал из файла

Импорт принимает выгрузку терминала, отчёт брокера или вашу собственную таблицу — в CSV, Excel, PDF, Word, HTML или обычным текстом. Выгрузки известных платформ разбираются сразу и сами; всё остальное размечает ИИ: он определяет, где дата, где инструмент, где результат, и понимает форматы, в которых записаны значения. Ваша работа — проверить разметку и решить, что делать со спорными строками.

Какие файлы принимаются

ФорматЧто из него читается
.csv, .tsvТаблица с любым разделителем столбцов, какой встречается в выгрузках.
.xlsx, .xlsВсе листы книги. Формулы приходят посчитанными значениями, даты — датами.
.pdfТаблицы отчёта постранично. Таблица, идущая через несколько страниц, собирается в одну.
.docxТаблицы документа и текст вокруг них — в нём часто указаны инструмент и депозит.
.htm, .htmlОтчёты терминалов. MetaTrader 4, например, другого формата не отдаёт вовсе.
.txtТекстовая таблица — с разделителем или с колонками, выровненными пробелами.

Расширение не решает: формат определяется по самому файлу. Переименованный или сохранённый «не тем» способом файл всё равно прочитается.

  • Строка заголовков — по ней понимается смысл столбцов. Заголовок может занимать две строки, если перенос стоит внутри кавычек, и может лежать не в первой строке: над таблицей часто стоит блок настроек.
  • Кодировка — UTF-8 или Windows-1251. Русские выгрузки часто во второй; продукт определяет её сам.

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

Скан импортировать нельзя. Если PDF — это картинка страницы, текста в нём нет, и брать данные неоткуда. Попросите у брокера файл с данными.

Выгрузки, которые разбираются сами

Структура обычного отчёта известна заранее, поэтому распознавать её ИИ незачем. Файлы этих платформ размечаются сразу после загрузки — мгновенно и не тратя токены:

MetaTrader 4 и MetaTrader 5, cTrader, NinjaTrader, Interactive Brokers (Flex Query), thinkorswim, QUIK, Binance, Bybit, TradingView.

Опознанная платформа названа на экране сопоставления. Если она определена неверно — нажмите «Распознать заново», и разметку сделает ИИ. Он, в свою очередь, знает и остальные платформы: Transaq, SmartX, Tiger Trade, ATAS, TSLab, Sierra Chart, отчёты Т-Инвестиций, БКС, ВТБ и Финама, выгрузки OKX, KuCoin, Kraken и других бирж.

Если в файле несколько таблиц

В книге Excel листов обычно три: параметры, сделки и сводка. В отчёте брокера разделов ещё больше. Продукт сам выбирает тот, который больше похож на таблицу сделок, и пишет на экране, какой именно лист разобран. Не тот — выберите нужный в списке «Таблица в документе».

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

Как проходит импорт

  1. Три вводных экрана Как ИИ читает журнал, примеры хороших журналов и зачем нужны стандартные поля. Их можно пролистать, но третий стоит прочитать: он объясняет, почему сопоставление важнее, чем кажется.
  2. Загрузка файла Перетащите CSV в поле или выберите на диске. Продукт прочитает файл и покажет, сколько нашёл столбцов и записей.
  3. Распознавание Кнопка «Распознать автоматически» отправляет структуру файла ИИ. Он размечает столбцы, определяет форматы дат и чисел и сопоставляет значения — например, понимает, что Sell в вашем файле означает «шорт». Идёт фоном, с полосой прогресса; страницу можно перезагрузить, ход не потеряется.
  4. Проверка сопоставления Экран «Выбери столбцы для импорта»: у каждого столбца — галочка «брать или нет», описание для ИИ и выпадающий список стандартного поля. Ваш выбор важнее догадки ИИ: что поставили руками, то и будет.
  5. Сохранение Название журнала, теги — и сделки попадают в базу.

Стандартные поля — почему это главное

Столбец, сопоставленный со стандартным полем, участвует в расчётах. Несопоставленный просто хранится текстом и виден в таблице.

Стандартное полеЧто без него не посчитается
Дата и времяНичего: график капитала, серии, P&L по дням и часам
ИнструментЛучшие и худшие инструменты, фильтр по инструменту
НаправлениеРазбивка лонг/шорт — а это половина выводов о перекосе
Цена входа и выходаРасчёт результата, если он не задан деньгами
Результат, деньгиWin rate, profit factor, просадка, вся финансовая часть
ОбъёмЗагрузка депозита, средний размер позиции
Стоп-лосс и тейк-профитR:R и оценка дисциплины по риску

Если метрика в статистике недоступна, продукт прямо пишет, какого столбца не хватает — сопоставьте его и пересчитайте.

Даты, разложенные по столбцам

Год, месяц и число в отдельных колонках собираются в одну дату автоматически. Месяц понимается и числом, и словом — русским или английским; двузначный год считается двухтысячным. Это работает и без ИИ, но столбец «День недели» датой не считается: он проверяется по значениям, а не только по заголовку.

Если файл грязный

Кнопка «Исправить с помощью ИИ» запускает разбор проблемных мест: битые даты вроде 18.18.2020, мусор в числовом столбце, разнобой в написании категорий. Модель предлагает исправления, вы решаете, применять ли.

Непрочитанные значения не блокируют импорт. Они перечислены в предупреждениях, и сделки всё равно заносятся. Это сознательный выбор: остановить импорт из-за одной строки — значит не импортировать вообще ничего. Просмотрите список предупреждений после загрузки и поправьте такие сделки руками.

Импорт в существующий журнал

Импортировать можно не только при создании: откройте журнал и запустите импорт оттуда. Новые сделки добавятся к имеющимся. Дубли продукт не ищет — если зальёте один и тот же файл дважды, сделки удвоятся; лишние удаляются массовым действием в таблице (как работать с журналом).

Частые вопросы

ВопросОтвет
Файл не читается совсемПродукт скажет, почему именно: скан вместо данных, презентация вместо таблицы, документ Word старого формата .doc (пересохраните как .docx).
Разобран не тот листВыберите нужный в списке «Таблица в документе» на экране сопоставления.
В PDF столбцы съехалиТак бывает, когда в отчёте нет разлиновки: колонки восстанавливаются по расположению текста. Об этом написано предупреждением — сверьте разметку до импорта.
Русские буквы превратились в мусорПродукт определяет кодировку сам; если всё же так — сохраните файл в UTF-8.
Часть сделок без датыОни импортируются, но не попадут в графики по времени. Проще поправить дату в таблице после импорта.
Столбец распознан неверноПоменяйте стандартное поле на экране сопоставления — ручной выбор перекрывает догадку ИИ. Уже импортированный журнал правится в «Схеме».