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 dei servizi per gli sviluppatori di Apigee Edge per il cloud privato.
Il nome precedente del prodotto "Portale dei servizi per gli sviluppatori on-premise di Apigee Edge" o "OPDK" è ora "Portale dei servizi per gli sviluppatori di Apigee Edge per il cloud privato".
In caso di domande, contatta l'assistenza di 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 stai collegando questa release del portale a un'installazione di Edge for Private Cloud, devi collegarla alla versione 4.15.07.00 o successive per assicurarti che tutte le funzionalità di SmartDocs siano supportate. Per ulteriori informazioni, consulta le note di rilascio della versione 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 per Swagger 2.0, inclusa l'importazione tramite file o URL, incluso il supporto per oggetti di sicurezza con nomi personalizzati.
- Miglioramenti della progettazione visiva nei modelli che generano SmartDocs.
- Miglioramenti dell'usabilità e del flusso di lavoro nel portale per gli sviluppatori, disponibili tramite il menu Contenuti > SmartDocs in Drupal.
- L'autenticazione "Token personalizzato" è ora denominata "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 SmartDocs preconfigurate.
Per ulteriori descrizioni delle funzionalità, consulta questo blog post.
Per la documentazione di SmartDocs, consulta Utilizzare SmartDocs per documentare le API.
Procedura di upgrade di SmartDocs
Se hai già utilizzato SmartDocs durante il periodo beta, le nuove funzionalità e capacità della versione di disponibilità generale richiedono l'upgrade di SmartDocs nel portale per gli sviluppatori.
Le pagine SmartDocs già pubblicate nel 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 portale per sviluppatori, SmartDocs viene generato 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 (analogamente a come gli sviluppatori esistono in tutti gli ambienti Pantheon).
Per eseguire l'upgrade dalla versione beta di SmartDocs alla disponibilità generale
- Aggiorna e testa la release 15.05.27 negli ambienti di sviluppo o test su Pantheon.
- 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.
- Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti >
SmartDocs > modello, seleziona Impostazioni di sicurezza.
- Controlla l'autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti >
SmartDocs) facendo clic su Impostazioni nella colonna Operazioni.
- 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.
- Esegui di nuovo il rendering e pubblica la revisione del modello.
- Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla release 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 ottenere la risposta migliore.
Bug corretti
In questa release sono stati corretti i seguenti bug.
| ID problema | Descrizione |
|---|---|
| DEVSOL-487 | Il formato della data 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 | Il parametro del percorso non viene ricordato al primo utilizzo Il parametro del percorso durante le chiamate non veniva sempre ricordato. |
| DEVSOL-603 | La pagina del piano di conflitto è formattata in modo errato Quando acquisti un piano che si sovrappone a un piano esistente, la pagina visualizzata è ora formattata correttamente per l'utente. |
| DEVSOL-709 | SmartDocs: il parametro del modello di URL non è modificabile dopo l'invio della richiesta con un 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 SmartDocs |
| DEVSOL-1013 | Rendi 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 ambiente per le release OPDK |
| DEVSOL-1273 | "DevConnect Mint" viene visualizzato due volte nell'elenco dei moduli In Moduli, "Dev Connect Mint" veniva visualizzato due volte. Il problema ora è stato risolto. |
| DEVSOL-1313 | Supporta l'importazione di file JSON/YAML o URL sia per Swagger che per WADL Ora è possibile importare i file WADL tramite URL e caricare i file Swagger. |
| DEVSOL-1339 | Modifica le posizioni del menu di amministrazione di SmartDocs SmartDocs si trova ora nel menu dei contenuti e le impostazioni di SmartDocs si trovano nel menu di amministrazione delle impostazioni. |
| DEVSOL-1340 | Rimuovi la versione beta quando passi alla disponibilità generale |
| DEVSOL-1390 |
La libreria Edge dell'SDK PHP è stata aggiornata per risolvere il problema della chiamata a
__toString() 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 Si tratta di un bug che interessa solo i clienti di Monetizzazione con codice personalizzato che chiama il metodo toString(). |
| DEVSOL-1398 | Il modello SmartDocs Petstore viene importato durante l'installazione senza richiedere all'utente SmartDocs ora importa l'esempio 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 SmartDocs. |
| DEVSOL-1407 | Cron non riesce a essere eseguito quando ci sono molti sviluppatori Quando esegui cron di Drupal, un numero elevato di sviluppatori causava un problema di timeout. Quando un' organizzazione ha più di 200 utenti, ora viene utilizzato un processo batch. |
| DEVSOL-1410 | Gli errori di connessione non sono evidenti durante l'installazione del portale per gli sviluppatori Sono stati aggiunti messaggi di errore migliori al programma di installazione quando la connessione di gestione di 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, ma puoi farlo 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 Devconnect Developer Apps per consentire la modifica dei
dati di analisi # 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 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 è necessario eliminare anche lo schema di autenticazione del modello associato. |
| DEVSOL-1470 | Crea un link di menu "API" e la visualizzazione corrispondente Il portale per gli sviluppatori SmartDocs ora include per impostazione predefinita un link alla documentazione di SmartDocs di cui è stato eseguito il rendering nel menu principale denominato "API", che rimanda a tutti i modelli con metodi pubblicati. |
| DEVSOL-1486 | Le chiamate SmartDocs possono essere autenticate con una chiave predefinita Consente l'autenticazione con chiavi API fornite in precedenza e fornite dall'utente. |
| DEVSOL-1499 | Il codice HTML non viene analizzato nelle descrizioni dei parametri di SmartDocs Il codice HTML viene ora analizzato nelle descrizioni dei parametri di SmartDocs. |
| DEVSOL-1507 | Impossibile aggiungere più parametri a un'API con Aggiungi metodo 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 "esempio" per un'API SmartDocs Ora puoi impostare "Tipo MIME del corpo", "Documentazione del corpo" ed "Esempio del corpo" quando modifichi una pagina SmartDocs. |
| DEVSOL-1534 | Il tipo di contenuto non viene compilato nell'output di SmartDocs Il tipo di contenuto viene ora compilato nella pagina del metodo SmartDocs. |
| DEVSOL-1554 | Confronto di date non valido in Monetizzazione Nella scheda del piano acquistato per i portali per gli sviluppatori con la monetizzazione attivata, il pulsante "Annulla" non veniva mai visualizzato per un piano con una data di inizio futura, |
| DEVSOL-1556 | Viene fornita la versione precedente dei moduli Drupal I moduli media_youtube e features sono stati aggiornati all'ultima versione. |
| DEVSOL-1558 | Le pagine dei metodi SmartDocs non vengono sottoposte a rendering per l'esempio di PetStore Nelle nuove installazioni, i metodi di esempio di SmartDocs PetStore ora vengono sottoposti a rendering correttamente. |
| DEVSOL-1562 | Genera una visualizzazione per ogni modello SmartDocs Quando crei un nuovo modello, per impostazione predefinita viene creata una nuova visualizzazione per quel modello. |
| DEVSOL-1565 | La modifica del metodo SmartDocs genera un errore irreversibile È stato risolto un problema per cui la modifica di un metodo SmartDocs a volte generava un errore. |
| DEVSOL-1567 | "Aggiungi modello" viene visualizzato nel menu di amministrazione principale È stato risolto il problema per cui la voce di menu "Aggiungi modello" veniva visualizzata nel menu di amministrazione principale. |
| 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 fai 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 > Visualizzazioni # Fai clic sul menu a discesa accanto a "Modifica" in "Modelli SmartDocs" per visualizzare tutte le operazioni. # Se vedi "Ripristina", significa che hai sovrascritto il codice con la tua modifica. Fai clic su "Ripristina" per riportare la visualizzazione allo stato predefinito. Tieni presente che questa operazione rimuoverà tutte le modifiche apportate a questa visualizzazione. |
| DEVSOL-1578 | Esegui il rendering dei modelli Meteo e Petstore durante l'installazione del sito I modelli SmartDocs Petstore e Meteo vengono importati nei nuovi siti. |
| DEVSOL-1584 | Impossibile acquistare i piani È stato risolto un 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 |
Io, indicatore ambiente e upgrade del modulo funzionalità https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Assicurati che arg_separator.output sia '&' per evitare interruzioni di reCAPTCHA È stato risolto un problema relativo alla piattaforma per cui l'utilizzo di Google reCAPTCHA non funzionava. |
| DEVSOL-1651 | Il tema di base di Apigee non funziona se il modulo SmartDocs non è attivato Il tema apigee_base non dipende più dall'attivazione del modulo SmartDocs. |
| DEVSOL-1654 |
Aumenta la versione di admin_views per applicare la correzione di sicurezza critica
|