# Excel 匯入

### 01｜Excel 首次匯入

進入材料管理頁面後，請遵循以下步驟執行匯入作業：

{% stepper %}
{% step %}

#### 下載 Excel 模板

1. 開啟下載視窗，點選畫面右上方的 ![](/files/QRaKAoDosxJrt6vQjPVU) 圖示。

<figure><img src="/files/etIM2KZKF4YORHjSTsi5" alt=""><figcaption><p>圖一 - 點選<kbd><mark style="color:green;"><strong>Excel匯入</strong></mark></kbd></p></figcaption></figure>

2. 下載標準模板：在開啟的視窗中，點擊 ![](/files/6gka2s4zWQVqrL8k34at)。請務必使用系統提供的原始模板進行資料填寫，以確保資料格式能精確對應。

<figure><img src="/files/QNbAA6syhKeoJAQkGHnS" alt=""><figcaption><p>圖二 - 下載模板</p></figcaption></figure>

**【Excel 模板填寫規範與補充】**

<table><thead><tr><th width="198.890380859375">欄位名稱</th><th>填寫規範與實務建議</th></tr></thead><tbody><tr><td>廠商（選填）</td><td><p></p><p>此欄位為「選填」，系統會根據填寫內容執行不同的自動歸類動作：</p><ul><li><strong>若欄位留白（未填寫）：</strong> 系統將自動將該筆工項歸類於『未指派』分類。這適合用於專案初期 WBS 規畫，或是尚未確定分包對象的工項建置。</li><li><p><strong>若有填寫廠商名稱：</strong> 系統將啟動自動偵測機制，並產生以下兩種結果：</p><ol><li>廠商已存在： 若填寫的名稱與專案內已建置的廠商名稱<strong>完全一致</strong>，系統會自動將工項新增至該廠商名下。</li><li>廠商不存在： 若系統偵測不到相同名稱，將會直接以您填寫的名稱「自動建立一筆新協力廠商資料」，並將工項掛載其下。</li></ol></li></ul></td></tr><tr><td>合約（選填）</td><td>填寫該材料所屬的合約名稱，配合廠商欄位。同廠商下可區分不同合約（如：水泥採購、紅磚供應），以利後續針對單一合約進行增補紀錄管理與對帳。 <strong>若未填寫：</strong>系統將自動歸類於該該廠商下的『沒有合約』分類，方便後續再行手動調整歸屬。</td></tr><tr><td>分類<mark style="color:red;"><strong>（必填）</strong></mark></td><td>定義材料屬性（如結構材、裝修材、機電設備）。</td></tr><tr><td>材料或設備編號<mark style="color:red;"><strong>（必填）</strong></mark></td><td>填入材料識別碼（如：01, 02...）。<br>唯一性限制： 同個專案下，編號絕對不可重複，否則將導致匯入失敗或數據新增異常。</td></tr><tr><td>材料或設備名稱<mark style="color:red;"><strong>（必填）</strong></mark></td><td>須與採購契約或規範之品名完成一致（如4000psi 預拌混凝土、D13 鋼筋）。建議標註規格，方便現場人員進行離線點交時核對。</td></tr><tr><td>單位<mark style="color:red;"><strong>（必填）</strong></mark></td><td>填入營建常用單位（依標案需求填寫，沒有限制）。</td></tr><tr><td>契約數量<mark style="color:red;"><strong>（必填）</strong></mark></td><td>填寫合約原始總量。<br>僅限填寫數字，不可包含任何文字或符號。</td></tr><tr><td>單價<mark style="color:red;"><strong>（必填）</strong></mark></td><td>填入合約原始單價。<br>系統匯入後自動計算複價，即為該資材在全案中的價值權重。</td></tr></tbody></table>

<figure><img src="/files/p9uzVcG2HEwHEPv82pql" alt=""><figcaption><p>圖三 - 材料模板</p></figcaption></figure>
{% endstep %}

{% step %}

#### 填寫 Excel 模板

**【重要警告】Excel 模板規範與格式限制**

由於系統必須精確判讀各項資料，請在填寫 Excel 材料模板時，務必嚴格遵守以下規範：

{% tabs %}
{% tab title="嚴禁變動模板結構" %}

* **勿自行添加欄位：**&#x8ACB;勿在模板中插入任何自訂的欄位、欄位名稱或備註資訊。系統後台已固定讀取位置，多出的欄位將導致資料偏移，進而引發匯入錯誤或數據錯位。
* **勿漏項必填欄位**：標註為必填(**\***) 的項目（如：分類、材料編號、名稱、單位、數量、單價）絕對不可留白。一旦缺少核心數據，系統將無法建立該材料，甚至導致整份檔案匯入失敗。 **禁止公式運算：**&#x8ACB;直接填寫「數值」，切勿在數量或單價欄位中使用 Excel 公式（如：`=SUM(...)`）。
  {% endtab %}

{% tab title="格式純淨化原則" %}

* **禁止公式運算：**&#x8ACB;直接填寫「數值」，切勿在數量或單價欄位中使用 Excel 公式（如：`=SUM(...)`）。
* **禁止特殊格式化：**&#x8ACB;勿對表格進行儲存格合併、更改字體顏色或加上框線樣式。維持模板原始的純淨格式，能確保匯入過程的穩定性。
  {% endtab %}

{% tab title="數據填寫邏輯" %}

* **單位一致性：**&#x8ACB;參照系統建議的營建常用單位填寫。
* **廠商名稱精確度：**&#x5982;前所述，若欲將材料新增至已建立的廠商，名稱必須與系統內完全一致。差一個空格或符號，系統就會視為新廠商而重複建立。
  {% endtab %}
  {% endtabs %}

<figure><img src="/files/UCB7ybvEMwHbzJTrqpng" alt=""><figcaption><p>圖四 - 填寫模板</p></figcaption></figure>
{% endstep %}

{% step %}

#### 上傳 Excel 模板

材料檔案填寫完畢並確認格式無誤後，請依序執行以下步驟完成匯入：

1. 開啟匯入視窗：點選材料管理頁面右上方之 ![](https://docs.jobdone.cc/user_guide/~gitbook/image?url=https%3A%2F%2F2002560121-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FEqUCL3D5WQfpxJw8NL3P%252Fuploads%252FDCq3UvinUhprNmos590W%252Fimage.png%3Falt%3Dmedia%26token%3D4c016ce2-a779-41cd-bc1b-114c6874aa0b\&width=300\&dpr=3\&quality=100\&sign=a6f23bf9\&sv=2) 圖示。

<figure><img src="/files/EJSDHvsxpHMmWwGu0ku3" alt=""><figcaption><p>圖五 - 點選<kbd><mark style="color:green;"><strong>Excel匯入</strong></mark></kbd></p></figcaption></figure>

2. 上傳檔案：於『Excel 模板檔案上傳』欄位，選擇或拖曳您填寫完畢的 Excel 檔案。
3. 執行匯入：點選 ![](https://docs.jobdone.cc/user_guide/~gitbook/image?url=https%3A%2F%2F2002560121-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FEqUCL3D5WQfpxJw8NL3P%252Fuploads%252FfISMZNiZ4ooxWWx6aKkP%252Fimage.png%3Falt%3Dmedia%26token%3Df0ef7e77-f4f3-45f5-b500-6936f3bbad0b\&width=300\&dpr=3\&quality=100\&sign=37457733\&sv=2) 按鈕，系統將開始判讀資料並自動建置廠商、合約與材料。

<figure><img src="/files/hTOjSzOU4WJcgv0hvEl5" alt=""><figcaption><p>圖六 - 上傳檔案</p></figcaption></figure>

完成畫面如下：

{% hint style="info" %}

#### 實務說明與最終檢查

* **資料核對：**&#x532F;入成功後，系統會自動跳轉至材料清單。建議立即核對總筆數是否正確，以及各材料的『契約複價』是否與原始價單一致。
* **錯誤排除提醒：**&#x82E5;匯入過程中出現錯誤提示，通常是因『編號重複』或『必填欄位漏項』所致。請修正 Excel 檔案後，再次執行匯入，以維持資料的純淨性。

**透過 Excel匯入後，若您需要更動/增加材料資訊，則可 手動編輯 或 再次匯入Excel。**

**（請注意，**<mark style="color:red;">**再次匯入並不會覆蓋原有檔案，且若再次匯入之材料編號不可與既有資料重複**</mark>**。因此，**<mark style="color:red;">**若需修改資料則請手動修正；若需額外添加材料則可再次執行 Excel匯入**</mark>**。）**
{% endhint %}

<figure><img src="/files/8G28SR4Nm0LisMeVZ3mH" alt=""><figcaption><p>圖七 - 完成畫面</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### 02｜Excel 重複匯入

在材料管理模組中，Excel 匯入功能具備較高的操作彈性。與「施工項目」必須在完全無資料狀態下才能匯入的限制不同，材料管理支援在既有資料庫的基礎上進行「重複匯入」。

為了確保工程材料數據的嚴謹性，系統在執行重複匯入時遵循以下邏輯：

{% tabs %}
{% tab title="非覆蓋原則" %}
系統採取「僅增補、不覆蓋」機制。匯入作業不會對系統內已存在的既有資料進行任何修改、替換或刪除
{% endtab %}

{% tab title="編號唯一性檢核" %}
系統以「材料編號」作為唯一識別基準。若 Excel 表單中欲匯入的材料編號與系統既有編號重複，該筆資料將會被判定為重複而導致匯入失敗。&#x20;
{% endtab %}
{% endtabs %}

{% hint style="info" %}

#### 實務應用

基於上述機制，此功能在管理實務上具備明確的適用範圍：

1. 適用於「批次新增材料」： 當專案進入不同施工階段（如由結構轉裝修期），需額外納入大量新型號材料、五金配件或新進場物資時，可直接整理成 Excel 檔進行增補匯入，無需清空原有的材料清單。
2. 不適用於「既有資料修改」： 若需針對已在系統內的材料進行單價、規格描述或分類異動，透過再次匯入 Excel 的方式將無法達成（因編號重複會被系統攔截）。此類修改需求應直接於系統介面進行編輯，或透過專門的資料更新功能處理。
   {% endhint %}

{% stepper %}
{% step %}

#### 填寫 Excel模板

請參考下圖圖示，依據系統提供的 Excel 範本填寫欲新增之材料項目：

<figure><img src="/files/Oiap8K9IiXq1VdZbSVut" alt=""><figcaption><p>圖八 - 填寫材料模板 </p></figcaption></figure>
{% endstep %}

{% step %}

#### 上傳 Excel模板

材料檔案填寫完畢並確認格式無誤後，請依序執行以下步驟完成匯入：

1. 開啟匯入視窗：點選材料管理頁面右上方之 ![](https://docs.jobdone.cc/user_guide/~gitbook/image?url=https%3A%2F%2F2002560121-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FEqUCL3D5WQfpxJw8NL3P%252Fuploads%252FDCq3UvinUhprNmos590W%252Fimage.png%3Falt%3Dmedia%26token%3D4c016ce2-a779-41cd-bc1b-114c6874aa0b\&width=300\&dpr=3\&quality=100\&sign=a6f23bf9\&sv=2) 圖示。

<figure><img src="/files/Vmz8I42ZI5m0QqNAPzNR" alt=""><figcaption><p>圖九 - 點選<kbd><mark style="color:green;"><strong>Excel匯入</strong></mark></kbd></p></figcaption></figure>

2. 上傳檔案：於『Excel 模板檔案上傳』欄位，選擇或拖曳您填寫完畢的 Excel 檔案。
3. 執行匯入：點選 ![](https://docs.jobdone.cc/user_guide/~gitbook/image?url=https%3A%2F%2F2002560121-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FEqUCL3D5WQfpxJw8NL3P%252Fuploads%252FfISMZNiZ4ooxWWx6aKkP%252Fimage.png%3Falt%3Dmedia%26token%3Df0ef7e77-f4f3-45f5-b500-6936f3bbad0b\&width=300\&dpr=3\&quality=100\&sign=37457733\&sv=2) 按鈕，系統將開始判讀資料並自動併入或建置廠商、合約與材料。

<figure><img src="/files/rKwmGJUtZliSNQIBzVDv" alt=""><figcaption><p>圖十 - 上傳新增材料</p></figcaption></figure>

完成畫面如下：

<figure><img src="/files/vfRgqQJ5n0N5PkiBejb6" alt=""><figcaption><p>圖十一 - 完成畫面</p></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.jobdone.cc/user_guide/cpm/project_level/project_data/material_management/cheng-lan-shang-he-yue-ge-shi/excel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.