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

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info

Martedì 2 giugno 2015 abbiamo rilasciato una nuova versione cloud del Portale dei servizi per sviluppatori Apigee.

Per qualsiasi domanda, contatta l'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 SmartDocs

SmartDocs passa dalla versione beta alla disponibilità generale. Gli aggiornamenti e le nuove funzionalità includono:

  • Supporto di Swagger 2.0, inclusa l'importazione tramite file o URL, nonché il supporto per gli oggetti di sicurezza con nomi personalizzati.
  • Miglioramenti al design visivo nei modelli che generano SmartDocs.
  • Miglioramenti all'usabilità e al flusso di lavoro nel portale per sviluppatori, disponibili tramite il menu Contenuti > SmartDocs in Drupal.
  • L'autenticazione "Token personalizzato" ora si chiama "Chiave API".
  • Oggetti "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 del 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 SmartDocs

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

Tutte le pagine SmartDocs già pubblicate nel tuo Developer Portal 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, anche se puoi visualizzare e pubblicare SmartDocs all'interno del tuo portale per sviluppatori, gli SmartDocs vengono generati dal modello API che si trova all'interno di Apigee's Edge API Management Services. Eventuali 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

  1. Aggiorna e testa la release del 27/05/15 nei tuoi ambienti di sviluppo 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 gestisci il modello API tramite il modulo SmartDocs, esportalo come JSON di SmartDocs e importalo nel nuovo modello utilizzando l'allegato del file.
  3. Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti > SmartDocs > modello, seleziona Impostazioni di sicurezza.
  4. Controlla l'autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti > SmartDocs) facendo clic su Impostazioni nella colonna Operazioni.
  5. Aggiorna i modelli personalizzati in modo da utilizzare la versione 6 degli asset CSS e JS e apporta le modifiche necessarie per riflettere eventuali nuovi nomi di oggetti, come authSchemes e apiSchema. Per informazioni sull'aggiornamento dei modelli di SmartDocs, consulta Utilizzare SmartDocs per documentare le API.
  6. Esegui nuovamente il rendering e pubblica la revisione del modello.
  7. Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla release del 27/05/15.

Se sei un cliente Edge Enterprise e hai domande o dubbi sulla procedura di upgrade, invia un'email all'indirizzo 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
Ora il formato della data è configurabile in Monetizzazione nelle impostazioni di monetizzazione per i formati delle date europei e statunitensi.
DEVSOL-603 La pagina del piano in conflitto non è formattata correttamente
Quando acquisti un piano che si sovrappone a un piano esistente, la pagina mostrata ora è formattata in modo piacevole per l'utente.
DEVSOL-642 Spostare le configurazioni a livello di client dalle impostazioni di sicurezza alle impostazioni del modello
DEVSOL-709 SmartDocs: parametro del modello di URL non modificabile dopo l'invio della richiesta con valore vuoto
È stato risolto il problema che rendeva 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 sarà 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" è 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 le posizioni del menu Amministrazione di SmartDocs
Ora SmartDocs si trova nel menu Contenuti e le impostazioni di SmartDocs nel menu Amministrazione delle impostazioni.
DEVSOL-1340 Rimuovere la versione beta quando si passa a GA
SmartDocs ora si trova nel menu Contenuti e le impostazioni di SmartDocs si trovano nel menu Amministrazione delle impostazioni.
DEVSOL-1390 La libreria PHP SDK Edge è stata aggiornata per risolvere il problema di chiamata di __toString()
La libreria PHP SDK Edge è stata aggiornata per risolvere il problema di chiamata di __toString() sull'oggetto DeveloperRatePlan, che genera questo errore: {quote} Errore fatale: chiamata a una funzione di membro format() su un non-oggetto in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php nella riga 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 SmartDocs Petstore importato durante l'installazione senza richiedere all'utente
Ora SmartDocs importa l'esempio swagger del negozio di animali domestici 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 va a buon fine quando ci sono molti sviluppatori
Durante l'esecuzione di Drupal cron, un numero elevato di sviluppatori ha causato un problema di timeout. Quando un'organizzazione ha più di 200 utenti, ora viene utilizzata una procedura batch.
DEVSOL-1470 Crea link al menu "API" e visualizzazione corrispondente
Ora, per impostazione predefinita, SmartDocs del portale per sviluppatori include un link alla documentazione di SmartDocs visualizzata 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 dei metodi SmartDocs dell'esempio 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:
  1. Seleziona Contenuti > SmartDocs nel menu di Drupal.
  2. Seleziona il modello "Esempio di negozio di animali domestici".
  3. Seleziona Esegui il rendering e pubblica i nodi in 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.