אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
תהליך משותף הוא פונקציונליות לשימוש חוזר שדומה ל-proxy ל-API. אם אתם כבר מכירים את שרתי ה-proxy של API, רוב התוכן של ההפניה הזו יהיה מוכר לכם.
אם אתם לומדים איך ליצור תהליך משותף, כדאי להתחיל עם הנושא תהליכים משותפים לשימוש חוזר.
מבנה של חבילת תהליך משותף
חבילה של תהליך משותף מורכבת מההגדרות הבאות:
| הגדרת הבסיס | הגדרות התצורה העיקריות. הגדרה בסיסית |
| המדיניות | קובצי הגדרה בפורמט XML שתואמים לסכימות המדיניות של Apigee Edge. מדיניות |
| מקורות מידע | סקריפטים, קובצי JAR וקובצי XSLT שהמדיניות מפנה אליהם כדי להפעיל לוגיקה בהתאמה אישית. משאבים |
| 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 ו-minorVersion 0. יכול להיות שנשתמש בהגדרה הזו בעתיד כדי לאפשר התפתחות של פורמט חבילת התגים המשותפת. | 4.0 | לא |
CreatedAt וגם CreatedBy |
התאריך והשעה (בזמן עידן) שבהם נוצר חבילת הזרימה המשותפת, יחד עם כתובת האימייל של המשתמש שיצר אותה. | ||
Description |
תיאור טקסטואלי של התהליך המשותף. אם תספקו תיאור, הוא יוצג בממשק הניהול של Edge. | לא רלוונטי | לא |
DisplayName |
שם ידידותי למשתמש שעשוי להיות שונה מהמאפיין name של הגדרת הרכיב המשותף. |
לא רלוונטי | לא |
LastModifiedAt וגם LastModifiedBy |
התאריך והשעה (בזמן אפוק) שבהם חבילת הזרימה המשותפת שונתה לאחרונה, וגם כתובת האימייל של המשתמש ששינה אותה. | ||
Policies |
רשימת כללי המדיניות בספרייה /policies של התהליך המשותף הזה. בדרך כלל רואים את הרכיב הזה רק כשיוצרים את התהליך המשותף באמצעות ממשק ניהול Edge. זו פשוט הגדרה של 'מניפסט', שנועדה לספק תצוגה של התוכן של התהליך המשותף. |
לא רלוונטי | לא |
Resources |
רשימה של מקורות מידע (JavaScript, Python, Java, XSLT) בספרייה /resources
של הזרימה המשותפת הזו. בדרך כלל רואים את הרכיב הזה רק כשיוצרים את התהליך המשותף באמצעות ממשק ניהול Edge. זו פשוט הגדרה של 'מניפסט', שנועדה לספק תצוגה של התוכן של התהליך המשותף. |
לא רלוונטי | לא |
SharedFlows |
מציין את התהליך המשותף שהחבילה הזו מכילה.
הערה: בשלב הזה, הרכיב הזה תומך רק ברכיב צאצא אחד מסוג <SharedFlow>. אפשר להוסיף רק תהליך משותף אחד לחבילת תהליכים משותפים. |
לא רלוונטי | כן |
תהליכי עבודה משותפים
/sharedflowbundle/sharedflows/default.xmlבהגדרה של SharedFlow מוגדר הרצף שבו רכיבי הזרימה צריכים לפעול. כל אחד מרכיבי הצאצא <Step> של הרכיב <SharedFlow> מציין חלק מהרצף, כמו קריאה למדיניות.
ההגדרה הבאה של SharedFlow מציינת שלושה כללי מדיניות שיבוצעו ברצף מלמעלה למטה (מימין לשמאל במסוף הניהול), כאשר Spike Arrest policy (מדיניות למניעת עליות פתאומיות בתנועה) מופיע ראשון ו-Flow Callout policy (מדיניות של קריאה ל-Flow) מופיע אחרון.
<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
בדומה ל-proxy ל-API, בחבילת זרימה משותפת, הספרייה /policies מכילה XML של הגדרות לכל המדיניות שאפשר לצרף לזרימה המשותפת בחבילה.
יש קבוצת משנה של אלמנטים שמשותפת לכללי המדיניות, אבל קבוצת המשנה הזו מורחבת עם אלמנטים שספציפיים למדיניות. מידע נוסף על הגדרת מדיניות זמין בנושא המדיניות הרלוונטי. אפשר להגיע אליהם גם מסקירה כללית של הפניות למדיניות.
משאבים
/sharedflowbundle/resources
משאבים הם סקריפטים, קוד וטרנספורמציות XSL שאפשר לצרף לתהליכים משותפים באמצעות כללי מדיניות. הם מופיעים בקטע Scripts (סקריפטים) בכלי לעריכת תהליכים משותפים בממשק המשתמש של הניהול.
במאמר קובצי משאבים מפורטים סוגי המשאבים הנתמכים.
פרסום שאלות בפורום המפתחים של Apigee.