新增自訂特徵
Custom features (and custom tables) are written in a programming language called FeatureScript and are created in an Onshape tab called a Feature Studio. These custom features are able to be added to your Feature toolbar for use in documents to which you have write access. Custom tables are available immediately in the document in which they are created, and you can add them to any other document (from a version). See Custom Tables for more information on adding custom tables to Part Studios, and FeatureScript Custom Tables for information on creating custom tables in FeatureScript.
在特徵工具列中:
Custom features are written in a programming language called FeatureScript and are created in an Onshape tab called a Feature Studio. These custom features can be added to your Feature toolbar for use in documents to which you have write access.
您可以將在其他文件中定義的自訂特徵加入到您的工具列中,也可以將在同一工作區中定義的自訂特徵加入到您的工具列中。
將來自您有「檢視、複製& 匯出」最小權限集合文件的自訂特徵加入到您的特徵工具列中。您可以在您有寫入權限的 Part Studio 中加入自訂特徵,或在正檢視的版本中包含定義特徵的 Feature Studio 時加入自訂特徵。
- While in a Part Studio, click on the Feature toolbar.
- In the dialog, locate the document in which the desired custom feature is defined:
- FeatureScript samples - This filter lists all Onshape-supplied documents containing FeatureScript samples for you to try.
- Onshape standard filters - Use these filters as you do on the Documents page to locate a specific document.
- Search box - Enter the name of a document or paste the URL of a document containing FeatureScript (usually acquired through a Share action).
自訂特徵是與其他文件的特定版本連結;根據預設會選擇最新的版本。如果沒有可用的版本,可以要求文件擁有者 (或其他有寫入存取權限的人) 建立一個版本。
- 按一下文件名稱來顯示於其中定義的自訂特徵。
- Select the top level icon to insert all custom features inside it (each represented by its own icon on your toolbar), or select one feature.
The custom feature icon appears on the Feature toolbar.
若要在關閉對話方塊之前移除自訂特徵,請在對話方塊中再次選擇自訂特徵 (這會將自訂特徵移進或移出工具列中)。
- If there is more than one version of the document, the latest version is displayed by default. Click to access the version graph and select a different version.
- 按一下對話方塊右上角的 X 來關閉對話方塊。
現在即可使用出現在您特徵工具列上的自訂特徵。
使用自訂特徵
Using a custom feature creates a feature in the Part Studio Feature list, just like any other Onshape feature. Custom features linked to from another document are indicated in the Feature list by this icon .
自訂特徵的行為模式與其他的 Onshape 特徵類似;您可以編輯、抑制、隱藏與刪除自訂特徵。
更新自訂特徵
當建立自訂特徵來源文件有較新版本時,在特徵清單中的連結圖示會以藍色強調顯示,同樣的圖示也會出現在 Part Studio 分頁中:
這僅做為通知之用,您不需要採取任何行動。
更新自訂特徵所使用的版本:
- 按一下更新的圖示 (或在特徵上按右鍵然後選擇 [更新連結的文件]) 來存取「參考管理員」,您可以在其中選擇更新的選項。
- 更新至最新的版本,按一下 [全部更新]。
- To update to a specific version:
- Click Selective update:
- Select the document (if there is more than one) and click for that document:
- 選擇要更新至的版本。
- 如果需要,為其他文件重複這些步驟。
- 按一下 [更新所選項目]。
If a feature in a user's Feature list corresponds to a tool added by the admin, the feature will not show as out-of-date (even if the tool is) but if it is not from the same version as the tool it will show as out-of-sync .
參考管理員的 [全部更新] 指令會將未同步特徵更新為工具列中的版本,即使該版本是低於最新的版本或低於特徵目前來自於的版本。使用者可以點按圖示並使用 [更新] 指令來更新工具:
移除自訂特徵
若要從工具列中移除自訂特徵,在工具列的圖示上按右鍵並選擇移除。
當編輯 Part Studios 時,自訂特徵將不會再出現於工具列中,除非該特徵已被使用並存在於特徵清單中。如果特徵清單中包含了自訂特徵,且您的工具列中沒有相對應的自訂特徵圖示 (有可能是因為已被移除,或文件是與您共享而您的工具列中從未包含該圖示),則在這個 Part Studio 中的連結自訂特徵圖示出現在工具列中,且可從下拉清單中存取自訂特徵:
這樣可讓可存取該 Part Studio 的使用者繼續使用自訂特徵。
開啟有連結自訂特徵的文件
要再次熟悉您文件中的自訂特徵與其操作方式,在工具列上的自訂特徵圖示上按右鍵,然後選擇 [開啟連結的文件]。包含自訂特徵 Feature Studio 的文件會在另一個分頁中開啟。
If you have written your own custom feature in this workspace, the custom features defined in it are automatically available for use from the Custom features drop down in the Feature toolbar:
- 按一下圖示來列出於此工作區定義的所有自訂特徵:
- 選擇要使用的自訂特徵。
當定義特徵的 FeatureScript 被編輯與提交時,來自目前工作區的自訂特徵會自動更新。這對設計自訂特徵時的快速測試相當有用。
共享自訂特徵
將您的自訂特徵設定為可讓他人使用:
- 建立一個包含自訂特徵 FeatureScript 的文件版本。
- Either:
- 將文件與特定的個人或團隊共享,最少給定「可以檢視、複製與匯出」的權限。
- 或是將文件設定為公開的。
A custom feature icon is specified by uploading the icon as an SVG blog tab in the document, and then referencing it. For more information, see the instructions in Custom Icons in the FeatureScript documentation.
A description image is a picture of the feature output and is specified by uploading the image as an SVG blog tab in the document, and then referencing it. For more information, see the instructions in Custom Icons in the FeatureScript documentation.
如果在您的文件中包含有您要發佈並將其公開的自訂特徵,您可以在建立文件的新版本時進行,或直接在「版本與歷程」面板中的版本適境功能表中操作。這樣同時會更容易搜尋包含公開自訂特徵的文件。
-
在 Feature Studio 分頁中建立包含自訂特徵的公開文件。詳細資訊請參考新增自訂特徵。
-
在同一文件中,按一下插入新分頁圖示 (),然後建立使用自訂特徵的 Part Studio。
-
在同一文件中,按一下插入新分頁圖示 (),然後按一下 [匯入]。找出並匯入 PDF 檔案。通常這是一個說明自訂特徵的說明性文件。
-
Click the Versions and history icon () to open the Versions and history panel.
-
按一下「建立版本」圖示 () 來開啟「建立新版本」對話方塊。
-
提供「名稱」與「說明」。
-
按一下「發佈自訂特徵與表格」選項。如果您文件的 FeatureScript 有任何錯誤,在檢查清單中說明事項的左側會有紅色的 x 圖示 ()。核取記號圖示 () 則表示符合發佈的條件。
-
按一下 建立與發佈 或 建立版本、發佈並編輯屬性 來建立版本,並同時發佈自訂特徵與表格。
僅在文件包含有 Feature Studio 分頁的情況下,才會顯示「發佈自訂特徵與表格」選項。
Custom features must also have a description (this is different than the Description field in the above dialog). See Feature UI: Description in the FeatureScript documentation for more information.
如果您在「建立版本」對話方塊中沒有使用「發佈自訂特徵與表格」選項,您可以之後在版本 (下方範例中的 V1) 上按右鍵,然後從適境功能表中選擇 [發佈 FeatureScript] 來發佈:
如果文件版本中包含已發佈的自訂特徵,系統會在「版本與歷程」圖表的版本節點周圍顯示括弧指標 ({}):
若要解除發佈自訂特徵,在版本上按右鍵並從適境功能表中選擇 [解除發佈 FeatureScript]:
若要搜尋已發佈的自訂特徵:
-
在文件頁面中從左側面板選擇「公開」篩選器。
-
在螢幕上方的「搜尋」欄位中,按一下右側的下拉箭頭。
-
按一下「新增準則」下拉清單,然後選擇 [已發佈的 FeatureScript]:
-
選擇「真」來以已發佈的 FeatureScript 篩選所有文件,選擇「假」來以已發佈的 FeatureScript 排除所有文件:
-
按一下 搜尋。結果會顯示於下方。
- Onshape 會自動依字母順序列出自訂特徵。
- 如果您選擇更新至的版本不是最新的版本,則「過時」的圖示仍會出現。
- 更新自訂特徵的參考版本並不會變更您工具列指向的自訂特徵版本。要更新工具列指向的版本,請移除現有的圖示,然後新增指向較新版本的新自訂特徵。
- 在更新自訂特徵之後,您可能需要編輯特徵來避免重新計算時的錯誤 (例如,可能會有額外的欄位需要輸入值)。
- 一旦在文件中使用了連結的自訂特徵,即使原始文件被刪除或解除共享,您仍可以存取它。
- 將自訂特徵新增至工具列是帳戶層級的設定而非文件級別的設定。圖示 (以及相關的自訂特徵) 會出現在您所有的文件中。
- Adding a custom feature to your toolbar (or opening a document containing a custom feature) automatically turns on the FeatureScript notices, indicated by in the Navigation bar. These notices provide feedback that may be useful to the developer of the custom feature.
FeatureScript 的設計已將安全性的議題考量在內。為保護您的權益,FeatureScript 是在嚴密的沙箱中執行,且限制特徵對使用它的 Part Studio 的影響程度。這樣可確保即使使用未受信任使用者所編寫的自訂特徵也是相當安全的。
自訂特徵無法:
- 修改除了其被使用處 Part Studio 外的任何項目。
- 以任何方式「侵染」您的 Onshape 帳戶。
- 與其製作者或任何其他人進行溝通。
- 在其從特徵清單中被移除之後影響 Part Studio 的重生成。
- 修改特徵清單中的其他特徵。
惡意 (或編寫不佳的) 的自訂特徵可能會:
- 花費相當長的時間來重生成,或可能耗用過量的資源而使得對 Part Studio 的操作受到干擾,問題要到移除自訂特徵時才能解決。
- 嘗試在 Part Studio 中修改變數值或幾何可能會有負面的影響。
發佈惡意的 FeatureScript 是違反 Onshape 使用條款且不被允許的。
請使用說明功能表中的意見反應選項來報告任何發現的惡意自訂特徵。
將來自其他文件 (您對該文件有「連結文件」的最基本許可權限集) 的自訂特徵加入到您的特徵工具列中。您可以在有編輯權限的 Part Studio 中加入自訂特徵,或在您檢視的版本包含有定義特徵的 Feature Studio 中加入自訂特徵。
- Tap on the Add custom features icon.
新增自訂特徵飛出視窗開啟。
- 輕觸來在目前工作區與瀏覽文件中選擇。
- 輕觸來選擇要從其中加入自訂特徵的文件。
- 輕觸來選擇文件的版本。
- Tap to select the custom feature you wish to add.
Tap a drop down to select all of the custom features within it or tap individual custom features.
新增的自訂特徵會在飛出視窗中以藍色被強調顯示,且被加至您的特徵工具列中。
- 輕觸核取記號來關閉飛出視窗。
Onshape 會自動依字母順序列出自訂特徵。
Custom features linked to from another document are indicated in the Feature list by a link icon.
When a newer version of the document from which you inserted the custom feature is created, the link icon in the Feature list highlights in blue, and an identical icon appears on the Part Studio tab.
See Linked documents for more information on linked documents and how to update them.
移除特徵工具列中的自訂特徵
- 輕觸您特徵工具列右下方的管理。
- 輕觸您所要移除自訂特徵旁的 x。
- 當您完成自訂特徵的管理時,請輕觸完成。
FeatureScript 的設計已將安全性的議題考量在內。為保護您的權益,FeatureScript 是在嚴密的沙箱中執行,且限制特徵對使用它的 Part Studio 的影響程度。這樣可確保即使使用未受信任使用者所編寫的自訂特徵也是相當安全的。
A custom feature cannot:
- 修改除了其被使用處 Part Studio 外的任何項目。
- 以任何方式影響您的 Onshape 帳戶。
- 與其製作者或任何其他人進行溝通。
- 在其從特徵清單中被移除之後影響 Part Studio 的重生成。
- 修改特徵清單中的其他特徵。
A malicious (or poorly written) custom feature may:
- 花費相當長的時間來重生成,或可能耗用過量的資源而使得對 Part Studio 的操作受到干擾,問題要到移除自訂特徵時才能解決。
- 嘗試在 Part Studio 中修改變數值或幾何可能會有負面的影響。
發佈惡意的 FeatureScript 是違反 Onshape 使用條款且不被允許的。
請使用說明功能表中的 [聯絡支援人員] 按鈕來報告任何所發現的惡意自訂特徵。
在您能夠於行動裝置上存取自訂特徵之前,必須先在瀏覽器上使用 Onshape 來將自訂特徵加入至特徵工具列上。詳細資訊請參考 Onshape 瀏覽器說明文件中的自訂特徵主題。
在行動裝置的 Part Studio 中:
- Tap the Features icon to access the Feature toolbar.
The custom feature added using Onshape on a browser, is available in the Feature toolbar on your mobile device.
- 輕觸來使用自訂特徵。
- 完成對話方塊並輕觸核取記號。
- 已使用的自訂特徵會列在特徵清單中,就像任何其他的 Onshape 特徵一樣。
自訂特徵的行為模式與其他的 Onshape 特徵類似;可以編輯、抑制、隱藏與刪除自訂特徵。
Custom features linked to from another document are indicated in the Feature list by a link icon.
When a newer version of the document from which you inserted the custom feature is created, the link icon in the Feature list highlights in blue, and an identical icon appears on the Part Studio tab.
See Linking Documents for more information on linked documents and how to update them.
FeatureScript 的設計已將安全性的議題考量在內。為保護您的權益,FeatureScript 是在嚴密的沙箱中執行,且限制特徵對使用它的 Part Studio 的影響程度。這樣可確保即使使用未受信任使用者所編寫的自訂特徵也是相當安全的。
A custom feature does not have the ability to:
- 修改除了其被使用處 Part Studio 外的任何項目。
- 以任何方式影響您的 Onshape 帳戶。
- 與其製作者或任何其他人進行溝通。
- 在其從特徵清單中被移除之後影響 Part Studio 的重生成。
- 修改特徵清單中的其他特徵。
A malicious (or poorly written) custom feature may:
- 花費相當長的時間來重生成,或可能耗用過量的資源而使得對 Part Studio 的操作受到干擾,問題要到移除自訂特徵時才能解決。
- 嘗試在 Part Studio 中修改變數值或幾何可能會有負面的影響。
發佈惡意的 FeatureScript 是違反 Onshape 使用條款且不被允許的。
請使用說明功能表中的 [聯絡支援人員] 按鈕來報告任何所發現的惡意自訂特徵。