Google Apps Script: Поиск значения в столбце таблицы

/**
 * Получает все значения из указанного столбца.
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @param {number} columnIndex Индекс столбца (начиная с 1).
 * @returns {Array} Одномерный массив значений столбца.
 * @customfunction
 */
function getColumnValues(sheet, columnIndex) {
  // Проверяем корректность индекса столбца
  if (columnIndex  sheet.getMaxColumns()) {
    Logger.log('Некорректный индекс столбца: ' + columnIndex);
    return [];
  }
  const dataRange = sheet.getDataRange();
  const allValues = dataRange.getValues(); // Получаем [[row1col1, row1col2], [row2col1, row2col2], ...]
  
  // Извлекаем значения только из нужного столбца
  const columnValues = allValues.map(row => row[columnIndex - 1]); 
  return columnValues;
}

/**
 * Находит первое вхождение значения в столбце.
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @param {number} columnIndex Индекс столбца для поиска (начиная с 1).
 * @param {any} searchValue Значение для поиска.
 * @returns {number} Индекс строки (начиная с 1), где найдено значение, или -1, если не найдено.
 * @customfunction
 */
function findFirstValueRowIndex(sheet, columnIndex, searchValue) {
  const columnValues = getColumnValues(sheet, columnIndex);

  for (let i = 0; i < columnValues.length; i++) {
    // Сравнение с учетом возможных разных типов данных
    if (String(columnValues[i]).trim() === String(searchValue).trim()) {
      return i + 1; // Возвращаем номер строки (индекс + 1)
    }
  }
  
  return -1; // Значение не найдено
}

/**
 * Находит индексы всех строк, где значение в столбце соответствует искомому.
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @param {number} columnIndex Индекс столбца для поиска (начиная с 1).
 * @param {any} searchValue Значение для поиска.
 * @returns {Array} Массив индексов строк (начиная с 1), где найдено значение.
 * @customfunction
 */
function findAllMatchingRowIndices(sheet, columnIndex, searchValue) {
  const allValues = sheet.getDataRange().getValues();
  const foundIndices = [];

  allValues.forEach((row, index) => {
    // Проверяем, что столбец существует в данной строке
    if (row.length >= columnIndex) {
      if (String(row[columnIndex - 1]).trim() === String(searchValue).trim()) {
        foundIndices.push(index + 1); // Добавляем номер строки
      }
    }
  });

  return foundIndices;
}

/**
 * Находит строки, содержащие подстроку в указанном столбце (регистронезависимый поиск).
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @param {number} columnIndex Индекс столбца для поиска (начиная с 1).
 * @param {string} substring Подстрока для поиска.
 * @returns {Array} Массив индексов строк (начиная с 1).
 * @customfunction
 */
function findRowsContainingSubstring(sheet, columnIndex, substring) {
  const allValues = sheet.getDataRange().getValues();
  const foundIndices = [];
  const lowerCaseSubstring = String(substring).toLowerCase();

  allValues.forEach((row, index) => {
    if (row.length >= columnIndex) {
      const cellValue = String(row[columnIndex - 1]).toLowerCase();
      if (cellValue.includes(lowerCaseSubstring)) {
        foundIndices.push(index + 1);
      }
    }
  });

  return foundIndices;
}

// Пример с регулярным выражением (поиск email-адресов)
/**
 * Находит строки с валидными email в указанном столбце.
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @param {number} columnIndex Индекс столбца для поиска (начиная с 1).
 * @returns {Array} Массив индексов строк (начиная с 1).
 * @customfunction
 */
function findRowsWithEmail(sheet, columnIndex) {
  const emailRegex = /^[^\]+@[^\]+\.[^\]+$/i; // Простое регулярное выражение для email
  const allValues = sheet.getDataRange().getValues();
  const foundIndices = [];

  allValues.forEach((row, index) => {
    if (row.length >= columnIndex) {
      const cellValue = String(row[columnIndex - 1]);
      if (emailRegex.test(cellValue)) {
        foundIndices.push(index + 1);
      }
    }
  });

  return foundIndices;
}

/**
 * Находит строки, где числовое значение в столбце больше заданного порога.
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @param {number} columnIndex Индекс столбца для поиска (начиная с 1).
 * @param {number} threshold Пороговое значение.
 * @returns {Array} Массив индексов строк (начиная с 1).
 * @customfunction
 */
function findRowsWithValueGreaterThan(sheet, columnIndex, threshold) {
  const allValues = sheet.getDataRange().getValues();
  const foundIndices = [];

  allValues.forEach((row, index) => {
    if (row.length >= columnIndex) {
      const cellValue = parseFloat(row[columnIndex - 1]); // Преобразуем в число
      if (!isNaN(cellValue) && cellValue > threshold) {
        foundIndices.push(index + 1);
      }
    }
  });

  return foundIndices;
}

function processSearchResult() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const emailToFind = 'test@example.com';
  const emailColumnIndex = 3; // Пример: столбец C

  const rowIndex = findFirstValueRowIndex(sheet, emailColumnIndex, emailToFind);

  if (rowIndex !== -1) {
    Logger.log('Email найден в строке: ' + rowIndex);
    // Дальнейшая обработка...
  } else {
    Logger.log('Email не найден.');
    // Обработка случая, когда email отсутствует
  }
}

function findContactByEmail() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Контакты'); // Укажите имя листа
  if (!sheet) {
     Logger.log('Лист "Контакты" не найден.');
     return;
  }
  const emailColumnIndex = 2; // Столбец B
  const targetEmail = 'client.specific@example.com';

  const rowIndex = findFirstValueRowIndex(sheet, emailColumnIndex, targetEmail);

  if (rowIndex !== -1) {
    const name = sheet.getRange(rowIndex, 1).getValue(); // Получаем имя из столбца A
    Logger.log(`Контакт найден: Имя - ${name}, Строка - ${rowIndex}`);
  } else {
    Logger.log(`Email ${targetEmail} не найден.`);
  }
}

/**
 * Находит статус заказа по его ID.
 * @param {string} orderId ID заказа для поиска.
 * @param {GoogleAppsScript.Spreadsheet.Sheet} [sheet=SpreadsheetApp.getActiveSheet()] Лист с заказами (по умолчанию активный).
 * @returns {string|null} Статус заказа или null, если заказ не найден.
 * @customfunction
 */
function getOrderStatusById(orderId, sheet = SpreadsheetApp.getActiveSheet()) {
  const idColumnIndex = 1; // Столбец A
  const statusColumnIndex = 4; // Столбец D
  const searchId = String(orderId).trim();

  const allValues = sheet.getDataRange().getValues();

  for(let i = 0; i = Math.max(idColumnIndex, statusColumnIndex)) { // Убедимся, что столбцы существуют
       const currentId = String(row[idColumnIndex - 1]).trim();
       if (currentId === searchId) {
         return String(row[statusColumnIndex - 1]); // Возвращаем статус
       }
    }
  }

  return null; // Заказ не найден
}

// Пример использования:
function checkOrder() {
  const orderIdToCheck = 'ORD-12345';
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Заказы');
  if (!sheet) {
    Logger.log('Лист "Заказы" не найден.');
    return;
  }
  const status = getOrderStatusById(orderIdToCheck, sheet);
  if (status !== null) {
    Logger.log(`Статус заказа ${orderIdToCheck}: ${status}`);
  } else {
    Logger.log(`Заказ ${orderIdToCheck} не найден.`);
  }
}

/**
 * Находит все ID заказов для указанного ID клиента.
 * @param {string} customerId ID клиента.
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Лист с заказами.
 * @returns {Array} Массив ID заказов.
 * @customfunction
 */
function findOrderIdsByCustomerId(customerId, sheet) {
  const customerIdColumnIndex = 3; // Столбец C
  const orderIdColumnIndex = 1;    // Столбец A
  const searchCustomerId = String(customerId).trim();
  const orderIds = [];

  const allValues = sheet.getDataRange().getValues();

  allValues.forEach(row => {
     // Проверяем наличие обоих столбцов
    if (row.length >= Math.max(customerIdColumnIndex, orderIdColumnIndex)) {
        const currentCustomerId = String(row[customerIdColumnIndex - 1]).trim();
        if (currentCustomerId === searchCustomerId) {
          orderIds.push(String(row[orderIdColumnIndex - 1]));
        }
    }
  });

  return orderIds;
}

// Пример использования:
function showCustomerOrders() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Заказы');
  if (!sheet) {
    Logger.log('Лист "Заказы" не найден.');
    return;
  }
  const customerId = 'CUST-007';
  const orders = findOrderIdsByCustomerId(customerId, sheet);

  if (orders.length > 0) {
    Logger.log(`Найдены заказы (${orders.length}) для клиента ${customerId}: ${orders.join(', ')}`);
  } else {
    Logger.log(`Заказы для клиента ${customerId} не найдены.`);
  }
}