15.05.27.00 – informacje o wersji portalu Apigee dla programistów

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

We wtorek 2 czerwca 2015 r. udostępniliśmy nową wersję w chmurze portalu usług dla deweloperów Apigee .

Jeśli masz pytania, skontaktuj się z zespołem pomocy Apigee Edge.

Listę wszystkich informacji o wersjach Apigee Edge znajdziesz w artykule Informacje o wersjach Apigee.

Nowe funkcje

Ogólna dostępność SmartDocs

SmartDocs wychodzi z wersji beta i staje się ogólnie dostępne. Aktualizacje i nowe funkcje:

• Obsługa Swagger 2.0, w tym importowanie według pliku lub adresu URL, oraz obsługa obiektów zabezpieczeń o nazwach niestandardowych.
• Ulepszenia wyglądu w szablonach generujących SmartDocs.
• Ulepszenia dotyczące użyteczności i przepływu pracy w portalu dla deweloperów, dostępne w Drupalu w menu Treści > SmartDocs.
• Uwierzytelnianie znane jako „Token niestandardowy” nosi teraz nazwę „Klucz API”.
• Obiekty „zabezpieczeń” uwierzytelniania zdefiniowane na poziomie wersji.
• Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie resetują już wstępnie skonfigurowanych danych logowania klienta SmartDocs.

Więcej informacji o funkcjach znajdziesz w tym poście na blogu.

Dokumentację SmartDocs znajdziesz w artykule Dokumentowanie interfejsów API za pomocą SmartDocs.

Proces uaktualniania SmartDocs

Jeśli korzystasz już ze SmartDocs w okresie beta, nowe funkcje i możliwości w wersji ogólnodostępnej wymagają uaktualnienia SmartDocs w portalu dla deweloperów.

Wszystkie strony SmartDocs, które zostały już opublikowane w portalu dla programistów, będą nadal działać , ale przed edytowaniem lub opublikowaniem zmian na istniejących lub nowych stronach musisz wykonać proces aktualizacji.

Pamiętaj, że chociaż możesz renderować i publikować SmartDocs w portalu dla programistów, są one generowane na podstawie modelu API, który znajduje się w usługach zarządzania interfejsami API Apigee Edge. Wszelkie zmiany wprowadzone w modelu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie jak deweloperzy w środowiskach Pantheon).

Aby przejść z wersji beta SmartDocs na wersję ogólnodostępną:

1. Zaktualizuj i przetestuj wersję 15.05.27 w środowiskach dev lub test w Pantheon.
2. Utwórz nowy model, który zastąpi dotychczasowy model API.
   • Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowej wersji.
   • Jeśli utrzymujesz model API za pomocą modułu SmartDocs, wyeksportuj go jako SmartDocs JSON i zaimportuj do nowego modelu za pomocą załącznika.
3. Ustaw właściwości zabezpieczeń wersji modelu. Na stronie Treści > SmartDocs > model kliknij Ustawienia zabezpieczeń.
   
4. Sprawdź wstępnie skonfigurowane uwierzytelnianie na stronie ustawień modelu (Treści > SmartDocs), klikając Ustawienia w kolumnie Operacje.
   
5. Zaktualizuj wszystkie szablony niestandardowe, aby używać zasobów CSS i JS w wersji 6, i wprowadź zmiany, aby odzwierciedlić nowe nazwy obiektów, takie jak authSchemes i apiSchema. Informacje o aktualizowaniu szablonów SmartDocs znajdziesz w artykule Dokumentowanie interfejsów API za pomocą SmartDocs.
6. Ponownie wyrenderuj i opublikuj wersję modelu.
7. Po sprawdzeniu nowej dokumentacji zaktualizuj portal produkcyjny do wersji 15.05.27.

Jeśli jesteś klientem korporacyjnym Edge i masz pytania lub wątpliwości dotyczące procesu uaktualniania , wyślij e-maila na adres marsh@apigee.com i cnovak@apigee.com. W przeciwnym razie skorzystaj z społeczności Apigee.

Naprawione błędy

W tej wersji naprawiono te błędy.

Identyfikator problemu	Opis
DEVSOL-487	Format dnia w Monetization powinien być konfigurowalny przez administratorów Format daty można teraz skonfigurować w Monetization w ustawieniach Monetization dla formatów daty europejskiej i amerykańskiej.
DEVSOL-603	Strona Konflikt planu jest źle sformatowana Gdy kupujesz plan, który pokrywa się z istniejącym planem, wyświetlana strona jest teraz dobrze sformatowana dla użytkownika.
DEVSOL-642	Przenieś konfiguracje na poziomie klienta z ustawień zabezpieczeń do ustawień szablonu ustawienia
DEVSOL-709	SmartDocs: nie można edytować parametru szablonu adresu URL po wysłaniu żądania z pustą wartością Rozwiązuje problem, który powoduje, że po usunięciu parametru szablonu w dokumentacji metody nie można edytować parametrów szablonu po wysłaniu żądania ze SmartDocs.
DEVSOL-1013	Umożliwienie edytowania adresów e-mail użytkowników portalu dla deweloperów Pole adresu e-mail na stronie profilu edycji nie będzie już wyłączone, a deweloperzy będą mogli zmieniać swoje adresy e-mail.
DEVSOL-1273	„DevConnect Mint” pojawia się 2 razy na liście modułów W sekcji Moduły „Dev Connect Mint” był wyświetlany 2 razy. Problem został już rozwiązany.
DEVSOL-1313	Obsługa importowania plików JSON/YAML lub adresów URL zarówno w przypadku Swagger, jak i WADL Pliki WADL można teraz importować za pomocą adresu URL, a pliki Swagger można przesyłać.
DEVSOL-1339	Zmień lokalizacje menu administracyjnego SmartDocs SmartDocs znajduje się teraz w menu treści, a ustawienia SmartDocs – w menu administracyjnym ustawień.
DEVSOL-1340	Usuń wersję beta po przejściu do wersji ogólnodostępnej SmartDocs znajduje się teraz w menu treści, a ustawienia SmartDocs – w menu administracyjnym ustawień.
DEVSOL-1390	Biblioteka PHP SDK Edge została zaktualizowana, aby rozwiązać problem z wywoływaniem __toString() Biblioteka PHP SDK Edge została zaktualizowana, aby rozwiązać problem z wywoływaniem __toString() w obiekcie DeveloperRatePlan, który powoduje ten błąd: {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} Jest to błąd, który dotyczy tylko klientów Monetization z kodem niestandardowym wywołującym metodę toString().
DEVSOL-1398	Model SmartDocs Petstore importowany podczas instalacji bez wyświetlania monitu dla użytkownika SmartDocs importuje teraz przykład Swagger Petstore podczas instalacji witryny (http://petstore.swagger.io/v2/swagger.json) zamiast modelu pogody, aby mieć bardziej wyczerpujący przykład użycia SmartDocs.
DEVSOL-1407	Cron kończy się niepowodzeniem, gdy jest wielu deweloperów Podczas uruchamiania crona Drupal duża liczba deweloperów powodowała przekroczenie limitu czasu. Gdy organizacja ma ponad 200 użytkowników, używany jest teraz proces wsadowy.
DEVSOL-1470	Utwórz link do menu „Interfejsy API” i odpowiedni widok Portal dla deweloperów SmartDocs domyślnie zawiera link do renderowanej dokumentacji SmartDocs w menu głównym o nazwie „Interfejsy API”, który prowadzi do wszystkich modeli z opublikowanymi metodami.

Znane problemy

Ta wersja zawiera te znane problemy:

Identyfikator problemu

Opis

DEVSOL-1558

Strony metod SmartDocs w przykładzie Petstore nie są prawidłowo renderowane w nowej instalacji Strony metod w przykładzie Petstore w SmartDocs nie są prawidłowo renderowane w nowej instalacji. Aby rozwiązać ten problem: W menu Drupal kliknij Treści > SmartDocs. Wybierz model „Petstore Example”. W sekcji Opcje aktualizacji kliknij Renderuj i publikuj węzły. Kliknij pole wyboru Zaznacz / odznacz wszystko , aby zaznaczyć wszystkie węzły. Kliknij Aktualizuj. Węzły powinny się teraz prawidłowo renderować.