Benutzerdefinierte Features hinzufügen

Schritte: Benutzerdefinierte Features, die in anderen Dokumenten definiert sind

Fügen Sie der Feature-Symbolleiste benutzerdefinierte Features aus jedem beliebigen Dokument hinzu, für das Sie mindestens die Berechtigung „Anzeigen, Kopieren und Exportieren“ haben. Sie können benutzerdefinierte Features hinzufügen, wenn Sie sich in einem Part Studio befinden, auf das Sie Schreibzugriff haben, oder wenn Sie eine Version aus dem Feature Studio anzeigen, das die Features definiert.

Klicken Sie im Part Studio in der Feature-Symbolleiste auf .
Suchen Sie im Dialogfenster das Dokument, in dem das gewünschte benutzerdefinierte Feature definiert ist:
1. FeatureScript-Beispiele: Dieser Filter zeigt alle von Onshape bereitgestellten Dokumente mit FeatureScript-Beispielen, die Sie ausprobieren können.
2. Onshape-Standardfilter: Verwenden Sie diese Filter wie auf der Dokumentenseite zum Suchen eines bestimmten Dokuments.
3. Suchfeld: Geben Sie den Namen eines Dokuments ein oder fügen Sie die URL eines Dokuments ein, das FeatureScript enthält (erhält man für gewöhnlich über eine Freigabe).
Benutzerdefinierte Features werden mit bestimmten Versionen anderer Dokumente verknüpft. Standardmäßig wird die letzte Version ausgewählt. Wenn keine Version vorhanden ist, können Sie den Eigentümer des Dokuments (oder jemanden mit Schreibberechtigung) auffordern, eine zu erstellen.
Durch Klicken auf einen Dokumentnamen werden die im Dokument definierten benutzerdefinierten Features angezeigt.
Wählen Sie das oberste Symbol aus, um alle benutzerdefinierten Features darin einzufügen (jedes ist mit einem eigenen Symbol auf der Symbolleiste dargestellt). Oder wählen Sie ein Feature aus.
Das Symbol für das benutzerdefinierte Feature ist jetzt in Ihrer Feature-Symbolleiste verfügbar.
Um das benutzerdefinierte Feature zu entfernen, bevor Sie das Dialogfenster schließen, wählen Sie das benutzerdefinierte Feature erneut im Dialogfenster aus. (Dies aktiviert und deaktiviert das benutzerdefinierte Feature in der Symbolleiste.)
Gibt es mehrere Versionen eines Dokuments, wird standardmäßig die letzte Version angezeigt. Klicken Sie auf , um auf das Versionsdiagramm zuzugreifen und eine andere Version auszuwählen.
Um das Dialogfenster zu schließen, klicken Sie oben rechts auf das X.

Das benutzerdefinierte Features ist jetzt in Ihrer Feature-Symbolleiste verfügbar und kann verwendet werden.

Benutzerdefiniertes Feature verwenden

Die Verwendung eines benutzerdefinierten Features erzeugt – wie jedes andere Onshape-Feature – ein Feature in der Feature-Liste im Part Studio. Benutzerdefinierte Features, die mit einem anderen Dokument verknüpft sind, erkennen Sie in der Feature-Liste an dem Symbol Symbol „Verknüpfte benutzerdefinierte Features“ .

Benutzerdefinierte Features verhalten sich wie andere Onshape-Features. Sie können bearbeitet, unterdrückt, verborgen und gelöscht werden.

Benutzerdefiniertes Feature aktualisieren

Wird eine neuere Version des Dokuments erstellt, von dem das benutzerdefinierte Feature stammt, wird das Verknüpfungssymbol in der Feature-Liste in Blau hervorgehoben. Ein identisches Symbol wird in der Registerkarte „Part Studio“ angezeigt: Symbol für „Neuere Version des Dokuments vorhanden, aus der das benutzerdefinierte Feature erstellt wird“

Dies ist nur eine Benachrichtigung, Sie müssen nichts machen.

Aktualisieren der Version des verwendeten benutzerdefinierten Features:

Klicken Sie auf das Symbol für Aktualisieren (oder klicken Sie mit der rechten Maustaste auf das Feature und wählen Sie „Verknüpftes Dokument aktualisieren“ aus), um auf den Referenz-Manager zuzugreifen. Dort können Sie die Update-Optionen auswählen.
Um ein Update auf die letzte Version vorzunehmen, klicken Sie auf „Alles aktualisieren“.
Auf eine bestimmte Version aktualisieren: Klicken Sie auf
1. Selektive Aktualisierung:
1. Wählen Sie das Dokument aus (wenn mehrere Dokumente vorliegen) und klicken Sie für dieses Dokument auf :
2. Wählen Sie die Version aus, auf die aktualisiert werden soll.
3. Wiederholen Sie diesen Vorgang für weitere Dokumente in der Liste, falls erforderlich.
4. Klicken Sie auf „Auswahl aktualisieren“.

Wenn ein Feature in der Feature-Liste eines Benutzers einem vom Administrator hinzugefügten Tool entspricht, wird das Feature nicht als veraltet angezeigt (auch wenn das Tool veraltet ist). Hat es aber eine andere Version als das Tool ist, wird es als nicht synchronisiert Symbol „Nicht synchronisiert“ angezeigt.

Der Befehl im Referenz-Manager „Alles aktualisieren“ aktualisiert nicht synchronisierte Features auf die Version in der Symbolleiste, auch wenn diese Version älter (niedrigere Versionsnr.) als die neueste Version oder älter als die Version ist, aus der das Feature aktuell stammt. Ein Benutzer kann auf das Symbol klicken und den Befehl „Aktualisieren“ verwenden, um das Tool zu aktualisieren:

Referenz-Manager, auf den neuesten Stand bringen.

Benutzerdefiniertes Feature entfernen

Um ein benutzerdefiniertes Feature aus Ihrer Symbolleiste zu entfernen, klicken Sie mit der rechten Maustaste auf das Symbol in der Symbolleiste und wählen „Entfernen“ aus.

Das benutzerdefinierte Feature wird beim Bearbeiten eines Part Studios nicht mehr in der Symbolleiste angezeigt, es sei denn, das Feature wurde verwendet und kommt in der Feature-Liste vor. Wenn die Feature-Liste ein benutzerdefiniertes Feature enthält und das entsprechende Symbol für das benutzerdefinierte Feature in Ihrer Symbolleiste fehlt (weil es entweder entfernt wurde oder das Dokument mit Ihnen geteilt wurde und das Symbol niemals in Ihrer Symbolleiste angezeigt wurde), wird das Symbol für verknüpfte benutzerdefinierte Features in diesem Part Studio in der Symbolleiste angezeigt und das benutzerdefinierte Feature ist in der Dropdown-Liste verfügbar:

Beispiel für das Entfernen eines benutzerdefinierten Features

Auf diese Weise können Benutzer mit Zugriff auf dieses Part Studio dieses benutzerdefinierte Feature weiterhin verwenden.

Dokument eines verknüpften benutzerdefinierten Features öffnen

Um sich mit einem benutzerdefinierten Feature in Ihrem Dokument und seiner Funktionsweise wieder vertraut zu machen, klicken Sie mit der rechten Maustaste in der Symbolleiste auf das Symbol für benutzerdefinierte Features und wählen „Verknüpftes Dokument öffnen“ aus. Das Dokument mit dem Feature Studio des benutzerdefinierten Features wird in einer anderen Registerkarte geöffnet.

Schritte: Benutzerdefiniertes Feature vom selben Arbeitsbereich hinzufügen

Wenn Sie in diesem Arbeitsbereich ein eigenes benutzerdefiniertes Feature geschrieben haben, werden die benutzerdefinierten Features, die darin definiert sind, automatisch in der Dropdown-Liste „Benutzerdefinierte Features“ der Feature-Symbolleiste angezeigt und können verwendet werden:

Klicken Sie auf das Symbol, um alle im Arbeitsbereich definierten benutzerdefinierten Features aufzulisten:
Wählen Sie das benutzerdefinierte Feature aus, das Sie verwenden möchten.

Benutzerdefinierte Features aus dem aktuellen Arbeitsbereich werden automatisch aktualisiert, wenn das FeatureScript, das das Feature definiert, bearbeitet und übernommen wird. Dies eignet sich als Schnelltest bei der Entwicklung von benutzerdefinierten Features.

Benutzerdefiniertes Feature teilen

So machen Sie Ihre benutzerdefinierten Features für andere verfügbar:

Erstellen Sie eine Version des Dokuments, die das FeatureScript des benutzerdefinierten Features enthält.
Sie haben folgende Optionen:
1. Teilen Sie das Dokument mit bestimmten Personen oder Teams, wobei Sie als minimale Berechtigung „Darf anzeigen, kopieren und exportieren“ festlegen.
2. Legen Sie das Dokument als öffentlich fest.

Ein Symbol für ein benutzerdefiniertes Feature verwenden

Ein Symbol für benutzerdefinierte Features wird festgelegt, indem das Symbol als SVG-Blog-Registerkarte in das Dokument hochgeladen und dann referenziert wird. Weitere Informationen finden Sie in den Anleitungen unter Benutzerdefinierte Symbole in der FeatureScript-Dokumentation.

Beschreibungsbild hinzufügen

Ein Beschreibungsbild ist ein Bild der Feature-Ausgabe und wird definiert, indem es als SVG-Blog-Tab im Dokument hochgeladen und dann referenziert wird. Weitere Informationen finden Sie in den Anleitungen unter Benutzerdefinierte Symbole in der FeatureScript-Dokumentation.

Benutzerdefiniertes Feature veröffentlichen

Wenn Sie ein Dokument haben, das ein benutzerdefiniertes Feature enthält, das Sie veröffentlichen möchten, können Sie dies beim Erstellen einer neuen Version des Dokuments oder direkt über das Kontextmenü der Version im Bereich „Versionen und Historie“ machen. Dies erleichtert auch die Suche nach Dokumenten, die öffentliche benutzerdefinierte Features enthalten.

Schritte

Erstellen Sie ein öffentliches Dokument, das das benutzerdefinierte Feature auf einer Feature-Studio-Registerkarte enthält. Weitere Informationen finden Sie unter Benutzerdefinierte Features hinzufügen.
Klicken Sie im selben Dokument auf das Symbol zum Einfügen einer neuen Registerkarte () und erstellen Sie ein Part Studio, das das benutzerdefinierte Feature verwendet.
Klicken Sie im selben Dokument auf das Symbol zum Einfügen einer neuen Registerkarte () und klicken Sie auf „Importieren“. Wählen Sie eine PDF-Datei aus und importieren Sie diese. In der Regel handelt es sich bei diesem Dokument um eine Anleitung, in der das benutzerdefinierte Feature erklärt wird.
Klicken Sie auf das Symbol für Versionen und Historie (), um die Palette Versionen und Historie zu öffnen.
Klicken Sie auf das Symbol zum Erstellen einer Version (), um das Dialogfenster „Version erstellen“ zu öffnen.
Geben Sie einen Namen und eine Beschreibung ein.
Klicken Sie auf die Option „Benutzerdefinierte Features und Tabellen veröffentlichen“. Enthält das FeatureScript Ihres Dokuments Fehler, werden diese links neben ihrer Erklärung in der Checkliste mit einem roten X-Symbol gemeldet (). Ein Häkchensymbol () zeigt an, dass die Veröffentlichungsanforderungen erfüllt sind.

Die Option „Benutzerdefinierte Funktionen und Tabellen veröffentlichen“ wird nur angezeigt, wenn das Dokument eine Feature-Studio-Registerkarte enthält.

Benutzerdefinierte Funktionen müssen ebenfalls eine Beschreibung haben (diese unterscheidet sich von dem Beschreibungsfeld im obigen Dialogfenster). Weitere Informationen finden Sie unter Feature-UI: Beschreibung in der FeatureScript-Dokumentation.

Klicken Sie auf Erstellen und veröffentlichen oder Version erstellen, veröffentlichen und Eigenschaften bearbeiten, um die Version zu erstellen und die benutzerdefinierten Features und Tabellen gleichzeitig zu veröffentlichen.

Wenn Sie die Option „Benutzerdefinierte Features und Tabellen veröffentlichen“ im Dialogfenster „Version erstellen“ nicht verwenden, können Sie diese auch nachträglich veröffentlichen, indem Sie auf die Version rechtsklicken (V1 im Beispiel unten) und im Kontextmenü „FeatureScript veröffentlichen“ auswählen:

FeatureScript über die Palette „Versionen und Historie“ veröffentlichen

Nach veröffentlichten benutzerdefinierten Features suchen

So suchen Sie nach veröffentlichten benutzerdefinierten Features:

Wählen Sie auf der Dokumentenseite im linken Seitenbereich den Filter „Öffentlich“ aus.
Klicken Sie im Suchfeld oben auf dem Bildschirm auf den Dropdown-Pfeil auf der rechten Seite.
Klicken Sie auf die Dropdown-Liste „Kriterien hinzufügen“ und wählen Sie „Veröffentlichtes FeatureScript“ aus:
Wählen Sie „Wahr“ aus, um alle Dokumente mit veröffentlichtem FeatureScript zu filtern, oder „Falsch“, um alle Dokumente mit veröffentlichtem FeatureScript auszuschließen:
Klicken Sie auf Suchen. Die Ergebnisse werden unten angezeigt.

Tipps

Onshape listet benutzerdefinierte Features automatisch alphabetisch auf.
Wenn Sie auf eine andere als die neueste Version aktualisieren, wird das Symbol für „Veraltet“ weiterhin angezeigt.
Beim Aktualisieren der Referenzversion eines benutzerdefinierten Features ändert sich nicht die Version des benutzerdefinierten Features, auf das in der Symbolleiste verwiesen wird. Um die in der Symbolleiste angezeigte Version zu aktualisieren, entfernen Sie das bestehende Symbol und fügen Sie ein neues benutzerdefiniertes Features hinzu, das auf die neuere Version verweist.
Nach der Aktualisierung eines benutzerdefinierten Features muss das Feature u. U. bearbeitet werden, damit es fehlerlos erneut erzeugt werden kann (beispielsweise durch das Hinzufügen von Feldern, die ausgefüllt werden müssen).
Sobald Sie ein verknüpftes benutzerdefiniertes Feature in Ihrem Dokument verwendet haben, haben Sie Zugriff darauf, auch wenn das Quelldokument gelöscht oder das Teilen aufgehoben wird.
Das Hinzufügen von benutzerdefinierten Features zu Ihrer Symbolleiste ist eine Konto- und keine Dokumenteinstellung. Das Symbol (und das damit verbundene benutzerdefinierte Feature) ist in allen Ihren Dokumenten verfügbar.
Wenn Sie ein benutzerdefiniertes Feature zur Ihrer Symbolleiste hinzufügen (oder ein Dokument mit einem benutzerdefinierten Feature öffnen), werden die FeatureScript-Hinweise automatisch aktiviert. Sie erkennen das an dem Symbol in der Navigationsleiste. Diese Hinweise geben dem Entwickler des Features nützliches Feedback.

Wichtig

Bei der Entwicklung von FeatureScript hatten Sicherheitsaspekte von Anfang an hohe Priorität. Zu Ihrem Schutz wird FeatureScript in einer begrenzten Sandbox ausgeführt. Zudem sind die Auswirkungen des Features auf das Part Studio, in dem es verwendet wird, beschränkt. Dadurch wird gewährleistet, dass auch die Verwendung von benutzerdefinierten Features, die von nicht vertrauenswürdigen Benutzern geschrieben wurden, relativ sicher ist.

Was ein benutzerdefiniertes Feature nicht kann:

etwas anderes außer dem Part Studio ändern, in dem es verwendet wird
Ihr Onshape-Konto auf irgendeine Weise „infizieren“
etwas an den Autor oder sonst jemanden kommunizieren
die erneute Erzeugung des Part Studios initiieren, nachdem es von der Feature-Liste entfernt wurde
andere Features in der Feature-Liste ändern

Woran Sie ein schädliches (oder schlecht geschriebenes) benutzerdefiniertes Feature erkennen:

Die erneute Erzeugung dauert lange oder nimmt übermäßig viele Ressourcen in Anspruch, was Ihre Arbeit im Part Studio stören würde und nur durch die Entfernung des benutzerdefinierten Features zu beheben wäre.
Variable Werte oder Geometrien in dem Part Studio werden geändert, um auf diese Weise Schaden anzurichten.

Die Veröffentlichung von schädlichem FeatureScript widerspricht den Onshape-Nutzungsbedingungen und wird nicht toleriert.

Bitte melden Sie schädliche benutzerdefinierte Features mit der Feedback-Schaltfläche im Hilfemenü.