Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Martedì 2 giugno 2015 abbiamo rilasciato una nuova versione cloud del portale dei servizi per sviluppatori Apigee.
In caso di domande, contatta l'assistenza di Apigee Edge.
Per un elenco di tutte le note di rilascio di Apigee Edge, consulta Note di rilascio di Apigee.
Nuove funzionalità
Disponibilità generale di SmartDocs
SmartDocs passa dalla versione beta alla disponibilità generale. Gli aggiornamenti e le nuove funzionalità includono:
- Supporto per Swagger 2.0, inclusa l'importazione tramite file o URL, incluso il supporto per oggetti di sicurezza con nomi personalizzati.
- Miglioramenti del design visivo nei modelli che generano SmartDocs.
- Miglioramenti dell'usabilità e del flusso di lavoro nel portale per gli sviluppatori, disponibile tramite il menu Contenuti > SmartDocs in Drupal.
- L'autenticazione "Token personalizzato" è ora denominata "Chiave API".
- Oggetti di "sicurezza" di autenticazione definiti a livello di revisione.
- Configurazione dell'autenticazione del client a livello di modello. Le nuove revisioni non reimpostano più le credenziali client di SmartDocs preconfigurate.
Per ulteriori descrizioni delle funzionalità, consulta questo blog post.
Per la documentazione di SmartDocs, consulta Utilizzare SmartDocs per documentare le API.
Procedura di upgrade di SmartDocs
Se hai già utilizzato SmartDocs durante il periodo beta, le nuove funzionalità e capacità della versione di disponibilità generale richiedono l'upgrade di SmartDocs nel portale per gli sviluppatori.
Le pagine di SmartDocs già pubblicate nel portale per sviluppatori continueranno a funzionare, ma devi seguire la procedura di aggiornamento prima di modificare o pubblicare le modifiche alle pagine esistenti o nuove.
Tieni presente che, sebbene tu possa eseguire il rendering e pubblicare SmartDocs all'interno del portale per sviluppatori, SmartDocs viene generato dal modello API che si trova all'interno dei servizi di gestione delle API Edge di Apigee. Le modifiche apportate a un modello API in Edge saranno le stesse in tutti gli ambienti Pantheon (in modo simile a come gli sviluppatori esistono negli ambienti Pantheon).
Per eseguire l'upgrade dalla versione beta di SmartDocs alla disponibilità generale
- Aggiorna e testa la release 15.05.27 negli ambienti di sviluppo o test su Pantheon.
- Crea un nuovo modello per sostituire qualsiasi modello API esistente che hai utilizzato.
- Se hai importato documenti Swagger o WADL, importali di nuovo in una nuova revisione.
- Se hai gestito il modello API tramite il modulo SmartDocs, esportalo come SmartDocs JSON e importalo nel nuovo modello utilizzando l'allegato di file.
- Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti >
SmartDocs > modello, seleziona Impostazioni di sicurezza.
- Controlla l'autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti >
SmartDocs) facendo clic su Impostazioni nella colonna Operazioni.
- Aggiorna tutti i modelli personalizzati in modo che utilizzino la versione 6 degli asset CSS e JS e apporta modifiche per riflettere eventuali nuovi nomi di oggetti, come authSchemes e apiSchema. Per informazioni sull'aggiornamento dei modelli SmartDocs, consulta Utilizzare SmartDocs per documentare le API.
- Esegui di nuovo il rendering e pubblica la revisione del modello.
- Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla release 15.05.27.
Se sei un cliente aziendale Edge e hai domande o dubbi sulla procedura di upgrade, invia un'email a marsh@apigee.com e cnovak@apigee.com. In caso contrario, utilizza la community Apigee per ottenere la risposta migliore.
Bug corretti
In questa release sono stati corretti i seguenti bug.
| ID problema | Descrizione |
|---|---|
| DEVSOL-487 | Il formato del giorno in Monetizzazione deve essere configurabile dagli amministratori Il formato della data è ora configurabile in Monetizzazione nelle impostazioni di monetizzazione per i formati di data europei e statunitensi. |
| DEVSOL-603 | La pagina del piano di conflitto è formattata in modo errato Quando acquisti un piano che si sovrappone a un piano esistente, la pagina visualizzata è ora formattata correttamente per l'utente. |
| DEVSOL-642 | Sposta le configurazioni a livello di client dalle impostazioni di sicurezza alle impostazioni del modello settings |
| DEVSOL-709 | SmartDocs: il parametro del modello di URL non è modificabile dopo l'invio della richiesta con un valore vuoto Risolve il problema che rende i parametri del modello non modificabili dopo l'invio della richiesta da SmartDocs dopo aver eliminato il parametro del modello nella documentazione del metodo. |
| DEVSOL-1013 | Rendi modificabili gli indirizzi email degli utenti del portale per gli sviluppatori Il campo dell'indirizzo email nella pagina di modifica del profilo non sarà più disattivato e gli sviluppatori potranno modificare i propri indirizzi email. |
| DEVSOL-1273 | "DevConnect Mint" viene visualizzato due volte nell'elenco dei moduli In Moduli, "Dev Connect Mint" veniva visualizzato due volte. Il problema ora è stato risolto. |
| DEVSOL-1313 | Supporta l'importazione di file JSON/YAML o URL sia per Swagger che per WADL Ora è possibile importare i file WADL tramite URL e caricare i file Swagger. |
| DEVSOL-1339 | Modifica le posizioni del menu di amministrazione di SmartDocs SmartDocs si trova ora nel menu dei contenuti e le impostazioni di SmartDocs si trovano nel menu di amministrazione delle impostazioni. |
| DEVSOL-1340 | Rimuovi la versione beta quando passi alla disponibilità generale SmartDocs si trova ora nel menu dei contenuti e le impostazioni di SmartDocs si trovano nel menu di amministrazione delle impostazioni. |
| DEVSOL-1390 | La libreria Edge dell'SDK PHP è stata aggiornata per risolvere il problema della chiamata a
__toString() La libreria Edge dell'SDK PHP è stata aggiornata per risolvere il problema della chiamata a __toString() sull'oggetto DeveloperRatePlan che crea questo errore: {quote} Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 {quote} Si tratta di un bug che interessa solo i clienti di Monetizzazione con codice personalizzato che chiama il metodo toString(). |
| DEVSOL-1398 | Il modello Petstore di SmartDocs viene importato durante l'installazione senza richiedere all'utente SmartDocs ora importa l'esempio di Swagger di Petstore durante l'installazione del sito (http://petstore.swagger.io/v2/swagger.json) anziché il modello meteo per avere un esempio più esaustivo dell'utilizzo di SmartDocs. |
| DEVSOL-1407 | Cron non riesce quando ci sono molti sviluppatori Quando si esegue cron di Drupal, un numero elevato di sviluppatori ha causato un problema di timeout. Quando un'organizzazione ha più di 200 utenti, ora viene utilizzato un processo batch. |
| DEVSOL-1470 | Crea il link del menu "API" e la visualizzazione corrispondente SmartDocs del portale per gli sviluppatori ora include per impostazione predefinita un link alla documentazione di SmartDocs di cui è stato eseguito il rendering nel menu principale denominato "API", che rimanda a tutti i modelli con metodi pubblicati. metodi. |
Problemi noti
Questa release contiene i seguenti problemi noti:
| ID problema | Descrizione |
|---|---|
| DEVSOL-1558 |
Le pagine dei metodi di SmartDocs dell'esempio di Petstore non vengono sottoposte a rendering correttamente in una nuova
installazione
Le pagine dei metodi di Petstore di esempio in SmartDocs non vengono sottoposte a rendering correttamente in una nuova
installazione. Per risolvere questo problema:
Ora i nodi dovrebbero essere sottoposti a rendering correttamente. |