4.15.07.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ì 8 settembre 2015 abbiamo rilasciato una versione trimestrale del portale di servizi per sviluppatori Apigee Edge per Private Cloud.

Il nome precedente del prodotto "Apigee Edge On-premises Developer Services Portal" o "OPDK" è ora "Apigee Edge Developer Services Portal for Private Cloud".

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.

Requisiti di Apigee Edge per il portale

Se colleghi questa release del portale a un'installazione di Edge for Private Cloud, devi connetterla alla versione 4.15.07.00 o successive per assicurarti che tutte le funzionalità di Smart Docs siano supportate. Per saperne di più, consulta le note di rilascio di 4.15.07.00 - Apigee Edge for Private Cloud.

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-584 Parametro percorso non memorizzato al primo utilizzo
Il parametro percorso durante le chiamate non veniva sempre memorizzato.
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-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-723 Mostra messaggi intuitivi in caso di errore di importazione di Smart Docs
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-1244 Non attivare il modulo Indicatore ambiente per le release OPDK
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 Rimuovere la versione beta quando si passa alla disponibilità generale
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:

Errore irreversibile: chiamata alla funzione membro format() su un non oggetto in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php alla riga 221

Si tratta di un bug che interessa solo i clienti della monetizzazione con codice personalizzato che chiama il metodo toString().

DEVSOL-1398 Modello Petstore Smart Docs 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 riesce a essere eseguito quando ci sono molti sviluppatori
Quando viene eseguito Drupal cron, un numero elevato di sviluppatori causerebbe un problema di timeout. Quando un'organizzazione ha più di 200 utenti, ora viene utilizzato un processo batch.
DEVSOL-1410 Errori di connessione non evidenti durante l'installazione del portale degli sviluppatori
Sono stati aggiunti messaggi di errore migliori al programma di installazione quando la connessione di gestione Edge non funziona per ridurre al minimo i problemi di risoluzione dei problemi.
DEVSOL-1422 Rimuovi il modulo di configurazione SMTP dal profilo Apigee
La procedura di installazione non ti chiede più se vuoi configurare SMTP. Questa operazione può essere eseguita dopo il completamento dell'installazione seguendo la procedura standard di Drupal per attivare il modulo SMTP e configurarlo correttamente.
DEVSOL-1427

Aggiungi hook al modulo App per sviluppatori Devconnect per consentire la modifica dei dati di analisi
Il modulo devconnect_developer_apps ora fornisce tre nuovi hook:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

Questi consentono ai moduli personalizzati di modificare il grafico di analisi dell'app per sviluppatori.

DEVSOL-1464 Errore irreversibile durante il salvataggio delle impostazioni di autenticazione per un modello
Quando viene eliminato uno schema di sicurezza, ora viene visualizzata una casella di controllo per selezionare se deve essere eliminato anche lo schema di autenticazione del modello associato.
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.
DEVSOL-1486 Le chiamate Smart Docs possono autenticarsi con una chiave predefinita
Consente l'autenticazione con chiavi API fornite in precedenza e fornite dall'utente.
DEVSOL-1499 Codice HTML non analizzato nelle descrizioni dei parametri di Smart Docs
Il codice HTML viene ora analizzato nelle descrizioni dei parametri di Smart Docs.
DEVSOL-1507 Impossibile aggiungere più parametri a un'API con Add Method
Ora puoi aggiungere più parametri a un'API Smart Docs quando modifichi il metodo.
DEVSOL-1509 Non riesci a trovare un modo per modificare il campo "Esempio " per un'API Smart Docs
Ora puoi impostare "Tipo MIME del corpo", "Documentazione del corpo" ed "Esempio del corpo" quando modifichi una pagina Smart Docs.
DEVSOL-1534 Il tipo di contenuti non viene compilato nell'output di SmartDocs
Il tipo di contenuti viene ora compilato nella pagina del metodo SmartDocs.
DEVSOL-1554 Confronto di date non valido nella monetizzazione
Nella scheda del piano acquistato per i portali per sviluppatori con monetizzazione abilitata, il pulsante "Annulla" non è mai stato visualizzato per un piano con una data di inizio futura.
DEVSOL-1556 Viene spedita la vecchia versione dei moduli Drupal
I moduli media_youtube e features sono stati aggiornati all'ultima versione.
DEVSOL-1558 Le pagine dei metodi SmartDocs non vengono visualizzate per l'esempio PetStore
Nelle nuove installazioni, i metodi SmartDocs PetStore di esempio vengono ora visualizzati correttamente.
DEVSOL-1562 Genera una vista per ogni modello Smart Docs
Quando crei un nuovo modello, per impostazione predefinita viene creata una nuova vista per quel modello.
DEVSOL-1565 La modifica del metodo Smart Docs genera un errore irreversibile
Risolto il problema per cui la modifica di un metodo Smart Docs a volte generava un errore.
DEVSOL-1567 "Aggiungi modello" visualizzato nel menu di amministrazione in alto
È stato risolto il problema per cui la voce di menu "Aggiungi modello" viene visualizzata nel menu di amministrazione in alto.
DEVSOL-1576 La visualizzazione della documentazione dell'API mostra il nome del modello, non il nome visualizzato
La pagina della documentazione dell'API visualizzata quando si fa clic su "API" nel menu mostrava il nome interno del modello anziché il nome visualizzato. Se esegui l'aggiornamento alla release e hai modificato questa visualizzazione, dovrai ripristinarla per visualizzare queste modifiche seguendo questi passaggi: # Accedi come amministratore # Vai a Struttura > Viste # Fai clic sul menu a discesa accanto a "Modifica" in "Modelli Smart Docs" per visualizzare tutte le operazioni. # If you see "revert", then you have overwritten the code w/your own change. Fai clic su "Ripristina" per riportare la visualizzazione allo stato predefinito. Tieni presente che verranno rimosse tutte le modifiche apportate a questa visualizzazione.
DEVSOL-1578 Esegui il rendering dei modelli Meteo e Pet Store nelle installazioni dei siti
I modelli Smart Docs Pet Store e Meteo vengono importati nei nuovi siti.
DEVSOL-1584 I piani non possono essere acquistati
È stato risolto il problema per cui il modulo di acquisto dei piani di monetizzazione non veniva inviato per la release cloud 15.05.27.00 e 15.06.08.00 se utilizzavi il tema Apigee Responsive o un tema secondario del tema Apigee Responsive.
DEVSOL-1597 Impossibile modificare le impostazioni di timeout dello sviluppatore
È stato corretto un bug per cui le impostazioni di timeout della connessione Edge non venivano applicate correttamente.
DEVSOL-1620

Aggiornamenti del modulo Io, dell'indicatore dell'ambiente e delle funzionalità
Aggiornamento della sicurezza moderatamente critico per il modulo Io e aggiornamenti dei moduli per l'indicatore dell'ambiente e le funzionalità. Altre informazioni:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 Assicurati che arg_separator.output sia impostato su "&" per evitare problemi con reCAPTCHA
È stato risolto un problema relativo alla piattaforma in cui l'utilizzo di Google reCAPTCHA non funzionava.
DEVSOL-1651 Il tema di base Apigee non funziona se il modulo SmartDocs non è abilitato
Il tema apigee_base non dipende più dall'abilitazione del modulo SmartDocs.
DEVSOL-1654

Aumenta la versione di admin_views per applicare la correzione di sicurezza critica
Sono stati aggiornati i seguenti moduli contrib:

  • Visualizzazioni amministrative
  • Esegui migrazione
  • Reindirizzamento
  • Redis
  • Visualizzare le operazioni collettive