Быстрый старт: первый проект

Подготовить каталог, положить книгу и скрипт, запустить пример и увидеть результат.

Команды ниже выполняются в подготовленной папке ~/Desktop/F1-API-First-Run. Её вместе со скриптом f1-api-first-run.mjs и книгой input.xlsx даёт Evaluation Kit — отдельный артефакт поставки (см. Состав поставки). В установщик F1 он не входит и с dl.plantype.ru не скачивается: его запрашивают у поставщика.

Если Evaluation Kit ещё не получен, установленного F1 достаточно, чтобы пройти тот же путь: процессор compute_contract_cli лежит внутри приложения (см. Установка F1), полный текст скрипта — на странице Проверенный скрипт, а любую свою книгу можно переименовать в input.xlsx.

Подготовить первый проект

Понадобится Node.js версии 22 LTS или новее и любая XLSX-книга. В готовом комплекте на рабочем столе уже лежат input.xlsx и проверенный f1-api-first-run.mjs.

Создать каталог

mkdir -p ~/Desktop/F1-API-First-Run
cd ~/Desktop/F1-API-First-Run

mkdir $HOME\Desktop\F1-API-First-Run -Force
cd $HOME\Desktop\F1-API-First-Run

mkdir -p ~/Desktop/F1-API-First-Run
cd ~/Desktop/F1-API-First-Run

Положить исходную книгу

Скопируйте существующую книгу и назовите её input.xlsx. Скрипт не изменяет исходный файл: он пишет новый result.xlsx.

cp ~/Downloads/workbook.xlsx ./input.xlsx
ls -lh input.xlsx

Copy-Item $HOME\Downloads\workbook.xlsx .\input.xlsx
Get-Item .\input.xlsx | Format-List Name, Length

cp ~/Downloads/workbook.xlsx ./input.xlsx
ls -lh input.xlsx

Положить скрипт

Используйте файл f1-api-first-run.mjs из Evaluation Kit. Полный текст — на странице Проверенный скрипт.

Запустить пример

cd ~/Desktop/F1-API-First-Run
node ./f1-api-first-run.mjs

cd $HOME\Desktop\F1-API-First-Run
node .\f1-api-first-run.mjs

cd ~/Desktop/F1-API-First-Run
node ./f1-api-first-run.mjs

Скрипт выполняет семь шагов:

запускает compute_contract_cli –session и получает handshake;
открывает input.xlsx через open_workbook_subset;
получает subsetId и sheetKey из ответа Rust;
пишет A1 = F1 API, B1 = 21, C1 = формула =B1*2;
читает C1 и получает displayValue 42;
выполняет Undo и Redo через центральную историю;
сохраняет result.xlsx, запускает новый процесс и проверяет C1 после холодного открытия.

Ожидаемый вывод

1. Сессия: compute_contract_cli_session_ready
2. Открыта книга: Data subset-...
3. Изменения применены, revision: 1
4. C1 после формулы: ... displayValue: '42' ...
5. Undo/Redo: выполнены
6. Сохранено: .../result.xlsx
7. Повторное открытие, C1: ... displayValue: '42' ...

Увидеть результат

open -a ~/Applications/F1.app ~/Desktop/F1-API-First-Run/result.xlsx

& "C:\Program Files\F1\F1.exe" "$HOME\Desktop\F1-API-First-Run\result.xlsx"

/opt/F1/f1 ~/Desktop/F1-API-First-Run/result.xlsx

Что дальше

Понять, как живёт сеанс и что приходит в ответе — Как устроен сеанс API.
Разобрать каждый вызов примера — Запросы, использованные в примере.
Взять скрипт целиком — Проверенный скрипт.
Все операции с полями — справочник Compute Contract.
Что-то не запускается — Диагностика.