مرجع ضبط حِزمة التدفق المشتركة

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

التدفق المشترك عبارة عن وظيفة قابلة لإعادة الاستخدام تشبه الخادم الوكيل لواجهة برمجة التطبيقات. سيتضمن معظم محتوى هذا إذا كنت على دراية بالخوادم الوكيلة لواجهة برمجة التطبيقات.

إذا كنت تتعلم كيفية إنشاء تدفق مشترك، ابدأ بالموضوع المسارات المشتركة القابلة لإعادة الاستخدام.

بنية حزمة التدفق المشتركة

تتألف حزمة التدفق المشترك من الإعدادات التالية:

الإعداد الأساسي	إعدادات الضبط الأساسية. يُرجى الاطّلاع على الإعداد الأساسي.
السياسات	ملفات إعداد بتنسيق XML تتوافق مع مخططات سياسة Apigee Edge. عرض السياسات:
المراجع	النصوص البرمجية وملفات JAR وملفات WebRTC المشار إليها من خلال السياسات لتنفيذ منطق مخصص. عرض الموارد:
SharedFlows	المسارات المشتركة المضمَّنة في هذه الحزمة يُرجى الاطّلاع على المسارات المشتركة.

يتم تحديد المكوّنات في الجدول أعلاه من خلال ملفات الإعداد في ما يلي: بنية الدليل:

ملفات الإعداد وبنية الدليل لحزمة التدفق المشتركة

يشرح هذا القسم ملفات الإعداد وبنية الدليل للمسار المشترك. حُزم.

• الإعداد الأساسي
• السياسات
• المسارات المشتركة
• المراجع

الإعدادات الأساسية

يقع ملف الإعداد الأساسي في الدليل الجذري للحزمة. اسمه هو اسم الحزمة.

/sharedflowbundle/traffic-management-shared.xml

تحدد الإعدادات الأساسية محتوى حزمة التدفق المشتركة، إلى جانب المعلومات لتتبع سجلّ النُسخ السابقة للحزمة.

<SharedFlowBundle revision="2" name="traffic-management-shared">
    <ConfigurationVersion majorVersion="4" minorVersion="0"/>
    <CreatedAt>1478637529218</CreatedAt>
    <CreatedBy>gladys@example.com</CreatedBy>
    <Description>Shared flow to moderate API traffic</Description>
    <DisplayName>traffic-management-shared</DisplayName>
    <LastModifiedAt>1481573374023</LastModifiedAt>
    <LastModifiedBy>gladys@example.com</LastModifiedBy>
    <Policies>
        <Policy>Auth-Flow-Callout</Policy>
        <Policy>Extract-Token</Policy>
        <Policy>Spike-Arrest</Policy>
    </Policies>
    <Resources>
        <Resource>jsc://extract-token.js</Resource>
    </Resources>
    <SharedFlows>
        <SharedFlow>default</SharedFlow>
    </SharedFlows>
</SharedFlowBundle>

سمات الإعداد الأساسي

الاسم	الوصف	تلقائي	مطلوب؟
SharedFlowBundle
name	اسم حزمة التدفق المشتركة، والذي يجب أن تكون فريدة داخل المؤسسة. تشير رسالة الأشكال البيانية في الاسم، تقتصر الأحرف التي يُسمح لك باستخدامها على ما يلي: A-Za-z0-9_-	لا ينطبق	نعم
revision	رقم النسخة السابقة لإعدادات حزمة التدفق المشترك. لا يجب عليك اضبط رقم النسخة السابقة بشكل صريح، نظرًا لأن Apigee Edge يتتبّع تلقائيًا مراجعة التدفق المشترك.	لا ينطبق	لا

عناصر الإعداد الأساسية

الاسم	الوصف	تلقائي	مطلوب؟
SharedFlowBundle
ConfigurationVersion	إصدار مخطط إعدادات حزمة التدفق المشتركة الذي يتم استخدامه في هذا المسار المشترك يتوافق. إنّ القيمة الوحيدة المسموح بها حاليًا هيMajorVersion 4 و miniVersion 0. هذا النمط في المستقبل لتمكين تطوُّر حزمة التدفق المشتركة .	4.0	لا
CreatedAt وCreatedBy	التاريخ/الوقت (في وقت الحقبة) الذي تم فيه إنشاء حزمة التدفق المشتركة، إلى جانب والبريد الإلكتروني للمستخدم الذي أنشأه.
Description	وصف نصي للتدفق المشترك. في حال توفّره، سيتم عرض الوصف باللغة واجهة مستخدم إدارة الحافة.	لا ينطبق	لا
DisplayName	اسم سهل الاستخدام قد يختلف عن السمة name إعدادات التدفق المشترك.	لا ينطبق	لا
LastModifiedAt وLastModifiedBy	التاريخ/الوقت (في وقت الحقبة) الذي تم فيه إجراء آخر تعديل على حزمة التدفق المشتركة، إلى جانب البريد الإلكتروني للمستخدم الذي عدّله.
Policies	قائمة بالسياسات في دليل /policies لهذا المسار المشترك إِنْتَ وعادة ما سيشاهدون هذا العنصر فقط عند إنشاء التدفق المشترك باستخدام واجهة إدارة واجهة المستخدم. هذا مجرد "بيان" صُمِّمت لتوفير رؤية ومحتويات التدفق المشترك.	لا ينطبق	لا
Resources	قائمة بالموارد (JavaScript وPython وJava وWava) في /resources لهذا التدفق المشترك. لن تشاهد عادةً هذا العنصر إلا عند إجراء التدفق المشترك باستخدام واجهة مستخدم إدارة Edge. هذا مجرد "بيان" الإعداد، مصمم من أجل وتوفر رؤية لمحتويات التدفق المشترك.	لا ينطبق	لا
SharedFlows	تُحدِّد التدفق المشترك الذي تحتوي عليه هذه الحزمة. تجدر الإشارة إلى أنّ هذا العنصر يتيح حاليًا استخدام عنصر <SharedFlow> الثانوي واحد فقط. واحد فقط يمكن إضافة مسار مشترك إلى حزمة تدفق مشتركة.	لا ينطبق	نعم

المسارات المشتركة

/sharedflowbundle/sharedflows/default.xml

تحدد تهيئة SharedFlow التسلسل الذي يجب تنفيذ عناصر التدفق فيه. فيديو <SharedFlow> العنصر <Step> العناصر الفرعية التي تحدد كل منها جزءًا من التسلسل، مثل طلب السياسات من الجمهور

تحدد إعدادات SharedFlow التالية ثلاث سياسات يتم تنفيذها في تسلسل من أعلى إلى أسفل (من اليمين إلى اليسار في وحدة تحكم الإدارة)، مع وضع سياسة اعتقال معلّق أولاً سياسة وسائل شرح التدفق الأخير.

<SharedFlow name="default">
    <Step>
        <Name>Spike-Arrest</Name>
    </Step>
    <Step>
        <Name>Extract-Token</Name>
    </Step>
    <Step>
        <Name>Auth-Flow-Callout</Name>
    </Step>
</SharedFlow>

سمات ضبط التدفق المشترك

الاسم	الوصف	تلقائي	مطلوب؟
SharedFlow
name	اسم التدفق المشترك، والذي يجب أن يكون فريدًا داخل المؤسسة. تشير رسالة الأشكال البيانية في الاسم، تقتصر الأحرف التي يُسمح لك باستخدامها على ما يلي: A-Za-z0-9_-	لا ينطبق	نعم
revision	رقم النسخة السابقة لإعدادات التدفق المشترك. لا تحتاج إلى تعيين رقم النسخة السابقة، نظرًا لأن Apigee Edge يتتبع تلقائيًا النسخة الحالية من عملية مشتركة.	لا ينطبق	لا

عناصر إعداد التدفق المشترك

الاسم	الوصف	تلقائي	مطلوب؟
SharedFlow	تحدِّد سلسلة السياسات في التدفق المشترك.	لا ينطبق	نعم
Step	تحدد هذه الخطوة خطوةً -- أي مرحلة في تسلسل التدفق.	لا ينطبق	نعم
Name	تُحدِّد اسم العنصر المُشار إليه في الخطوة. يجب أن تكون قيمة هذا العنصر المعرّف الفريد للسلعة، مثل قيمة سمة اسم السياسة.	لا ينطبق	نعم

السياسات

/sharedflowbundle/policies

كما هو الحال في الخادم الوكيل لواجهة برمجة التطبيقات، في حزمة التدفق المشتركة، يحتوي الدليل /policies على ملف XML للإعدادات لجميع السياسات المتاحة لإرفاقها ضمن المسار المشترك في الحزمة. تشترك السياسات في مجموعة فرعية من العناصر، على الرغم من أن هذه المجموعة الفرعية يتم زيادتها بعناصر الخاصة بالسياسة لمزيد من المعلومات عن طريقة ضبط سياسة، اطّلِع على موضوع السياسة. التي تريدها. يمكنك أيضًا الوصول إلى هؤلاء المستخدمين من مرجع السياسة نظرة عامة.

الموارد

/sharedflowbundle/resources

الموارد هي النصوص البرمجية والتعليمات البرمجية وتحويلات XSL التي يمكن إرفاقها بالتدفقات المشتركة باستخدام السياسات. تظهر هذه في قسم النصوص البرمجية لمحرر التدفق المشترك في وحدة الإدارة واجهة مستخدم

راجِع ملفات الموارد للاطّلاع على الملفات المتوافقة. والموارد.

يمكنك نشر الأسئلة في منتدى مطوّري Apigee.