4.15.07.00 – Versionshinweise zum Apigee Developer Services Portal

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

Am 8. September 2015 haben wir eine vierteljährliche Version des Apigee Edge Developer Services Portal für Private Cloud veröffentlicht.

Der frühere Produktname „Apigee Edge On-Premises Developer Services Portal“ oder „OPDK“ ist jetzt „Apigee Edge Developer Services Portal for Private Cloud“.

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

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

Apigee Edge-Anforderungen für das Portal

Wenn Sie diesen Release des Portals mit einer Installation von Edge for Private Cloud verbinden, müssen Sie eine Verbindung zu Version 4.15.07.00 oder höher herstellen, um sicherzustellen, dass alle SmartDocs-Features unterstützt werden. Weitere Informationen finden Sie unter 4.15.07.00 – Versionshinweise zu Apigee Edge for Private Cloud.

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-584 Pfadparameter bei der ersten Verwendung nicht gespeichert
Der Pfadparameter bei Aufrufen wurde nicht immer gespeichert.
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-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-723 Benutzerfreundliche Nachrichten bei einem SmartDocs-Importfehler anzeigen
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-1244 Modul „Umgebungsanzeige“ nicht für OPDK-Releases aktivieren
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-Version bei GA-Seite entfernen
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 zu beheben, das beim Aufrufen von __toString() für das DeveloperRatePlan-Objekt zu folgendem Fehler führt:

Schwerer Fehler: Aufruf an eine Mitgliedsfunktion 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

Dieser Fehler betrifft nur Monetarisierungskunden, deren benutzerdefinierter Code die toString()-Methode aufruft.

DEVSOL-1398 SmartDocs Petstore-Modell, das bei der Installation ohne Aufforderung des Nutzers importiert wird
SmartDocs importiert jetzt das Beispiel der 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 verursacht eine große Anzahl von Entwicklern ein Zeitlimit. Wenn eine Organisation mehr als 200 Nutzer hat, wird jetzt eine Batchverarbeitung verwendet.
DEVSOL-1410 Verbindungsfehler, die bei der Installation des Dev-Portals nicht sichtbar sind
Es wurden bessere Fehlermeldungen für das Installationsprogramm hinzugefügt, wenn die Edge-Management-Verbindung nicht funktioniert, um Fehlerbehebungsprobleme zu minimieren.
DEVSOL-1422 SMTP-Konfigurationsformular aus Apigee-Profil entfernen
Bei der Installation werden Sie nicht mehr gefragt, ob Sie SMTP konfigurieren möchten. Dies kann nach Abschluss der Installation erfolgen. Dabei werden die standardmäßige Drupal-Praxis zum Aktivieren des SMTP-Moduls und der ordnungsgemäßen Konfiguration ausgeführt.
DEVSOL-1427

Fügen Sie dem Devconnect Developer Apps-Modul Hooks hinzu, um die Änderung der Analysedaten zu ermöglichen.
Das Modul devconnect_developer_apps bietet jetzt drei neue Hooks:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

Damit können benutzerdefinierte Module das Analysediagramm für Entwickler-Apps ändern.

DEVSOL-1464 Schwerwiegender Fehler beim Speichern der Authentifizierungseinstellungen für ein Modell
Wenn ein Sicherheitsschema gelöscht wird, wird jetzt ein Kästchen angezeigt, über das Sie auswählen können, ob das verknüpfte Schema für die Vorlagenauthentifizierung ebenfalls gelöscht werden muss.
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.
DEVSOL-1486 SmartDocs-Aufrufe können mit einem vordefinierten Schlüssel authentifiziert werden
Aktiviert die Authentifizierung sowohl mit vordefinierten als auch mit vom Nutzer bereitgestellten API-Schlüsseln.
DEVSOL-1499 HTML-Code wird in den Beschreibungen der SmartDocs-Parameter nicht geparst
HTML-Code wird jetzt in den Beschreibungen der SmartDocs-Parameter geparst.
DEVSOL-1507 Mit der Methode "Methode hinzufügen" können einer API nicht mehrere Parameter hinzugefügt werden
Sie können einer SmartDocs API jetzt mehrere Parameter hinzufügen, wenn Sie die Methode bearbeiten.
DEVSOL-1509 Es gibt keine Möglichkeit, das Feld „Beispiel“ für eine SmartDocs API zu bearbeiten
Sie können jetzt beim Bearbeiten einer SmartDocs-Seite den MIME-Typ „Text“, „Dokumentation im Haupttext“ und „Textbeispiel“ festlegen.
DEVSOL-1534 Inhaltstyp wird in der SmartDocs-Ausgabe nicht ausgefüllt
Der Inhaltstyp wird jetzt auf der Seite mit der SmartDocs-Methode eingefügt.
DEVSOL-1554 Ungültiger Datumsvergleich in der Monetarisierung
Auf dem Tab „Erworbener Tarif“ für Entwicklerportale mit aktivierter Monetarisierung wurde für Pläne mit einem Startdatum in der Zukunft nie die Schaltfläche „Abbrechen“ angezeigt.
DEVSOL-1556 Alte Version der Drupal-Module wird veröffentlicht
Das Modul „media_youtube und Funktionen“ wurde auf die neueste Version aktualisiert.
DEVSOL-1558 Beispiel für SmartDocs-Methode: Methoden, die nicht für PetStore gerendert werden
Bei Neuinstallationen werden die Beispielmethoden von SmartDocs PetStore korrekt gerendert.
DEVSOL-1562 Ansicht für jedes SmartDocs-Modell generieren
Wenn Sie ein neues Modell erstellen, wird für dieses Modell standardmäßig eine neue Ansicht erstellt.
DEVSOL-1565 Beim Bearbeiten einer SmartDocs-Methode tritt ein schwerwiegender Fehler auf
Ein Problem wurde behoben, durch das beim Bearbeiten einer SmartDocs-Methode manchmal ein Fehler generiert wurde.
DEVSOL-1567 Anzeige „Modell hinzufügen“ oben im Admin-Menü
Das Problem, dass der Menüpunkt „Modell hinzufügen“ oben im Admin-Menü angezeigt wurde, wurde behoben.
DEVSOL-1576 In der API-Dokumentationsansicht wird nicht der Anzeigename, sondern der Modellname angezeigt
Die API-Dokumentationsseite, die beim Klicken auf „APIs“ im Menü angezeigt wurde, enthielt statt des Anzeigenamens den internen Namen des Modells. Wenn Sie auf die Version aktualisieren und diese Ansicht geändert haben, müssen Sie Ihre Ansicht zurücksetzen, damit die Änderungen angezeigt werden. Gehen Sie dazu so vor: # Als Administrator anmelden # Zu „Struktur“ > „Ansichten“ wechseln # Klicken Sie bei „SmartDocs-Modelle“ auf das Drop-down-Menü neben „Bearbeiten“, um alle Vorgänge anzuzeigen. # Wenn "revert" angezeigt wird, haben Sie den Code mit Ihrer eigenen Änderung überschrieben. Klicken Sie auf „Zurück“, um die Ansicht auf die Standardeinstellung zurückzusetzen. Dadurch werden alle Änderungen entfernt, die Sie an dieser Ansicht vorgenommen haben.
DEVSOL-1578 Bei Websiteinstallationen sowohl Wetter- als auch Petstore-Modelle rendern
Sowohl die Petstore- als auch die Weather SmartDocs-Modelle werden in neue Websites importiert.
DEVSOL-1584 Abos können nicht erworben werden
Ein Problem wurde behoben, durch das das Kaufformular für Monetarisierungspläne nicht für die Cloud-Releases 15.05.27.00 und 15.06.08.00 gesendet wurde, wenn Sie das responsive Apigee-Design oder ein Unterthema des Apigee Responsive-Designs verwendet hatten.
DEVSOL-1597 Zeitüberschreitungseinstellungen für Entwickler können nicht geändert werden
Ein Fehler, bei dem die Zeitüberschreitungseinstellungen für die Edge-Verbindung nicht korrekt angewendet wurden, wurde behoben.
DEVSOL-1620

Ich, Umgebungsanzeige und Funktionsmodulupgrades
Einigermaßen kritisches Sicherheitsupdate für die Updates des me-Moduls und der Modulupdates für Umgebungsindikatoren und Features. Weitere Informationen:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 Achten Sie darauf, dass arg_separator.output „&“ lautet, um reCAPTCHA-Fehler zu vermeiden.
Ein plattformbezogenes Problem, bei dem die Verwendung von Google reCAPTCHA unterbrochen wurde, wurde behoben.
DEVSOL-1651 Das Apigee Base-Design schlägt fehl, wenn das SmartDocs-Modul nicht aktiviert ist.
Für das Apigee Base-Design ist es nicht mehr erforderlich, dass das SmartDocs-Modul aktiviert ist.
DEVSOL-1654

Version von „admin_views“ wiederholen, um kritisches Sicherheitsupdate aufzunehmen
Die folgenden Beitragsmodule wurden aktualisiert:

  • Administrative Ansichten
  • Migrieren
  • Weiterleiten
  • Redis
  • Aufrufe von Bulk-Vorgängen