4.15.07.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ì 8 settembre 2015 abbiamo rilasciato una versione trimestrale del portale Apigee Edge Developer Services per il cloud privato.

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

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.

Requisiti di Apigee Edge per il portale

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

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-584 Parametro Path non memorizzato al primo utilizzo
Il parametro Path non veniva sempre memorizzato quando si effettuavano chiamate.
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-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-723 Mostrare messaggi facili da comprendere in caso di errore di importazione di SmartDocs
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-1244 Non attivare il modulo Indicatore dell'ambiente per le release OPDK
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 alla versione GA
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:

Errore fatale: chiamata a una funzione 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

Si tratta di un bug che interessa solo i clienti di Monetizzazione 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 di 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
Quando esegui Drupal cron, un numero elevato di sviluppatori causerebbe un problema di timeout. Quando un'organizzazione ha più di 200 utenti, ora viene utilizzata una procedura batch.
DEVSOL-1410 Errori di connessione non evidenti durante l'installazione del Dev Portal
Sono stati aggiunti messaggi di errore migliori all'installatore quando la connessione di gestione di Edge non funziona per minimizzare i problemi di risoluzione dei problemi.
DEVSOL-1422 Rimuovere il modulo di configurazione SMTP dal profilo Apigee
La procedura di installazione non chiede più se vuoi configurare SMTP, ma puoi farlo al termine dell'installazione seguendo la procedura standard di Drupal per attivare il modulo SMTP e configurarlo correttamente.
DEVSOL-1427

Aggiungi hook al modulo Devconnect Developer Apps 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 delle app per sviluppatori.

DEVSOL-1464 Errore fatale 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 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.
DEVSOL-1486 Le chiamate SmartDocs possono autenticarsi con una chiave predefinita
Consente l'autenticazione con chiavi API fornite dall'utente e predefinite.
DEVSOL-1499 Codice HTML non analizzato nelle descrizioni dei parametri di SmartDocs
Ora il codice HTML viene analizzato nelle descrizioni dei parametri di SmartDocs.
DEVSOL-1507 Impossibile aggiungere più parametri a un'API con il metodo Aggiungi
Ora puoi aggiungere più parametri a un'API SmartDocs quando modifichi il metodo.
DEVSOL-1509 Non riesco a trovare un modo per modificare il campo "sample " per un'API SmartDocs
Ora puoi impostare "Tipo MIME del corpo", "Documentazione del corpo" e "Esempio del corpo" quando modifichi una pagina SmartDocs.
DEVSOL-1534 Il tipo di contenuto non viene compilato nell'output di SmartDocs
Ora il tipo di contenuto viene compilato nella pagina del metodo SmartDocs.
DEVSOL-1554 Confronto delle date non valido in Monetizzazione
Nella scheda del piano acquistato per i portali per sviluppatori con la monetizzazione abilitata, il pulsante "Annulla" non è mai stato visualizzato per un piano con una data di inizio futura,
DEVSOL-1556 Versione precedente dei moduli Drupal in uso
Il modulo media_youtube e il modulo 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 di esempio di SmartDocs PetStore ora vengono visualizzati correttamente.
DEVSOL-1562 Genera una vista per ogni modello SmartDocs
Quando crei un nuovo modello, per impostazione predefinita viene creata una nuova vista per quel modello.
DEVSOL-1565 La modifica del metodo SmartDocs genera un errore fatale
È stato risolto il problema per cui la modifica di un metodo SmartDocs a volte generava un errore.
DEVSOL-1567 "Aggiungi modello" visualizzato nel menu di amministrazione superiore
È stato risolto il problema relativo alla visualizzazione della voce di menu "Aggiungi modello" nel menu di amministrazione superiore.
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 stai eseguendo l'aggiornamento alla release e hai modificato questa visualizzazione, dovrai ripristinarla per visualizzare le modifiche seguendo questi passaggi: # Accedi come amministratore # Vai a Struttura > Visualizzazioni # Fai clic sul menu a discesa accanto a "Modifica" in "Modelli SmartDocs" per visualizzare tutte le operazioni. # Se vedi "revert", significa che hai sovrascritto il codice con la tua modifica. Fai clic su "Ripristina" per ripristinare lo stato predefinito della vista. Tieni presente che verranno rimosse tutte le modifiche apportate a questa visualizzazione.
DEVSOL-1578 Esegui il rendering di entrambi i modelli di SmartDocs di Meteo e Petstore nelle installazioni dei siti
Entrambi i modelli di SmartDocs di Petstore e Meteo vengono importati nei nuovi siti.
DEVSOL-1584 Impossibile acquistare i piani
È stato risolto il problema relativo alla mancata invio del modulo di acquisto dei piani di monetizzazione per le release cloud 15.05.27.00 e 15.06.08.00 se utilizzavi il tema Apigee Responsive o un sottotema del tema Apigee Responsive.
DEVSOL-1597 Impossibile modificare le impostazioni di timeout per gli sviluppatori
È stato corretto un bug per cui le impostazioni di timeout della connessione Edge non venivano applicate correttamente.
DEVSOL-1620

Upgrade dei moduli Me, indicatore dell'ambiente e funzionalità
Aggiornamento della sicurezza moderatamente critico per il modulo Me 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 "&" per evitare che reCAPTCHA si rompa
È stato risolto un problema relativo alla piattaforma che impediva l'utilizzo di Google reCAPTCHA.
DEVSOL-1651 Il tema Apigee Base non funziona se il modulo SmartDocs non è abilitato
Il tema apigee_base non dipende più dall'abilitazione del modulo SmartDocs.
DEVSOL-1654

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

  • Visualizzazioni amministrative
  • Esegui migrazione
  • Reindirizzamento
  • Redis
  • Operazioni collettive sulle visualizzazioni