客戶資料管理

1. 後台管理，會有 新增(C)、編輯(U)、查詢(R)、刪除(D)。因為試算表的列指標，會有變動，如刪除或排序. 所以用流水號來代表唯一的記錄。當新增時流水號為「''」，編輯時流水號的值須在客戶工作表裡面
2. 上個單元，我們已經有辦法將資料儲存到一個儲存格，接下來會用迴圈來完成一筆記錄
3. 結構欄位：流水號、客戶名稱、客戶電話、客戶地址、備註
   流水號：自訂，這裡不使用列編號，因為列編號會因刪除、排序而有所改變
   客戶電話：行動電話的開頭為 0，在試算表若無設定格式，則會視數字而不見
4. 標題

function myFunction() {
  let ws = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('day2');
  let range = ws.getRange(1, 1);
  range.setValue('流水號');
  range = ws.getRange(1, 2);
  range.setValue('客戶名稱');
  range = ws.getRange(1, 3);
  range.setValue('客戶電話');
  range = ws.getRange(1, 4);
  range.setValue('客戶地址');
  range = ws.getRange(1, 5);
  range.setValue('備註');
}

5. 函式(function)：通常會把處理事件的指令集合在一起，來完成事件，
   分析第1項，我們可以建立一個函式 setCellData(sheet, rowIndex, colIndex, value)
   setCellData：函式名稱，請不要重覆，若重覆則會以放在檔案列表的順序決定執行，最後面的檔案會要被執行
   sheet, rowIndex, colIndex, value：函式的參數，當我們調用函式時，可以透過參數傳遞「變數」進入函式
6. 像第1項的函式，我們會用「迴圈」來執行資料處理
   for...in ：物件 與 陣列 都可使用，物件迭代「屬性」、陣列迭代「索引」，不過迭代的變數的型態是「字串」，若有需要計算，記得轉型為「數字」
   https://developer.mozilla.org/zh-TW/docs/Web/JavaScript/Reference/Statements/for...in
7. 例：在 set_head_custom(), 調用 「setCellData()」

/*========================================
設定客戶標題列 
=========================================*/
function set_head_custom() {
  setCellData('day2', 1, 1, '流水號');
  setCellData('day2', 1, 2, '客戶名稱');
  setCellData('day2', 1, 3, '客戶電話');
  setCellData('day2', 1, 4, '客戶地址');
  setCellData('day2', 1, 5, '備註');
}
/*========================================
資料寫入單一儲存格 
=========================================*/
function setCellData(sheet, rowIndex, colIndex, value) {
  let ws = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheet);
  let range = ws.getRange(rowIndex, colIndex);
  range.setValue(value);
}

8. 將標題列整理成陣列資料，然後跑迴圈

/*========================================
設定標題列 
=========================================*/
function set_head_custom() {
  // setCellData('day2', 1, 1, '流水號');
  // setCellData('day2', 1, 2, '客戶名稱');
  // setCellData('day2', 1, 3, '客戶電話');
  // setCellData('day2', 1, 4, '客戶地址');
  // setCellData('day2', 1, 5, '備註');
  let headData = ['流水號', '客戶名稱', '客戶電話', '客戶地址', '備註']; //headData[0] =>  '流水號' 、headData[1] =>  '客戶名稱' .....
  let sheet = 'day2';
  let rowIndex = 1;
  for (let i in headData) {
    let colIndex = Number(i) + 1;//i 型態為字串，須轉為數字做計算
    setCellData(sheet, rowIndex, colIndex, headData[i]);
  }
}

此時 set_head_custom() 其實就是 寫入一列(一筆記錄)的函式
9. 設定客戶資料

/*========================================
設定客戶資料 
=========================================*/
function set_data_custom() {
  let sheet = 'day2';
  let rowIndex = 2;
  let customData = [1, '育將電腦', '0123456789', '台南市永康區大灣路158號', '備註1'];
  for (let i in customData) {
    let colIndex = Number(i) + 1;//i 型態為字串，須轉為數字做計算
    setCellData(sheet, rowIndex, colIndex, customData[i]);
  }
  rowIndex = 3;
  customData = [2, 'Google', '1234567890', '美國', '備註2'];
  for (let i in customData) {
    let colIndex = Number(i) + 1;//i 型態為字串，須轉為數字做計算
    setCellData(sheet, rowIndex, colIndex, customData[i]);
  }
}

10. 客戶資料，有二個地方需要調整
    

客戶電話：第1個'0'被吃掉了，因為儲存格的格式自動變成「數字」格式，如果資料是字串，則在寫入時需要特別處理，
setNumberFormat('@') ：將數字或日期格式，設為「字串」。
https://developers.google.com/apps-script/reference/spreadsheet/range?hl=zh-tw#setnumberformatnumberformat

新增資料，希望可以自動偵測寫入最後資料那列的下一列
getLastRow()：取得工作表的最後列指標
getLastColumn()：取得工作表的最後欄指標