Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Martedì 2 giugno 2015 abbiamo rilasciato una nuova versione cloud del portale Apigee Developer Services.
Se hai domande, rivolgiti all'assistenza clienti Apigee.
Per un elenco di tutte le note di rilascio di Apigee Edge, consulta le note di rilascio di Apigee.
Nuove funzionalità
Disponibilità generale di SmartDocumenti
SmartDocumenti sta passando dalla versione beta alla disponibilità generale. Gli aggiornamenti e le nuove funzionalità includono:
- Supporto per Swagger 2.0, inclusa l'importazione per file o URL, incluso il supporto per oggetti di sicurezza con nomi personalizzati.
- Miglioramenti del design visivo nei modelli che generano SmartDocumenti.
- Miglioramenti a livello di usabilità e del flusso di lavoro nel Portale per gli sviluppatori, disponibili tramite il menu Contenuti > SmartDocumenti in Drupal.
- L'autenticazione nota come "token personalizzato" ora si chiama "Chiave API".
- Oggetti di "sicurezza" di autenticazione definiti a livello di revisione.
- Configurazione dell'autenticazione client a livello di modello. Le nuove revisioni non reimpostano più le credenziali client SmartDocumenti preconfigurate.
Per ulteriori descrizioni delle funzionalità, consulta questo post del blog.
Per la documentazione di SmartDocuments, vedi Utilizzare SmartDocs per documentare le API.
Processo di upgrade di SmartDocumenti
Se hai già utilizzato SmartDocumenti durante il periodo beta, le nuove funzionalità e caratteristiche nella versione di disponibilità generale richiedono l'upgrade di SmartDocumenti nel tuo portale per gli sviluppatori.
Tutte le pagine SmartDocumenti già pubblicate nel tuo portale per gli sviluppatori continueranno a funzionare, ma devi seguire la procedura di aggiornamento prima di modificare o pubblicare eventuali modifiche a pagine nuove o esistenti.
Tieni presente che anche se puoi eseguire il rendering e la pubblicazione di SmartDocumenti all'interno del tuo portale per gli sviluppatori, gli SmartDocuments vengono generati 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 esistono gli sviluppatori negli ambienti Pantheon).
Per eseguire l'upgrade dalla versione beta di SmartDocumenti alla disponibilità generale
- Aggiorna e testa la release 15.05.27 nei tuoi ambienti dev o test su Pantheon.
- Crea un nuovo modello per sostituire l'eventuale modello API esistente che utilizzi.
- Se stai importando documenti Swagger o WADL, importali di nuovo in una nuova revisione.
- Se stai gestendo il tuo modello API tramite il modulo SmartDocumenti, esportalo in formato JSON SmartDocuments e importalo nel nuovo modello utilizzando un file allegato.
- Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti > SmartDocumenti > modello, seleziona Impostazioni di sicurezza.
- Controlla un'eventuale autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti > SmartDocuments) facendo clic su Impostazioni nella colonna Operazioni.
- Aggiorna gli eventuali modelli personalizzati per utilizzare la versione 6 degli asset CSS e JS e apporta modifiche in base ai nuovi nomi degli oggetti, ad esempio authSchemes e apiSchema. Per informazioni sull'aggiornamento dei modelli SmartDocumenti, vedi Utilizzare SmartDocs per documentare le API.
- Esegui nuovamente il rendering e pubblica la revisione del modello.
- Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla release del 15/05/27.
Se sei un cliente Edge Enterprise e hai domande o dubbi sul processo di upgrade, invia un'email a marsh@apigee.com e cnovak@apigee.com. Altrimenti, utilizza la community Apigee per ricevere la risposta migliore.
Bug corretti
In questa release sono stati corretti i bug indicati di seguito.
| 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 Piano di conflitto non è formattata correttamente Quando acquisti un piano che si sovrappone a un piano esistente, la pagina mostrata ora è formattata correttamente per l'utente. |
| DEVSOL-642 | Sposta le configurazioni a livello di client dalle impostazioni di sicurezza alle impostazioni dei modelli |
| DEVSOL-709 | SmartDocumenti: parametro del modello di URL non modificabile dopo l'invio della richiesta con valore vuoto Risolvi il problema che rende i parametri del modello non modificabili dopo l'invio della richiesta da SmartDocumenti dopo l'eliminazione del parametro del modello nella documentazione del metodo. |
| DEVSOL-1013 | Rendere 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 Moduli Nella sezione Moduli, "Dev Connect Mint" è stato visualizzato due volte. Il problema ora è stato risolto. |
| DEVSOL-1313 | Supporto dell'importazione di file JSON/YAML o URL sia per Swagger che per WADL Ora i file WADL possono essere importati tramite URL e i file Swagger possono essere caricati. |
| DEVSOL-1339 | Modificare la posizione del menu Amministratore SmartDocumenti Ora SmartDocumenti si trova nel menu Contenuti e le impostazioni di SmartDocumenti si trovano nel menu Amministratore delle impostazioni. |
| DEVSOL-1340 | Rimuovi la versione beta quando si accede a GA SmartDocumenti si trova ora nel menu Contenuti e le impostazioni di Smartdocs si trovano nel menu Amministratore impostazioni. |
| DEVSOL-1390 | La libreria Edge SDK PHP è stata aggiornata per risolvere il problema di chiamata a
__toString() La libreria Edge SDK PHP è stata aggiornata per risolvere il problema di chiamata di __toString() sull'oggetto DeveloperRatePlan che crea questo errore: {quote} Errore irreversibile: Chiamare a un membro format() su un oggetto non-oggetto in /Applications/MAMP/htdocs/ordnance/phpliram/italia sul metodo Apigee-frame-frame-frame-frame-work-pipe.d4-on-sp. su un metodo non-oggetto in/Applications/MAMP/htdocs/ordnance/phpliram/italia su un'immagine |
| DEVSOL-1398 | Modello Petstore di SmartDocs importato all'installazione senza chiedere all'utente di SmartDocs ora importa l'esempio di spavalderia del negozio di animali durante l'installazione del sito (http://petstore.swagger.io/v2/swagger.json) anziché il modello meteorologico per avere un esempio più esaustivo dell'utilizzo di SmartDocumenti. |
| DEVSOL-1407 | Il crono non funziona se il numero di sviluppatori è elevato Durante l'esecuzione di Drupal cron, un numero elevato di sviluppatori ha causato un problema di timeout. Se un'organizzazione ha più di 200 utenti, viene utilizzata una procedura batch. |
| DEVSOL-1470 | Crea un link al menu "API" e alla visualizzazione corrispondente Per impostazione predefinita, SmartDocs del Portale per sviluppatori include ora un link alla documentazione visualizzata da SmartDocumenti nel menu principale denominato "API", che rimanda a qualsiasi modello con metodi pubblicati. |
Problemi noti
Questa release contiene i seguenti problemi noti:
| ID problema | Descrizione |
|---|---|
| DEVSOL-1558 |
Le pagine del metodo Smart Docs di esempio di Petstore non vengono visualizzate correttamente in una nuova installazione
Le pagine di esempio del metodo Petstore in SmartDocs non vengono visualizzate correttamente in una nuova installazione. Per risolverlo:
Ora i nodi dovrebbero essere visualizzati correttamente. |