इस पेज का अनुवाद Cloud Translation API से किया गया है.

20.07.27 - Apigee Edge के साथ इंटिग्रेट किए गए पोर्टल के रिलीज़ नोट

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी

सोमवार, 27 जुलाई को हम Apigee Edge के इंटिग्रेट किए गए पोर्टल का नया वर्शन रिलीज़ करना शुरू करेंगे.

नई सुविधाएं और बेहतर टूल

इस सेक्शन में, इस रिलीज़ में जोड़ी गई नई सुविधाओं और सुधारों के बारे में बताया गया है.

सुलभता और जवाब देने में लगने वाले समय को बेहतर बनाया गया है

इस रिलीज़ के लिए लागू किए गए सुलभता और जवाब देने में मदद करने वाले सुधारों की सूची नीचे दी गई है.

कीबोर्ड नेविगेशन: अब कीबोर्ड का इस्तेमाल करके हेडर और फ़ुटर नेविगेशन बार, SmartDocs के साइड नेविगेशन, ऐप्लिकेशन सूची, ऐप्लिकेशन व्यू, और एपीआई कार्ड पर नेविगेट किया जा सकता है.
ध्यान दें: मौजूदा पोर्टल के लिए, आपको ये बदलाव करने होंगे:
- अगर लागू हो, तो अपने पोर्टल पर ऐसी किसी भी प्रोसेस को अपडेट करें जो ऐप्लिकेशन पेज पर एपीआई को मैनेज करने के तरीके के बारे में बताती हो. ज़्यादा जानकारी के लिए, किसी ऐप्लिकेशन के लिए एपीआई मैनेज करने की प्रोसेस अपडेट करना देखें.
- होम पेज पर मौजूद एपीआई कार्ड सूची की सुलभता सुविधाओं में सुधार का फ़ायदा पाने के लिए, होम पेज के DOM को अपडेट करें. ज़्यादा जानकारी के लिए, किसी मौजूदा होम पेज में सुलभता सुविधाएं जोड़ना लेख पढ़ें.
फ़ोकस मैनेजमेंट: हेडर नेविगेशन बार और SmartDocs की साइड नेविगेशन से, फ़ोकस, नेविगेशन ऐक्शन के बाद पेज पर पहले <H1> पर फ़ोकस हो जाता है.
लाइव रीजन: टेक्स्ट वाले फ़िल्टर की वजह से जनरेट हुए एपीआई की सूची में होने वाले बदलावों की रिपोर्ट, अब स्क्रीन रीडर का इस्तेमाल करने वाले उपयोगकर्ताओं को की जाती है.
एचटीएमएल हेडिंग का इस्तेमाल करना: अब पूरा टेक्स्ट, वाक्य की बनावट के हिसाब से सही एचटीएमएल टैग में शामिल है. अब पूरे पोर्टल में, हेडिंग के लिए सही क्रम वाली संरचना का इस्तेमाल किया गया है.
<H1> का एक भाषा में इस्तेमाल: अब हर पेज में सिर्फ़ एक <H1> है, इसलिए स्क्रीन रीडर, पेज के कॉन्टेंट के बारे में सबसे सटीक जानकारी आसानी से पहचान सकते हैं.
स्टाइल के हिसाब से कैपिटल लेटर का इस्तेमाल: विज़ुअल ऐक्सेंट के तौर पर ऑल-कैप का इस्तेमाल, अब असल टेक्स्ट के बजाय सिर्फ़ सीएसएस के साथ किया जाता है.
डीओएम का लॉजिकल क्रम: 'ऐप्लिकेशन बनाएं' और 'बदलाव करें' पेजों पर मौजूद ऐक्शन बटन को DOM में फ़ॉर्म एलिमेंट के नीचे ले जाया गया है, ताकि फ़ॉर्म इंटरैक्शन पूरा होने पर उन्हें लॉजिकल क्रम में चालू किया जा सके.
विज़ुअल एलिमेंट के बारे में टेक्स्ट वाली जानकारी: लेबल, वैकल्पिक लेख, और बटन टेक्स्ट के इस्तेमाल को बेहतर बनाया गया है. ये सभी चीज़ें स्क्रीन रीडर की मदद से नेविगेशन को बेहतर बनाती हैं.
कलर कंट्रास्ट: प्रॉडक्ट में कई जगहों पर डब्ल्यूसीएजी एए कंट्रास्ट की ज़रूरी शर्तों को पूरा करने के लिए, रंगों के कंट्रास्ट को बढ़ाया गया है. रंगों के कंट्रास्ट को कम करने के लिए, एपीआई की सूची में एपीआई के टाइटल को इमेज के नीचे ले जाया गया है.
फ़ॉर्म की पुष्टि करना: 'ऐप्लिकेशन बनाएं और उसमें बदलाव करें' पेजों पर, फ़ॉर्म सबमिशन बटन अब बंद नहीं होते हैं. साथ ही, फ़ॉर्म की पुष्टि करने के लिए इन्हें चालू किया जा सकता है. 'ऐप्लिकेशन बनाएं और उसमें बदलाव करें' पेजों पर मौजूद, पुष्टि किए गए फ़ॉर्म फ़ील्ड में अब पुष्टि की गड़बड़ी के बारे में टेक्स्ट के तौर पर जानकारी शामिल की जाएगी.
जवाब देने का तरीका: अब SmartDocs को छोड़कर, बाकी सभी पेजों के लिए ज़्यादा से ज़्यादा चौड़ाई लागू की गई है. SmartDocs नेविगेशन की सुविधा, अब फ़ोन के साइज़ की छोटी स्क्रीन पर भी काम करती है. अब 'ऐप्लिकेशन बनाएं और उसमें बदलाव करें' पेज, छोटी स्क्रीन के लिए ज़्यादा रिस्पॉन्सिव हैं.

डीओएम में हुए ऐसे बदलाव जिनसे आपके पोर्टल पर असर पड़ सकता है

खास तौर पर इन मामलों में विचार करें:

नेविगेशन बार (हेडर और फ़ुटर) और पेज की हेडिंग को सीएसएस ओवरराइड का इस्तेमाल करके स्टाइल किया गया है (या छिपाया गया है): अब पेज के कॉन्टेंट के लिए, स्क्रीन की चौड़ाई सबसे ज़्यादा है. नेविगेशन बार और पेज हेडर को ब्राउज़र विंडो के किनारों तक बढ़ाने के लिए, Apigee ने :before सूडो एलिमेंट की स्टाइल तय की है. ज़्यादा जानकारी के लिए, नेविगेशन बार और पेज हेडर के लिए मुख्य रंग ओवरराइड करना देखें.
पेज के कुछ एलिमेंट, ब्राउज़र विंडो के किनारे तक (फ़ुल-स्क्रीन बैकग्राउंड इमेज के अलावा) दिखते हैं: रिस्पॉन्सिव को बेहतर बनाने के लिए, पेज पर मौजूद कॉन्टेंट की ज़्यादा से ज़्यादा चौड़ाई को सीमित किया गया है. इस वजह से, पसंद के मुताबिक बनाए गए पेज में पहले से पूरी चौड़ाई वाले पैनल को सीमित किया जा सकता है. ज़्यादा से ज़्यादा चौड़ाई वाली नई सेटिंग इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, पोर्टल पेज में पूरी चौड़ाई वाला पैनल बनाना देखें.
टेक्स्ट की स्टाइल में बदलाव करने के लिए, सीएसएस सिलेक्टर की मदद से खास एचटीएमएल हेडिंग लेवल टारगेट किए गए हैं: कुछ कॉन्टेंट पर लागू किए गए हेडिंग लेवल में बदलाव किया गया है. उदाहरण के लिए: <H1> → <H2> इस रिलीज़ में हुए बदलावों की पूरी सूची देखें, ताकि आपको पता चल सके कि किस तरह के कॉन्टेंट पर असर पड़ रहा है.
पोर्टल थीम एडिटर में, सफ़ेद या बहुत हल्के रंग को "सेकंडरी कलर" के तौर पर चुना गया है: दूसरे कलर का इस्तेमाल नेविगेशन एलिमेंट के लिए किया जाता है. इन्हें सफ़ेद बैकग्राउंड में देखना मुश्किल होता है. हमारा सुझाव है कि आप ऐक्सेस किया जा सकने वाला दूसरा रंग चुनें. इसके बाद, खास स्थितियों में ज़रूरत के मुताबिक इसे कस्टम एसएसएस से बदलें.
इन-टेक्स्ट लिंक को स्टाइल किया गया: लिंक की स्टाइलिंग अब ज़्यादा आसानी से इस्तेमाल की जा सकती है. यह समझने के लिए कि यह आपकी मौजूदा स्टाइल के साथ कैसे इंटरैक्ट कर सकता है, नीचे दिए गए बदलाव देखें.
होम व्यू कार्ड के कॉन्टेंट एरिया पर मौजूद 2 पिक्सल के बॉर्डर-बॉटम को सीएसएस ओवरराइड से स्टाइल किया गया है या छिपाया गया है: इस बॉर्डर को <mat-card-content> से <mat-card-actions> पर बॉर्डर-टॉप पर ले जाया गया है.

सभी बदलावों की खास जानकारी

नीचे दिए सेक्शन में, कैटगरी के हिसाब से उन बदलावों के बारे में खास जानकारी दी गई है जिन्हें इस रिलीज़ में लागू किया गया है.

पूरे पोर्टल में बदलाव

पूरे पोर्टल में हुए बदलावों की खास जानकारी नीचे दी गई है.

अब नीचे दिए गए वैरिएबल इस्तेमाल में नहीं हैं:
- $layout-horizontal-padding
- $layout-main-content-horiz-padding
- $layout-header-horiz-padding
- $layout-context-bar-horiz-padding
कुछ नए वैरिएबल उपलब्ध हैं. ये मुख्य कॉन्टेंट एरिया के लिए, ज़्यादा से ज़्यादा चौड़ाई और कम से कम हॉरिज़ॉन्टल पैडिंग (जगह) को कंट्रोल करने की सुविधा देते हैं:
- $layout-main-content-max-width
- $layout-horizontal-min-padding

प्राइमरी नेविगेशन बार में हुए बदलावों की खास जानकारी यहां दी गई है.

<img> लोगो को अब डेस्कटॉप और मोबाइल स्क्रीन, दोनों साइज़ के लिए <a> में रैप कर दिया गया है
उपयोगकर्ता ड्रॉप-डाउन बटन अब <a> के बजाय <button> है

लिंक की स्टाइल में किए गए बदलाव

टेक्स्ट में <a> स्टैंडर्ड लिंक को अब डिफ़ॉल्ट रूप से अंडरलाइन किया जा सकता है. कर्सर घुमाने पर, बैकग्राउंड का रंग (थीम सेटिंग "सेकंडरी कलर") पर आधारित होता है

404 पेज में बदलाव

404 पेज में हुए बदलावों की खास जानकारी नीचे दी गई है.

"अभी साइन इन करें" का समय, <H1> के बजाय <H2> है
जानकारी देने वाला टेक्स्ट अब <H1> के बजाय <H2> है

API पेज

एपीआई पेज में हुए बदलावों की खास जानकारी नीचे कैटगरी के मुताबिक दी गई है.

एपीआई सर्च/फ़िल्टर इनपुट कार्ड:
- <mat-card-content class="mat-card-content">, अब Search API कार्ड के हेडिंग और इनपुट को रैप करता है
- <H2>, अब class="api-doc-filter-title" के बजाय class="mat-subheading-1" का इस्तेमाल करता है
- <mat-form-field> में अब appearance="outline" का इस्तेमाल किया जाता है
- इनपुट से पहले <mat-form-field> में एक खोज आइकॉन जोड़ा गया है: "<mat-icon matPrefix>search</mat-icon>"
- इनपुट में एरिया लेबल और कंट्रोल के रेफ़रंस जोड़े गए हैं
एपीआई की सूची खाली होने का मैसेज:
- "कोई एपीआई नहीं मिला" अब <H1> के बजाय, <H2> है
- इसकी वजह, अब <H2> के बजाय <H3> है
एपीआई कार्ड की सूची:
"आपकी खोज से कोई एपीआई मेल नहीं खाता" अब <H1> के बजाय <H2> है
एपीआई कार्ड:
- >div class="api-doc-card-content-image-gradient"></div> को हटा दिया गया है
- एपीआई के टाइटल को <div> वाली इमेज से बाहर और <div class="api-doc-card-content-title"></div> में, इमेज <div> के ठीक बाद ले जाया गया है
- एपीआई का टाइटल अब <H1> के बजाय <H2> है

ऐप्लिकेशन की सूची:

खाली स्थिति:
- "शुरू करें" अब <H2> है, <H1>
- खाली स्थिति के दिशा-निर्देश अब <H2> के बजाय <H3> है
सूची:
- "मेरे ऐप्लिकेशन" अब <H1> की जगह <H2> हैं
- <mat-row> को अब <a> में बदल दिया गया है

ऐप्लिकेशन पेज बनाना और उनमें बदलाव करना

'ऐप्लिकेशन बनाएं और उसमें बदलाव करें' पेजों में हुए बदलावों की खास जानकारी यहां दी गई है.

<div class="app-buttons"> को <form> के आखिर में ले जाया गया है और उसे <div class="form-buttons-sticky-container"> से बदल दिया गया है
.app-layout-section क्लास के सभी इस्तेमाल को .details-layout-section में बदल दिया गया है
.app-layout-section-title क्लास के सभी इस्तेमाल को .details-layout-section-title में बदल दिया गया है
सभी सेक्शन के शीर्षक अब <div> के बजाय <H2> हैं
.app-layout-section-content क्लास के सभी इस्तेमाल को .details-layout-section-content में बदल दिया गया है
एपीआई की सूची, अब टॉगल स्विच वाले एपीआई कार्ड की सूची नहीं है. यह एपीआई सूची की तरह ही है. इसके बजाय, यह API की एक टेबल है,
कॉलबैक यूआरएल इनपुट को नए सेक्शन में ले जाया गया
'सेव करें' बटन अब मैट-रेज़ बटन स्टाइल और प्राइमरी कलर बैकग्राउंड का इस्तेमाल करता है
टेबल को अब <div> में, .app-table-wrapper क्लास के साथ रैप किया गया है
टेबल के हेडर अब <thead> रैपर का इस्तेमाल करते हैं
टेबल का मुख्य भाग अब <tbody> रैपर का इस्तेमाल करता है
[style.width] का इस्तेमाल अब टेबल कॉलम की चौड़ाई सेट करने के लिए नहीं किया जाता
टेबल के सभी <a> टैग, अब <button का इस्तेमाल करेंगे

टीम की सूची

टीम की सूची में हुए बदलावों की खास जानकारी नीचे दी गई है.

खाली स्थिति:
- "शुरू करें" विकल्प अब <H1> के बजाय <H2> है
- "शेयर किए गए ऐप्लिकेशन के मालिकाना हक को मैनेज करने के लिए टीम बनाएं" अब <H2> की जगह <H3> है
सूची:
"टीम" का टाइटल अब <H1> के बजाय <H2> है

टीम पेज बनाना और उनमें बदलाव करना

'टीम बनाएं' और 'बदलाव करें' पेजों में किए गए बदलावों की खास जानकारी नीचे दी गई है.

<form> पर, क्लास .teams-form को .details-form से बदल दिया गया है
<div class="teams-buttons"> को <form> के आखिर में ले जाया गया है और उसकी जगह <div class="form-buttons-sticky-container"> ले ली गई है
.teams-layout-section क्लास के सभी इस्तेमाल को .details-layout-section में बदल दिया गया है
.teams-layout-section-title क्लास के सभी इस्तेमाल को .details-layout-section-title में बदल दिया गया है
.teams-layout-section-content क्लास के सभी इस्तेमाल को .details-layout-section-content में बदल दिया गया है
<table class="team-apps"> के आस-पास <div class="team-apps-container"> जोड़ा गया

SmartDocs

SmartDocs के इंटरफ़ेस में हुए बदलावों की खास जानकारी नीचे दी गई है.

साइड नेविगेशन:
- साइड नेविगेशन को ऐंगुलर-मटीरियल कॉम्पोनेंट के साथ फिर से लिखा गया है
- साइड नेविगेशन के शीर्षक अब <div> के बजाय <H2> हैं
- नेविगेशन आइटम में अब पोर्टल थीम एडिटर "दूसरा रंग" के बजाय पोर्टल के डिफ़ॉल्ट टेक्स्ट कलर का इस्तेमाल किया जाता है
- साइड नेविगेशन में चुने गए, फ़ोकस किए गए, और कर्सर घुमाने पर दिखने वाले आइटम में टेक्स्ट के लिए, अब पोर्टल थीम एडिटर के गहरे और हल्के रंग के "सेकंडरी कलर" और बैकग्राउंड के लिए "सेकंडरी कलर" का इस्तेमाल किया जाता है
सामग्री:
- "पाथ पैरामीटर" और "हेडर पैरामीटर" जैसे कई सब-वीडियो अब <H3> के बजाय <H2> हैं
- खास जानकारी देने वाले पेज पर स्कीमा इकाइयां अब <H2> के बजाय <H3>=> हैं

मौजूदा होम पेज में सुलभता सुविधाएं जोड़ना

अगर आपके पास पोर्टल से एग्ज़िट होता है, तो नेविगेट किए जा सकने वाले कार्ड की सुलभता सुविधाओं को बेहतर बनाने के लिए, आपको होम पेज में बदलाव करना होगा. इसकी जानकारी नीचे दी गई है:

<mat-card> कंटेनर से href="" हटाएं.
<mat-card-header> में कार्ड हेडिंग के लिए, <H1> के बजाय <H2> का इस्तेमाल करें.
कार्ड के हेडिंग <h2> में, <a class="navigable-content" href="href-name"> के टेक्स्ट को रैप करें. साथ ही, कार्ड के नेविगेशन के लिए, href-name की वैल्यू को सही वैल्यू पर सेट करें.

इसके अलावा, इस कार्ड टेंप्लेट का भी इस्तेमाल किया जा सकता है:


<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>

नेविगेशन बार और पेज हेडर के लिए मुख्य रंग ओवरराइड करना

नेविगेशन बार और पेज के हेडर को ब्राउज़र विंडो के किनारे तक बढ़ाने के लिए, बेहतर थीम एडिटर का इस्तेमाल करके, नेविगेशन बार और पेज के हेडर के लिए पसंद के मुताबिक स्टाइल जोड़ें. यह स्टाइल, हेडर नेविगेशन बार के लिए नीचे दी गई स्टाइल की तरह है:


// 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
  }
}

किसी ऐप्लिकेशन के लिए एपीआई मैनेज करने की प्रोसेस अपडेट करना

इंटिग्रेट किए गए पोर्टल पर किसी ऐप्लिकेशन में एपीआई मैनेज करने के लिए, उपयोगकर्ता के इंटरैक्शन में बदलाव हुआ है. खास तौर पर, किसी ऐप्लिकेशन को मैनेज करते समय, उपयोगकर्ताओं को एपीआई सेक्शन में, चालू करने का आइकॉन या बंद करने का आइकॉन (टॉगल करने के बजाय) पर क्लिक करना होगा. इससे, उस ऐप्लिकेशन से एपीआई का ऐक्सेस चालू या बंद किया जा सकेगा.

अगर लागू हो, तो अपने पोर्टल पर ऐसी किसी भी प्रोसेस को अपडेट करें जो ऐप्लिकेशन पेज पर एपीआई को मैनेज करने के तरीके के बारे में बताती हो. ज़्यादा जानकारी के लिए, अपने ऐप्लिकेशन में एपीआई मैनेज करना देखें.

गड़बड़ियां ठीक की गईं

इस रिलीज़ में इन गड़बड़ियों को ठीक किया गया है. यह सूची मुख्य रूप से उन उपयोगकर्ताओं के लिए है जो यह देखते हैं कि उनके सहायता टिकट की समस्या ठीक हुई है या नहीं. इसे सभी उपयोगकर्ताओं को पूरी जानकारी देने के लिए नहीं बनाया गया है.

समस्या आईडी	कॉम्पोनेंट का नाम	ब्यौरा
161269688	इंटिग्रेट किया गया पोर्टल	Apigee हाइब्रिड में, एसेट के थंबनेल गलत तरीके से रेंडर हो रहे हैं एसेट पेज पर, अब थंबनेल सही तरीके से दिखते हैं.
161295683	इंटिग्रेट किया गया पोर्टल	ऐप्लिकेशन के लिए कोई ब्यौरा सेट न होने की वजह से सर्वर काम नहीं कर रहा अगर किसी ऐप्लिकेशन की जानकारी (वैकल्पिक फ़ील्ड) तय नहीं की जाती है, तो अब ऐप्लिकेशन बनाने की सुविधा चालू हो जाएगी.
160898967	इंटिग्रेट किया गया पोर्टल	पोर्टल का लैंडिंग पेज ठीक से स्क्रोल नहीं करता अब पोर्टल लैंडिंग पेज स्क्रोल किया जा सकता है.
160613314, 159197760, 158643196, 158069283, 158069066, 140154942	इंटिग्रेट किया गया पोर्टल	सुरक्षा से जुड़े अलग-अलग तरह के सुधार
158593496	इंटिग्रेट किया गया पोर्टल	V1 पोर्टल में डेवलपर ऐप्लिकेशन बनाने में समस्या आ रही है एक समस्या को ठीक कर दिया गया है, जिसकी वजह से V1 पोर्टल पर डेवलपर ऐप्लिकेशन नहीं बन पा रहा था.
158318079	इंटिग्रेट किया गया पोर्टल	डेवलपर पोर्टल में कॉलबैक यूआरएल जोड़ने या उसमें बदलाव करने की सुविधा काम नहीं कर रही है पोर्टल के उपयोगकर्ताओं को एपीआई पेज पर कॉलबैक यूआरएल जोड़ने या उसमें बदलाव करने से रोकने वाली समस्या को ठीक कर दिया गया है.
157902256	इंटिग्रेट किया गया पोर्टल	पब्लिश करने से, पेज की ज़्यादा जानकारी वाले पेज पर मौजूद पेज के नाम में हुए अपडेट को बदला जा सकता है एक समस्या को ठीक कर दिया गया है जिसकी वजह से, पोर्टल (रेस की स्थिति की वजह से) को पब्लिश करते समय, पेज का नाम अपडेट हो गया था.
138993728	इंटिग्रेट किया गया पोर्टल	डेवलपर प्रोग्राम की ओर से ईमेल को क्रम से लगाने और खोजने की सुविधा का काम न करना उपभोक्ता उपयोगकर्ता खातों को खोजने और क्रम से लगाने का काम अब उम्मीद के मुताबिक काम करता है.

आम तौर पर होने वाली समस्याएं

इंटिग्रेट किए गए पोर्टल में आने वाली समस्याओं की सूची देखने के लिए, इंटिग्रेटेड पोर्टल की जानी-पहचानी समस्याएं देखें.