Company-/Kurs-/Enterprise-Einstellungen – Entwickler

1. Click the OAuth applications tab on the Developer page to see a list of all your apps:

   

2. Klicken Sie auf die Schaltfläche Neue OAuth-Anwendung erstellen.

3. Füllen Sie das Formular aus:

   • Name: Name der Anwendung, die Benutzern angezeigt wird

   • Primäres Format: Zeichenfolge, die Ihre Anwendung eindeutig identifiziert und an der sich die Daten erkennen lassen, die die App möglicherweise auf Onshape-Servern speichert (z. B. com.beispiel.beispiel). Wurde die App registriert, kann dies nicht mehr geändert werden. Wird Benutzern nicht angezeigt.

   • Zusammenfassung: Beschreibung der angezeigten Anwendung für Benutzer, wenn sie gebeten werden, der Anwendung den Zugriff auf die eigenen Daten zu erlauben.

   • Weiterleitungs-URLs: URL, zu der Sie nach der Authentifizierung weitergeleitet werden (die Landing-Page Ihrer Anwendung).

     • Ihre Anwendung muss mindestens eine URL angeben, die beim OAuth-Protokollaustausch verwendet wird.

     • This URL must also use SSL (a URL that begins with https), with two exceptions applicable for installed desktop applications: http://localhost:<port> and urn:ietf:wg:oauth:2.0:oob.

   • Typ: Anwendungstyp, Optionen: Integrierte Cloud-App, Verbundene Cloud-App oder Verbundene Desktop-App.

   • OAuth-URL: die URL, die verwendet wird, um den OAuth2-Prozess zur Benutzerauthentifizierung zu starten. Weitere Informationen finden Sie in der Entwicklerdokumentation unter „OAuth2“.

     • Sollte die URL Ihrer bereitgestellten Anwendung enthalten.

     • Dies ist die erste URL, die von der Onshape-Anwendungsseite aufgerufen wird.

     • Die Seite, die unter dieser URL gehostet wird, sollte die OAuth-Authentifizierung verarbeiten. Sobald der Server Ihrer Anwendung im Auftrag des Benutzers authentifiziert wurde, sollte dieser Benutzer zu Ihrer Anwendung umgeleitet werden.

     • Wenn Sie Ihre App noch nicht bereitgestellt haben, können Sie dieses Feld für die Arbeit an einem lokalen Rechner leer lassen und es später aktualisieren.

       Alle Anwendungen, die im Onshape App Store zur öffentlichen Verwendung eingereicht werden, müssen korrekt mit OAuth2 authentifiziert werden. Weitere Informationen finden Sie in der Entwicklerdokumentation unter „OAuth2“.

   • Einstellungen

     • Unterstützt Zusammenarbeit: aktivieren, wenn Sie bei der Entwicklung der Anwendung mit anderen Benutzern zusammenarbeiten möchten

   • Berechtigungen: siehe Berechtigungsbereiche unten

4. Klicken Sie auf Anwendung erstellen.

5. Kopieren Sie den geheimen OAuth-Schlüssel aus dem Fenster.

   Sie werden nicht wieder auf diesen geheimen Schlüssel zugreifen können. Dieses Geheimnis gilt nur für Sie und Ihre App. Es sollte wie jedes vertrauliche Passwort geschützt und niemals in den Quellcode integriert werden.

6. The app's OAuth application entry appears with the Details tab active. Selecting the app name on the OAuth applications tab now brings you to this screen.

Mit den Registerkarten auf diesem Bildschirm haben Sie folgende Möglichkeiten:

• Details:

  • Store-Eintrag für die App erstellen

  • Eigentümerschaft an der App übertragen

  • Delete the application

• Einstellungen: App-Einstellungen verwalten

• Schlüssel und Geheimnis:
  • OAuth-Client-Identifikationsschlüssel kopieren
  • Neuen geheimen OAuth-Client-Schlüssel erzeugen

• Berechtigungen: Berechtigungsbereiche der App ändern

• Erweiterungen: App-Erweiterungen verwalten

• Onshape OAuth: Onshape-Authentifizierung verwalten

• Externes OAuth: Drittanbieter-Authentifizierung verwalten

Weitere Informationen finden Sie in der Onshape-Dokumentation für Entwickler, einschließlich: korrekte Authentifizierung mit OAuth2 und Ausfüllen der Launch-Checkliste. Ein funktionierendes Beispiel finden Sie im Tutorial Hello World.

1. Click the OAuth applications tab on the Developer page, then select your application.

2. Klicken Sie auf die Registerkarte Erweiterungen.

   

3. Klicken Sie auf Erweiterung hinzufügen.

4. Füllen Sie das Formular aus:

   • Name: kann in der Benutzeroberfläche abgeschnitten werden, wenn er zu lang ist.

   • Beschreibung (optional): erscheint nicht in der Onshape-Benutzeroberfläche, könnte aber bei der Authentifizierung zu sehen sein.

   • Position: wo die Erweiterung in der Onshape-Benutzeroberfläche zu finden ist.

     • Weitere Informationen finden Sie in der Entwicklerdokumentation unter Unterstützte Positionen und Kontexte.

     • Sie können nur eine Element-Registerkartenerweiterung pro Anwendung erstellen.

   • Kontext: Manche Positionen funktionieren im Kontext einer Auswahl, zum Beispiel in einem Part Studio.

     • Weitere Informationen finden Sie in der Entwicklerdokumentation unter Unterstützte Positionen und Kontexte.

   • Aktions-URL: Bei Positionen, die eine Benutzeroberfläche einbetten, definiert die Aktions-URL die Adresse der anzuzeigenden Seite. Handelt es sich bei einer Position um eine Aktion (Kontextmenü, Symbolleistenelement, Aktion im Dialogfenster usw.) und der Aktionstyp ist GET oder POST, gibt die Aktions-URL den REST-Endpunkt an. Handelt es sich bei der Position um die Aktion „In neuem Fenster öffnen“, entspricht die Aktions-URL der URL, die in dem neuen Fenster geöffnet werden soll.

     • Eine Liste der Parameter, die in diesem Feld verwendet werden können, finden Sie in der Entwicklerdokumentation unter Aktions-URL-Parameter.

   • Aktionstyp: Gilt für Standorte, die keine Benutzeroberflächen einbetten. Unterstützte Aktionstypen sind:

     • GET: löst einen GET-API-Aufruf unter Verwendung der Aktions-URL aus. Die Parameterersetzung erfolgt bei der Aktions-URL.

     • POST: löst einen POST-API-Aufruf mit der Aktions-URL und dem Aktionstext als Beitragstext. Die Parameterersetzung erfolgt sowohl für bei der Aktions-URL als auch beim Aktionstext.

     • In neuem Fenster öffnen: öffnet die Aktions-URL in einem neuen Browserfenster. Die Parameterersetzung erfolgt bei der Aktions-URL.

   • Aktionstext: gilt nur für POST-Aktionstypen. Der Aktionstext wird in einem POST-API-Aufruf übergeben und muss ein gültiges JSON-Format haben.

   • Antwort anzeigen: gilt nur, wenn der Aktionstyp GET oder POST ist. Wenn ausgewählt, wartet die Benutzeroberfläche auf eine Antwort und zeigt diese dann in einem Dialogfenster in der Benutzeroberfläche an. Die Antwort muss ein gültiges JSON-Format haben.

   • Symbol: Das Symbol wird dort angezeigt, wo die Erweiterung vorhanden ist. Das umfasst auch Symbole, die zu einer Informationspalette, einer Kontextmenü-Aktion, einer Symbolleisten-Schaltfläche, einer Aktions-Schaltfläche in einem Dialogfenster oder zu anderen unterstützten Positionen gehören.

5. Klicken Sie auf OK.

Weitere Informationen zum Erstellen und Verwalten von Onshape-Anwendungen finden Sie in der Onshape-Dokumentation für Entwickler. Ein funktionierendes Beispiel finden Sie im Tutorial Hello World.

Adminstratoren können interne Benutzer zu Anwendungen zum Testen hinzufügen, bevor sie Anwendungen an den Onshape App Store übermitteln. Benutzer, die hier hinzugefügt wurden, sehen automatisch die zugehörigen App-Erweiterungen in ihrer Onshape-Benutzeroberfläche, ohne sie die Anwendung über den App Store abonnieren zu müssen.

1. Sobald Ihre App registriert ist, klicken Sie im linken Bereich auf Anwendungen.

2. Wählen Sie die Anwendung in der Liste aus.

   

3. Beginnen Sie mit der Eingabe des Namens oder der E-Mail-Adresse eines Benutzers, Teams oder Alias in das Feld Benutzer oder Teams hinzufügen und wählen Sie ein Ergebnis aus der Liste aus. Der Administrator, der die App erstellt hat, ist automatisch in der Benutzerliste. Fügen Sie weitere Namen oder E-Mails hinzu.

   

4. Klicken Sie auf die Schaltfläche Hinzufügen.

Light-Benutzer können nicht zu Anwendungen hinzugefügt werden.

Um einen Benutzer, ein Alias oder ein Team aus der App zu entfernen, klicken Sie auf das entsprechende X-Symbol in der Spalte Entfernen.

1. Klicken Sie in Ihren Entwicklereinstellungen auf OAuth-Anwendungen.
2. Klicken Sie auf den Namen der App, die übertragen werden soll.
3. Click the Transfer ownership button on the Details tab. The Transfer ownership dialog opens.

   

4. Wählen Sie eine Option aus, um die App an eine Einzelperson, eine Company oder ein Enterprise zu übertragen.
5. Um an eine Einzelperson zu übertragen, geben Sie den Namen oder die E-Mail-Adresse des neuen Eigentümers in das Suchfeld ein. Um die Eigentümerschaft an eine Company oder ein Enterprise zu übertragen, wählen Sie eine Option aus dem Dropdown-Menü aus.
6. Klicken Sie auf Eigentümerschaft übertragen. Die Anwendung wird darauf aus Ihrer OAuth-Apps-Liste entfernt.
   • Wenn die App an das Konto einer Einzelperson übertragen wurde, erhält dieser Benutzer eine E-Mail-Benachrichtigung und die App wird in seinem Onshape-Entwicklerportal angezeigt.
   • Wenn die App an ein Company-, Classroom- oder Enterprise-Mitglied übertragen wurde, erhalten alle Administratoren eine E-Mail-Benachrichtigung und die App wird in ihren Entwicklereinstellungen angezeigt.

Der zukünftige Verbrauch und die Abrechnung von API-Aufrufen werden dem neuen Eigentümer zugerechnet. Weitere Informationen finden Sie unter API-Grenzwerte.

1. Click Developer in the left pane of your company settings, click OAuth applications, then select the app to deprecate.

2. On the Details tab, click the Delete permanently button.
   

3. Click Delete again to confirm in the dialog.

So erstellen Sie eine neue Store-Einreichung für eine OAuth-Anwendung:

1. Click OAuth applications on the Developer page, then select your application.

2. Click the Create store entry button on the app's Details tab.

   

3. Füllen Sie das Formular aus:

   • Name: wird automatisch anhand des bei der Registrierung angegebenen App-Namens festgelegt.

   • Zusammenfassung: wird automatisch anhand der bei der Registrierung bereitgestellten Zusammenfassung festgelegt.

   • Typ – Anwendungstyp: Integrierte Cloud-App, Verbundene Cloud-App oder Verbundene Desktop-App. Dies sollte dem Typ entsprechen, der bei der Registrierung der OAuth-Anwendung ausgewählt wurde.

   • Kategorie: Wählen Sie die entsprechende Kategorie für Ihre App aus.

   • Team-Sichtbarkeit: Geben Sie an, ob die private Einreichung beim App Store für keine internen Benutzer (Standard), alle internen Benutzer oder bestimmte Teams zu sehen sein soll.

   • Beschreibung: Beschreibung der Anwendung, die dem Benutzer angezeigt wird. Eine gewisse Formatierung ist möglich.

   • Support-URL: URL oder E-Mail-Adresse, an die Benutzer Ihrer App weitergeleitet werden sollten, um Hilfe zu erhalten. Diese URL oder E-Mail-Adresse muss aktiv überwacht werden.

   • Support-E-Mail: E-Mail-Adresse, an die Benachrichtigungen zum App-Abonnement gehen sollen. Diese E-Mail-Adresse muss aktiv überwacht werden.

   • Anbieter: Ihr Company-Name.

   • Version: aktuelle Version dieser Anwendung.

   • Bilder: Laden Sie optional Übersichts-, Hero- und andere Bilder hoch.

4. Klicken Sie auf Erstellen.

Die Anwendung wird im Onshape App Store als privat angezeigt. Sie ist nur für Sie und alle internen Teams sichtbar, die in den Team-Sichtbarkeitseinstellungen angegeben sind. Um die App öffentlich zu machen, sehen Sie sich als Nächstes die Launch-Checkliste an.

To return to this screen, click the Store entry tab for the application:

1. Click OAuth applications on the Developer page, then select your application.
2. Click the Store entry tab.
3. Click Delete store entry on the Details tab.
   
4. Klicken Sie zur Bestätigung erneut auf Löschen.