15.05.27.00 – Versionshinweise zum Apigee Developer Services Portal

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Am Dienstag, dem 2. Juni 2015, wurde eine neue Cloud-Version des Apigee Developer Services Portal veröffentlicht.

Wenn Sie Fragen haben, wenden Sie sich an den Apigee-Kundensupport.

Eine Liste aller Versionshinweise zu Apigee Edge finden Sie unter Apigee-Versionshinweise.

Neue Funktionen

Allgemeine Verfügbarkeit von SmartDocs

SmartDocs wechselt von der Betaversion zur allgemeinen Verfügbarkeit. Zu den Updates und neuen Funktionen gehören:

  • Unterstützung für Swagger 2.0, einschließlich Import per Datei oder URL, einschließlich Unterstützung für benutzerdefinierte Sicherheitsobjekte.
  • Verbesserungen am Design der Vorlagen, die SmartDocs generieren
  • Verbesserungen der Nutzerfreundlichkeit und des Workflows im Entwicklerportal, verfügbar über das Menü „Content“ > „SmartDocs“ in Drupal
  • Die bisherige Authentifizierung mit einem benutzerdefinierten Token heißt jetzt „API-Schlüssel“.
  • Sicherheitsobjekte, die auf Versionsebene definiert wurden.
  • Konfiguration der Clientauthentifizierung auf Vorlagenebene. Bei neuen Überarbeitungen werden keine vorkonfigurierten SmartDocs-Clientanmeldedaten mehr zurückgesetzt.

Weitere Funktionsbeschreibungen finden Sie in diesem Blogpost.

Weitere Informationen zur SmartDocs-Dokumentation finden Sie unter SmartDocs zum Dokumentieren von APIs verwenden.

SmartDocs-Upgradeprozess

Wenn Sie SmartDocs bereits in der Betaphase verwendet haben, müssen Sie aufgrund neuer Features und Funktionen in der Version mit allgemeiner Verfügbarkeit in Ihrem Entwicklerportal SmartDocs upgraden.

Alle SmartDocs-Seiten, die bereits in Ihrem Entwicklerportal veröffentlicht wurden, funktionieren weiterhin. Sie müssen jedoch den Aktualisierungsprozess durchführen, bevor Sie Änderungen an vorhandenen oder neuen Seiten bearbeiten oder veröffentlichen.

Beachten Sie, dass Sie zwar SmartDocs in Ihrem Entwicklerportal rendern und veröffentlichen können, SmartDocs wird jedoch über das API-Modell generiert, das in den Edge API Management Services von Apigee enthalten ist. Alle Änderungen, die Sie an einem API-Modell in Edge vornehmen, sind in allen Ihren Pantheon-Umgebungen gleich (ähnlich wie bei Entwicklern in Pantheon-Umgebungen).

Um ein Upgrade von SmartDocs Beta auf die allgemeine Verfügbarkeit durchzuführen

  1. Aktualisieren und testen Sie Version 15.05.27 in Ihrer dev- oder Testumgebung in Pantheon.
  2. Erstellen Sie ein neues Modell, um ein vorhandenes API-Modell zu ersetzen, das Sie bisher verwendet haben.
    • Wenn Sie Swagger- oder WADL-Dokumente importiert haben, importieren Sie sie noch einmal in eine neue Überarbeitung.
    • Wenn Sie Ihr API-Modell über das SmartDocs-Modul gepflegt haben, exportieren Sie es als SmartDocs-JSON-Datei und importieren Sie es mithilfe eines Dateianhangs in Ihr neues Modell.
  3. Legen Sie die Sicherheitsattribute der Version Ihres Modells fest. Wählen Sie auf der Seite Inhalt > SmartDocs > Modell die Option Sicherheitseinstellungen aus.
  4. Prüfen Sie die vorkonfigurierte Authentifizierung auf der Seite mit den Modelleinstellungen (Content > SmartDocs), indem Sie in der Spalte „Vorgänge“ auf Einstellungen klicken.
  5. Aktualisieren Sie alle benutzerdefinierten Vorlagen, um Version 6 der CSS- und JS-Assets zu verwenden, und nehmen Sie Änderungen vor, um neue Objektnamen wie authSchemes und apiSchema widerzuspiegeln. Informationen zum Aktualisieren von SmartDocs-Vorlagen finden Sie unter SmartDocs zum Dokumentieren von APIs verwenden.
  6. Rendern Sie die Modellüberarbeitung noch einmal und veröffentlichen Sie sie.
  7. Nachdem Sie die neue Dokumentation validiert haben, aktualisieren Sie Ihr Produktionsportal auf die Version 15.05.27.

Wenn Sie Kunde von Edge Enterprise sind und Fragen oder Bedenken zum Upgradeprozess haben, senden Sie eine E-Mail an marsh@apigee.com und cnovak@apigee.com. Verwenden Sie andernfalls die Apigee Community, um die beste Antwort zu erhalten.

Fehlerkorrekturen

Folgende Fehler wurden in diesem Release behoben.

Fehler-ID Beschreibung
DEVSOL-487 Das Tagesformat bei der Monetarisierung sollte von Administratoren konfiguriert werden
Das Datumsformat kann jetzt in den Monetarisierungseinstellungen für europäische und US-amerikanische Datumsformate konfiguriert werden.
DEVSOL-603 Seite „Konfliktplan“ ist schlecht formatiert
Wenn Sie einen Tarif kaufen, der sich mit einem vorhandenen Abo überschneidet, ist die Seite jetzt gut für den Nutzer formatiert.
DEVSOL-642 Konfigurationen auf Clientebene von den Sicherheitseinstellungen in die Vorlageneinstellungen verschieben
DEVSOL-709 SmartDocs: URL-Vorlagenparameter kann nach dem Senden einer Anfrage mit leerem Wert nicht bearbeitet werden
Behebt das Problem, bei dem die Vorlagenparameter nach dem Senden der Anfrage von SmartDocs nicht mehr bearbeitet werden können, nachdem der Vorlagenparameter in der Methodendokumentation gelöscht wurde.
DEVSOL-1013 E-Mail-Adressen von Nutzern des Dev-Portals bearbeitbar machen
Das Feld für die E-Mail-Adresse auf der Seite „Profil bearbeiten“ wird nicht mehr deaktiviert und Entwickler können ihre E-Mail-Adressen ändern.
DEVSOL-1273 „DevConnect Mint“ wird in der Liste der Module zweimal angezeigt
Unter „Module“ wurde zweimal „Dev Connect Mint“ angezeigt. Dieser Fehler wurde jetzt behoben.
DEVSOL-1313 Unterstützung von JSON/YAML- oder URL-Import für Swagger und WADL
WADL-Dateien können jetzt über URL importiert und Swagger-Dateien hochgeladen werden.
DEVSOL-1339 Positionen des Menüs „Admin“ in SmartDocs ändern
SmartDocs befindet sich jetzt im Menü „Inhalt“, die Einstellungen von Smartdocs im Menü „Verwaltung“.
DEVSOL-1340 Beta unter GA entfernen
SmartDocs befindet sich jetzt im Menü „Inhalte“, die Smartdocs-Einstellungen im Menü „Verwaltung“ der 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 des Aufrufs von __toString() für das DeveloperRatePlan-Objekt zu beheben, das den folgenden Fehler verursacht: {quote} Schwerwiegender Fehler: Der Aufruf an eine Mitgliedsfunktion format() für ein Nicht-Objekt in /Apigee/Apigee/Apigee-Anwendungs-/Monetarisierungs-Methode wirkt sich nur auf /Apigee/Apigee/Apigee-Anwendungscode an.
DEVSOL-1398 SmartDocs Petstore-Modell, das bei der Installation ohne Aufforderung des Nutzers importiert
SmartDocs importiert jetzt das Beispiel für die Zoohandlung (http://petstore.swagger.io/v2/swagger.json) anstelle des Wettermodells, um ein ausführlicheres Beispiel für die Verwendung von SmartDocs zu erhalten.
DEVSOL-1407 Cron schlägt fehl, wenn es viele Entwickler gibt
Beim Ausführen von Drupal Cron verursachte eine große Anzahl von Entwicklern ein Zeitüberschreitungsproblem. Wenn eine Organisation mehr als 200 Nutzer hat, wird jetzt eine Batchverarbeitung verwendet.
DEVSOL-1470 Link zum Menü „APIs“ und entsprechende Ansicht erstellen
SmartDocs im Entwicklerportal enthält jetzt standardmäßig einen Link zur von SmartDocs gerenderten Dokumentation im Hauptmenü „APIs“, der auf alle Modelle mit veröffentlichten Methoden verweist.

Bekannte Probleme

In dieser Version gibt es die folgenden bekannten Probleme:

Fehler-ID Beschreibung
DEVSOL-1558
Beispielseiten für die SmartDocs-Methode für Tierbedarf werden bei einer Neuinstallation nicht richtig gerendert
Die Beispielseiten mit der Petstore-Methode in SmartDocs werden bei einer Neuinstallation nicht richtig gerendert. So beheben Sie das Problem:
  1. Wählen Sie im Drupal-Menü Content > SmartDocs aus.
  2. Wählen Sie das Modell „Beispiel für Zoohandlung“ aus.
  3. Wählen Sie unter Aktualisierungsoptionen die Option Knoten rendern und veröffentlichen aus.
  4. Klicken Sie auf das Kästchen Alle auswählen / Auswahl aufheben, um alle Knoten auszuwählen.
  5. Klicken Sie auf Aktualisieren.

Die Knoten sollten jetzt korrekt gerendert werden.