15.05.27.00 – informacje o wersji portalu Apigee dla programistów

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

We wtorek 2 czerwca 2015 roku opublikowaliśmy nową wersję chmurową portalu Apigee Developer Services.

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.

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-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-642 Przenieś konfiguracje na poziomie klienta z ustawień zabezpieczeń do ustawień szablonu
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-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-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 Usuń wersję beta po przejściu do Google Analytics
Inteligentne Dokumenty Google znajdują się teraz w menu treści, a ustawienia inteligentnych dokumentów znajdują się w menu administratora ustawień.
DEVSOL-1390 Biblioteka API SDK Edge w PHP została zaktualizowana w celu rozwiązania problemu z wywoływaniem funkcji __toString()
biblioteka Edge SDK Edge w PHP została zaktualizowana w celu rozwiązania problemu z wywoływaniem metody __toString() w obiekcie DeveloperRatePlan() w obiekcie DeveloperRatePlan(), która powoduje wystąpienie błędu: {quote on aroot-Resultsback().
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 aplikacji SmartDokumentacja.
DEVSOL-1407 Błąd cron w przypadku wielu deweloperów
Podczas uruchamiania tego programu w Dupal wielu programistów wystąpiło problem z czasem oczekiwania. Jeśli organizacja ma więcej niż 200 użytkowników, używany jest proces wsadowy.
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.

Znane problemy

W tej wersji występują następujące znane problemy:

Identyfikator problemu Opis
DEVSOL-1558
Strony metody z przykładowymi dokumentami SmartDokumentacja w usłudze Petstore nie są prawidłowo renderowane podczas nowej instalacji
Przykładowe strony metody Petstore w SmartDokumentach nie są renderowane prawidłowo przy nowej instalacji. Aby rozwiązać ten problem:
  1. W menu Drupal wybierz Treść > Inteligentne dokumenty.
  2. Wybierz model „Przykładowy sklep zoologiczny”.
  3. W sekcji Opcje aktualizacji wybierz Renderowanie i publikowanie węzłów.
  4. Kliknij pole wyboru Zaznacz / odznacz wszystko, aby wybrać wszystkie węzły.
  5. Kliknij Aktualizuj.

Węzły powinny się teraz prawidłowo renderować.