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

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

27 Temmuz Pazartesi günü, Apigee Edge entegre portalının yeni bir 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 duyarlılık iyileştirmeleri

Aşağıda, bu sürüm için uygulanan erişilebilirlik ve yanıt verebilirlik iyileştirmeleri listelenmiştir.

  • Klavyede gezinme: Artık klavyeyi kullanarak üstbilgi ve altbilgi gezinme çubukları, SmartDokümanlar yan gezinme menüsü, Uygulama listesi, Uygulama görünümü ve API kartlarında gezinmek mümkün.
  • Odak yönetimi: Başlık gezinme çubuğu ve SmartDokümanlar yan gezinme menüsüyle gezinme, bir gezinme işleminin ardından odağı sayfadaki ilk <H1> konumuna taşır.
  • Yayındaki bölgeler: Metin filtrelemesi sonucunda API listesinde yapılan değişiklikler, ekran okuyucu kullanan kullanıcılara artık bildiriliyor.
  • HTML başlıklarının anlamsal kullanımı: Tüm metinler artık anlam açısından uygun HTML etiketlerinde yer alıyor. Artık portal genelinde uygun bir hiyerarşik başlık yapısı kullanılıyor.
  • <H1> öğesinin tekil kullanımı: Artık her sayfada yalnızca tek bir <H1> bulunmaktadır. Böylece ekran okuyucular, sayfa içeriğinin en bilgilendirici açıklamasını kolayca belirleyebilir.
  • Biçimle büyük harf kullanımı: Görsel aksan olarak büyük harf kullanımı, artık metinde değil, yalnızca CSS ile uygulanıyor.
  • DOM'nin mantıksal sıralaması: Uygulama Oluşturma ve Düzenleme sayfalarındaki işlem düğmeleri, form etkileşimi tamamlandığında mantıksal olarak etkinleştirilebilmesi için DOM'daki form öğelerinin altına taşındı.
  • Görsel öğelerin metin içerikli açıklamaları: Etiketler, alternatif metinler ve düğme metni kullanımı iyileştirildi. Bunların tümü ekran okuyucuyla gezinmeyi iyileştirir.
  • Renk kontrastı: Ürün genelinde pek çok yerde WCAG AA kontrast şartlarını karşılamak için renk kontrastı artırıldı. API listesindeki API başlıkları, yetersiz renk kontrastı olasılığını önlemek için resmin altına taşındı.
  • Form doğrulama: Uygulama Oluşturma ve Düzenleme 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 bulunmaktadır. SmartDokümanlar gezinme özelliği artık dar telefon boyutlarındaki 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 bulundurulmalıdır:

  • Gezinme çubukları (üstbilgi ve alt bilgi) ve sayfa başlıkları, CSS geçersiz kılmalarıyla biçimlendirilmiştir (veya gizlenmiştir): Artık sayfa içeriği için bir maksimum genişlik bulunmaktadır. Gezinme çubuklarını ve sayfa başlıklarını tarayıcı penceresinin kenarına kadar genişletmek için Apigee, sözde :before öğesinin stilini belirledi. Daha fazla bilgi için Gezinme çubukları ve sayfa üstbilgileri için birincil renkleri geçersiz kılma bölümüne bakın.
  • Arka planı tarayıcı penceresinin kenarına kadar uzanan (tam ekran arka plan resmi dışında) sayfa öğeleri vardır: Duyarlılığı iyileştirmek için sayfa içeriğinin maksimum genişliği sınırlandırılmıştır. Bu durum, özel sayfalardaki eskiden tam genişlikli panelleri kısıtlayabilir. Yeni maksimum genişlik ayarlarını kullanma hakkında daha fazla bilgi edinmek için Portal sayfasında tam genişlikli panel oluşturma bölümüne bakın.
  • Metin stillerini değiştirmek için CSS seçicilerle belirli HTML başlık seviyeleri hedeflendi: Belirli içeriklere uygulanan başlık düzeyi değişti. Örneğin: <H1> → <H2> Tam olarak hangi içeriğin etkilendiğini anlamak için bu sürümün ayrıntılı değişiklik listesini inceleyin.
  • Portal teması düzenleyicide "ikincil renk" olarak beyaz veya çok açık bir renk seçilir: İkincil renk, beyaz arka plan üzerinde görülmesi zor olacak gezinme öğeleri için kullanılır. Erişilebilir ikincil bir renk seçmenizi ve ardından gerekirse 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. Bu temanın mevcut stilinizle nasıl etkileşim kurabileceğini anlamak için aşağıdaki değişikliklere bakın.
  • Ana sayfa görünümü kartlarının içerik alanının alt kısmındaki 2 piksellik kenarlık, CSS geçersiz kılmalarıyla biçimlendirildi veya gizlendi: Bu kenarlık, <mat-card-content> değerinden <mat-card-actions> ürününde bir kenarlığa taşındı.

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

Aşağıdaki bölümlerde, bu sürümde uygulanan değişiklikler kategoriye göre ayrıntılı olarak ö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ı için maksimum genişlik ve ana içerik alanı için minimum yatay dolgu üzerinde kontrol sağlayan yeni değişkenler bulunur:
    • $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 de mobil ekran boyutları için <a> ile sarmalanmış durumda
  • Kullanıcı açılır menü düğmesi artık <a> yerine <button>

Metin içindeki standart bağlantılar <a> artık fareyle üzerine gelindiğinde varsayılan olarak alt çizgiye ve arka plan rengine ("ikincil renk" tema ayarlarına bağlı olarak) sahiptir

404 sayfası değişiklikleri

404 sayfasında yapılan değişiklikler aşağıda özetlenmiştir.

  • "Şimdi oturum açın" seçeneği <H1> yerine <H2> olarak değiştirildi
  • Açıklama metni artık <H1> yerine <H2>

API'ler sayfası

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

  • API arama/filtre giriş kartı:
    • <mat-card-content class="mat-card-content"> artık Search API'leri kartının başlığını ve girişini 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> bölümüne "<mat-icon matPrefix>search</mat-icon>" girişinden önce bir arama simgesi eklendi.
    • Girişe Aria etiketleri ve kontrol referansları eklendi
  • Boş API listesi mesajı:
    • "No API found" (API bulunamadı) artık <H1> yerine <H2>
    • Açıklama artık <H2> yerine <H3> şeklinde
  • API kartları listesi:

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

  • 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> resminin hemen ardından <div class="api-doc-card-content-title"></div> bölümüne taşındı.
    • API başlığı artık <H1> yerine <H2>

Uygulama Listesi:

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

Uygulama sayfaları oluşturma ve düzenleme

Uygulama Oluşturma ve Düzenleme sayfalarında yapılan 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ı bulunan API kartlarından oluşan bir liste değildir (API listesine benzer). Bu tablo bir API tablosudur
  • Geri çağırma URL'si girişi yeni bir bölüme taşındı
  • Kaydet düğmesi artık mat-raized-button stilini ve birincil renkli arka planı kullanıyor
  • Tablolar artık .app-table-wrapper sınıfıyla bir <div> içine sarmalanmış durumda
  • Tablo başlıkları artık <thead> sarmalayıcısını kullanıyor
  • Tablo gövdeleri artık <tbody> sarmalayıcısını kullanıyor
  • [style.width] artık tablo sütunu genişliklerini ayarlamak için kullanılmıyor
  • Tablodaki tüm <a> etiket artık bunun yerine <button kullanıyor

Takım listesi

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

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

    "Ekipler" unvanı <H1> yerine <H2> olarak değiştirildi

Ekip sayfaları oluşturma ve düzenleme

Ekip Oluşturma ve Düzenleme 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"> civarında <div class="team-apps-container"> eklendi

SmartDocs

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

  • Yan gezinme:
    • Yan gezinme çubuğu, açısal malzeme bileşenleriyle tamamen yeniden yazılmıştır
    • Yan gezinme başlıkları artık <div> yerine <H2>
    • Gezinme öğeleri, artık portal teması düzenleyicisi "ikincil renk" yerine portalın varsayılan metin rengini kullanıyor
    • Yan gezinme menüsündeki seçili, odaklanılan ve fareyle üzerine gelinen öğelerde artık metin ve arka plan için "ikincil renk" portal teması düzenleyicisinin koyu ve açık varyasyonları kullanılıyor.
  • İçerik:
    • "Yol Parametreleri" ve "Başlık Parametreleri" gibi birçok alt başlık artık <H3> yerine <H2>
    • Genel bakış sayfasındaki şema varlıkları artık <H2> yerine <H3>=>

Mevcut bir ana sayfaya erişilebilirlikle ilgili iyileştirmeler ekleme

Çıkış yapan bir portalınız varsa gezilebilir kartlara ilişkin yeni erişilebilirlik iyileştirmelerinden yararlanmak için aşağıda açıklandığı gibi 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çinde metni <a class="navigable-content" href="href-name"> içine alın ve href-name öğesini kartın gezinmesinde 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ı tarayıcı penceresinin kenarına kadar genişletmek için, başlık gezinme çubuğu için aşağıdakine benzer şekilde gelişmiş tema düzenleyiciyi kullanarak gezinme çubukları ve sayfa başlıkları için özel stiller ekleyin:


// 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 bir uygulamada API'leri yönetmek için kullanıcı etkileşimi değişti. Özellikle de bir uygulamayı yönetirken, API'ler bölümünde kullanıcıların uygulamadan API'ye erişimi etkinleştirmek veya devre dışı bırakmak için sırasıyla etkinleştir simgesi veya devre dışı bırak simgesi seçeneğini (geçiş anahtarı yerine) tıklaması gerekir.

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

Düzeltilen hatalar

Bu sürümde aşağıdaki hatalar düzeltilmiştir. Bu liste, öncelikli olarak destek kayıtlarının düzeltilip düzeltilmediğini kontrol eden kullanıcılar içindir. Tüm kullanıcılara ayrıntılı bilgi sağlamak için tasarlanmamıştır.

Sorun Kimliği Bileşen Adı Açıklama
161269688 Entegre Portal

ApigeeHybrid'te öğe küçük resimleri yanlış oluşturuluyor

Küçük resimler artık Öğeler sayfasında doğru şekilde gösterilmektedir.

161295683 Entegre Portal

Uygulama için açıklama ayarlanmadığından sunucu başarısız oluyor

Bir uygulama için açıklama (isteğe bağlı bir alan) tanımlanmamışsa uygulama oluşturma işlemi artık başarılı olacaktır.

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şturulamıyor

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şlemi çalışmıyor

Portal kullanıcılarının API'ler sayfasına geri çağırma URL'si eklemesini veya bu URL'yi 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şulu nedeniyle) 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 çalışmıyor

Tüketici kullanıcı hesaplarını arama ve sıralama artık beklendiği gibi çalışıyor.

Bilinen sorunlar

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