20.07.27 - Apigee Edge entegre portal sürüm notları

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

27 Temmuz Pazartesi günü, Apigee Edge entegre portalının yeni sürümünü kullanıma sunmaya başlayacağız.

Yeni özellikler ve geliştirmeler

Bu bölümde, bu sürümdeki yeni özellikler ve geliştirmeler açıklanmaktadır.

Erişilebilirlik ve yanıt vermeyle ilgili iyileştirmeler

Aşağıda, bu sürüm için uygulanan erişilebilirlik ve yanıt verme ile ilgili iyileştirmeler listelenmektedir.

• Klavyeyle gezinme: Artık üstbilgi ve altbilgi gezinme çubuklarında, SmartDokümanlar yan gezinme çubuklarında, Uygulamalar listesinde, Uygulama görünümünde ve API kartlarında klavyeyi kullanarak gezinebilirsiniz.
  .
• Odak yönetimi: Başlık gezinme çubuğu ve SmartDokümanlar yan gezinme çubuğu ile gezinme, bir gezinme işleminden sonra odağı sayfadaki ilk <H1> öğesine taşır.
• Yayındaki bölgeler: API listesinde metin filtrelemesinden kaynaklanan değişiklikler artık ekran okuyucu kullanan kullanıcılara bildiriliyor.
• HTML başlıklarının anlamsal kullanımı: Artık tüm metinler anlamsal olarak uygun HTML etiketlerinde yer alıyor. Artık portalda uygun şekilde hiyerarşik bir başlık yapısı kullanılıyor.
• <H1> öğesinin tekil kullanımı: Ekran okuyucuların sayfa içeriğinin en bilgilendirici açıklamasını kolayca belirleyebilmesi için her sayfada artık tek bir <H1> öğesi bulunmaktadır.
• Stilde büyük harf kullanımı: Görsel bir vurgu olarak tüm büyük harf kullanımı artık gerçek metinde değil, yalnızca CSS ile uygulanıyor.
• DOM'nin mantıksal sıralaması: Uygulama Oluştur ve Düzenle sayfalarındaki işlem düğmeleri, form etkileşimi tamamlandıktan sonra mantıksal sırayla etkinleştirilebilmeleri için DOM'deki form öğelerinin altına taşındı.
• Görsel öğelerin yazılı açıklamaları: Ekran okuyucuyla gezinmeyi iyileştiren etiketlerin, alternatif metnin ve düğme metninin kullanımı geliştirildi.
• Renk kontrastı: Renk kontrastı, ürünün birçok yerinde WCAG AA kontrast şartlarını karşılayacak şekilde artırıldı. API'ler listesindeki API başlıkları, olası yetersiz renk kontrastını önlemek için resmin altına taşındı.
• Form doğrulama: Uygulama Oluştur ve Düzenle sayfalarında, form gönderme düğmeleri artık devre dışı değildir ve formu doğrulamak için etkinleştirilebilir. Uygulama Oluşturma ve Düzenleme sayfalarındaki doğrulanmış form alanları artık doğrulama hatasının metin açıklamalarını içeriyor.
• Duyarlılık: Artık SmartDokümanlar hariç tüm sayfalar için geçerli olan bir maksimum genişlik vardır. SmartDokümanlar gezinme özelliği artık dar telefon boyutlu ekranlarda çalışıyor. Uygulama Oluşturma ve Düzenleme sayfaları artık dar ekranlara daha duyarlı.

Portalınızı etkileyebilecek DOM değişiklikleri

Özellikle şu durumlarda göz önünde bulundurun:

• Gezinme çubukları (üstbilgi ve alt bilgi) ve sayfa başlıklarının stili CSS geçersiz kılmaları ile belirlendi (veya gizlendi): Artık sayfa içeriği için maksimum genişlik konmuştur. Apigee, gezinme çubuklarını ve sayfa başlıklarını tarayıcı penceresinin kenarına kadar genişletmek için sözde :before öğesini biçimlendirdi. Daha fazla bilgi için Gezinme çubukları ve sayfa üstbilgileri için birincil renkleri geçersiz kılma konusuna bakın.
• Arka planı tarayıcı penceresinin kenarına kadar uzanan sayfa öğeleri var (tam ekran arka plan resmi hariç): Sayfa içeriğinin maksimum genişliği, duyarlılığı iyileştirmek için sınırlandırılmıştır. Bu durum, özel sayfalarda önceden tam genişlikte olan panellerin kullanımını kısıtlayabilir. Yeni maksimum genişlik ayarlarını kullanma hakkında daha fazla bilgi için Portal sayfasında tam genişlikte panel oluşturma bölümüne bakın.
• Metin stillerini değiştirmek için CSS seçicilerle belirli HTML başlık düzeyleri hedeflendi: Belirli içeriğe uygulanan başlık düzeyi değişti. Örneğin: <H1> → <H2> Tam olarak hangi içeriklerin etkilendiğini anlamak için bu sürümün ayrıntılı değişiklik listesini inceleyin.
• "İkincil renk" olarak beyaz veya çok açık bir renk seçilir portal teması düzenleyicide: İkincil renk, beyaz arka plan üzerinde zor görülecek gezinme öğeleri için kullanılır. Erişilebilir bir ikincil renk seçmenizi ve ardından belirli durumlarda özel scss ile gerekirse bu rengi geçersiz kılmanızı öneririz.
• Metin içi bağlantıların stili ayarlandı: Bağlantıların stili artık daha erişilebilir. Mevcut stilinizle nasıl etkileşime girebileceğini anlamak için aşağıdaki değişikliklere bakın.
• Ana sayfa görünümü kartlarının içerik alanındaki 2 piksellik kenarlık, CSS geçersiz kılmaları ile biçimlendirildi veya gizlendi: Bu kenarlık, <mat-card-content> değerinden <mat-card-actions> üzerinde kenarlık üstüne taşındı.

Ayrıntılı değişikliklerin özeti

Aşağıdaki bölümlerde kategoriye göre, bu sürümde uygulanan ayrıntılı değişiklikler özetlenmektedir.

Portal genelindeki değişiklikler

Portal genelindeki değişiklikler aşağıda özetlenmiştir.

• Aşağıdaki değişkenler artık kullanılmamaktadır:
  • $layout-horizontal-padding
  • $layout-main-content-horiz-padding
  • $layout-header-horiz-padding
  • $layout-context-bar-horiz-padding
• Ana içerik alanının maksimum genişliği ve ana içerik alanının minimum yatay dolgusu üzerinde kontrol sağlayan yeni değişkenler vardır:
  • $layout-main-content-max-width
  • $layout-horizontal-min-padding

Birincil gezinme çubuğu değişiklikleri

Birincil gezinme çubuğunda yapılan değişiklikler aşağıda özetlenmiştir.

• <img> logosu artık hem masaüstü hem mobil ekran boyutları için <a> içine yerleştirilmiş
• Kullanıcı açılır düğmesi artık <a> yerine <button>

Bağlantı stili değişiklikleri

Metin içindeki <a> standart bağlantılarının fareyle üzerine gelindiğinde artık varsayılan olarak alt çizgi ve arka plan rengi ("ikincil renk" tema ayarlarına göre) var

404 sayfa değişiklikleri

404 sayfasındaki değişiklikler aşağıda özetlenmiştir.

• "Şimdi oturum aç" artık <H1> yerine <H2>
• Açıklama metni artık <H1> yerine <H2>

API'ler sayfası

API'ler sayfasında yapılan değişiklikler kategoriye göre aşağıda özetlenmiştir.

• API arama/filtre giriş kartı:
  • <mat-card-content class="mat-card-content"> artık arama API'leri kart başlığını ve girişi sarmalıyor
  • <H2> artık class="api-doc-filter-title" yerine class="mat-subheading-1" kullanıyor
  • <mat-form-field> artık appearance="outline" kullanıyor
  • <mat-form-field> girişinden önce bir arama simgesi eklendi: "<mat-icon matPrefix>search</mat-icon>"
  • Girişe Aria etiketleri ve kontrol referansları eklendi
• Boş API listesi mesajı:
  • "API bulunamadı" artık <H1> yerine <H2>
  • Açıklama artık <H2> yerine <H3> olacak
• API kartları listesi:

  "Aramanızla eşleşen API yok" artık <H1> yerine <H2>

• API kartları:
  • >div class="api-doc-card-content-image-gradient"></div> kaldırıldı
  • API başlığı, <div> ifadesini içeren resmin dışına ve <div> görüntüsünden hemen sonra <div class="api-doc-card-content-title"></div> etiketine taşındı
  • API başlığı artık <H1> yerine <H2> oldu

Uygulama Listesi:

• Boş durum:
  • "Başlayın" artık <H1> yerine <H2>
  • Boş durum kılavuzu artık <H2> yerine <H3>
• Liste:
  • "Uygulamalarım" artık <H1> yerine <H2>
  • <mat-row> artık <a> içinde çarpık

Uygulama sayfaları oluşturma ve düzenleme

Uygulama Oluşturma ve Düzenleme sayfalarındaki değişiklikler aşağıda özetlenmiştir.

• <div class="app-buttons">, <form> etiketinin sonuna taşındı ve <div class="form-buttons-sticky-container"> ile değiştirildi
• .app-layout-section sınıfının tüm kullanımı .details-layout-section olarak değiştirildi
• .app-layout-section-title sınıfının tüm kullanımı .details-layout-section-title olarak değiştirildi
• Tüm bölüm başlıkları artık <div> yerine <H2>
• .app-layout-section-content sınıfının tüm kullanımı .details-layout-section-content olarak değiştirildi
• API listesi artık açma/kapatma anahtarları olan API kartlarından oluşan bir liste değil (API listesine benzer). Bunun yerine, API'lerin bulunduğu bir tablodur.
• Geri çağırma URL'si girişi yeni bir bölüme taşındı
• Kaydet düğmesinde artık matlaştırılan düğme stili ve birincil renk arka planı kullanılıyor.
• Tablolar artık .app-table-wrapper sınıfıyla bir <div> içinde sarmalanıyor
• Tablo başlıkları artık <thead> sarmalayıcı kullanıyor
• Tablo gövdeleri artık <tbody> sarmalayıcı kullanıyor
• [style.width] artık tablo sütun genişliklerini ayarlamak için kullanılmıyor
• Tablodaki tüm <a> etiketleri artık <button etiketini kullanıyor

Takım listesi

Ekip listesinde yapılan değişiklikler aşağıda özetlenmiştir.

• Boş durum:
  • "Başlayın" artık <H1> yerine <H2>
  • "Paylaşılan uygulama sahipliğini yönetmek için bir ekip oluşturun" artık <H2> yerine <H3>
• Liste:

  "Ekipler" başlık artık <H1> yerine <H2>

Ekip sayfaları oluşturma ve düzenleme

Ekip Oluştur ve Düzenle sayfalarında yapılan değişiklikler aşağıda özetlenmiştir.

• <form> tarihinde .teams-form sınıfı .details-form ile değiştirildi
• <div class="teams-buttons">, <form> sonuna taşındı ve <div class="form-buttons-sticky-container"> ile değiştirildi
• .teams-layout-section sınıfının tüm kullanımı .details-layout-section olarak değiştirildi
• .teams-layout-section-title sınıfının tüm kullanımı .details-layout-section-title olarak değiştirildi
• .teams-layout-section-content sınıfının tüm kullanımı .details-layout-section-content olarak değiştirildi
• <table class="team-apps"> konumunun etrafına <div class="team-apps-container"> eklendi

SmartDocs

SmartDokümanlar arayüzünde yapılan değişiklikler aşağıda özetlenmiştir.

• Yanda gezinme:
  • Yan gezinme bölümü, açısal malzeme bileşenleriyle tamamen yeniden yazıldı.
  • Yan gezinme başlıkları artık <div> yerine <H2>
  • Gezinme öğeleri artık portal tema düzenleyicisi "ikincil renk" yerine portalın varsayılan metin rengini kullanıyor
  • Yan gezinme bölmesindeki seçili, odaklanılmış ve fareyle üzerine gelinen öğeler artık portal teması düzenleyicisinin koyu ve açık renk varyasyonlarını kullanıyor "ikincil renk" sırasıyla metin ve arka plan için
• İçerik:
  • "Yol Parametreleri" gibi birçok alt başlık ve "Header Parameters" (Başlık Parametreleri) artık <H3> yerine <H2>
  • Genel bakış sayfasındaki şema varlıkları artık <H2> yerine <H3>=> oldu

Mevcut bir ana sayfaya erişilebilirlik iyileştirmeleri ekleme

Çıkış yapan bir portalınız varsa aşağıda açıklandığı gibi, gezinilebilir kartlara yönelik yeni erişilebilirlik iyileştirmelerinden yararlanmak için ana sayfayı düzenlemeniz gerekir:

1. href="" öğesini <mat-card> kapsayıcısından kaldırın.
2. <mat-card-header> içindeki kart başlığı için <H1> yerine <H2> kullanın.
3. <h2> kart başlığının içindeki metni bir <a class="navigable-content" href="href-name"> içine alın ve href-name öğesini kartta gezinme için uygun değere ayarlayın.

Alternatif olarak aşağıdaki kart şablonunu da kullanabilirsiniz:

<mat-card class="home-page-card quick-start">
  <mat-card-header class="home-page-card-header" color="primary">
    <mat-icon class="home-page-card-header-icon">
      check_circle
    </mat-icon>
    <h2 class="home-page-card-header-text">
      <a class="navigable-content" href="page-route">
        Card heading
      </a>
    </h2>
  </mat-card-header>
  <mat-card-content class="home-page-card-content">
    <p class="home-page-card-content-text">
      Extra content
    </p>
  </mat-card-content>
</mat-card>
</p>

Gezinme çubukları ve sayfa üstbilgileri için birincil renkleri geçersiz kılma

Gezinme çubuklarını ve sayfa başlıklarını genişletmek için gelişmiş tema düzenleyiciyi kullanarak gezinme çubukları ve sayfa üstbilgileri için özel stil ekleyin. Bu stil, başlık gezinme çubuğu için aşağıdakine benzer:

// Override use of the primary color for header navigation bar background-color
.nav-header .mat-toolbar {
  color: #fff //  color for navigation text

  // Use the :before pseudo element to style the background of full-width bars
  // (header and footer navigation bars and page headers)
  &:before {
    background-color: #000; // background color for header navigation bar
  }
}

Bir uygulamanın API'lerini yönetme prosedürü güncelleme

Entegre portaldaki uygulamalarda API'leri yönetmek için kullanıcı etkileşimi değişti. Özellikle bir uygulamayı yönetirken kullanıcılar, API'ler bölümünde uygulamadan bir API'ye erişimi etkinleştirmek veya devre dışı bırakmak için sırasıyla veya düğmesini (açma/kapatma işlemi yerine) tıklamalıdır.

Portalınızda, uygulamalar sayfasında API'lerin nasıl yönetileceğini (varsa) açıklayan prosedürleri güncelleyin. Daha fazla bilgi için bkz. Uygulamanızdaki API'leri yönetme.

Düzeltilen hatalar

Bu sürümde aşağıdaki hatalar düzeltilmiştir. Bu liste öncelikle düzeltmesini isteyemezdim. Proje yöneticileri için tüm kullanıcıları kapsar.

Sorun Kimliği	Bileşen Adı	Açıklama
161269688	Entegre Portal	Apigee hybrid'de öğe küçük resimleri yanlış oluşturuluyor Küçük resimler artık Öğeler sayfasında düzgün görüntülenir.
161295683	Entegre Portal	Uygulama için açıklama ayarlanmadan sunucu başarısız oluyor Bir uygulamanın açıklaması (isteğe bağlı alan) tanımlanmamışsa uygulama oluşturma işlemi artık başarılı olur.
160898967	Entegre Portal	Portalın açılış sayfası düzgün kaydırılmıyor Portal açılış sayfası artık kaydırılabilir.
160613314, 159197760, 158643196, 158069283, 158069066, 140154942	Entegre Portal	Çeşitli güvenlik düzeltmeleri
158593496	Entegre Portal	V1 portallarında geliştirici uygulaması oluşturma işlemi başarısız oluyor V1 portallarında geliştirici uygulaması oluşturulmasını engelleyen bir sorun düzeltildi.
158318079	Entegre Portal	Geliştirici portalında geri çağırma URL'si ekleme veya değiştirme işlevi çalışmıyor Portal kullanıcılarının API'ler sayfasına geri arama URL'si eklemesini veya bir geri çağırma URL'sini değiştirmesini engelleyen bir sorun düzeltildi.
157902256	Entegre Portal	Yayınlama, Sayfa ayrıntıları sayfasındaki sayfa adı güncellemesini geçersiz kılabilir Portalı yayınladığınızda (bir yarış koşulundan kaynaklanan) sayfa adı güncellemesinin geçersiz kılınmasına neden olan bir sorun düzeltildi.
138993728	Entegre Portal	Geliştirici programları e-posta sıralama ve arama işlevleri çalışmıyor Tüketici kullanıcı hesaplarının aranması ve sıralanması artık beklendiği gibi çalışmaktadır.

Bilinen sorunlar

Entegre portalla ilgili bilinen sorunların listesi için Entegre portalla ilgili bilinen sorunlar başlıklı makaleyi inceleyin.