editCellValue

await crafttechApi.editCellValue(
  fileHandler,
  sheetName,
  cellAddress,
  data,
);

Описание

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

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

Параметры

• fileHandler (number) — ссылка на файл; ссылку предоставляет метод openFile;
• sheetName (string) — название листа;
• cellAddress (string) — адрес ячейки в строковом формате (например: С1, либо 1,3; во втором случае сначала передаётся строка, а потом столбец);
• data (string | object) — строка или объект, указывающий(-ая), что именно пользователь хочет изменить:

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

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

  • style — флаг для изменения стиля ячейки, в поле style передается значение в формате стиля (см. editCells (для версии 3 и выше) или editCells Legacy);

  • 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("Возникла ошибка");
}