
成果範例
Merging the monthly sales files of 9 shops into one Excel report
How it is run
python merge_sales.py --month 2026-10
2026-11-02 09:14:03 INFO Folder: sales/2026-10, 9 files found
2026-11-02 09:14:03 INFO shop-01.csv: 1,284 rows
2026-11-02 09:14:04 INFO shop-02.xlsx: 967 rows
2026-11-02 09:14:04 WARN shop-07.csv: 3 rows without a price skipped (lines 88, 412, 913)
2026-11-02 09:14:05 INFO Done: 10,412 rows -> report-2026-10.xlsx (sheets "Sales" and "Totals")
Settings, not code
The column names of each shop live in settings.ini, so a new shop or a renamed column is a line there:
[columns]
date = Date, Sale date, Day
product = Product, Item, Name
quantity = Qty, Quantity, Pcs
price = Price, Unit price
A part of the code
def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
"""Reads one shop's file and gives it the report's column names."""
table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
renamed = {}
for name, variants in columns.items():
found = next((c for c in table.columns if c.strip() in variants), None)
if found is None:
raise ReportError(f"{path.name}: no column for '{name}' (looked for {', '.join(variants)})")
renamed[found] = name
table = table.rename(columns=renamed)[list(columns)]
table["shop"] = path.stem
return table
Files: a ZIP archive with merge_sales.py (310 lines), settings.ini, requirements.txt and a README with installing Python, running the script and what each message in the log means. The client runs it on their own computer.
Client: a small chain of 9 stationery shops; each shop sends its sales for the month as a CSV or Excel file, with slightly different column names. Task: one script that reads every file in a folder, brings the columns to one shape, and writes a single Excel report with all sales and a sheet of totals by shop.
客戶與所有細節皆為虛構。
關於此服務
專案中有些人用 Airtable,有些人只用 Google 試算表,在兩者之間複製紀錄遲早會出錯。這個 Google Apps Script 會使用您自己的個人存取權杖,透過 Airtable 官方 API 讀取您的 base,並把您選擇的紀錄寫入試算表:一個資料表或一個檢視,您需要的欄位就是試算表的欄。標準版起,它會在每一列保存紀錄 ID,所以第二次執行時會更新資料列而不是重複新增,連結紀錄也會以名稱顯示。進階版會依您設定的「哪一方為準」規則,把試算表中的修改傳回 Airtable。您的權杖放在由您填寫的指令碼屬性中,絕不寫進程式碼。它依 Airtable API 允許的速度執行;附件會以連結形式帶過來。
包含內容
- 您會得到一個 ZIP 壓縮檔,內含 Apps Script 程式碼和 README,說明如何加到您的試算表、填入權杖並執行;訂單頁面上也會顯示程式碼。
- 官方 API使用您權杖的 Airtable 官方 Web API
- 欄位由您選擇一個資料表或檢視,只取您需要的欄位
- 不會重複標準版起,依紀錄 ID 對應資料列
- 權杖不寫進程式碼由您填入指令碼屬性
- 易讀的程式碼附有註解,日後很容易新增欄位
服務流程
- 1任務您說明 base、資料表和同步方向
- 2程式碼我們依 Airtable 的文件撰寫腳本和安裝說明
- 3試跑您用 base 的副本或測試用檢視執行
- 4修改您在方案範圍內提出修改,並附上任何錯誤訊息
需要您提供的資料
要同步的 Airtable 資料表或檢視,以及其欄位和欄位類型的截圖(文字、數字、日期、單選、連結紀錄、附件)、要寫入的試算表,以及欄名和順序。您需要的同步方向;雙向同步(進階版)請說明同一筆紀錄在兩邊都被修改時以哪一方為準。多久執行一次。請在您的 Airtable 帳戶中自行建立個人存取權杖;絕對不要提供給我們。
我們會詢問您:
- Airtable base 裡有什麼?
- 您需要哪個同步方向?
- 要帶過來哪些欄位?
- 多久要執行一次?
比較方案
付款保障
下單時付款,但只有在驗收成果後,款項才會撥付。
- 固定價格付款後,方案價格不會變動。
- 款項先行保留付款時,金額只會先保留,在您驗收後才會撥付給服務。
- 交付前檢查每份成果在交到您手上之前都會經過品質檢查,您也可以在驗收前於訂單頁面查看成果。
- 免費修改在需求說明範圍內,可依方案允許的次數提出修改。
- 3 天後自動驗收若您在交付後 3 天內未驗收也未提出修改,成果將自動驗收。若您在交付後於訂單聊天室留言,訂單會暫停自動驗收;我們回覆後,可能會重新起算 3 天,並會在聊天室中告知。
- 重新製作或全額退款若成果不符合您的需求說明且修改後仍未改善,或製作時間超過交付期限的兩倍,請在訂單聊天室留言:我們將重新製作,或全額退還款項。
常見問題
它是即時同步嗎?
不是。它在執行時才會複製:按下按鈕時,或依進階版的說明用時間觸發條件,例如每 15 分鐘一次。中間的變更會在下次執行時出現。
附件和連結紀錄會怎麼處理?
附件會以檔案連結的形式帶過來。標準版起,連結紀錄會以名稱顯示;基本版則顯示紀錄 ID。
試算表中的修改可以覆寫 Airtable 嗎?
只有進階版可以,而且只限您允許的欄位,並依您設定的「哪一方為準」規則。請先在 base 的副本上試試看。
你們會取得我 base 的存取權嗎?
不會。權杖由您建立,腳本也由您加到自己的帳戶中。我們依您的截圖和 Airtable 的文件工作。
沒有找到您要的答案?