Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen. 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 Edge-Support.
Eine Liste aller Apigee Edge-Versionshinweise finden Sie unter Apigee-Versionshinweise.
Neue Funktionen
Allgemeine Verfügbarkeit von SmartDocs
SmartDocs ist nach dem Abschluss der Betaphase jetzt allgemein verfügbar. Updates und neue Funktionen:
- Unterstützung für Swagger 2.0, einschließlich Import per Datei oder URL, einschließlich Unterstützung für benutzerdefinierte Sicherheitsbenennungsobjekte.
- Verbesserungen des visuellen Designs in den Vorlagen, mit denen SmartDocs generiert werden.
- Verbesserungen der Benutzerfreundlichkeit und des Workflows im Entwicklerportal, die über das Menü „Inhalte“ > „SmartDocs“ in Drupal verfügbar sind.
- Die bisher als „Benutzerdefiniertes Token“ bekannte Authentifizierung wird jetzt als „API-Schlüssel“ bezeichnet.
- Auf Revisionsebene definierte Authentifizierungssicherheitsobjekte.
- Konfiguration der Clientauthentifizierung auf Vorlagenebene. Bei neuen Überarbeitungen werden keine vorkonfigurierten SmartDocs-Clientanmeldedaten mehr zurückgesetzt.
Weitere Informationen zu den Funktionen finden Sie in diesem Blogpost.
Die SmartDocs-Dokumentation finden Sie unter APIs mit SmartDocs dokumentieren.
SmartDocs-Upgrade
Wenn Sie SmartDocs bereits in der Betaphase verwendet haben, müssen Sie SmartDocs in Ihrem Entwicklerportal aktualisieren, um die neuen Funktionen und Möglichkeiten der allgemein verfügbaren Version nutzen zu können.
Alle SmartDocs-Seiten, die bereits in Ihrem Entwicklerportal veröffentlicht wurden, funktionieren weiterhin. Sie müssen jedoch den Aktualisierungsprozess durchlaufen, bevor Sie Änderungen an bestehenden oder neuen Seiten bearbeiten oder veröffentlichen.
SmartDocs können zwar in Ihrem Entwicklerportal gerendert und veröffentlicht werden, sie werden jedoch aus dem API-Modell generiert, das sich in den Edge API Management Services von Apigee befindet. Alle Änderungen, die Sie an einem API-Modell in Edge vornehmen, sind in allen Ihren Pantheon-Umgebungen gleich (ähnlich wie Entwickler in Pantheon-Umgebungen vorhanden sind).
Von der SmartDocs-Betaversion auf die General Availability-Version upgraden
- Aktualisieren und testen Sie das Release vom 27.05.15 in Ihren dev- oder test-Umgebungen auf Pantheon.
- Erstellen Sie ein neues Modell, um alle vorhandenen API-Modelle zu ersetzen, die Sie verwendet haben.
- Wenn Sie Swagger- oder WADL-Dokumente importiert haben, importieren Sie sie noch einmal in eine neue Revision.
- 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 Revision Ihres Modells fest. Wählen Sie auf der Seite Inhalte > SmartDocs > Modell die Option Sicherheitseinstellungen aus.
- Prüfen Sie auf der Seite mit den Modelleinstellungen (Inhalte > SmartDocs) alle vorkonfigurierten Authentifizierungen, indem Sie in der Spalte „Vorgänge“ auf Einstellungen klicken.
- Aktualisieren Sie alle benutzerdefinierten Vorlagen, damit sie die Version 6 der CSS- und JS-Assets verwenden, und nehmen Sie Änderungen vor, um neue Objektnamen wie „authSchemes“ und „apiSchema“ zu berücksichtigen. Informationen zum Aktualisieren von SmartDocs-Vorlagen finden Sie unter SmartDocs zum Dokumentieren von APIs verwenden.
- Rendern Sie die Modellrevision noch einmal und veröffentlichen Sie sie.
- Nachdem Sie die neue Dokumentation geprüft haben, aktualisieren Sie Ihr Produktionsportal auf die Version 15.05.27.
Wenn Sie ein Edge-Unternehmenskunde sind und Fragen oder Bedenken zum Upgrade-Prozess haben, senden Sie bitte eine E-Mail an marsh@apigee.com und cnovak@apigee.com. Andernfalls nutzen Sie bitte die Apigee-Community, um die beste Antwort zu erhalten.
Fehlerkorrekturen
Folgende Fehler wurden in diesem Release behoben.
| Problem-ID | Description |
|---|---|
| DEVSOL-487 | Das Tagesformat in Monetization sollte von Administratoren konfiguriert werden können Das Datumsformat kann jetzt in Monetization unter den Monetarisierungseinstellungen für europäische und US-amerikanische Datumsformate konfiguriert werden. |
| DEVSOL-603 | Die Seite „Konfliktplan“ ist schlecht formatiert Beim Kauf eines Plans, der sich mit einem bestehenden Plan überschneidet, wird die angezeigte Seite jetzt für den Nutzer formatiert. |
| DEVSOL-642 | Konfigurationen auf Kundenebene aus den Sicherheitseinstellungen in die Vorlageneinstellungen verschieben |
| DEVSOL-709 | SmartDocs: URL-Vorlagenparameter nach dem Senden einer Anfrage mit leerem Wert nicht bearbeitbar Behebt das Problem, dass die Vorlagenparameter nach dem Senden der Anfrage über SmartDocs nicht mehr bearbeitet werden können, nachdem der Vorlagenparameter in der Methodendokumentation gelöscht wurde. |
| DEVSOL-1013 | E-Mail-Adressen von Entwicklerportalnutzern bearbeitbar machen Das Feld für die E-Mail-Adresse auf der Seite „Profil bearbeiten“ 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 „DevConnect Mint“ zweimal angezeigt. Dieser Fehler wurde jetzt behoben. |
| DEVSOL-1313 | JSON-/YAML-Datei oder URL-Import für Swagger und WADL wird unterstützt WADL-Dateien können jetzt über eine URL importiert und Swagger-Dateien hochgeladen werden. |
| DEVSOL-1339 | Änderung der Menüpositionen für SmartDocs SmartDocs befindet sich jetzt im Inhaltsmenü und die SmartDocs-Einstellungen im Admin-Menü „Einstellungen“. |
| DEVSOL-1340 | Beta entfernen, wenn die allgemeine Verfügbarkeit erreicht wird SmartDocs befindet sich jetzt im Inhaltsmenü und die SmartDocs-Einstellungen im Admin-Menü „Einstellungen“. |
| 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() für das DeveloperRatePlan-Objekt zu beheben, das diesen Fehler verursacht: {quote} Schwerwiegender Fehler: Aufruf der Member-Funktion „format()“ für ein Nicht-Objekt in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php in Zeile 221 {quote} Dieser Fehler betrifft nur Monetarisierungskunden mit benutzerdefiniertem Code, der die toString()-Methode aufruft. |
| DEVSOL-1398 | SmartDocs-Petstore-Modell bei der Installation ohne Aufforderung des Nutzers importiert SmartDocs importiert jetzt das Petstore-Swagger-Beispiel während der Websiteinstallation (http://petstore.swagger.io/v2/swagger.json) anstelle des Wettermodells, um ein umfassenderes Beispiel für die Verwendung von SmartDocs zu haben. |
| DEVSOL-1407 | Cron schlägt fehl, wenn es viele Entwickler gibt Beim Ausführen von Drupal Cron kam es aufgrund einer großen Anzahl von Entwicklern zu einem Zeitüberschreitungsproblem. Wenn eine Organisation mehr als 200 Nutzer hat, wird jetzt ein Batchprozess verwendet. |
| DEVSOL-1470 | Menülink „APIs“ und entsprechende Ansicht erstellen Dev Portal SmartDocs enthält jetzt standardmäßig einen Link zur gerenderten SmartDocs-Dokumentation im Hauptmenü mit dem Namen „APIs“. Dieser Link führt zu allen Modellen mit veröffentlichten Methoden. |
Bekannte Probleme
Diese Version enthält die folgenden bekannten Probleme:
| Problem-ID | Description |
|---|---|
| DEVSOL-1558 |
SmartDocs-Methodenseiten des Petstore-Beispiels werden bei einer Neuinstallation nicht korrekt gerendert.
Die Beispielmethodenseiten für den Petstore in SmartDocs werden bei einer Neuinstallation nicht richtig gerendert. So beheben Sie das Problem:
Die Knoten sollten jetzt richtig gerendert werden. |