Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu
Apigee X. info
Am Dienstag, 8. September 2015, haben wir eine vierteljährliche Version des Apigee Edge Developer Services Portal für Private Cloud veröffentlicht.
Der bisherige 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 Edge-Support.
Eine Liste aller Versionshinweise zu Apigee Edge finden Sie unter Versionshinweise zu Apigee.
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 zu 4.15.07.00 – Apigee Edge for Private Cloud.
Neue Funktionen
Allgemeine Verfügbarkeit von SmartDocs
SmartDocs geht von der Betaphase in die allgemeine Verfügbarkeit über. 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 Sicherheitsobjekte.
- Verbesserungen des visuellen Designs in den Vorlagen, mit denen SmartDocs generiert wird.
- Verbesserungen der Nutzerfreundlichkeit und des Workflows im Entwicklerportal, verfügbar über das Menü „Content“ > „SmartDocs“ in Drupal.
- Die bisher als „Benutzerdefiniertes Token“ bekannte Authentifizierung wird jetzt als „API-Schlüssel“ bezeichnet.
- Authentifizierungsobjekte („Sicherheit“) auf Revisionsebene definiert.
- Konfiguration der Clientauthentifizierung auf Vorlagenebene. Bei neuen Revisionen werden vorkonfigurierte SmartDocs-Clientanmeldedaten nicht mehr zurückgesetzt.
Weitere Funktionsbeschreibungen finden Sie in diesem Blog post.
Die SmartDocs-Dokumentation finden Sie unter APIs mit SmartDocs dokumentieren.
SmartDocs-Upgradeprozess
Wenn Sie SmartDocs bereits in der Betaphase verwendet haben, müssen Sie ein Upgrade auf die Version mit allgemeiner Verfügbarkeit durchführen, um die neuen Funktionen und Möglichkeiten 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 vorhandenen oder neuen Seiten bearbeiten oder veröffentlichen.
SmartDocs können zwar in Ihrem Entwicklerportal gerendert und veröffentlicht werden, SmartDocs werden jedoch aus dem API-Modell generiert, das sich in den Apigee Edge API Management Services befindet. Alle Änderungen, die Sie an einem API-Modell in Edge vornehmen, werden in allen Ihren Pantheon Umgebungen übernommen (ähnlich wie bei Entwicklern in verschiedenen Pantheon-Umgebungen).
So führen Sie ein Upgrade von der SmartDocs-Betaversion auf die Version mit allgemeiner Verfügbarkeit durch
- Aktualisieren und testen Sie das Release 15.05.27 in Ihren Entwicklungs- oder Testumgebungen auf Pantheon.
- Erstellen Sie ein neues Modell, um alle vorhandenen API-Modelle zu ersetzen.
- 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 verwalten, exportieren Sie es als SmartDocs-JSON und importieren Sie es mit einer Dateianlage in Ihr neues Modell.
- Legen Sie die Sicherheitseigenschaften der Revision Ihres Modells fest. Wählen Sie auf der Seite Content >
SmartDocs > model die Option Security Settings aus.
- Prüfen Sie alle vorkonfigurierten Authentifizierungen auf der Seite mit den Modelleinstellungen (Content >
SmartDocs). Klicken Sie dazu in der Spalte „Operations“ auf Settings.
- 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“ zu berücksichtigen. Informationen zum Aktualisieren von SmartDocs Vorlagen finden Sie unter APIs mit SmartDocs dokumentieren.
- Rendern und veröffentlichen Sie die Modellrevision noch einmal.
- Nachdem Sie die neue Dokumentation validiert haben, aktualisieren Sie Ihr Produktionsportal auf Release 15.05.27.
Wenn Sie ein Edge-Unternehmen sind und Fragen oder Bedenken zum Upgrade Prozess haben, senden Sie bitte eine E‑Mail an marsh@apigee.com und cnovak@apigee.com. Andernfalls verwenden Sie bitte die Apigee-Community, um die beste Antwort zu erhalten.
Fehlerkorrekturen
Folgende Fehler wurden in diesem Release behoben.
| Problem-ID | Beschreibung |
|---|---|
| DEVSOL-487 | Das Datumsformat in der Monetarisierung sollte von Administratoren konfigurierbar sein Das Datumsformat kann jetzt in der Monetarisierung unter den Monetarisierungseinstellungen für europäische und US-amerikanische Datumsformate konfiguriert werden. |
| DEVSOL-584 | Pfad-Parameter wird bei der ersten Verwendung nicht gespeichert Der Pfad-Parameter wurde bei Aufrufen nicht immer gespeichert. |
| DEVSOL-603 | Die Seite „Konfliktplan“ ist schlecht formatiert Wenn Sie einen Plan kaufen, der sich mit einem vorhandenen Plan überschneidet, wird die angezeigte Seite jetzt für den Nutzer formatiert. |
| DEVSOL-709 | SmartDocs: URL-Vorlagenparameter kann nach dem Senden einer Anfrage mit einem leeren
Wert nicht 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 Meldungen bei SmartDocs-Importfehlern anzeigen |
| 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-1244 | Das Modul „Umgebungsindikator“ 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 | JSON/YAML-Datei- oder URL-Import für Swagger und WADL unterstützen WADL-Dateien können jetzt über eine URL importiert und Swagger-Dateien hochgeladen werden. |
| DEVSOL-1339 | Speicherorte des SmartDocs-Admin-Menüs ändern SmartDocs befindet sich jetzt im Menü „Content“ und die SmartDocs-Einstellungen im Admin-Menü „Settings“. |
| DEVSOL-1340 | „Beta“ entfernen, wenn zu „Allgemeine Verfügbarkeit“ gewechselt wird |
| DEVSOL-1390 |
Die PHP SDK Edge-Bibliothek wurde aktualisiert, um das Problem beim Aufrufen von
__toString() Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 Dieser Fehler betrifft nur Monetarisierungskunden mit benutzerdefiniertem Code, der die Methode toString() aufruft. |
| DEVSOL-1398 | SmartDocs-Petstore-Modell wird bei der Installation ohne Aufforderung des Nutzers importiert SmartDocs importiert jetzt während der Websiteinstallation das Swagger-Beispiel für den Tierbedarfsladen (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 viele Entwickler vorhanden sind Beim Ausführen von Drupal-Cron würde eine große Anzahl von Entwicklern zu einem Timeout-Problem führen. Wenn eine Organisation mehr als 200 Nutzer hat, wird jetzt ein Batchprozess verwendet. |
| DEVSOL-1410 | Verbindungsfehler beim Installieren des Entwicklerportals werden nicht angezeigt Dem Installationsprogramm wurden bessere Fehlermeldungen hinzugefügt, wenn die Edge-Verbindung nicht funktioniert, um Probleme bei der Fehlerbehebung zu minimieren. |
| DEVSOL-1422 | SMTP-Konfigurationsformular aus dem Apigee-Profil entfernen Beim Installationsprozess werden Sie nicht mehr gefragt, ob Sie SMTP konfigurieren möchten. Stattdessen kann dies nach Abschluss der Installation gemäß der Standardpraxis von Drupal erfolgen, indem Sie das SMTP-Modul aktivieren und richtig konfigurieren. |
| DEVSOL-1427 |
Hooks zum Modul „Devconnect Developer Apps“ hinzufügen, 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() Damit können benutzerdefinierte Module das Diagramm der App-Analysen von 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, mit dem Sie auswählen können, ob das zugehörige Authentifizierungsschema der Vorlage ebenfalls gelöscht werden soll. |
| DEVSOL-1470 | Menülink „APIs“ und entsprechende Ansicht erstellen Das Entwicklerportal SmartDocs enthält jetzt standardmäßig einen Link zur gerenderten SmartDocs-Dokumentation im Hauptmenü mit dem Namen „APIs“, der auf alle Modelle mit veröffentlichten Methoden verweist. |
| DEVSOL-1486 | SmartDocs-Aufrufe können mit einem vordefinierten Schlüssel authentifiziert werden Ermöglicht die Authentifizierung mit vorab bereitgestellten und vom Nutzer bereitgestellten API-Schlüsseln. |
| DEVSOL-1499 | HTML-Code wird in SmartDocs-Parameterbeschreibungen nicht geparst HTML-Code wird jetzt in SmartDocs-Parameterbeschreibungen geparst. |
| DEVSOL-1507 | Einer API können mit „Methode hinzufügen“ nicht mehrere Parameter hinzugefügt werden Sie können jetzt beim Bearbeiten der Methode mehrere Parameter zu einer SmartDocs-API hinzufügen. |
| DEVSOL-1509 | Das Feld „Beispiel“ für eine SmartDocs-API kann nicht bearbeitet werden Sie können jetzt beim Bearbeiten einer SmartDocs-Seite den MIME-Typ des Texts, die Dokumentation des Texts und das Beispiel für den Text festlegen. |
| DEVSOL-1534 | Content-Type wird in der SmartDocs-Ausgabe nicht ausgefüllt Der Content-Type wird jetzt auf der SmartDocs-Methodenseite ausgefüllt. |
| DEVSOL-1554 | Ungültiger Datumsvergleich in der Monetarisierung Auf dem Tab „Gekaufter Plan“ für Entwicklerportale mit aktivierter Monetarisierung wurde die Schaltfläche „Abbrechen“ nie für einen Plan mit einem zukünftigen Startdatum angezeigt, |
| DEVSOL-1556 | Alte Version von Drupal-Modulen wird ausgeliefert Die Module „media_youtube“ und „features“ wurden auf die neueste Version aktualisiert. |
| DEVSOL-1558 | SmartDocs-Methodenseiten werden für das PetStore-Beispiel nicht gerendert Bei neuen Installationen werden die SmartDocs-Methoden für den Tierbedarfsladen 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 Behebt das Problem, dass beim Bearbeiten einer SmartDocs-Methode manchmal ein Fehler generiert wurde. |
| DEVSOL-1567 | „Modell hinzufügen“ wird im oberen Admin-Menü angezeigt Behebt das Problem, dass das Menüelement „Modell hinzufügen“ im oberen Admin-Menü angezeigt wird. |
| DEVSOL-1576 | In der Ansicht „API-Dokumentation“ wird der Modellname und nicht der Anzeigename angezeigt Auf der Seite „API-Dokumentation“, die angezeigt wird, wenn Sie im Menü auf „APIs“ klicken, wurde der interne Name des Modells anstelle des Anzeigenamens angezeigt. Wenn Sie ein Upgrade auf das Release durchführen und diese Ansicht geändert haben, müssen Sie die Ansicht zurücksetzen, um diese Änderungen zu sehen. Gehen Sie dazu so vor: # Melden Sie sich als Administrator an. # Rufen Sie „Structure“ > „Views“ auf. # Klicken Sie auf das Drop-down-Menü neben „Edit“ unter „SmartDocs Models“, um alle Vorgänge zu sehen. # Wenn Sie "revert" sehen, haben Sie den Code mit Ihrer eigenen Änderung überschrieben. Klicken Sie auf „revert“, um die Ansicht auf den Standardzustand zurückzusetzen. Dadurch werden alle Änderungen entfernt, die Sie an dieser Ansicht vorgenommen haben. |
| DEVSOL-1578 | Sowohl das Wetter- als auch das Petstore-Modell bei der Installation der Website rendern Sowohl das Petstore- als auch das Wetter-SmartDocs-Modell werden auf neuen Websites importiert. |
| DEVSOL-1584 | Pläne können nicht gekauft werden Behebt das Problem, dass das Kaufformular für Monetarisierungspläne für die Cloud-Releases 15.05.27.00 und 15.06.08.00 nicht gesendet wurde, wenn Sie das Apigee Responsive-Theme oder ein Untertheme des Apigee Responsive-Themes verwendet haben. |
| DEVSOL-1597 | Timeout-Einstellungen für Entwickler können nicht geändert werden Ein Fehler, bei dem die Timeout-Einstellungen für die Edge-Verbindung nicht richtig angewendet wurden, wurde behoben. |
| DEVSOL-1620 |
Upgrades für „Me“, „Umgebungsindikator“ und „Features“ https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Sicherstellen, dass „arg_separator.output“ „&“ ist, um reCAPTCHA
Fehler zu vermeiden Ein plattformbezogenes Problem, bei dem die Verwendung von Google reCAPTCHA nicht funktionierte, wurde behoben. |
| DEVSOL-1651 | Das Apigee Base-Theme schlägt fehl, wenn das SmartDocs-Modul nicht aktiviert ist Das Theme „apigee_base“ ist nicht mehr davon abhängig, dass das SmartDocs-Modul aktiviert ist. |
| DEVSOL-1654 |
Version von „admin_views“ aktualisieren, um kritische Sicherheitskorrekturen zu übernehmen
|