Wyświetlasz dokumentację Apigee Edge.
Zapoznaj się z dokumentacją Apigee X. info
We wtorek 8 września 2015 roku udostępniliśmy kwartalną wersję portalu usług deweloperskich Apigee Edge dla chmury prywatnej.
Poprzednia nazwa produktu „Apigee Edge On-premises Developer Services Portal” lub „OPDK” to teraz „Apigee Edge Developer Services Portal for Private Cloud”.
Jeśli masz pytania, skontaktuj się z zespołem pomocy Apigee Edge.
Listę wszystkich informacji o wersjach Apigee Edge znajdziesz w informacjach o wersjach Apigee.
Wymagania dotyczące portalu Apigee Edge
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. Więcej informacji znajdziesz w informacjach o wersji 4.15.07.00 Apigee Edge Private Cloud.
Nowe funkcje
Ogólna dostępność SmartDocs
SmartDocs wychodzi z wersji beta i staje się ogólnie dostępny. Aktualizacje i nowe funkcje obejmują:
- Obsługa Swaggera 2.0, w tym importowanie według pliku lub adresu URL, a także obsługa obiektów zabezpieczeń o niestandardowych nazwach.
- Ulepszenia projektu wizualnego w szablonach, które generują dokumenty SmartDocs.
- Ulepszenia dotyczące użyteczności i przepływu pracy w Portalu dla deweloperów, dostępne w menu Treści > SmartDocs w Drupalu.
- Uwierzytelnianie znane dotychczas jako „Token niestandardowy” nosi teraz nazwę „Klucz interfejsu API”.
- Obiekty „security” uwierzytelniania zdefiniowane na poziomie wersji.
- Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie resetują już wstępnie skonfigurowanych danych logowania klienta Smart Docs.
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 uaktualniania SmartDocs
Jeśli korzystasz już z SmartDocs w okresie testów beta, nowe funkcje i możliwości w wersji ogólnodostępnej wymagają uaktualnienia SmartDocs w portalu dewelopera.
Wszystkie strony SmartDocs, które zostały już opublikowane w portalu dla deweloperów, będą nadal działać, ale przed edytowaniem lub publikowaniem zmian na istniejących lub nowych stronach musisz przejść proces aktualizacji.
Pamiętaj, że dokumenty SmartDocs możesz renderować i publikować w portalu dla deweloperów, ale są one generowane na podstawie modelu interfejsu API, który znajduje się w usługach zarządzania interfejsami API Edge od Apigee. Wszelkie zmiany wprowadzone w modelu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie jak w przypadku deweloperów w środowiskach Pantheon).
Aby przejść z wersji beta SmartDocs na wersję ogólnodostępną:
- Zaktualizuj i przetestuj wersję 15.05.27 w środowiskach programistycznym lub testowym 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 model interfejsu API był utrzymywany 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ści > SmartDocs > model kliknij Ustawienia zabezpieczeń.
- Sprawdź wstępnie skonfigurowane uwierzytelnianie na stronie ustawień modelu (Treści > SmartDocs), klikając Ustawienia w kolumnie Operacje.
- Zaktualizuj wszystkie szablony niestandardowe, aby korzystały z wersji 6 zasobów CSS i JS, i wprowadź zmiany odzwierciedlające 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.
- Ponownie wyrenderuj i opublikuj zmienioną 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 adresy marsh@apigee.com i cnovak@apigee.com. W innych przypadkach skorzystaj z społeczności Apigee, aby uzyskać najlepszą odpowiedź.
Usunięte błędy
W tej wersji naprawiliśmy te błędy:
| Identyfikator problemu | Opis |
|---|---|
| DEVSOL-487 | Format dnia w sekcji Zarabianie powinien być konfigurowalny przez administratorów Format daty można teraz skonfigurować w sekcji Zarabianie w ustawieniach zarabiania dla formatów daty w Europie i Stanach Zjednoczonych. |
| 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 z informacjami o konflikcie planów jest nieprawidłowo sformatowana Gdy użytkownik kupuje plan, który pokrywa się z istniejącym 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ązuje problem, który powoduje, że parametry szablonu nie są edytowalne po wysłaniu żądania z SmartDocs po usunięciu parametru szablonu w dokumentacji metody. |
| DEVSOL-723 | Wyświetlanie przyjaznych dla użytkownika komunikatów w przypadku niepowodzenia importu 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 i 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” wyświetla się 2 razy na liście modułów W sekcji Moduły „Dev Connect Mint” wyświetlał się 2 razy. Problem został już rozwiązany. |
| DEVSOL-1313 | Obsługa importowania plików JSON/YAML lub adresów URL w przypadku Swaggera i WADL Pliki WADL można teraz importować za pomocą adresu URL, a pliki Swaggera można przesyłać. |
| DEVSOL-1339 | Zmiana lokalizacji menu administratora SmartDocs SmartDocs znajduje się teraz w menu treści, a ustawienia SmartDocs są dostępne w menu administratora ustawień. |
| DEVSOL-1340 | Usuwanie wersji beta po przejściu do wersji ogólnodostępnej |
| DEVSOL-1390 |
Zaktualizowaliśmy bibliotekę PHP SDK Edge, aby rozwiązać problem z wywoływaniem funkcji __toString() Błąd krytyczny: wywołanie funkcji format() na obiekcie niebędącym obiektem w /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php w wierszu 221 Jest to błąd, który dotyczy tylko klientów korzystających z usługi Zarabianie, którzy używają kodu niestandardowego wywołującego metodę toString(). |
| DEVSOL-1398 | Model SmartDocs Petstore importowany podczas instalacji bez wyświetlania użytkownikowi prośby SmartDocs importuje teraz podczas instalacji witryny przykład swaggera petstore (http://petstore.swagger.io/v2/swagger.json) zamiast modelu pogodowego, aby zapewnić bardziej wyczerpujący przykład korzystania z SmartDocs. |
| DEVSOL-1407 | Cron kończy się niepowodzeniem, gdy jest wielu deweloperów Podczas uruchamiania crona w Drupalu duża liczba deweloperów powodowała problem z limitem czasu. Gdy organizacja ma ponad 200 użytkowników, używany jest proces wsadowy. |
| DEVSOL-1410 | Błędy połączenia niewidoczne podczas instalowania portalu dla deweloperów Dodaliśmy do instalatora lepsze komunikaty o błędach, gdy połączenie z zarządzaniem Edge nie działa, aby zminimalizować problemy z rozwiązywaniem problemów. |
| DEVSOL-1422 | Usunięcie formularza konfiguracji SMTP z profilu Apigee Podczas instalacji nie pojawia się już pytanie o skonfigurowanie SMTP. Można to zrobić po zakończeniu instalacji zgodnie ze standardową procedurą Drupal, czyli włączając moduł SMTP i odpowiednio go konfigurując. |
| DEVSOL-1427 |
Dodaj do modułu Aplikacje deweloperskie Devconnect punkty zaczepienia, które umożliwiają 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 modyfikowanie wykresu statystyk aplikacji dewelopera. |
| 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 określić, czy powiązany schemat uwierzytelniania szablonu również ma zostać usunięty. |
| DEVSOL-1470 | Utwórz link do menu „Interfejsy API” i odpowiedni widok Portal dla deweloperów SmartDocs domyślnie zawiera link do wyrenderowanej 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 interfejsu 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 widzisz możliwości edytowania pola „sample” w przypadku interfejsu SmartDocs API Podczas edytowania strony SmartDocs możesz teraz ustawić „Body MIME type”, „Body documentation” i „Body sample”. |
| 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 sekcji Zarabianie Na karcie zakupionego abonamentu w portalach deweloperów z włączoną funkcją zarabiania przycisk „Anuluj” nigdy nie był wyświetlany w przypadku abonamentu z datą rozpoczęcia w przyszłości. |
| DEVSOL-1556 | Wysyłana jest starsza wersja modułów Drupal Moduły media_youtube i features zostały zaktualizowane do najnowszej wersji. |
| DEVSOL-1558 | Strony metod SmartDocs nie są renderowane w przykładzie 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 dla niego nowy widok. |
| DEVSOL-1565 | Edytowanie metody SmartDocs powoduje błąd krytyczny Rozwiązaliśmy problem, w wyniku którego edytowanie metody SmartDocs czasami powodowało błąd. |
| DEVSOL-1567 | Wyświetlanie opcji „Dodaj model” w górnym menu administracyjnym Naprawiono problem z wyświetlaniem opcji „Dodaj model” w górnym menu administracyjnym. |
| DEVSOL-1576 | W widoku dokumentacji interfejsu API wyświetlana jest nazwa modelu, a nie nazwa wyświetlana Na stronie dokumentacji interfejsu API, która wyświetlała się po kliknięciu „Interfejsy API” w menu, widoczna była wewnętrzna nazwa modelu zamiast nazwy wyświetlanej. Jeśli aktualizujesz wersję i masz zmieniony ten widok, musisz przywrócić go, aby zobaczyć te zmiany. W tym celu wykonaj te czynności: # Zaloguj się jako administrator. # Kliknij kolejno Structure (Struktura) > Views (Widoki). # Kliknij menu obok opcji „Edit” (Edytuj) w sekcji „SmartDocs Models” (Modele SmartDocs), aby wyświetlić wszystkie operacje. # Jeśli widzisz „revert”, oznacza to, że zastąpiono kod własnymi zmianami. Kliknij „Przywróć”, aby przywrócić widok do stanu domyślnego. Pamiętaj, że spowoduje to usunięcie wszystkich zmian wprowadzonych w tym widoku. |
| DEVSOL-1578 | Renderowanie modeli Pogody i Petstore w przypadku instalacji w witrynie W przypadku nowych witryn importowane są modele SmartDocs Petstore i Pogoda. |
| DEVSOL-1584 | Nie można kupić subskrypcji Naprawiono problem z nieprzesyłaniem formularza zakupu subskrypcji zarabiania w przypadku wersji w chmurze 15.05.27.00 i 15.06.08.00, jeśli używasz motywu elastycznego Apigee lub jego podmotywu. |
| DEVSOL-1597 | Nie można zmienić ustawień limitu czasu dewelopera Naprawiliśmy błąd, który powodował nieprawidłowe stosowanie ustawień limitu czasu połączenia Edge. |
| DEVSOL-1620 |
Aktualizacje modułu „Ja”, wskaźnika środowiska i funkcji https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Aby zapobiec nieprawidłowemu działaniu reCAPTCHA, upewnij się, że arg_separator.output ma wartość „&” Naprawiono problem z platformą, który powodował nieprawidłowe działanie Google reCAPTCHA. |
| DEVSOL-1651 | Motyw podstawowy Apigee 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 modułu admin_views w celu zastosowania krytycznej poprawki zabezpieczeń
|