15.05.27.00 - Note di rilascio del portale dei servizi per sviluppatori Apigee

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 di servizi per sviluppatori Apigee.

In caso di domande, contatta l'assistenza 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

Smart Docs passerà dalla versione beta alla disponibilità generale. Gli aggiornamenti e le nuove funzionalità includono:

  • Supporto di Swagger 2.0, incluso l'importazione per file o URL, incluso il supporto per oggetti di sicurezza con nome personalizzato.
  • Miglioramenti al design visivo nei modelli che generano Smart Docs.
  • Miglioramenti dell'usabilità e del flusso di lavoro nel portale per sviluppatori, disponibili tramite il menu Contenuti > Smart Docs in Drupal.
  • L'autenticazione nota come "token personalizzato" è ora denominata "chiave API".
  • Oggetti "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 SmartDocs preconfigurate.

Per ulteriori descrizioni delle funzionalità, consulta questo post del blog.

Per la documentazione di SmartDocs, consulta Utilizzare SmartDocs per documentare le API.

Procedura di upgrade di Smart Docs

Se hai già utilizzato SmartDocs durante il periodo beta, le nuove funzionalità nella versione di disponibilità generale richiedono l'upgrade di SmartDocs nel tuo portale per sviluppatori.

Tutte le pagine Smart Docs già pubblicate nel tuo portale per sviluppatori continueranno a funzionare, ma devi seguire la procedura di aggiornamento prima di modificare o pubblicare eventuali modifiche alle pagine esistenti o nuove.

Tieni presente che, sebbene tu possa eseguire il rendering e pubblicare SmartDocs all'interno del tuo portale per sviluppatori, SmartDocs vengono generate 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 Smart Docs alla disponibilità generale

  1. Aggiorna e testa la release 15.05.27 negli ambienti dev o test su Pantheon.
  2. 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.
  3. Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti > Smart Docs > modello, seleziona Impostazioni di sicurezza.
  4. Controlla l'eventuale autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti > Smart Docs) facendo clic su Impostazioni nella colonna Operazioni.
  5. 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.
  6. Esegui di nuovo il rendering e pubblica la revisione del modello.
  7. Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla versione 15.05.27.

Se sei un cliente aziendale di 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 ricevere 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 in conflitto è formattata male
Quando acquisti un piano che si sovrappone a un piano esistente, la pagina mostrata ora è formattata in modo ottimale per l'utente.
DEVSOL-642 Spostare le configurazioni a livello di cliente dalle impostazioni di sicurezza alle impostazioni del modello
DEVSOL-709 SmartDocs: il parametro del modello di URL non è modificabile dopo l'invio della richiesta con valore vuoto
Risolve il problema che rende i parametri del modello non modificabili dopo l'invio della richiesta da SmartDocs 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 verrà più disattivato e gli sviluppatori potranno modificare i propri indirizzi email.
DEVSOL-1273 "DevConnect Mint" viene visualizzato due volte nell'elenco dei moduli
Nella sezione Moduli, "Dev Connect Mint" veniva visualizzato due volte. Il problema ora è stato risolto.
DEVSOL-1313 Supporto dell'importazione di file JSON/YAML o URL per Swagger e WADL
Ora è possibile importare i file WADL tramite URL e caricare i file Swagger.
DEVSOL-1339 Modificare le posizioni del menu di amministrazione di Smart Docs
Smart Docs ora si trova nel menu dei contenuti e le impostazioni di Smart Docs nel menu di amministrazione delle impostazioni.
DEVSOL-1340 Rimozione della versione beta quando si passa a GA
Smart Docs ora si trova nel menu dei contenuti e le impostazioni di Smart Docs nel menu di amministrazione delle impostazioni.
DEVSOL-1390 La libreria PHP SDK Edge è stata aggiornata per risolvere il problema della chiamata a __toString()
La libreria PHP SDK Edge è stata aggiornata per risolvere il problema della chiamata a __toString() sull'oggetto DeveloperRatePlan che genera 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 Monetization con codice personalizzato che chiama il metodo toString().
DEVSOL-1398 Modello Smart Docs Petstore importato durante l'installazione senza richiedere l'intervento dell'utente
Smart Docs 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 Smart Docs.
DEVSOL-1407 Cron non funziona quando ci sono molti sviluppatori
Quando si esegue Drupal cron, 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 al menu "API" e la visualizzazione corrispondente
SmartDocs del portale per sviluppatori ora include per impostazione predefinita un link alla documentazione SmartDocs sottoposta a rendering nel menu principale denominato "API", che rimanda a tutti i modelli 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 dei metodi di esempio di Petstore in Smart Docs non vengono visualizzate correttamente in una nuova installazione. Per risolverlo:
  1. Seleziona Contenuti > Smart Docs nel menu Drupal.
  2. Seleziona il modello "Esempio Petstore".
  3. Seleziona Render and publish nodes (Esegui il rendering e pubblica i nodi) in Update Options (Opzioni di aggiornamento).
  4. Fai clic sulla casella di controllo Seleziona / Deseleziona tutto per selezionare tutti i nodi.
  5. Fai clic su Aggiorna.

Ora i nodi dovrebbero essere visualizzati correttamente.