input и settings только для чтения. Верните JSON-сериализуемое значение. Для отладки используйте console.log.
Скрипт работает не дольше 60 секунд и использует не больше 128 МБ памяти. За пределом он останавливается, и ошибка называет предел; повторный запуск на том же входе упрётся в него снова.
Исходный код не подставляет значения. Текст вроде {{Name}} остаётся как написан.
Внутри Loop item — текущий элемент, index — номер шага, с нуля. input по-прежнему результат предыдущего узла.
Вход
Вкладка инспектора Настройки. Правила пустого поля на графе: Предыдущие узлы. Вставить значение здесь нет.input скрипта — предыдущий Result, если агент не передал input. File id заменяет его: хост кладёт в input сетку листа (grid, merges, число строк и колонок) и файл (input.file.artifactId, input.file.name) и не подмешивает input. Полная сетка в результат шага не входит. Форму листа смотрите в Sheet map.
Агент выполняет на одном Instance один вызов Code за раз. Шаг Code на графе этого не ждёт. Когда платформа занята, вызов ждёт в очереди до двух минут; после этого ошибка говорит, что песочница занята. Повторите этот вызов.
Чтение State
Каждая коллекция из Коллекции, которые скрипт может читать читается до старта скрипта. Скрипт получаетstate.<collection> — массив { key, data }, отсортированный по ключу. Так скрипт находит записи, которых нет в файле, например список портов для сверки названий.
Во всех перечисленных коллекциях вместе может быть не больше 20 000 записей. Иначе вызов завершается ошибкой до запуска скрипта.
Запустить тест
Тестовый ввод (JSON или текст) и Запустить тест выполняются на выбранном Instance. Выберите Instance, чтобы протестировать код. Вывод: Результат и Консоль. Ошибки: Код завершился с ошибкой или Тест кода не удался. Смотреть результаты на узле тоже показывает Консоль дляconsole.log во время запуска графа.
Выход
На следующем узле Предыдущие узлы показываетCode: Result ({{Code.text}}, пока имя уникально).
Запись из кода
Пустой список Коллекции, куда скрипт может сохранить оставляет Result значением скрипта. State не меняется. Если список не пуст, скрипт возвращает{ writes: [{ collection, key, data, row }], skipped: [{ row, reason }], deletes: [...] }. Принимаются только эти имена коллекций. Повтор ключа отменяет вызов, ошибка называет обе строки. Собирайте ключ из всех полей, которые отличают записи друг от друга. data должно совпасть со схемой коллекции. Тот же ключ при следующем запуске заменяет запись. Правила ключа: State.
Когда File id загружает лист, row — номер строки листа с единицы, он нужен в каждой записи и каждом пропуске. Каждая непустая строка (внутри Строк, если они заданы) должна быть записана или пропущена, иначе вызов завершается ошибкой и перечисляет пропущенные строки.
С загруженным листом key необязателен. Запись без него получает <file id>:<лист>:<строка>:<n>. лист — номер этого листа в файле, с единицы, в том же порядке, что в оглавлении. Это не имя листа: в имени бывают символы, которые ключ хранить не может, и после их удаления два листа могут получить один ключ. n считает записи этой коллекции без ключа в той же строке, поэтому два раза { collection: "rates", row: 12, data } на листе 3 дают …:3:12:1 и …:3:12:2. Тот же скрипт на том же листе заменяет эти записи. Другой лист того же файла их не трогает. Свой key передавайте, только когда следующий файл должен обновить ту же запись. Если изменённый скрипт пишет из строки меньше записей, лишние записи этого листа остаются, пока следующий файл его не заменит.
deletes необязателен. Каждый элемент — { collection, key } или { collection, where, exceptArtifactId }. where использует те же фильтры, что чтение State, и не может быть пустым, если вы его передаёте.
Хост выполняет удаления, затем записи одной транзакцией. Сохраняется всё или ничего.
Замена старого файла
Запись из листа, который загрузил File id, помнит этот файл. При чтении State это полеsourceArtifactId. Импорт из файла тоже его ставит. Сохранение записи другим способом его не меняет.
exceptArtifactId оставляет записи, последний раз записанные из этого файла, и удаляет остальные, подходящие под where. Без where — во всей коллекции. Id должен быть файлом этого Instance. Так новый прайс заменяет старый того же перевозчика, а строки, которых в новом файле нет, исчезают:
dryRun true (его передаёт агент) всё проверяет и ничего не сохраняет.
Result — JSON-текст: