Verfügbar in: Feature Studios
Ein Feature Studio ist eine Onshape-Registerkarte für die Arbeit mit FeatureScript, einer Programmiersprache zum Definieren benutzerdefinierter Features.
FeatureScript wurde von Onshape entwickelt, um Features zu programmieren und mit parametrischen 3D-Modellen arbeiten zu können. Die Programmiersprache ist in Onshape integriert und dient als Grundlage für das Modellieren im Part Studio sowie zur Definition der Standard-Features (wie lineares Austragen, Verrundung oder Wandung).
Auf dieser Seite geht es hauptsächlich um die Arbeit mit der Feature-Studio-Benutzeroberfläche.
– Informationen zum Schreiben von FeatureScript zum Erstellen benutzerdefinierter Features finden Sie in der FeatureScript-Dokumentation.
– Anleitungen zum Hinzufügen dieser benutzerdefinierten Features zu einem Part Studio finden Sie unter Benutzerdefinierte Features.
The Feature Studio toolbar includes the following:
- Undo (
; ctrl/cmd+z ) - Undo the most recent change. - Redo (
; ctrl+y/shift+cmd+z ) - Repeat or redo the most recent change. - New feature (
) - Insert the basic framework for a new feature, which consists of a function declaration with the precondition and body within it. See the FeatureScript Docs for more information. - Parameters and functions lists - Insert the basic framework for parameters, queries, evaluations, math functions, sketch functions, and operations. On some screens, this option is collapsed into one list (as shown above); on other screens, each list is individual:
- Insert feature parameters
- Insert query functions
- Insert evaluation functions
- Insert math functions
- Insert sketch functions
- Insert operation functions
- Import (
) - Import a file, Part Studio, other Feature Studio, or Variable Studio from the current or another document. See Imports.- You can also create a version (
) and view the version graph (
) from this dialog. See Versions and History.
- You can also create a version (
- Format Studio (
) - Automatically format the current FeatureScript code. If this option is not visible on the toolbar, click the Import dropdown and select it from the menu. - Commit - Commit the current code changes. See Committing FeatureScript changes on this page.
- Search tools ( alt/option+c ) - Search for any of the parameters and functions available in the Parameters and functions lists, including their descriptions. To close the search box, click Close search, press the escape key, or click outside the box.
- Co-complete (
) - Use AI to help write FeatureScript code. See FeatureScript Co-Complete. - Monitor Part Studio (
) - Monitor a Part Studio's execution. See Debugging in Feature Studios.- Click the dropdown and select Profile Part Studio (
) to profile a Part Studio's execution. See Debugging in Feature Studios.
- Click the dropdown and select Profile Part Studio (
- Module outline (
) - Navigate through your FeatureScript code. See Navigating the outline on this page. - Back reference (
; ctrl/cmd+[ ) - Return your cursor to its previous position in your navigation history. - Forward reference (
; ctrl/cmd+] ) - Return your cursor to the next position in your navigation history. - Line - The line number of the current cursor location.
- Column - The column number of the current cursor location.
Wie bei allen Registerkarten in Onshape werden Ihre FeatureScript-Änderungen automatisch gespeichert, während Sie sie eingeben. Um die Änderungen zu bestätigen und den neuen FeatureScript-Code im gesamten Dokument anzuwenden, klicken Sie auf die Schaltfläche Übernehmen.
-
Um die Änderungen nur im aktuellen Feature Studio zu übernehmen, klicken Sie auf die Schaltfläche Übernehmen.
-
Sie können auch auf das Drop-down-Menü klicken und im Menü Übernehmen auswählen.
-
Oder Sie verwenden die Tastenkombination cmd/Strg + s.
-
-
Um alle Änderungen in allen Feature Studios in dem Dokument zu übernehmen, klicken Sie im Dropdown-Menü auf die Schaltfläche Übernehmen und wählen Alle übernehmen aus.
-
Die Anzahl der Feature-Studios mit noch nicht übernommenen Änderungen wird im Drop-down-Menü in Klammern angezeigt.
-
Sie können auch die Tastenkombination cmd/Strg + Umschalttaste + s verwenden.
-
-
Klicken Sie in der Menüleiste auf die Schaltfläche Feature Studios suchen (
), um den Bereich für die Textsuche zu öffnen (wie oben gezeigt).-
Sie können den Bereich für die Textsuche auch mit Strg/Befehlstaste+Umschalttaste+f öffnen.
-
Sie können den Bereich für die Symbolsuche öffnen, indem Sie auf ein Symbol rechtsklicken und im Kontextmenü Verwendungen im Arbeitsbereich finden oder Im Arbeitsbereich umbenennen auswählen.

-
-
Klicken Sie auf die Dropdown-Liste Suchmodus, um zwischen der Suche nach Text, Symbolen oder Standard-Bibliotheksimporten zu wechseln.

-
(Nur Textsuche) Geben Sie Ihren Suchtext in das Feld Text suchen ein, optional mit weiteren Suchparametern:
-
Groß-/Kleinschreibung beachten: Markieren Sie das Kontrollkästchen, wenn bei der Suche die Groß- und Kleinschreibung beachtet werden soll.
-
Regex: Markieren Sie das Kontrollkästchen für die Suche mit regulären Ausdrücken.
-
Feature-Studio-Namensfilter: Filtern Sie die Suchergebnisse nach Registerkarten, die dem eingegebenen Text entsprechen.
-
-
(Nur Suche nach Standard-Bibliotheksimporten) Geben Sie die Suchoptionen ein, um den passenden Standard-Bibliotheksimport zu finden:
-
Einschließen und Ausschließen: Geben Sie Versionen und Versionsbereiche als kommagetrennte Listen ein. Importe erscheinen nur dann in den Suchergebnissen, wenn ihre Versionen in der Einschließen-Liste nicht in der Ausschließen-Liste zurückgegeben werden.
-
So funktioniert das Ein- und Ausschließen von Suchoptionen: Wenn Sie eine Nebenversion einschließen (z. B. 3081.2), wird nur diese Version (3081.2) zurückgegeben. Wenn Sie dagegen eine bestimmte Nebenversion ausschließen (z. B. 3081), erhalten Sie alle Nebenversionen innerhalb der Hauptversion (3081.0, 3081.1, 3081.2, 3081.3).
-
Wird ein Versionsbereich (z. B. 3081.0-3081.2) eingegeben, umfasst dieser alle Versionen einschließlich der angegebenen Start- und Endversion für die Suche (also in diesem Beispiel einschließlich 3081.0 und 3081.2).
-
Mit einem Bindestrich werden alle Versionen vor und einschließlich der angegebenen Version (z. B. -3081.2) oder danach und einschließlich der angegebenen Version (z. B. 3081.2-) berücksichtigt.
-
Kommagetrennte Suchen geben alle übereinstimmenden Treffer zurück (z. B. 3079 - 3080, 3081.2 gibt alle Nebenversionen in 3079 sowie alle Nebenversionen in 3080 und 3081.2 zurück).
-
Wenn Sie Einschließen leer lassen, wird für alles nach Übereinstimmungen gesucht. Bleibt Ausschließen leer, wird nichts ausgeschlossen.
-
-
Feature-Studio-Namensfilter: Filtern Sie die Suchergebnisse nach Registerkarten, die dem eingegebenen Text entsprechen.

-
-
Klicken Sie auf Suchen.
- Die Suchergebnisse sind im FeatureScript-Code hervorgehoben.
-
Verwenden Sie die Schaltflächen Erweitern (
) und Reduzieren (
), um die Ergebnisse nach Feature-Studio-Registerkarten anzuzeigen. -
Verwenden Sie die Schaltflächen Suchergebnisse erweitern (
) und Suchergebnisse reduzieren (
), um alle Ergebnisdetails zu sehen bzw. auszublenden. -
Klicken Sie auf ein Suchergebnis, um direkt zur zugehörigen Position im Feature Studio zu gelangen.
-
(Optional) So ersetzen Sie den Suchtext, benennen ein Symbol um oder aktualisieren die Version des Standard-Bibliotheksimports:
-
Klicken Sie links neben der Schaltfläche Suchmodus auf den Pfeil für „Ersetzen“ umschalten (
) . -
Geben Sie Ihren Ersatztext in das Feld Ersetzen mit ein (Text- oder Symbolsuche). Oder geben Sie die gewünschte Versionsnummer in das Feld Versions setzen auf (Standardbibliothekssuche) ein. Sie können auch eine unterstützte Version aus der Dropdown-Liste Version setzen auf auswählen.
-
Klicken Sie auf Alle ersetzen (Text- oder Standard-Bibliothekssuche) oder Umbenennen (Symbolsuche).
-
Klicken Sie auf der Feature-Studio-Symbolleiste auf den Pfeil für die Modulübersicht, um die Gliederung anzuzeigen. Außerdem haben Sie folgende Möglichkeiten:
-
Klicken Sie auf ein Suchergebnis, um zu diesem Teil des FeatureScript-Codes zu navigieren.
-
Geben Sie den Suchtext in das Feld Symbole suchen ein, um die Ergebnisse zu verfeinern.
Eine weitere Ressource des Learning Centers finden im Kurs (mit Kursleiter) unter: FeatureScript-Grundlagen (Onshape-Konto erforderlich).