editCellsValue

await crafttechApi.editCellsValue(fileHandler, sheetName, data);

Описание

Вносит изменения в значения нескольких ячеек.

Требует сохранения при помощи saveFile (для внешнего файла), либо applyActiveFileChanges (для активного файла).

Параметры

• fileHandler (number) — ссылка на файл; ссылку предоставляет метод openFile;
• sheetName (string) — название листа;
• data (string | number | null)[][] — двумерный массив с числовыми или строковыми данными ячеек.

Данные ячеек передаются аналогично получаемым данным в методе getSheetArray. То есть всё кладём в один большой массив, а в нём другие массивы, которые соответствуют порядковому номеру ряда в документе. Элементы внутри второго массива соответствуют порядку столбцов в документе. Если мы пишем null — это означает, что мы хотим пропустить ряд или столбец.

Возвращает

• true | false (boolean) — логическая истина true в случае успешного изменения ячеек.

Пример

const result = await crafttechApi.editCellsValue(fileHandler, "Лист1", [
  ["Я ячейка A1", "А я B1"],
  null,
  ["Я A3", null, "А тут C3"],
]);

console.log("Значения добавлены: ", result);

Пусть мы имеем таблицу следующего формата:

A1 - B1 - C1
A2 - B2 - C2
A3 - B3 - C3

Тогда, после вызова метода из примера выше мы изменили значения ячеек, которые отмечены (*), остальные ячейки остались нетронутыми:

A1* - B1* - C1
A2  - B2  - C2
A3* - B3  - C3*