Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
We wtorek 8 września 2015 r. wprowadziliśmy kwartalną wersję portalu Apigee Edge Developer Services dla prywatnej chmury.
Była nazwa usługi „Apigee Edge On-premises Developer Services Portal” lub „OPDK” to teraz „Apigee Edge Developer Services Portal for Private Cloud”.
Jeśli masz pytania, odwiedź stronę pomocy Apigee.
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 for Private Cloud, musisz połączyć ją z wersją 4.15.07.00 lub nowszą, aby mieć pewność, że wszystkie funkcje SmartDocs są obsługiwane. Aby dowiedzieć się więcej, zapoznaj się z informacjami o wersji 4.15.07.00 – Apigee Edge w Private Cloud.
Nowe funkcje
Ogólna dostępność SmartDocs
SmartDocs przechodzi z wersji beta do wersji ogólnodostępnej. Aktualizacje i nowe funkcje:
- Obsługa Swagger 2.0, w tym importowanie za pomocą pliku lub adresu URL, w tym obsługa obiektów zabezpieczeń o niestandardowych nazwach.
- Ulepszenia wizualne w szablonach, które generują dokumenty inteligentne.
- Ulepszenia dotyczące użyteczności i procesów w portalu dla deweloperów, dostępne w menu Treści > SmartDocs w Drupalu.
- Metoda uwierzytelniania „Token niestandardowy” została teraz zastąpiona metodą „Klucz API”.
- Obiekty „security” uwierzytelniania zdefiniowane na poziomie poprawki.
- Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie resetują żadnych wstępnie skonfigurowanych danych logowania klienta SmartDocs.
Więcej informacji o funkcjach znajdziesz w tym poście na blogu.
Dokumentację SmartDocs znajdziesz w artykule Używanie SmartDocs do dokumentowania interfejsów API.
Proces przekształcania SmartDocs
Jeśli korzystasz już z SmartDocs w wersji beta, nowe funkcje i możliwości w wersji ogólnodostępnej wymagają uaktualnienia SmartDocs na portalu deweloperskim.
Strony SmartDocs, które zostały już opublikowane w portalu deweloperskim, 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ć dokumenty SmartDocs w portalu dewelopera, dokumenty te są generowane na podstawie modelu interfejsu API, który znajduje się w usłudze zarządzania interfejsem API na krawędzi od firmy Apigee. Wszelkie zmiany wprowadzone w modelu interfejsu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie jak deweloperzy w różnych środowiskach Pantheon).
Aby przejść z wersji beta SmartDocs do wersji ogólnodostępnej
- Zaktualizuj i przetestuj wersję 15.05.27 w środowiskach rozwojowym lub testowym w Pantheon.
- Utwórz nowy model, aby zastąpić dowolny dotychczasowy model interfejsu API, którego używasz.
- Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowej wersji.
- Jeśli model interfejsu API był aktualizowany za pomocą modułu SmartDocs, wyeksportuj go jako plik JSON SmartDocs i zaimportuj do nowego modelu za pomocą załącznika.
- Ustaw właściwości zabezpieczeń wersji modelu. Na stronie Treść >
SmartDocs > model wybierz Ustawienia zabezpieczeń.
- Sprawdź dowolną wstępnie skonfigurowaną metodę uwierzytelniania na stronie ustawień modelu (Treści >
SmartDocs) przez kliknięcie Ustawień w kolumnie Operacje.
- Zaktualizuj wszystkie szablony niestandardowe, aby używały zasobów CSS i JS w wersji 6. Wprowadź zmiany, aby uwzględnić nowe nazwy obiektów, np. authSchemes i apiSchema. Informacje o aktualizowaniu szablonów SmartDocs znajdziesz w artykule Używanie SmartDocs do dokumentowania interfejsów API.
- Ponownie wyrenderuj i opublikuj zaktualizowany model.
- Po zweryfikowaniu nowej dokumentacji zaktualizuj portal produkcyjny do wersji 15.05.27.
Jeśli jesteś klientem Edge Enterprise i masz pytania lub wątpliwości dotyczące procesu aktualizacji, wyślij e-maila na adresy 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 sekcji Monetyzacja powinien być konfigurowalny przez administratorów W sekcji Monetyzacja w ustawieniach monetyzacji możesz teraz wybrać format daty: europejski lub amerykański. |
| DEVSOL-584 | Parametr ścieżki nie jest zapamięty przy pierwszym użyciu Parametr ścieżki podczas wykonywania wywołań nie był zawsze zapamięty. |
| DEVSOL-603 | Strona planu konfliktowego ma niewłaściwy format Podczas kupowania planu, który pokrywa się z dotychczasowym planem, wyświetlana strona jest teraz prawidłowo sformatowana. |
| DEVSOL-709 | SmartDocs: parametr szablonu URL nie jest edytowalny po wysłaniu żądania z pustą wartością Rozwiązanie problemu polega na tym, że po wysłaniu żądania z poziomu SmartDocs i usunięciu parametru szablonu w dokumentacji metody parametry szablonu nie są edytowalne. |
| DEVSOL-723 | Wyświetlanie przyjaznych użytkownikowi komunikatów w przypadku niepowodzenia importu za pomocą SmartDocs |
| DEVSOL-1013 | Umożliwienie edytowania adresów e-mail użytkowników portalu dla programistów Pole adresu e-mail na stronie edycji profilu nie będzie już wyłączone, a programiści 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ę dwukrotnie na liście modułów W sekcji „Moduły” „Dev Connect Mint” był wyświetlany dwukrotnie. Problem został już rozwiązany. |
| DEVSOL-1313 | Obsługa importowania plików JSON/YAML lub URL-i w przypadku Swaggera i WADL Teraz możesz importować pliki WADL za pomocą adresu URL, a pliki Swaggera możesz przesyłać. |
| DEVSOL-1339 | Zmiana lokalizacji menu administracyjnego SmartDocs SmartDocs znajduje się teraz w menu treści, a ustawienia SmartDocs w menu administracyjnym ustawień. |
| DEVSOL-1340 | Usuwanie wersji beta podczas wprowadzania wersji na rynek |
| DEVSOL-1390 |
Zaktualizowano bibliotekę PHP SDK Edge, aby rozwiązać problem z wywoływaniem funkcji
__toString() Błąd krytyczny: wywołanie funkcji członkowskiej format() na obiekcie innym niż obiekt w pliku /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php w wierszu 221 Ten błąd dotyczy tylko klientów korzystających z usługi Monetyzacja, którzy mają kod niestandardowy wywołujący metodę toString(). |
| DEVSOL-1398 | Model sklepu zoologicznego SmartDocs importowany podczas instalacji bez prośby o pozwolenie użytkownika SmartDocs teraz importuje przykład swagger sklepu zoologicznego (http://petstore.swagger.io/v2/swagger.json) podczas instalacji witryny zamiast modelu pogody, aby zapewnić bardziej wyczerpujący przykład używania SmartDocs. |
| DEVSOL-1407 | Cron nie działa, gdy jest wielu deweloperów Gdy uruchamiasz crona Drupala, duża liczba deweloperów powoduje problem z przekroczeniem limitu czasu. Jeśli organizacja ma więcej niż 200 użytkowników, jest używany proces zbiorczy. |
| DEVSOL-1410 | Błędy połączenia nie są widoczne podczas instalowania Portalu programistów Dodano lepszy komunikat o błędzie do instalatora, gdy połączenie z Edge Management nie działa, aby zminimalizować problemy z rozwiązywaniem problemów. |
| DEVSOL-1422 | Usuwanie formularza konfiguracji SMTP z profilu Apigee W procesie instalacji nie pojawia się już pytanie o konfigurowanie SMTP. Można to zrobić po zakończeniu instalacji, korzystając ze standardowej procedury w Drupal polegającej na włączeniu modułu SMTP i odpowiedniej konfiguracji. |
| DEVSOL-1427 |
Dodaj do modułu Devconnect Developer Apps elementy wywołujące, 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 modyfikowanie wykresów statystyk aplikacji dewelopera przez moduły niestandardowe. |
| DEVSOL-1464 | Błąd krytyczny podczas zapisywania ustawień uwierzytelniania modelu Po usunięciu schematu zabezpieczeń pojawi się pole wyboru, w którym można określić, czy powiązany schemat uwierzytelniania szablonu też ma zostać usunięty. |
| DEVSOL-1470 | Utwórz link do menu „Interfejsy API” i odpowiednią stronę Portal dla deweloperów SmartDocs zawiera teraz domyślnie link do renderowanej dokumentacji SmartDocs w menu głównym „Interfejsy API”, który prowadzi do wszystkich modeli z opublikowanymi metodami. |
| DEVSOL-1486 | Wywołania SmartDocs mogą być uwierzytelniane za pomocą zdefiniowanego wstępnie klucza Umożliwia uwierzytelnianie za pomocą kluczy API dostarczonych z góry lub przez użytkownika. |
| DEVSOL-1499 | Kod HTML nie jest parsowany w opisach parametrów SmartDocs Kod HTML jest teraz parsowany w opisach parametrów SmartDocs. |
| DEVSOL-1507 | Nie można dodać wielu parametrów do interfejsu API za pomocą metody Add Method Możesz teraz dodawać wiele parametrów do interfejsu API SmartDocs podczas edytowania metody. |
| DEVSOL-1509 | Nie widzisz sposobu na edytowanie pola „sample” w przypadku interfejsu API SmartDocs podczas edytowania strony SmartDocs możesz teraz ustawić „Typ MIME treści”, „Dokumentację treści” i „Próbkę treści”. |
| DEVSOL-1534 | Typ treści nie jest wypełniany w wyjściu usługi SmartDocs Typ treści jest teraz wypełniany na stronie metody usługi SmartDocs. |
| DEVSOL-1554 | Nieprawidłowe porównanie dat w Monetyzacji Na karcie zakupionego abonamentu w portalu dewelopera z włączoną monetyzacją nigdy nie wyświetlał się przycisk „Anuluj” w przypadku abonamentu z przyszłą datą rozpoczęcia. |
| DEVSOL-1556 | Wysyłane są stare wersje modułów Drupala Moduł media_youtube i funkcje zostały zaktualizowane do najnowszej wersji. |
| DEVSOL-1558 | Strony metod w 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 | Wygeneruj widok dla każdego modelu SmartDocs Podczas tworzenia nowego modelu domyślnie tworzony jest nowy widok. |
| DEVSOL-1565 | Edycja metody SmartDocs powoduje błąd krytyczny Rozwiązaliśmy problem, który powodował, że edycja metody SmartDocs czasami powodowała błąd. |
| DEVSOL-1567 | Element menu „Dodaj model” wyświetlany u góry menu administracyjnego Rozwiązano problem z wyświetlaniem elementu menu „Dodaj model” u góry menu administracyjnego. |
| DEVSOL-1576 | Widok dokumentacji interfejsu API wyświetla nazwę modelu, a nie wyświetlaną nazwę Strona dokumentacji interfejsu API, która wyświetla się po kliknięciu „Interfejsy API” w menu, wyświetlała nazwę wewnętrzną modelu zamiast wyświetlanej nazwy. Jeśli aktualizujesz wersję i zmienisz ten widok, musisz go przywrócić, aby zobaczyć te zmiany. W tym celu: # Zaloguj się jako administrator # Przejdź do Struktura > Widoki # Kliknij menu obok opcji „Edytuj” w sekcji „Modele SmartDocs”, aby wyświetlić wszystkie operacje. # Jeśli widzisz opcję „Cofnij”, oznacza to, że zastąpiono kod Twoją zmianą. Kliknij „Cofnij”, aby przywrócić widok do stanu domyślnego. Pamiętaj, że spowoduje to usunięcie wszystkich zmian wprowadzonych w tym widoku. |
| DEVSOL-1578 | Wyświetlanie modeli Petstore i Weather podczas instalowania witryn Oba modele SmartDocs Petstore i Weather są importowane do nowych witryn. |
| DEVSOL-1584 | Nie można kupić subskrypcji Rozwiązano problem, który powodował, że formularz zakupu subskrypcji zarabiania nie był przesyłany w przypadku wersji w chmurze 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 dla deweloperów Naprawiono błąd, który powodował, że ustawienia limitu czasu połączenia w 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 uszkodzeniu reCAPTCHA, sprawdź, czy arg_separator.output ma wartość „&”. Został rozwiązany problem związany z platformą, który uniemożliwiał korzystanie z reCAPTCHA Google. |
| DEVSOL-1651 | Motyw Apigee Base nie działa, jeśli moduł SmartDocs nie jest włączony Motyw apigee_base nie zależy już od włączenia modułu SmartDocs. |
| DEVSOL-1654 |
Zwiększenie wersji modułu admin_views w celu uwzględnienia ważnej poprawki zabezpieczeń
|