Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info
Am Dienstag, dem 8. September 2015, haben wir eine vierteljährliche Version des Apigee Edge Developer Services Portals für die Private Cloud veröffentlicht.
Der frühere Produktname „Apigee Edge On-Premises Developer Services Portal“ oder „OPDK“ lautet jetzt „Apigee Edge Developer Services Portal for Private Cloud“.
Wenn Sie Fragen haben, wenden Sie sich an den Apigee-Kundensupport.
Eine Liste aller Apigee Edge-Versionshinweisen finden Sie unter Apigee-Versionshinweisen.
Apigee Edge-Anforderungen für das Portal
Wenn Sie diese Version des Portals mit einer Installation von Edge for Private Cloud verbinden, müssen Sie sie mit Version 4.15.07.00 oder höher verbinden, damit alle SmartDocs-Funktionen unterstützt werden. Weitere Informationen finden Sie in den Versionshinweisen für 4.15.07.00 – Apigee Edge for Private Cloud.
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-584 | Pfadparameter wird bei der ersten Verwendung nicht gespeichert Der Pfadparameter bei Aufrufen wurde nicht immer gespeichert. |
| 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-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-723 | Nutzerfreundliche Fehlermeldungen beim SmartDocs-Import anzeigen |
| 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-1244 | Modul „Umgebungsanzeige“ für OPDK-Releases nicht aktivieren |
| 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 | „Beta“ entfernen, wenn Sie zu GA wechseln |
| DEVSOL-1390 |
Die PHP SDK Edge-Bibliothek wurde aktualisiert, um das Problem beim Aufrufen von __toString() zu beheben. Kritischer Fehler: Aufruf einer Mitgliedsfunktion „format()“ auf 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 mit benutzerdefiniertem Code, in dem die Methode toString() aufgerufen wird. |
| DEVSOL-1398 | SmartDocs-Petstore-Modell wird bei der Installation ohne Aufforderung des Nutzers importiert SmartDocs importiert jetzt das Petstore-Swagger-Beispiel (http://petstore.swagger.io/v2/swagger.json) anstelle des Wettermodells während der Websiteinstallation, 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-1410 | Verbindungsfehler bei der Installation des Dev Portals nicht sichtbar Es wurden bessere Fehlermeldungen in den Installationsprogramm hinzugefügt, wenn die Edge-Verwaltungsverbindung nicht funktioniert, um Probleme bei der Fehlerbehebung zu minimieren. |
| DEVSOL-1422 | SMTP-Konfigurationsformular aus dem Apigee-Profil entfernen Während der Installation werden Sie nicht mehr gefragt, ob Sie SMTP konfigurieren möchten. Stattdessen können Sie dies nach Abschluss der Installation tun. Aktivieren Sie dazu das SMTP-Modul und konfigurieren Sie es gemäß den standardmäßigen Drupal-Vorgaben. |
| DEVSOL-1427 |
Dem Devconnect-Modul „Developer Apps“ wurden Hooks hinzugefügt, um die Analysedaten zu ändern. # hook_devconnect_developer_apps_analytics_chart_data_alter() # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() So können benutzerdefinierte Module das Analysediagramm für Entwickler-Apps ändern. |
| DEVSOL-1464 | Fataler Fehler beim Speichern der Authentifizierungseinstellungen für ein Modell Wenn ein Sicherheitsschema gelöscht wird, kann jetzt in einem Kästchen ausgewählt werden, ob auch das zugehörige Vorlagen-Authentifizierungsschema gelöscht werden soll. |
| 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. |
| DEVSOL-1486 | SmartDocs-Aufrufe können mit einem vordefinierten Schlüssel authentifiziert werden Ermöglicht die Authentifizierung sowohl mit vorab bereitgestellten als auch von Nutzern bereitgestellten API-Schlüsseln. |
| DEVSOL-1499 | HTML-Code wird in SmartDocs-Parameterbeschreibungen nicht geparst HTML-Code wird jetzt in SmartDocs-Parameterbeschreibungen geparst. |
| DEVSOL-1507 | Mit der Methode „Methode hinzufügen“ können einer API keine mehrere Parameter hinzugefügt werden Sie können einer SmartDocs API jetzt mehrere Parameter hinzufügen, wenn Sie die Methode bearbeiten. |
| DEVSOL-1509 | Ich kann das Feld „sample“ für eine SmartDocs API nicht bearbeiten Sie können jetzt „MIME-Typ des Inhalts“, „Dokumentation des Inhalts“ und „Beispiel für den Inhalt“ festlegen, wenn Sie eine SmartDocs-Seite bearbeiten. |
| DEVSOL-1534 | Der Inhaltstyp wird in der SmartDocs-Ausgabe nicht ausgefüllt Der Inhaltstyp wird jetzt auf der SmartDocs-Methodenseite ausgefüllt. |
| DEVSOL-1554 | Ungültiger Datumsvergleich bei der Monetarisierung Auf dem Tab „Gekauftes Abo“ in Entwicklerportalen, in denen die Monetarisierung aktiviert ist, wurde die Schaltfläche „Stornieren“ für ein Abo mit einem zukünftigen Startdatum nie angezeigt. |
| DEVSOL-1556 | Alte Version von Drupal-Modulen wird bereitgestellt Die Module „media_youtube“ und „features“ wurden auf die neueste Version aktualisiert. |
| DEVSOL-1558 | SmartDocs-Methodenseiten werden für das Beispiel „Tierbedarf“ nicht gerendert Bei neuen Installationen werden die Beispielmethoden für SmartDocs „Tierbedarf“ jetzt korrekt gerendert. |
| DEVSOL-1562 | Eine Ansicht für jedes SmartDocs-Modell generieren Beim Erstellen eines neuen Modells wird standardmäßig eine neue Ansicht für dieses Modell erstellt. |
| DEVSOL-1565 | Beim Bearbeiten einer SmartDocs-Methode wird ein schwerwiegender Fehler generiert Es wurde ein Problem behoben, bei dem beim Bearbeiten einer SmartDocs-Methode manchmal ein Fehler generiert wurde. |
| DEVSOL-1567 | „Modell hinzufügen“ wird im oberen Menü der Verwaltung angezeigt Das Problem wurde behoben, dass der Menüpunkt „Modell hinzufügen“ im oberen Menü der Verwaltung angezeigt wird. |
| DEVSOL-1576 | In der API-Dokumentation wird der Modellname und nicht der Anzeigename angezeigt Auf der Seite „API-Dokumentation“, die angezeigt wird, wenn im Menü auf „APIs“ geklickt wird, wurde der interne Name des Modells anstelle des Anzeigenamens angezeigt. Wenn Sie auf die neue Version aktualisieren und diese Ansicht geändert haben, müssen Sie sie zurücksetzen, um die Änderungen zu sehen. Gehen Sie dazu so vor: # Melden Sie sich als Administrator an. # Gehen Sie zu „Struktur“ > „Ansichten“. # Klicken Sie unter „SmartDocs-Modelle“ auf das Drop-down-Menü neben „Bearbeiten“, um alle Vorgänge zu sehen. # Wenn „rückgängig machen“ angezeigt wird, haben Sie den Code mit Ihrer eigenen Änderung überschrieben. Klicken Sie auf „Zurücksetzen“, um die Ansicht auf den Standardzustand zurückzusetzen. Hinweis: Dadurch werden alle Änderungen an dieser Ansicht entfernt. |
| DEVSOL-1578 | Soll bei der Installation einer Website sowohl das Wetter- als auch das Petstore-Modell gerendert werden? Sowohl das Petstore- als auch das Wetter-SmartDocs-Modell werden auf neuen Websites importiert. |
| DEVSOL-1584 | Tarife können nicht gekauft werden Das Problem wurde behoben, dass das Kaufformular für Monetarisierungspakete bei den Cloud-Releases vom 27.05.15.00 und 08.06.15.00 nicht gesendet wurde, wenn das Apigee-Responsive-Design oder ein Unterthema des Apigee-Responsive-Designs verwendet wurde. |
| DEVSOL-1597 | Einstellungen für Zeitüberschreitungen von Entwicklern können nicht geändert werden Ein Fehler, durch den die Einstellungen für Zeitüberschreitungen von Edge-Verbindungen nicht richtig angewendet wurden, wurde behoben. |
| DEVSOL-1620 |
Module „Mein YouTube“, „Umgebungsanzeige“ und „Funktionen“ aktualisieren https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Achten Sie darauf, dass „arg_separator.output“ den Wert „&“ hat, um Fehler bei reCAPTCHA zu vermeiden. Ein Plattformproblem, bei dem die Verwendung von Google reCAPTCHA nicht funktionierte, wurde behoben. |
| DEVSOL-1651 | Apigee Base-Design funktioniert nicht, wenn das SmartDocs-Modul nicht aktiviert ist Das Apigee Base-Design ist nicht mehr davon abhängig, ob das SmartDocs-Modul aktiviert ist. |
| DEVSOL-1654 |
Version von „admin_views“ erhöht, um kritische Sicherheitskorrektur anzuwenden
|