Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu
Apigee X. info
Am Dienstag, 2. Juni 2015, haben wir eine neue Cloud-Version des Apigee Developer Services Portal veröffentlicht.
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.
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 Sicherheits-Objektnamen.
- Verbesserungen des visuellen Designs in den Vorlagen, die SmartDocs generieren.
- 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.
- Authentifizierungs-„Sicherheitsobjekte“ 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 während der Betaphase verwendet haben, müssen Sie SmartDocs in Ihrem Entwickler portal aktualisieren, um die neuen Funktionen und Möglichkeiten der Version mit allgemeiner Verfügbarkeit 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 Edge API Management Services von Apigee befindet. Alle Änderungen, die Sie an einem API-Modell in Edge vornehmen, werden in allen Ihren Pantheon Umgebungen übernommen (ähnlich wie bei Entwicklern in Pantheon-Umgebungen).
So führen Sie ein Upgrade von der SmartDocs-Betaversion auf die Version mit allgemeiner Verfügbarkeit durch
- Aktualisieren und testen Sie die Version 15.05.27 in Ihren Entwicklungs- oder Testumgebungen auf Pantheon.
- Erstellen Sie ein neues Modell, um alle vorhandenen API-Modelle zu ersetzen, die Sie verwendet haben.
- 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 verwaltet haben, exportieren Sie es als SmartDocs-JSON und importieren Sie es über eine 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), indem Sie in der Spalte „Operations“ auf Settings 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“ 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 die Version 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 erhalten Sie in der Apigee-Community die beste Antwort.
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-603 | Die Seite „Conflict Plan“ 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-642 | Konfigurationen auf Clientebene von den Sicherheitseinstellungen zu den Vorlagen einstellungen verschieben |
| DEVSOL-709 | SmartDocs: URL-Vorlagenparameter können nach dem Senden einer Anfrage mit leerem
Wert nicht bearbeitet werden Behebt das Problem, dass die Vorlagenparameter nicht bearbeitet werden können, nachdem die Anfrage von SmartDocs gesendet wurde, nachdem der Vorlagenparameter in der Methodendokumentation gelöscht wurde. |
| 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-1273 | „DevConnect Mint“ wird zweimal in der Liste „Modules“ angezeigt Unter „Modules“ 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 | SmartDocs-Admin-Menüstandorte ändern SmartDocs befindet sich jetzt im Menü „Content“ und die SmartDocs-Einstellungen im Admin-Menü „Settings“. |
| DEVSOL-1340 | Beta entfernen, wenn zu GA gewechselt wird SmartDocs befindet sich jetzt im Menü „Content“ und die SmartDocs-Einstellungen im Admin-Menü „Settings“. |
| DEVSOL-1390 | Die PHP SDK Edge-Bibliothek wurde aktualisiert, um das Problem beim Aufrufen von
__toString() Die PHP SDK Edge-Bibliothek wurde aktualisiert, um das Problem beim Aufrufen von __toString() für das DeveloperRatePlan-Objekt zu beheben, das diesen Fehler verursacht: {quote} 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 {quote} 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 verursachte eine große Anzahl von Entwicklern ein Timeout-Problem. Wenn eine Organisation mehr als 200 Nutzer hat, wird jetzt ein Batchprozess verwendet. |
| DEVSOL-1470 | Menülink „APIs“ und entsprechende Ansicht erstellen Dev Portal 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. |
Bekannte Probleme
Dieses Release enthält die folgenden bekannten Probleme:
| Problem-ID | Beschreibung |
|---|---|
| DEVSOL-1558 |
Die SmartDocs-Methodenseiten des Petstore-Beispiels werden bei einer neuen
Installation nicht korrekt gerendert
Die Beispielmethodenseiten des Tierbedarfsladens in SmartDocs werden bei einer neuen
Installation nicht korrekt gerendert. So beheben Sie das Problem:
Die Knoten sollten jetzt ordnungsgemäß gerendert werden. |