Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację
Apigee X. info
8 września 2015 r. opublikowaliśmy kwartalną wersję portalu usług dla deweloperów Apigee Edge dla chmury prywatnej.
Poprzednia nazwa produktu "Portal usług dla deweloperów Apigee Edge lokalnie" lub "OPDK" to teraz "Portal usług dla deweloperów Apigee Edge dla chmury prywatnej".
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.
Wymagania Apigee Edge dotyczące portalu
Jeśli łączysz tę wersję portalu z instalacją Edge dla chmury prywatnej, musisz połączyć ją z wersją 4.15.07.00 lub nowszą, aby mieć pewność, że wszystkie funkcje SmartDocs są obsługiwane. Więcej informacji znajdziesz w informacjach o wersji 4.15.07.00 – Apigee Edge dla chmury prywatnej.
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, które generują SmartDocs.
- Ulepszenia dotyczące użyteczności i przepływu pracy w portalu dla deweloperów, dostępne w Drupalu w menu Treść > SmartDocs.
- Uwierzytelnianie „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ólnej dostępności wymagają uaktualnienia SmartDocs w portalu dla programistó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 interfejsu API, który znajduje się w usługach zarządzania interfejsami API Apigee Edge. Wszystkie zmiany wprowadzone w modelu interfejsu 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ą:
- Zaktualizuj i przetestuj wersję 15.05.27 w środowiskach dev lub test w Pantheon.
- Utwórz nowy model, który zastąpi dotychczasowy model interfejsu API.
- Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowej wersji.
- Jeśli utrzymujesz model interfejsu API za pomocą modułu SmartDocs, wyeksportuj go jako SmartDocs JSON i zaimportuj do nowego modelu za pomocą załącznika.
- Ustaw właściwości zabezpieczeń wersji modelu. Na stronie Treść >
SmartDocs > model kliknij Ustawienia zabezpieczeń.
- Sprawdź wstępnie skonfigurowane uwierzytelnianie na stronie ustawień modelu (Treść >
SmartDocs), klikając Ustawienia w kolumnie Operacje.
- 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. Więcej informacji o aktualizowaniu szablonów SmartDocs znajdziesz w artykule Dokumentowanie interfejsów API za pomocą SmartDocs.
- Ponownie wyrenderuj i opublikuj wersję modelu.
- 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, aby uzyskać najlepszą odpowiedź.
Naprawione błędy
W tej wersji naprawiliśmy 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-584 | Parametr ścieżki nie jest zapamiętywany przy pierwszym użyciu Parametr ścieżki podczas wykonywania połączeń nie zawsze był zapamiętywany. |
| 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-709 | SmartDocs: nie można edytować parametru szablonu adresu URL po wysłaniu żądania z pustą
wartością Rozwiązaliśmy problem, który powodował, że po usunięciu parametru szablonu w dokumentacji metody nie można było edytować parametrów szablonu po wysłaniu żądania ze SmartDocs. |
| DEVSOL-723 | Wyświetlanie przyjaznych dla użytkownika komunikatów o błędach podczas importowania 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-1244 | Nie włączaj modułu wskaźnika środowiska w przypadku wersji OPDK |
| 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 | Zmiana lokalizacji menu administratora SmartDocs SmartDocs znajduje się teraz w menu Treść, a ustawienia SmartDocs – w menu administratora Ustawienia. |
| DEVSOL-1340 | Usunięcie wersji beta po przejściu do wersji ogólnodostępnej |
| DEVSOL-1390 |
Biblioteka PHP SDK Edge została zaktualizowana, aby rozwiązać problem z wywoływaniem
__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 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 problem z przekroczeniem limitu czasu. Gdy organizacja ma więcej niż 200 użytkowników, używany jest teraz proces wsadowy. |
| DEVSOL-1410 | Błędy połączenia nie są widoczne podczas instalowania portalu dla deweloperów Dodaliśmy lepsze komunikaty o błędach w instalatorze, gdy połączenie z zarządzaniem Edge nie działa, aby zminimalizować problemy z rozwiązywaniem problemów. |
| DEVSOL-1422 | Usuwanie formularza konfiguracji SMTP z profilu Apigee Proces instalacji nie pyta już, czy chcesz skonfigurować SMTP. Możesz to zrobić po zakończeniu instalacji zgodnie ze standardową praktyką Drupal, czyli włączyć moduł SMTP i odpowiednio go skonfigurować. |
| DEVSOL-1427 |
Dodawanie haków do modułu aplikacji dla deweloperów Devconnect, aby umożliwić zmianę danych analitycznych # hook_devconnect_developer_apps_analytics_chart_data_alter() # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() Umożliwiają one modułom niestandardowym zmianę wykresu danych analitycznych aplikacji dla deweloperów. |
| DEVSOL-1464 | Błąd krytyczny podczas zapisywania ustawień uwierzytelniania dla modelu Gdy schemat zabezpieczeń zostanie usunięty, pojawi się pole wyboru, w którym możesz wybrać, czy powiązany schemat uwierzytelniania szablonu też ma zostać usunięty. |
| DEVSOL-1470 | Tworzenie linku do menu „Interfejsy API” i odpowiedniego widoku 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. |
| DEVSOL-1486 | Wywołania SmartDocs mogą uwierzytelniać się za pomocą wstępnie zdefiniowanego klucza Umożliwia uwierzytelnianie za pomocą wstępnie dostarczonych i dostarczonych przez użytkownika kluczy API. |
| DEVSOL-1499 | Kod HTML nie jest analizowany w opisach parametrów SmartDocs Kod HTML jest teraz analizowany w opisach parametrów SmartDocs. |
| DEVSOL-1507 | Nie można dodać wielu parametrów do interfejsu API za pomocą opcji Dodaj metodę Podczas edytowania metody możesz teraz dodać wiele parametrów do interfejsu API SmartDocs. |
| DEVSOL-1509 | Nie można edytować pola „przykład” w interfejsie API SmartDocs Podczas edytowania strony SmartDocs możesz teraz ustawić „Typ MIME treści”, „Dokumentację treści” i „Przykład treści”. |
| DEVSOL-1534 | Typ treści nie jest wypełniany w danych wyjściowych SmartDocs Typ treści jest teraz wypełniany na stronie metody SmartDocs. |
| DEVSOL-1554 | Nieprawidłowe porównanie dat w Monetization Na karcie zakupionego planu w portalach dla deweloperów z włączoną Monetization przycisk „Anuluj” nigdy nie był wyświetlany w przypadku planu z datą rozpoczęcia w przyszłości. |
| DEVSOL-1556 | Wysyłanie starej wersji modułów Drupal Moduły media_youtube i features zostały zaktualizowane do najnowszej wersji. |
| DEVSOL-1558 | Strony metod SmartDocs nie są renderowane w przypadku przykładu PetStore W przypadku nowych instalacji przykładowe metody SmartDocs PetStore są teraz renderowane prawidłowo. |
| DEVSOL-1562 | Generowanie widoku dla każdego modelu SmartDocs Podczas tworzenia nowego modelu domyślnie tworzony jest dla niego nowy widok. |
| DEVSOL-1565 | Edytowanie metody SmartDocs powoduje błąd krytyczny Rozwiązaliśmy problem, który powodował, że edytowanie metody SmartDocs czasami generowało błąd. |
| DEVSOL-1567 | „Dodaj model” wyświetla się w górnym menu administratora Rozwiązaliśmy problem, który powodował, że element menu „Dodaj model” był wyświetlany w górnym menu administratora. |
| DEVSOL-1576 | Widok dokumentacji interfejsu API wyświetla nazwę modelu, a nie nazwę wyświetlaną Strona dokumentacji interfejsu API, która wyświetla się po kliknięciu „Interfejsy API” w menu, wyświetlała wewnętrzną nazwę modelu zamiast nazwy wyświetlanej. Jeśli aktualizujesz do tej wersji i masz zmieniony ten widok, musisz przywrócić widok, aby zobaczyć te zmiany. Aby to zrobić: # Zaloguj się jako administrator. Kliknij „przywróć”, aby przywrócić widok do stanu domyślnego. # Kliknij menu obok opcji „Edytuj” w sekcji „Modele SmartDocs”, aby wyświetlić wszystkie operacje. |
| DEVSOL-1578 | Renderowanie modeli Weather i Petstore podczas instalacji witryny Podczas tworzenia nowych witryn importowane są modele SmartDocs Petstore i Weather. |
| DEVSOL-1584 | Nie można kupić planów Rozwiązaliśmy problem, który powodował, że formularz zakupu planów Monetization nie przesyłał się w przypadku wersji chmurowej 15.05.27.00 i 15.06.08.00, jeśli używasz motywu Apigee Responsive lub jego podmotywu. |
| DEVSOL-1597 | Nie można zmienić ustawień limitu czasu dewelopera Naprawiliśmy błąd, który powodował, że ustawienia limitu czasu połączenia Edge nie były prawidłowo stosowane. |
| DEVSOL-1620 |
Uaktualnienia modułów Me, Environment Indicator i Features https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Aby zapobiec awarii reCAPTCHA, upewnij się, że arg_separator.output to „&” Rozwiązaliśmy problem związany z platformą, który powodował, że korzystanie z Google reCAPTCHA było niemożliwe. |
| DEVSOL-1651 | Motyw Apigee Base nie działa, jeśli moduł SmartDocs nie jest włączony Motyw apigee_base nie jest już zależny od włączenia modułu SmartDocs. |
| DEVSOL-1654 |
Zwiększenie wersji admin_views, aby zastosować krytyczną poprawkę zabezpieczeń
|