Impostazioni Azienda/Aula/Enterprise - Sviluppatore

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

   

2. Fai clic sul pulsante Crea nuova applicazione OAuth.

3. Compila il modulo:

   • Nome: nome dell'applicazione visualizzata agli utenti.

   • Formato principale: stringa che identifica in modo univoco la tua applicazione e funge da marcatore per i dati che potrebbe memorizzare sui server Onshape (ad esempio, com.example.example). Non può essere modificata dopo la registrazione dell'applicazione e non viene mostrata gli utenti.

   • Riepilogo: descrizione dell'applicazione, mostrata all'utente quando gli viene chiesto di concedere all'applicazione l'autorizzazione ad accedere ai dati.

   • URL di reindirizzamento: URL che si apre dopo l'autenticazione; la pagina di destinazione della tua applicazione.

     • La tua applicazione deve specificare almeno un URL utilizzato negli scambi del protocollo OAuth.

     • 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.

   • Tipo: tipo di applicazione: App cloud integrata, App cloud connessa oppure App desktop connessa.

   • URL OAuth: URL utilizzato per avviare il processo OAuth2 di autenticazione dell'utente. Per i dettagli, consulta Documentazione per gli sviluppatori: OAuth2.

     • Dovrebbe contenere l'URL della tua applicazione implementata.

     • Questo è il primo URL richiamato dalla pagina delle applicazioni Onshape.

     • La pagina ospitata a questo URL deve gestire l'autenticazione OAuth. Una volta che il server della tua applicazione è stato autenticato per conto dell'utente, quest'ultimo deve essere reindirizzato ai contenuti della tua applicazione.

     • Se non hai ancora implementato la tua app, puoi lasciare questo campo vuoto per il lavoro in locale e aggiornarlo in un secondo momento.

       Tutte le applicazioni inviate all'App Store Onshape per uso pubblico devono autenticarsi correttamente con OAuth2. Per i dettagli, consulta Documentazione per sviluppatori: OAuth2.

   • Impostazioni

     • Supporta la collaborazione: seleziona la casella se desideri collaborare con altri utenti durante lo sviluppo dell'applicazione.

   • Autorizzazioni: vedi Ambiti autorizzazioni di seguito.

4. Fai clic su Crea applicazione.

5. Copia la chiave segreta OAuth dalla finestra.

   Non potrai più accedere nuovamente a questa chiave segreta. Questa codice segreto è unico per te e per la tua app, deve essere protetto come qualsiasi password riservata e non deve essere mai inserito nel codice sorgente.

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.

Usa le schede di questa pagina per:

• Dettagli:

  • Creare una voce nello store per l'app

  • Trasferire la proprietà dell'app

  • Delete the application

• Impostazioni: gestire le impostazioni dell'app

• Chiavi e codici segreti:
  • Copiare la chiave dell'Identificatore cliente OAuth
  • Rigenerare una nuova chiave del codice segreto cliente OAuth

• Autorizzazioni: modificare gli ambiti di autorizzazione dell'app

• Estensioni: gestire le estensioni delle app

• Onshape OAuth: gestire l'autenticazione Onshape

• OAuth esterno: gestire l'autenticazione di terze parti

Consulta la Documentazione per sviluppatori di Onshape per ulteriori informazioni, tra cui: la corretta autenticazione con OAuth2 e il completamento dell'elenco di controllo per il lancio. Consulta il tutorial Hello World per un esempio pratico.

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

2. Fai clic sulla scheda Estensioni.

   

3. Fai clic su Aggiungi estensione.

4. Compila il modulo:

   • Nome: può essere troncato nell'interfaccia utente se troppo lungo.

   • Descrizione (facoltativa): non viene visualizzata nell'interfaccia utente di Onshape, ma potrebbe apparire nel processo di autorizzazione dell'autenticazione.

   • Posizione: indica dove si trova l'estensione nell'interfaccia utente di Onshape.

     • Consulta Posizioni e contesti supportati nella documentazione per gli sviluppatori.

     • Puoi creare solo un'estensione per la scheda degli elementi per applicazione.

   • Contesto: alcune posizioni funzionano nel contesto di una selezione, ad esempio all'interno di un Part Studio.

     • Consulta Posizioni e contesti supportati nella documentazione per gli sviluppatori.

   • URL azione: le posizioni che incorporano un'interfaccia utente utilizzano l'URL azione per definire l'indirizzo della pagina da visualizzare. L'URL azione viene utilizzato per specificare l'endpoint REST se la posizione è un'azione (menu contestuale, elemento della barra degli strumenti, azione in una finestra di dialogo ecc.) e il tipo di azione è GET o POST. Se la posizione è un'azione e l'azione è Apri in una nuova finestra, l'URL azione è l'URL da aprire nella nuova finestra.

     • Consulta Parametri dell'URL azione nella documentazione per gli sviluppatori per un elenco di parametri che possono essere utilizzati in questo campo.

   • Tipo di azione: applicabile per le posizioni che non incorporano interfacce utente. I tipi di azione supportati sono:

     • GET: effettua una chiamata API GET utilizzando l'URL azione. La sostituzione dei parametri viene effettuata sull'URL azione.

     • POST: effettua una chiamata API POST utilizzando l'URL azione e il corpo azione come corpo della richiesta. La sostituzione dei parametri viene effettuata sia sull'URL azione che sul corpo azione.

     • Apri in una nuova finestra: apre l'URL azione in una nuova finestra del browser. La sostituzione dei parametri viene effettuata sull'URL azione.

   • Corpo azione: applicabile solo ai tipi di azione POST. Il corpo azione viene passato in una chiamata API POST e deve essere in un formato JSON valido.

   • Mostra risposta: applicabile solo se il tipo di azione è GET o POST. Quando è selezionata, l'interfaccia utente attende una risposta e la mostra in una finestra di dialogo nell'interfaccia utente. La risposta deve essere in un formato JSON valido.

   • Icona: l'icona viene visualizzata dove esiste l'estensione, ad esempio un'icona in un pannello delle informazioni, un'azione del menu contestuale, un pulsante nella barra degli strumenti, un pulsante di azione in una finestra di dialogo o altre posizioni supportate.

5. Fai clic su OK.

Per ulteriori informazioni sulla creazione e la gestione delle applicazioni Onshape, consulta la Documentazione per gli sviluppatori di Onshape. Consulta il tutorial Hello World per un esempio pratico.

Gli amministratori possono aggiungere utenti interni alle applicazioni per effettuare dei test prima di inviarle all'App Store Onshape. Gli utenti aggiunti qui visualizzeranno automaticamente le estensioni delle app associate nella loro interfaccia utente di Onshape, senza dover effettuare l'abbonamento tramite l'App Store.

1. Una volta registrata la tua app, fai clic su Applicazioni nel riquadro a sinistra.

2. Seleziona l'applicazione nell'elenco.

   

3. Inizia a digitare il nome o l'indirizzo email di un utente, team o alias nel campo Aggiungi utenti o team e seleziona un risultato dall'elenco. L'amministratore che ha creato l'app viene inserito automaticamente nell'elenco Utenti. Continua ad aggiungere nomi o indirizzi email.

   

4. Fai clic sul pulsante Aggiungi.

Non è possibile aggiungere utenti Light alle applicazioni.

Per rimuovere un utente, un alias o un team dall'app, fai clic sulla relativa icona X nella colonna Rimuovi.

1. Nelle tue impostazioni per sviluppatori, fai clic su Applicazioni OAuth.
2. Fai clic sul nome dell'app da trasferire.
3. Click the Transfer ownership button on the Details tab. The Transfer ownership dialog opens.

   

4. Seleziona un'opzione per trasferire l'app a una persona, un'azienda o un'enterprise.
5. Per il trasferimento a una persona fisica, inserisci il nome o l'indirizzo email del nuovo proprietario nel campo di ricerca. Per trasferire la proprietà a una società o enterprise, seleziona un'opzione nel menu a discesa.
6. Fai clic su Trasferisci proprietà. L'applicazione è rimossa dall'elenco delle tue app OAuth.
   • Se l'app viene trasferita a un account individuale, questo riceverà una notifica via email e l'app sarà visualizzata nel Portale sviluppatori Onshape dell'account.
   • Se l'app viene trasferita a un utente di un'azienda/aula/Enterprise, tutti gli amministratori riceveranno una notifica via email e l'app sarà visualizzata nelle Impostazioni sviluppatore dell'utente.

Il consumo e la fatturazione futuri delle chiamate API saranno attribuiti al nuovo proprietario. Vedi Limiti delle API per i dettagli.

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.

Per creare una nuova voce store per un'applicazione OAuth:

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. Compila il modulo:

   • Nome: impostato automaticamente in base al nome dell'app fornito durante la registrazione.

   • Riepilogo: impostato automaticamente dal riepilogo fornito durante la registrazione.

   • Tipo: tipo di applicazione: App cloud integrata, App cloud connessa o App desktop connessa. Il tipo deve corrispondere al Tipo selezionato al momento della registrazione dell'applicazione OAuth.

   • Categoria: seleziona la categoria appropriata per la tua app.

   • Visibilità del team: scegli se rendere la voce privata dell'App Store visibile a nessun utente interno (impostazione predefinita), a tutti gli utenti interni o a team specifici.

   • Descrizione: descrizione dell'applicazione visibile all'utente. È consentita una formattazione limitata.

   • URL di supporto: l'URL o l'indirizzo email a cui gli utenti della tua app devono essere indirizzati per ricevere assistenza. Deve essere monitorato regolarmente.

   • Email di supporto: indirizzo email che deve ricevere le notifiche degli abbonamenti all'app. Deve essere monitorato attivamente.

   • Rivenditore: il nome della tua azienda.

   • Versione: la versione corrente di questa applicazione.

   • Immagini: facoltativamente, carica riepilogo, hero e altre immagini.

4. Fai clic su Crea.

L'applicazione appare nell'App Store Onshape come privata. È visibile solo a te e agli eventuali team interni specificati nelle impostazioni di Visibilità team. Per rendere pubblica l'app, consulta successivamente l'elenco di controllo per il lancio.

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. Fai di nuovo clic su Elimina per confermare.