4.15.07.00 – Informacje o wersji portalu Apigee dla programistów

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
Informacje

We wtorek 8 września 2015 roku opublikowaliśmy kwartalną wersję portalu usług dla programistów Apigee Edge dla Private Cloud.

Wcześniejsza nazwa usługi „Lokalny portal usług dla programistów Apigee Edge” lub „OPDK” to teraz „Portal usług dla programistów Apigee Edge dla Private Cloud”.

Jeśli masz pytania, skontaktuj się z obsługą klienta Apigee.

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

Wymagania Apigee Edge dotyczące portalu

Jeśli łączysz tę wersję portalu z instalacją Edge dla Private Cloud, musisz połączyć ją z wersją 4.15.07.00 lub nowszą, aby mieć pewność, że wszystkie funkcje SmartDokumentacja będą obsługiwane. Więcej informacji znajdziesz w artykule 4.15.07.00 – Apigee Edge for Private Cloud.

Nowe funkcje

Ogólna dostępność SmartDokumentacja

Przekształcamy wersję beta funkcji SmartDokumenty w ogólne. Aktualizacje i nowe funkcje obejmują:

  • Obsługa Swagger 2.0, w tym możliwość importu według pliku lub adresu URL, w tym obsługa obiektów zabezpieczeń o niestandardowych nazwach.
  • Ulepszenia wizualne w szablonach do generowania SmartDokumentów.
  • Ulepszenia w zakresie łatwości obsługi i przepływów pracy w Portalu dla programistów dostępne w menu Treści > Inteligentne dokumenty w Drupal
  • Uwierzytelnianie, które było znane jako „token niestandardowy”, nosi teraz nazwę „klucz interfejsu API”.
  • Obiekty „zabezpieczeń” uwierzytelniania zdefiniowane na poziomie wersji.
  • Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie resetują już żadnych wstępnie skonfigurowanych danych logowania klienta SmartDokumentacja.

Więcej opisów funkcji znajdziesz w tym poście na blogu.

Dokumentację SmartDokumentacja znajdziesz w artykule Używanie SmartDokumentów do dokumentowania interfejsów API.

Proces uaktualniania SmartDokument

Jeśli korzystasz już z SmartDokumentów w wersji beta, nowe funkcje i możliwości dostępne w wersji ogólnodostępnej wymagają uaktualnienia tej funkcji w portalu dla programistów.

Wszystkie strony w Dokumentach inteligentnych, które zostały już opublikowane w portalu dla deweloperów, będą nadal działać, ale zanim zaczniesz edytować lub opublikować jakiekolwiek zmiany na istniejących lub nowych stronach, musisz przeprowadzić proces aktualizacji.

Pamiętaj, że chociaż w portalu dla programistów możesz renderować i publikować dokumenty SmartDokumenty, są one generowane na podstawie modelu interfejsu API działającego w ramach usług zarządzania interfejsem Edge API Apigee. Wszystkie zmiany wprowadzone w modelu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie do programistów w środowiskach Pantheon).

Aby przejść z wersji beta Dokumentów Google na wersję ogólnodostępną

  1. Zaktualizuj i przetestuj wersję 15.05.27 w środowisku dev lub dev Pantheon.
  2. Utwórz nowy model, który zastąpi dotychczasowy model interfejsu API, którego używasz.
    • Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowej wersji.
    • Jeśli Twój model interfejsu API był utrzymywany za pomocą modułu SmartDokumentacja, wyeksportuj go w formacie JSON Dokumentów i zaimportuj do nowego modelu za pomocą załącznika.
  3. Ustaw właściwości zabezpieczeń wersji modelu. Na stronie Treść > SmartDokumenty > Model wybierz Ustawienia zabezpieczeń.
  4. Sprawdź wstępnie skonfigurowane uwierzytelnianie na stronie ustawień modelu (Treść > SmartDokumenty), klikając Ustawienia w kolumnie Operacje.
  5. Zaktualizuj wszystkie szablony niestandardowe, aby używać wersji 6 zasobów CSS i JS, i wprowadź zmiany, aby odzwierciedlały nowe nazwy obiektów, takie jak authSchemes i apiSchema. Więcej informacji o aktualizowaniu szablonów SmartDokumentacja znajdziesz w artykule o używaniu SmartDokumentów do tworzenia dokumentów w interfejsach API.
  6. Ponownie wyrenderuj i opublikuj wersję modelu.
  7. Po sprawdzeniu nowej dokumentacji zaktualizuj portal produkcyjny do wersji 15.05.27.

Jeśli korzystasz z Edge Enterprise 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 skontaktuj się z społecznością Apigee, aby uzyskać najlepszą odpowiedź.

Naprawione błędy

Poprawiliśmy w niej wymienione niżej błędy.

Identyfikator problemu Opis
DEVSOL-487 Administratorzy powinni mieć możliwość skonfigurowania formatu daty w formacie dnia
Format daty można teraz skonfigurować w sekcji Zarabianie w ustawieniach zarabiania dla formatów dat w Europie i Stanach Zjednoczonych.
DEVSOL-584 Parametr ścieżki niezapamiętywany przy pierwszym użyciu
Parametr ścieżki podczas wywoływania nie zawsze był zapamiętywany.
DEVSOL-603 Strona planu konfliktu jest źle sformatowana
W przypadku zakupu abonamentu, który pokrywa się z istniejącym abonamentem, wyświetlana strona będzie poprawnie sformatowana z punktu widzenia użytkownika.
DEVSOL-709 SmartDokumentacja: po wysłaniu żądania z pustą wartością parametru szablonu URL nie można edytować
Rozwiązano problem, który powodował, że po wysłaniu żądania z SmartDokumentów nie można było edytować parametrów szablonu po usunięciu parametru szablonu w dokumentacji metody.
DEVSOL-723 Pokazuj przyjazne dla użytkownika komunikaty w przypadku niepowodzenia importu Dokumentów
DEVSOL-1013 Umożliwianie edycji 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 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ę dwukrotnie na liście modułów
W sekcji Modules (Moduły) „Dev Connect Mint” została wyświetlona dwukrotnie. 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 SmartDokumentacja
Inteligentne dokumenty są teraz dostępne w menu treści, a ustawienia dokumentów inteligentnych znajdują się w menu ustawień administratora.
DEVSOL-1340 Usuwanie wersji beta po przejściu do Google Analytics
DEVSOL-1390

Biblioteka PHP SDK Edge została zaktualizowana, aby rozwiązać problem z wywoływaniem funkcji __toString()
Biblioteka PHP SDK Edge została zaktualizowana, aby rozwiązać problem z wywoływaniem funkcji __toString() w obiekcie DeveloperRatePlan, który powoduje ten błąd:

Błąd krytyczny: wywołanie funkcji formatu członka grupy w 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

Ten błąd występuje tylko w przypadku klientów korzystających z funkcji Monetization, którzy używają niestandardowego kodu wywołującego metodę toString().

DEVSOL-1398 Model SmartDokumentacja petstore został zaimportowany podczas instalacji bez pytania użytkownika o zgodę
Podczas instalacji witryny SmartDokumentacja robi to teraz (http://petstore.swagger.io/v2/swagger.json), a nie z modelu pogody, aby uzyskać bardziej wyczerpujący przykład korzystania z dokumentów SmartDokumentacja.
DEVSOL-1407 Błąd cron w przypadku wielu programistów
Podczas uruchamiania tego cron w systemie Drupal duża liczba deweloperów powoduje problem z przekroczeniem limitu czasu. Jeśli organizacja ma więcej niż 200 użytkowników, używany jest proces wsadowy.
DEVSOL-1410 Błędy połączenia nie są widoczne podczas instalowania Portalu dla programistów
W instalatorze wyświetlane są komunikaty o błędach, które nie są widoczne, gdy połączenie zarządzania brzegiem nie działa, aby zminimalizować liczbę problemów.
DEVSOL-1422 Usuwanie formularza konfiguracji SMTP z profilu Apigee
Podczas instalacji nie pojawia się już pytanie, czy chcesz skonfigurować SMTP. Zamiast tego możesz to zrobić po zakończeniu instalacji zgodnie ze standardową metodą Drupal dotyczącą włączania modułu SMTP i prawidłowej konfiguracji go.
DEVSOL-1427

Dodaj punkty zaczepienia do modułu Devconnect Developer Apps, aby umożliwić modyfikowanie danych Analytics
W module devconnect_developer_apps pojawiły się 3 nowe punkty zaczepienia:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

Dzięki nim moduły niestandardowe mogą zmieniać wykres statystyk aplikacji dla deweloperów.

DEVSOL-1464 Błąd krytyczny podczas zapisywania ustawień uwierzytelniania dla modelu
Po usunięciu schematu zabezpieczeń pojawia się teraz pole wyboru do wyboru, czy trzeba usunąć też powiązany schemat uwierzytelniania szablonu.
DEVSOL-1470 Tworzenie linku do menu interfejsów API i odpowiedniego widoku
Funkcja SmartDokumentacja w portalu dla programistów ma teraz domyślnie link do dokumentacji renderowanej przez SmartDokumentacja w menu głównym o nazwie „Interfejsy API”, który zawiera linki do dowolnych modeli z opublikowanymi metodami.
DEVSOL-1486 Wywołania SmartDokumentacja mogą uwierzytelniać się przy użyciu wstępnie zdefiniowanego klucza
Włącza uwierzytelnianie przy użyciu wstępnie dostarczonych oraz dostarczonych przez użytkownika kluczy interfejsu API.
DEVSOL-1499 Kod HTML nie został przeanalizowany w opisach parametrów SmartDokumentacja
Kod HTML jest teraz analizowany w opisach parametrów SmartDokumentacja.
DEVSOL-1507 Nie można dodać wielu parametrów do interfejsu API za pomocą metody Add Method
Podczas edytowania tej metody do interfejsu SmartDokumentacja API możesz teraz dodawać wiele parametrów.
DEVSOL-1509 Nie widzę opcji edytowania pola „przykładowy” w interfejsie SmartDocuments API
Podczas edytowania strony SmartDocuments możesz teraz ustawić wartości „Typ MIME treści”, „Dokumentacja treści” i „Przykład treści”.
DEVSOL-1534 Typ treści nie jest wypełniany w danych wyjściowych aplikacji SmartDokumentacja
Na stronie metody dokumentów SmartDokumentacja typ treści jest teraz wypełniany.
DEVSOL-1554 Nieprawidłowe porównanie dat w sekcji Generowanie przychodu
W przypadku portali dla deweloperów z włączoną funkcją zarabiania przycisk „Anuluj” nie był wyświetlany na karcie Kupione subskrypcje w przypadku planu z datą rozpoczęcia w przyszłości.
DEVSOL-1556 Wysyłana jest starsza wersja modułów Drupal
Moduł media_youtube i funkcji został zaktualizowany do najnowszej wersji.
DEVSOL-1558 Strony metody SmartDokumentacja nie są renderowane na potrzeby sklepu PetStore
W przypadku nowych instalacji przykładowe metody SmartDocuments PetStore są teraz renderowane prawidłowo.
DEVSOL-1562 Generowanie widoku dla każdego modelu SmartDokumentacja
Podczas tworzenia nowego modelu domyślnie tworzony jest dla niego nowy widok.
DEVSOL-1565 Edytowanie metody SmartDokumentacja powoduje generowanie błędu krytycznego
Rozwiązaliśmy problem polegający na tym, że edytowanie metody SmartDokumentacja powodowało czasami wystąpienie błędu.
DEVSOL-1567 Błąd „Dodaj model” wyświetlany w górnym menu administracyjnym
Rozwiązaliśmy problem z wyświetlaniem pozycji menu „Dodaj model” w górnym menu administratora.
DEVSOL-1576 W widoku dokumentacji interfejsu API jest wyświetlana nazwa modelu, a nie wyświetlana nazwa
Strona dokumentacji interfejsu API wyświetlana po kliknięciu w menu opcji „Interfejsy API” zawierała wewnętrzną nazwę modelu, a nie wyświetlaną nazwę. Jeśli aktualizujesz wersję i ten widok został zmieniony, musisz cofnąć swój widok, aby zobaczyć te zmiany. Aby zobaczyć te zmiany, wykonaj te czynności: # Zaloguj się jako administrator # Otwórz Struktura > Widoki # Kliknij menu obok opcji „Edytuj” w sekcji „Modele SmartDokumentacja”, aby wyświetlić wszystkie operacje. # Jeśli widzisz opcję „Cofnij”, oznacza to, że kod został zastąpiony z własną zmianą. Kliknij „Przywróć”, aby przywrócić widok domyślny. 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
Modele SmartDokumentacja o Pogodzie i Pogoda są importowane w nowych witrynach.
DEVSOL-1584 Nie można kupować abonamentów
Rozwiązaliśmy problem polegający na tym, że w przypadku wersji Cloud 15.05.27.00 i 15.06.08.00 formularz zakupu planów zarabiania nie był przesyłany w przypadku korzystania z motywu elastycznego Apigee lub podtematu motywu elastycznego Apigee.
DEVSOL-1597 Nie można zmienić ustawień czasu oczekiwania programisty
Naprawiono błąd, który powodował, że ustawienia limitu czasu połączenia brzegowego nie były prawidłowo stosowane.
DEVSOL-1620

Uaktualnienia mnie, wskaźnika środowiska i modułu funkcji
Średnio krytyczna aktualizacja zabezpieczeń modułu „Ja” i modułu funkcji dotyczących środowiska oraz funkcji. Więcej informacji:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 Sprawdź, czy parametr arg_separator.output ma wartość „&”, aby zapobiec awarii reCAPTCHA
Naprawiliśmy problem związany z platformą, który powodował nieprawidłowe korzystanie z Google reCAPTCHA.
DEVSOL-1651 Motyw podstawowy Apigee przestanie działać, jeśli moduł smartdocs nie jest włączony
Motyw apigee_base nie zależy już od włączonego modułu SmartDokumentacja.
DEVSOL-1654

Zrzut wersji pliku admin_views, aby pobrać krytyczną poprawkę zabezpieczeń
Zaktualizowaliśmy te moduły składowe:

  • Widoki administracyjne
  • Migracja
  • Przekieruj
  • Redis
  • Wyświetlenia operacji zbiorczych