editCellValue

await crafttechApi.editCellValue(
  fileHandler,
  sheetName,
  cellAddress,
  data,
  (flag = "value")
);

Описание

Вносит изменения в значение ячейки.

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

Параметры

• fileHandler (number) — ссылка на файл; ссылку предоставляет метод openFile;

• sheetName (string) — название листа;

• cellAddress (string) — адрес ячейки в строковом формате (например: С1, либо 1,3; во втором случае сначала передаётся строка, а потом столбец);

• flag (string) — необязательный параметр, указывающий, что именно пользователь хочет изменить:

  • value — в поле value передается значение в формате строки (по умолчанию);

  • formula — флаг для изменения формулы ячейки, в поле value передается значение в формате строки;

  • value, formula — флаг для изменения значения и формулы, в поле value передается объект в следующем формате:

    let value = {
      value: "Строка", // значение, которое будет заменено
      formula: "C1+A5", // формула ячейки
    };

Возвращает

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

Пример

const result = await crafttechApi.editCellValue(
  fileHandler,
  "Лист1",
  "2,4",
  "777"
);

if (result) {
  console.log("Значение добавлено в ячейку B4");
} else {
  console.log("Возникла ошибка");
}