Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info
Am Dienstag, dem 2. Juni 2015, haben wir eine neue Cloud-Version des Apigee Developer Services Portals veröffentlicht.
Wenn Sie Fragen haben, wenden Sie sich an den Apigee-Kundensupport.
Eine Liste aller Apigee Edge-Versionshinweisen finden Sie unter Apigee-Versionshinweisen.
Neue Funktionen
Allgemeine Verfügbarkeit von SmartDocs
SmartDocs ist nach dem Abschluss der Betaphase jetzt allgemein verfügbar. Zu den Updates und neuen Funktionen gehören:
- Unterstützung für Swagger 2.0, einschließlich Import per Datei oder URL und Unterstützung für benutzerdefinierte Sicherheitsobjekte.
- Verbesserungen am visuellen Design der Vorlagen, mit denen SmartDocs generiert werden.
- Verbesserungen der Nutzerfreundlichkeit und des Workflows im Entwicklerportal, verfügbar über das Menü „Inhalte“ > „SmartDocs“ in Drupal.
- Die Authentifizierungsmethode „Benutzerdefiniertes Token“ heißt jetzt „API-Schlüssel“.
- „Sicherheits“-Objekte für die Authentifizierung, die auf Ebene der Version definiert sind.
- Konfiguration der Clientauthentifizierung auf Vorlagenebene. Bei neuen Versionen werden keine vorkonfigurierten SmartDocs-Clientanmeldedaten mehr zurückgesetzt.
Weitere Funktionsbeschreibungen finden Sie in diesem Blogpost.
Eine SmartDocs-Dokumentation finden Sie unter APIs mit SmartDocs dokumentieren.
SmartDocs-Upgrade
Wenn Sie SmartDocs bereits während der Betaphase verwendet haben, müssen Sie für die neuen Funktionen und Möglichkeiten in der allgemeinen Verfügbarkeitsversion ein Upgrade von SmartDocs in Ihrem Entwicklerportal ausführen.
Alle SmartDocs-Seiten, die bereits in Ihrem Entwicklerportal veröffentlicht wurden, funktionieren weiterhin. Sie müssen jedoch den Aktualisierungsprozess durchlaufen, bevor Sie Änderungen an vorhandenen oder neuen Seiten bearbeiten oder veröffentlichen können.
Sie können SmartDocs zwar in Ihrem Entwicklerportal rendern und veröffentlichen, sie werden aber aus dem API-Modell generiert, das in den Edge API Management Services von Apigee gespeichert ist. Alle Änderungen, die Sie an einem API-Modell in Edge vornehmen, werden in allen Ihren Pantheon-Umgebungen übernommen (ähnlich wie Entwickler in allen Pantheon-Umgebungen vorhanden sind).
Von der SmartDocs-Betaversion zur allgemeinen Verfügbarkeit wechseln
- Aktualisieren und testen Sie den Release vom 27. Mai 2015 in Ihrer dev- oder test-Umgebung auf Pantheon.
- Erstellen Sie ein neues Modell, um ein vorhandenes API-Modell zu ersetzen, das Sie verwendet haben.
- Wenn Sie Swagger- oder WADL-Dokumente importiert haben, importieren Sie sie noch einmal in eine neue Version.
- Wenn Sie Ihr API-Modell über das SmartDocs-Modul verwaltet haben, exportieren Sie es als SmartDocs JSON und importieren Sie es über einen Dateianhang in Ihr neues Modell.
- Legen Sie die Sicherheitseigenschaften der Version Ihres Modells fest. Wählen Sie auf der Seite Inhalte > SmartDocs > Modell die Option Sicherheitseinstellungen aus.
- Prüfen Sie auf der Seite „Modelleinstellungen“ (Inhalte > SmartDocs), ob eine vorkonfigurierte Authentifizierung vorhanden ist. Klicken Sie dazu in der Spalte „Vorgänge“ auf Einstellungen.
- Aktualisieren Sie alle benutzerdefinierten Vorlagen, damit sie Version 6 der CSS- und JS-Assets verwenden. Berücksichtigen Sie dabei auch neue Objektnamen wie „authSchemes“ und „apiSchema“. Informationen zum Aktualisieren von SmartDocs-Vorlagen finden Sie unter APIs mit SmartDocs dokumentieren.
- Rendern Sie die Modellversion noch einmal und veröffentlichen Sie sie.
- Nachdem du die neue Dokumentation validiert hast, aktualisiere dein Produktionsportal auf den Release vom 15. Mai 2027.
Wenn Sie Edge Enterprise-Kunde sind und Fragen oder Bedenken zum Upgradeprozess haben, senden Sie bitte eine E-Mail an marsh@apigee.com und cnovak@apigee.com. Andernfalls können Sie sich an die Apigee-Community wenden.
Fehlerkorrekturen
Folgende Fehler wurden in diesem Release behoben.
| Problem-ID | Beschreibung |
|---|---|
| DEVSOL-487 | Tagesformat in der Monetarisierung sollte von Administratoren konfigurierbar sein Das Datumsformat kann jetzt in den Monetarisierungseinstellungen unter „Monetarisierung“ für europäische und US-amerikanische Datumsformate konfiguriert werden. |
| DEVSOL-603 | Die Seite mit dem Konfliktplan ist schlecht formatiert Wenn ein Kunde einen Tarif kauft, der sich mit einem vorhandenen Tarif überschneidet, ist die angezeigte Seite jetzt für den Nutzer gut formatiert. |
| DEVSOL-642 | Konfigurationen auf Kundenebene aus den Sicherheitseinstellungen in die Vorlageneinstellungen verschieben |
| DEVSOL-709 | SmartDocs: URL-Vorlagenparameter kann nach dem Senden einer Anfrage mit einem leeren Wert nicht mehr bearbeitet werden Behebt das Problem, dass die Vorlagenparameter nach dem Senden der Anfrage aus SmartDocs nicht mehr bearbeitet werden können, nachdem der Vorlagenparameter in der Methodendokumentation gelöscht wurde. |
| DEVSOL-1013 | E-Mail-Adressen von Nutzern im Entwicklerportal bearbeitbar machen Das Feld für die E-Mail-Adresse auf der Seite zum Bearbeiten des Profils ist nicht mehr deaktiviert und Entwickler können ihre E-Mail-Adressen ändern. |
| DEVSOL-1273 | „DevConnect Mint“ wird zweimal in der Modulliste angezeigt Unter „Module“ wurde „Dev Connect Mint“ zweimal angezeigt. Dieser Fehler wurde jetzt behoben. |
| DEVSOL-1313 | Unterstützung von JSON-/YAML-Dateien oder URL-Importen sowohl für Swagger als auch für WADL WADL-Dateien können jetzt über eine URL importiert und Swagger-Dateien hochgeladen werden. |
| DEVSOL-1339 | Speicherorte für das SmartDocs-Admin-Menü ändern SmartDocs befindet sich jetzt im Menü „Inhalte“ und die SmartDocs-Einstellungen im Admin-Menü „Einstellungen“. |
| DEVSOL-1340 | Entfernen des Betastatus bei der Umstellung auf die allgemeine Verfügbarkeit SmartDocs befindet sich jetzt im Menü „Inhalte“ und die SmartDocs-Einstellungen im Menü „Verwaltung“. |
| DEVSOL-1390 | Die PHP SDK Edge-Bibliothek wurde aktualisiert, um das Problem beim Aufrufen von __toString() zu beheben. Die PHP SDK Edge-Bibliothek wurde aktualisiert, um das Problem beim Aufrufen von __toString() auf dem DeveloperRatePlan-Objekt zu beheben. Dadurch wurde folgender Fehler verursacht: {quote} 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 {quote} Dieser Fehler betrifft nur Monetarisierungskunden mit benutzerdefiniertem Code, in dem die Methode toString() aufgerufen wird. |
| DEVSOL-1398 | SmartDocs-Petstore-Modell wird bei der Installation ohne Aufforderung des Nutzers importiert Bei der Websiteinstallation wird jetzt das Petstore-Swagger-Beispiel (http://petstore.swagger.io/v2/swagger.json) anstelle des Wettermodells importiert, um ein umfassenderes Beispiel für die Verwendung von SmartDocs zu erhalten. |
| DEVSOL-1407 | Cron schlägt fehl, wenn viele Entwickler vorhanden sind Beim Ausführen von Drupal-Cron führte eine große Anzahl von Entwicklern zu einem Zeitüberschreitungsproblem. Wenn eine Organisation mehr als 200 Nutzer hat, wird jetzt ein Batch-Prozess verwendet. |
| DEVSOL-1470 | Menülink „APIs“ und entsprechende Ansicht erstellen Das Dev Portal SmartDocs enthält jetzt standardmäßig einen Link zur gerenderten SmartDocs-Dokumentation im Hauptmenü „APIs“, der zu allen Modellen mit veröffentlichten Methoden führt. |
Bekannte Probleme
Diese Version weist die folgenden bekannten Probleme auf:
| Problem-ID | Beschreibung |
|---|---|
| DEVSOL-1558 |
Die SmartDocs-Methodenseiten des Beispiels „Petstore“ werden bei einer neuen Installation nicht korrekt gerendert
Die Beispielseiten für Petstore-Methoden in SmartDocs werden bei einer Neuinstallation nicht richtig gerendert. So beheben Sie das Problem:
Die Knoten sollten jetzt korrekt gerendert werden. |