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
- Aktualisieren und testen Sie Version 15.05.27 in Ihrer dev- oder Testumgebung in Pantheon.
- 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.
- Legen Sie die Sicherheitsattribute der Version Ihres Modells fest. Wählen Sie auf der Seite Inhalt > SmartDocs > Modell die Option Sicherheitseinstellungen aus.
- Prüfen Sie die vorkonfigurierte Authentifizierung auf der Seite mit den Modelleinstellungen (Content > SmartDocs), indem Sie in der Spalte „Vorgänge“ auf Einstellungen klicken.
- 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.
- Rendern Sie die Modellüberarbeitung noch einmal und veröffentlichen Sie sie.
- 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 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. # 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 https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| 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
|