交付與交換 / X5 · CSV

CSV 交付比 ALE 多帶什麼、少帶什麼

CSV 明細表和 ALE 清單不是同一份資料換個副檔名。CSV 面向人和表格工具逐欄檢視,ALE 則是給接收流程讀取的交換清單;兩者的取值範圍、缺值寫法、編碼和欄位語義都不同。CSV 會帶出更多機位與拍攝參數,但它仍然不是媒體清單,也不提供聲道映射或聲音時碼。

格式不同,重要的不只是「多幾欄」,而是每一欄從哪裡來、準備給誰核對。

CSV 多帶的是機位與拍攝明細

相較 ALE,CSV 會帶出更多鏡頭與機位層資訊。焦段、濾鏡、感光度、光圈、快門、畫幅、解析度,以及景別、角度、運動等構圖資訊,都屬於這份表格明細能夠表達的範圍。

它還會寫入若干狀態位,包括特效、底板、淨景和參考等機位狀態,並帶拍攝日期。這裡要保留一個重要邊界:交付表裡存在一欄,不等於 App 目前就有對應的現場錄入入口。某些聲音狀態欄雖然出現在檔案結構中,但不能據此宣傳成已經可記錄的能力。

條備註與機位備註也會分開進入不同欄。產生 CSV 時,備註裡的換行、回車和製表符會被壓成空格,因此不能承諾「備註原樣保留」。接收方看到的是經過表格化處理後的文字。

兩欄檔位不能當成同一件事

CSV 裡有一欄文字檔名,也有一欄布林 Circle。文字檔名會寫成 Circle、Keep、Hold、N/G;未標記時可以為空。布林 Circle 欄則只有目前文字檔名為 Circle 對應的那一檔才寫 TRUE,其他情況寫 FALSE。

這意味著,現場把一條標成 Keep 時,文字檔名欄會明確寫 Keep,但布林 Circle 仍然是 FALSE。因此不能把布林欄直接解釋成「這一條在現場有沒有被圈過」的完整語義。它只是由特定檔位條件派生出來的一個布林值。

讀 Rating 是在讀文字檔名;讀 Circle 是在讀一個更窄的派生條件。兩欄不能互相替代。

這也是接收方需要逐欄建立映射的地方。如果自己的表格範本只看布林欄,就會漏掉文字檔名中仍然有意義的其他狀態;如果只看文字欄,也不能假定它等於 App 內部其他狀態欄位。

CSV 仍然沒有媒體位置和聲音映射

欄位更多,不等於這份檔案承擔了媒體關聯的全部資訊。目前 CSV 不寫素材路徑,也沒有聲道映射和聲音時碼。接收方如果需要知道媒體檔案實際放在哪裡、哪條聲道對應什麼聲音來源,必須從素材與其他交接記錄補齊。

同樣,表格裡出現 Filename、卷號或片段號,並不讓它自動變成一份可以直接定位全部媒體的清單。身份欄位需要和實際素材檔案名、卷號及現場記錄交叉核對。

編碼和清洗規則也與 ALE 不同

CSV 落盤時會帶位元組順序標記,而 ALE 不帶。兩份檔案都使用 LF 換行,但接收環境對編碼與換行的處理需要實際驗證。出現亂碼或欄位錯位時,應該先檢查編碼、分隔與文字清洗,不要先假定內容欄位本身錯了。

CSV 的每一個資料值會經過自己的轉義路徑。換行和製表會被壓平;包含逗號或雙引號時會按目前規則加引號和轉義。這個行為適合目前的產生方式,但不應被擴大成對某個外部 CSV 規範的合規承諾。

日期也不是所有交付物一套口徑

CSV 的日期欄固定寫成公曆機器格式 yyyy-MM-dd。另一類報告的頁首日期則跟著裝置環境的日期格式設定。兩者服務不同閱讀場景,因此不能寫成「所有交付物裡的日期一定逐字相同」。

如果接收方要做跨檔案對表,應先把日期欄位的格式差異當成預期條件,再核對它們是否指向同一天。字串不同不必然表示日期不同;字串相同也不能替代對來源記錄的確認。

FAQ

CSV 比 ALE 多出來的主要是什麼?

主要是更細的機位、光學、構圖、狀態和日期明細,例如焦段、濾鏡、感光度、光圈、快門、解析度、景別、角度和運動等。

Rating 和 Circle 兩欄為什麼可能看起來矛盾?

因為它們不是同一來源語義。Rating 寫文字檔名,而布林 Circle 只在檔名為 Circle 的那一檔寫 TRUE。一條 Keep 因此會同時出現 Rating=Keep 與 Circle=FALSE。

CSV 會把備註原樣保留下來嗎?

不會逐字元原樣保留。換行、回車和製表符會在產生時壓成空格,接收方看到的是適合表格行結構的處理結果。

CSV 有了更多欄位後,能不能直接找到素材和聲音聲道?

不能。目前檔案仍不包含素材路徑、聲道映射或聲音時碼。媒體位置與聲音關係需要從素材和其他交接資訊中核對。


Axiom One LLC — SlateX。以上數字截至 2026-09-24。