> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 組裝指引

> 在 ERP 中從 CAD 模型為自製零件建立動畫式的逐步 3D 指南，發布它，並讓作業員在生產現場跟著做。

組裝指引會把自製零件的 CAD 模型變成有序的 3D 組裝指南：每個步驟指出它所安裝的元件，並顯示它們如何移動到位。作者在 ERP 中建立，作業員則在生產現場的[引導式組裝檢視](https://docs.alforse.com/zh-Hant/docs/reference/mes.md#the-guided-assembly-view)中跟著執行。

## 運作方式

指引屬於一個自製零件，並由該零件的 STEP 模型建立。它有版本：你編輯**草稿**、發布它，**組件**類型的工單工序則播放已發布的版本。工單保有自己的步驟副本，所以只有在某個版本被設為啟用，或有人同步它們時才會改變。

Alforse screenshot**組裝指引編輯器：左側是步驟清單，中間是 3D 模型，右側是所選步驟的詳細資料分頁，含組件與播放方塊**

三個窗格：步驟清單、3D 模型，以及所選步驟的設定。

## 建立指引

### 確認零件有模型

零件必須是自製的，並在其**模型**分頁上有 STEP 檔案。沒有的話，Alforse 無法建立 3D 檢視。

### 開始指引

前往**生產 → 組件**，選取**新增組裝指引**，並選擇**零件**。

### 讓 Alforse 準備

Alforse 會在需要時轉換模型以供 3D 檢視、開啟編輯器，並開始產生草稿步驟。

## 版本與狀態

<details>
  <summary>**草稿**</summary>

  可編輯。每個新指引與每個新版本都從此狀態開始。
</details>

<details open>
  <summary>**已發布**</summary>

  生效中。使用該指引的工單工序所遵循的就是這個版本。
</details>

<details>
  <summary>**已封存**</summary>

  被較新的啟用中版本取代；保留為唯讀供參考。
</details>

每個版本都是完整、獨立的副本。有兩個動作可在它們之間切換：

| 動作 | 可用於 | 效果 |
| - | - | - |
| **新增版本** | 已發布的指引 | 建立可編輯的草稿，起初帶有目前的步驟。 |
| **設為啟用** | 草稿 | 將它發布，並封存先前啟用中的版本。 |

HEADS UP

**將版本設為啟用，會更新已在進行中的工單。**

每一個使用此指引其他版本的工單工序，都會移到新版本並同步其步驟，除非該工序已完成或已取消，或其工單已鎖定。已完成工單上的工序保留它們建立時的步驟，所以其記錄維持準確。

## 建立步驟

### 產生或新增步驟

新的指引在你建立之前沒有步驟：

* **產生步驟**會執行動作規劃器，它算出組裝順序和每個零件無碰撞的路徑。通常需要一到三分鐘。
* **手動新增步驟**會建立一個空白步驟。

一旦有了步驟，**新增步驟**會再新增一個，拖曳某一列的把手則可重新排序。

**新增步驟**旁的規劃器選單還有兩個選項：

| 選項 | 效果 |
| - | - |
| **執行動作規劃** | 重新計算動作路徑，並保留目前的步驟順序。 |
| **重新產生步驟** | 以全新的計畫取代每個步驟。 |

只要有任何步驟是手動新增，或標示為**完成**，就會阻擋重新產生，這樣已檢查或手寫的工作絕不會被丟棄。

### 步驟狀態

點擊步驟列末端的圖示以變更其狀態：

<details>
  <summary>**待辦事項**</summary>

  手動新增，尚未檢查。
</details>

<details>
  <summary>**審查**</summary>

  由動作規劃器建立，等待作者確認文字與動畫。
</details>

<details open>
  <summary>**完成**</summary>

  已由作者檢查。
</details>

### 規劃器警告

步驟清單中的圖示指出規劃問題：

| 圖示 | 意義 |
| - | - |
| 警告三角形 | 規劃器找不到無碰撞的路徑。零件改為淡入到最終位置，而不是移動。 |
| 手 | 放置的零件可能會翻倒，可能需要治具或第二個人。 |

## 步驟詳細資料

**詳細資料**分頁包含作業員在該步驟閱讀並記錄的內容：

FieldType

<details>
  <summary>**類型**</summary>

  步驟要求的輸入種類。**任務**是單純的指示；其他類型則擷取值、對照最小與最大值檢查的量測、核取方塊、清單中的選項、時間戳記、人員、檔案或檢驗結果。
</details>

<details>
  <summary>**標題**</summary>

  選填。留空時，Alforse 會以步驟的元件命名，例如「Add Bearing (×2)」。
</details>

<details>
  <summary>**指示**</summary>

  面向作業員的文字。輸入 `@` 可引用品項物料清單中的零件。
</details>

<details>
  <summary>**必填**</summary>

  開啟時，在作業員記錄此步驟之前，工序無法完成。
</details>

NOTE

**兩種儲存方式**

這四個欄位只有在你選取面板底部的**儲存**，或按 ⌘/Ctrl+Enter 時才會儲存。步驟上的其他一切（元件、隱藏零件、播放設定、狀態、物料、工具與投影片）則在你變更時立即儲存。

## 元件與隱藏零件

**組件**列出步驟所安裝的零件。

### 挑選零件

選取**新增**，然後在 3D 檢視中點擊零件。按住 Shift 點擊可一次新增數個。

### 確認

選取**完成新增**。若之後要移除某個零件，請使用其列上的 ✕。

### 隱藏礙事的零件

如果某個零件妨礙工作，請點擊**組件**分頁中其列上的眼睛。該零件只會在所選的步驟消失，其他步驟不受影響。隱藏的零件會集中在**在此步驟隱藏**清單中，你可以在那裡恢復它們。

適用兩條規則：步驟自己的元件絕不能在該步驟隱藏，而且作業員看到的正是你所隱藏的內容。

## 播放設定

**播放**方塊控制步驟如何動畫呈現。

### 動作

| 狀態 | 意義 |
| - | - |
| 「自動」 | 使用規劃器找到的路徑。 |
| 「自訂路徑」 | 路徑是你畫的。**重設**會還原規劃器的路徑。畫出的路徑也會取代「沒有明確路徑」。 |
| 「沒有明確路徑」 | 規劃器找不到路徑。將滑鼠移到標題備註上，可看到是哪些零件阻擋了它。 |

**編輯路徑**會在 3D 檢視中將路徑顯示為紅色的路徑點，並在所選路徑點的姿態處顯示零件的透視副本：

* 拖曳路徑點以改變路徑形狀。
* 對路徑按兩下以新增路徑點。
* 按 Delete 以移除所選的路徑點。

零件在移動途中也可以旋轉。將檢視器的**移動／旋轉**控制設為**旋轉**，所選路徑點周圍就會出現環。拖曳環會以 15° 為增量旋轉該點的零件，這就是你在零件進場途中將它翻面的方法。回到**移動**可重新定位路徑點。

### 相機

| 狀態 | 意義 |
| - | - |
| 「自動」 | Alforse 自行取景步驟的零件。直立組裝上產生的步驟，會從規劃器選擇的角度觀看。 |
| 「已儲存的檢視」 | 以**使用目前檢視**設定，它會儲存你目前的角度。**清除**（只在此狀態顯示）會回到自動。 |

### 方向

方向會讓整個組裝為了某一步驟而翻轉，例如翻面，讓零件可以裝到它的底面。

| 按鈕 | 旋轉 |
| - | - |
| **翻面（Flip over）** | 半圈，上下顛倒。 |
| **朝你傾倒（Tip toward you）**／**遠離你傾倒（Tip away from you）** | 四分之一圈，側躺。 |
| **向左轉（Spin left）**／**向右轉（Spin right）** | 在工作台上轉四分之一圈。 |

旋轉是相對於你目前的觀看角度，而且在組裝旋轉時攝影機不會移動。之後該列會將位置回報為「直立」、「上下顛倒」或「側躺」。

方向如何延續的規則：

* **後續步驟會繼承它。**同一個組裝的下一個步驟會保留該方向，顯示為例如「上下顛倒，自步驟 11 起」，直到另一個步驟轉動它。在播放中，該步驟的零件進場之前，組裝會先翻轉。
* **旋轉可以儲存檢視。**如果步驟沒有已儲存的檢視，而旋轉使組裝處於被轉動的狀態，你所觀看的檢視也會被儲存，因此相機列顯示「已儲存的檢視」，播放時以該角度顯示該步驟。把組裝轉回來會保留該檢視；相機列上的**清除**會讓它回到自動。
* **子組件是分開的。**子組件從直立開始，並保有自己的方向。
* **重設**會讓步驟取得其前一步驟的方向。

### 子組件路徑

安裝子組件的步驟，每個子組件都有一列。保持「自動」時，完成的單位會從組裝的側面滑入。**編輯路徑**讓你用與零件相同的路徑點和旋轉環工具繪製該單位的路線；**重設**則還原為自動。

## 子組件

實際的組裝常常是先單獨組裝一個單位，再整體安裝上去。例如，輪轂先在工作台上裝好軸承、扣環和煞車碟盤，然後才安裝到後拖臂上。子組件將此建模為一組具名的步驟，單獨建造，然後併入主組裝。

### 建立與整理

| 動作 | 位置 | 效果 |
| - | - | - |
| **製造子組件** | 步驟的選單 | 建立以該步驟為第一個步驟的子組件。 |
| 將步驟拖曳到它上面，或**移入** | 步驟的選單 | 將該步驟加入子組件。 |
| **移出子組件** | 步驟的選單 | 將步驟送回主清單。 |
| **取消群組** | 子組件 | 移除群組並將其步驟留在主清單中。 |
| **刪除子組件** | 子組件 | 連同其步驟一起移除群組。 |

成員步驟在其群組之下編號：子組件 4 包含 4.1、4.2，依此類推。

對子組件按兩下，或選擇**開啟子組件**，會將它隔離：步驟清單和 3D 檢視限於它自己的步驟與零件，**新增步驟**則在其內建立步驟。選取**所有步驟**可再次看到完整的指引。

### 去向

選取子組件會顯示它的名稱、它的步驟，以及**去向**區段：

FieldType

<details>
  <summary>**用於**</summary>

  哪個較後面的步驟安裝完成的單位。預設的\*\*主組裝（在其最後一個步驟之後）\*\*表示沒有步驟安裝它，它在自己的步驟之後直接併入組裝。
</details>

<details>
  <summary>**指示**</summary>

  只在預設時出現。單位併入主組裝時作業員閱讀的文字。
</details>

<details>
  <summary>**子組件路徑**</summary>

  只在預設時出現。單位進入主組裝的路線，以**編輯路徑**繪製。
</details>

<details>
  <summary>**相機**</summary>

  只在預設時出現。該時刻的觀看角度，以**使用目前檢視**儲存。
</details>

你也可以從安裝它的步驟連結：步驟上的**使用子組件**會選取一個完成的子組件，該步驟的列隨後會顯示，例如**使用 4**。

### 如何播放

播放時會先依序執行子組件自己的步驟。在使用它的步驟，完成的單位會移入，若有繪製的路徑則沿著該路徑，否則從側面滑入。

* 有自己路徑的單位會在該步驟的其他零件移動之前到達。
* 當一個步驟安裝數個單位時，它們會一個接一個到達。
* 選取子組件後按播放，會從它的第一個步驟開始建造。

NOTE

**只有一層巢狀。**

子組件不能巢狀。要把一個單位放進另一個單位，請從另一個單位的步驟來安裝它。安裝的步驟必須在子組件之後，且不能是它的成員。

## 物料、工具與投影片

| 分頁或動作 | 目的 |
| - | - |
| **BOM** 分頁 | 將步驟連結到它從品項物料清單消耗的零件，以及它所需的工具。 |
| **比對 BOM**（在**組件**中） | 將 3D 元件比對到物料清單品項，並填入每個步驟的物料。 |
| **投影片**分頁 | 新增作業員在此步驟看到的相片、PDF 或額外的 3D 模型。 |

## 在工單與生產現場

你把指引附加到品項製程清單上的**組件**[工序](https://docs.alforse.com/zh-Hant/docs/reference/jobs.md#operation-type)。每張新工單在建立時會取得指引步驟的副本。

工單不會自動採用之後的編輯。請在工單工序上執行**同步組裝步驟**來拉入：由指引衍生的步驟會被更新或刪除以符合，而在工單上手動新增的步驟則保留。

作業員在[引導式組裝檢視](https://docs.alforse.com/zh-Hant/docs/reference/mes.md#the-guided-assembly-view)中看到結果，步驟、隱藏零件與子組件都相同。他們記錄的是子組件的每個成員步驟，而不是群組。指引的步驟會放在工序已有的任何步驟之後。

## 權限

編輯指引需要同時符合兩件事：版本必須是**草稿**，而且你必須擁有生產模組的**更新**權限。沒有該權限，即使是草稿，編輯器也會以唯讀開啟。請見[權限與存取](https://docs.alforse.com/zh-Hant/docs/reference/permissions.md)。

## 疑難排解

每個項目都列出訊息或症狀、它為什麼出現，以及該怎麼做。

### "The selected item has no 3D model. Upload a STEP file on the item's Model tab first."（所選品項沒有 3D 模型。請先在品項的模型分頁上傳 STEP 檔案。）

* **原因：**在**新增組裝指引**中選擇的零件沒有 STEP 檔案。
* **解決方法：**在品項的**模型**分頁上傳一個，然後再次開始指引。

### "Only draft instructions can be edited"（只有草稿指引可以編輯）

* **原因：**你正在變更已發布或已封存的版本，而它們是凍結的。
* **解決方法：**在已發布的版本上選取**新增版本**，並在新的草稿中進行變更。

### 草稿的編輯器是唯讀的

* **原因：**你的帳號缺少生產**更新**權限。
* **解決方法：**請管理員授予。

### "Steps already exist — delete them before generating from the plan"（步驟已存在——請先刪除再依計畫產生）

* **原因：****產生步驟**只會為尚無步驟的指引建立計畫。
* **解決方法：**先刪除現有步驟，或使用規劃器選單中的**重新產生步驟**。

### "Some steps are locked — cannot regenerate"（部分步驟已鎖定——無法重新產生）

* **原因：**至少有一個步驟是手動撰寫或標示為**完成**；重新產生會丟棄那些工作。
* **解決方法：**保留步驟並選擇**執行動作規劃**，它會更新路徑而不動步驟順序。

### "The geometry service is offline — motion planning is unavailable right now."（幾何服務離線——動作規劃目前無法使用。）／"The geometry service is unavailable — motion planning can't run right now."（幾何服務無法使用——動作規劃目前無法執行。）

* **原因：**無法連線到動作規劃器，所以**產生步驟**被停用。
* **解決方法：**服務恢復後再試。期間仍可手動新增步驟。

### "Motion planning is already running"（動作規劃已在執行中）

* **原因：**此指引的規劃執行尚未完成。
* **解決方法：**等待；一次執行通常需要一到三分鐘。

### "This instruction has no processed model"（此指引沒有處理過的模型）／"The model must finish converting before planning"（模型必須先完成轉換才能規劃）

* **原因：**CAD 模型尚未完成供 3D 檢視的轉換。
* **解決方法：**讓轉換完成，然後開始規劃。

### "This step is already a sub-assembly"（此步驟已是子組件）／"This step is already in a sub-assembly"（此步驟已在子組件中）

* **原因：**對已經是子組件、或已屬於某個子組件的步驟使用了**製造子組件**。
* **解決方法：**挑選主清單中的步驟，或先以**移出子組件**將它移出。

### "A sub-assembly can't be inside another sub-assembly"（子組件不能在另一個子組件內）

* **原因：**巢狀僅限一層。
* **解決方法：**讓內層群組保持獨立，並以外層步驟上的**使用子組件**來安裝它。

### "A sub-assembly can only be used after it is built"（子組件只能在建造完成後使用）／"A sub-assembly can't be used by one of its own steps"（子組件不能被其自己的步驟使用）

* **原因：**選來安裝該單位的步驟位於子組件之前，或就是它的成員之一。
* **解決方法：**選擇子組件之外、較後面的步驟。

### "A sub-assembly's steps must come directly before it"（子組件的步驟必須直接位於它之前）

* **原因：**子組件的步驟必須直接位於清單中其標題之上，而這項變更會破壞該規則。
* **解決方法：**讓群組保持在一起；以**移入**或**移出子組件**變更成員。

### "This job is locked — steps can't be synced to it"（此工單已鎖定——無法將步驟同步到它）

* **原因：****同步組裝步驟**絕不會變更已鎖定的工單。
* **解決方法：**不需處理；工單保留它建立時的步驟。

### "Failed to make assembly instruction active"（無法將組裝指引設為啟用）

* **原因：**發布草稿未在伺服器上完成。
* **解決方法：**重試**設為啟用**。

## 相關內容

**MES 應用程式**

作業員跟著指引做的地方，包括建造、聚焦與完整可見度模式。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/mes.md#the-guided-assembly-view)

**工單**

其組件工序帶有步驟副本的製令。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/jobs.md)

**方法與供應來源**

每個步驟的物料所選自的物料清單。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/methods.md)

**權限與存取**

誰可以編輯與發布指引。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/permissions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.