Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Martedì 8 settembre 2015 abbiamo rilasciato una versione trimestrale del portale Apigee Edge Developer Services per il cloud privato.
Il precedente nome del prodotto "Apigee Edge On-premise Developer Services Portal" o "OPDK" è ora "Apigee Edge Developer Services Portal for Private Cloud".
Se hai domande, rivolgiti all'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 vuoi connettere questa release del portale a un'installazione di Edge per Private Cloud, devi connetterla alla versione 4.15.07.00 o successiva per assicurarti che tutte le funzionalità di SmartDocumenti siano supportate. Per saperne di più, consulta la pagina 4.15.07.00 - Note di rilascio di Apigee Edge per il cloud privato.
Nuove funzionalità
Disponibilità generale di SmartDocumenti
SmartDocumenti sta passando dalla versione beta alla disponibilità generale. Gli aggiornamenti e le nuove funzionalità includono:
- Supporto per Swagger 2.0, inclusa l'importazione per file o URL, incluso il supporto per oggetti di sicurezza con nomi personalizzati.
- Miglioramenti del design visivo nei modelli che generano SmartDocumenti.
- Miglioramenti a livello di usabilità e del flusso di lavoro nel Portale per gli sviluppatori, disponibili tramite il menu Contenuti > SmartDocumenti in Drupal.
- L'autenticazione nota come "token personalizzato" ora si chiama "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 SmartDocumenti preconfigurate.
Per ulteriori descrizioni delle funzionalità, consulta questo post del blog.
Per la documentazione di SmartDocuments, vedi Utilizzare SmartDocs per documentare le API.
Processo di upgrade di SmartDocumenti
Se hai già utilizzato SmartDocumenti durante il periodo beta, le nuove funzionalità e caratteristiche nella versione di disponibilità generale richiedono l'upgrade di SmartDocumenti nel tuo portale per gli sviluppatori.
Tutte le pagine SmartDocumenti già pubblicate nel tuo portale per gli sviluppatori continueranno a funzionare, ma devi seguire la procedura di aggiornamento prima di modificare o pubblicare eventuali modifiche a pagine nuove o esistenti.
Tieni presente che anche se puoi eseguire il rendering e la pubblicazione di SmartDocumenti all'interno del tuo portale per gli sviluppatori, gli SmartDocuments vengono generati 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 esistono gli sviluppatori negli ambienti Pantheon).
Per eseguire l'upgrade dalla versione beta di SmartDocumenti alla disponibilità generale
- Aggiorna e testa la release 15.05.27 nei tuoi ambienti dev o test su Pantheon.
- Crea un nuovo modello per sostituire l'eventuale modello API esistente che utilizzi.
- Se stai importando documenti Swagger o WADL, importali di nuovo in una nuova revisione.
- Se stai gestendo il tuo modello API tramite il modulo SmartDocumenti, esportalo in formato JSON SmartDocuments e importalo nel nuovo modello utilizzando un file allegato.
- Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti > SmartDocumenti > modello, seleziona Impostazioni di sicurezza.
- Controlla un'eventuale autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti > SmartDocuments) facendo clic su Impostazioni nella colonna Operazioni.
- Aggiorna gli eventuali modelli personalizzati per utilizzare la versione 6 degli asset CSS e JS e apporta modifiche in base ai nuovi nomi degli oggetti, ad esempio authSchemes e apiSchema. Per informazioni sull'aggiornamento dei modelli SmartDocumenti, vedi Utilizzare SmartDocs per documentare le API.
- Esegui nuovamente il rendering e pubblica la revisione del modello.
- Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla release del 15/05/27.
Se sei un cliente Edge Enterprise e hai domande o dubbi sul processo di upgrade, invia un'email a marsh@apigee.com e cnovak@apigee.com. Altrimenti, utilizza la community Apigee per ricevere la risposta migliore.
Bug corretti
In questa release sono stati corretti i bug indicati di seguito.
| 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 del percorso non memorizzato al primo utilizzo Il parametro del percorso durante le chiamate non è sempre stato memorizzato. |
| DEVSOL-603 | La pagina Piano di conflitto non è formattata correttamente Quando acquisti un piano che si sovrappone a un piano esistente, la pagina mostrata ora è formattata correttamente per l'utente. |
| DEVSOL-709 | SmartDocumenti: parametro del modello di URL non modificabile dopo l'invio della richiesta con valore vuoto Risolvi il problema che rende i parametri del modello non modificabili dopo l'invio della richiesta da SmartDocumenti dopo l'eliminazione del parametro del modello nella documentazione del metodo. |
| DEVSOL-723 | Mostra messaggi facili da usare in caso di errore di importazione di SmartDocumenti |
| 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 abilitare il modulo Indicatore di ambiente per le release OPDK |
| DEVSOL-1273 | "DevConnect Mint" viene visualizzato due volte nell'elenco 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 la posizione del menu Amministratore SmartDocumenti Ora SmartDocumenti si trova nel menu Contenuti e le impostazioni di SmartDocumenti si trovano nel menu Amministratore delle impostazioni. |
| DEVSOL-1340 | Rimuovere la versione beta quando si accede a GA |
| DEVSOL-1390 |
La libreria Edge SDK PHP è stata aggiornata per risolvere il problema di chiamata a
__toString() Errore irreversibile: chiama una funzione membro format() su un non oggetto in /Applications/MAMP/htdocs/ordnance/docroot/profile/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 Questo è un bug che riguarda solo i clienti per la monetizzazione con codice personalizzato che chiama il metodo toString(). |
| DEVSOL-1398 | Modello Petstore di SmartDocs importato all'installazione senza richiedere all'utente SmartDocs ora importa l'esempio di spavalderia del negozio di animali durante l'installazione del sito (http://petstore.swagger.io/v2/swagger.json) anziché il modello meteorologico, per avere un esempio più completo dell'utilizzo di SmartDocumenti. |
| DEVSOL-1407 | Il cron non funziona quando il numero di sviluppatori è elevato Durante l'esecuzione di Drupal cron, un numero elevato di sviluppatori potrebbe causare un problema di timeout. Se un'organizzazione ha più di 200 utenti, viene utilizzata una procedura batch. |
| DEVSOL-1410 | Errori di connessione non evidenti durante l'installazione del Portale per gli sviluppatori Sono stati aggiunti messaggi di errore migliori per il programma di installazione quando la connessione alla gestione perimetrale non funziona, in modo da ridurre al minimo i problemi di risoluzione dei problemi. |
| DEVSOL-1422 | Rimuovi il modulo di configurazione SMTP dal profilo Apigee Il processo di installazione non ti chiede più se vuoi configurare SMTP, ma puoi farlo al termine dell'installazione seguendo la pratica Drupal standard di abilitare il modulo SMTP e configurarlo correttamente. |
| DEVSOL-1427 |
Aggiungi hook al modulo App per sviluppatori Devconnect 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() Consentono a moduli personalizzati di modificare il grafico di analisi dell'app dello sviluppatore. |
| 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 che consente di selezionare se è necessario eliminare anche lo schema di autenticazione del modello associato. |
| DEVSOL-1470 | Crea un link al menu "API" e alla visualizzazione corrispondente Per impostazione predefinita, SmartDocs del Portale per sviluppatori include ora un link alla documentazione visualizzata da SmartDocumenti nel menu principale denominato "API", che rimanda a qualsiasi modello con metodi pubblicati. |
| DEVSOL-1486 | Le chiamate SmartDocumenti possono eseguire l'autenticazione con una chiave predefinita Abilita l'autenticazione con chiavi API preconfigurate e fornite dall'utente. |
| DEVSOL-1499 | Codice HTML non analizzato nelle descrizioni dei parametri SmartDocumenti Il codice HTML ora viene analizzato nelle descrizioni dei parametri SmartDocumenti. |
| DEVSOL-1507 | Impossibile aggiungere più parametri a un'API con Add Method Ora puoi aggiungere più parametri a un'API SmartDocumenti durante la modifica del metodo. |
| DEVSOL-1509 | Non vedo un modo per modificare il campo "sample " per un'API SmartDocs Ora puoi impostare il "Tipo MIME del corpo", la "Documentazione del corpo" e il "Corpo di esempio" quando modifichi una pagina SmartDocumenti. |
| DEVSOL-1534 | Il tipo di contenuto non viene compilato nell'output SmartDocs Il tipo di contenuto viene ora compilato nella pagina del metodo SmartDocs. |
| DEVSOL-1554 | Confronto di date non valido in Monetizzazione Nella scheda Piano di acquisto per i portali per sviluppatori abilitati alla monetizzazione, il pulsante "Annulla" non è mai stato mostrato per un piano con data di inizio futura, |
| DEVSOL-1556 | Versione precedente dei moduli Drupal in fase di distribuzione Il modulo media_youtube e funzionalità è stato aggiornato all'ultima versione. |
| DEVSOL-1558 | Le pagine dei metodi SmartDoc non vengono visualizzate per l'esempio di PetStore Nelle nuove installazioni, i metodi SmartDoc PetStore di esempio ora vengono visualizzati correttamente. |
| DEVSOL-1562 | Genera una vista per ogni modello SmartDocumenti 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 irreversibile È stato risolto il problema a causa del quale la modifica di un metodo SmartDocs a volte generava un errore. |
| DEVSOL-1567 | "Aggiungi modello" visualizzata nel menu Amministratore in alto È stato risolto il problema a causa del quale la voce di menu "Aggiungi modello" veniva visualizzata nel menu Amministratore 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 che viene mostrata quando si fa clic su "API" nel menu mostra il nome interno del modello anziché il nome visualizzato. Se stai effettuando l'aggiornamento alla release e hai modificato questa visualizzazione, dovrai ripristinare la vista per vederla seguendo questi passaggi: # Accedi come amministratore # Vai a Struttura > Viste # Fai clic sul menu a discesa accanto a "Modifica" in "Modelli SmartDocumenti" per visualizzare tutte le operazioni. # Se vedi "Ripristina", significa che hai sovrascritto il codice con la tua modifica. Fai clic su "Ripristina" per ripristinare lo stato predefinito. Tieni presente che tutte le modifiche apportate a questa vista verranno rimosse. |
| DEVSOL-1578 | Esegui il rendering dei modelli Meteo e di Petsstore sulle installazioni del sito Entrambi i modelli di Petstore e Meteo SmartDocs vengono importati sui nuovi siti. |
| DEVSOL-1584 | Impossibile acquistare i piani È stato risolto il problema a causa del quale il modulo di acquisto dei piani di monetizzazione non veniva inviato per le release Cloud 15.05.27.00 e 15.06.08.00 se utilizzavi il tema adattabile Apigee o un tema secondario del tema adattabile Apigee. |
| DEVSOL-1597 | Impossibile modificare le impostazioni di timeout dello sviluppatore È stato risolto un bug per cui le impostazioni di timeout della connessione perimetrale non venivano applicate correttamente. |
| DEVSOL-1620 |
Upgrade dei moduli Io, indicatori di ambiente e 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 in cui l'utilizzo di reCAPTCHA di Google non funzionava. |
| 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 |
Bump versione di admin_views per recuperare una correzione di sicurezza critica
|