דף זה תורגם על ידי Cloud Translation API.

הפניה לתצורה של חבילה משותפת

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

תהליך משותף הוא פונקציונליות של שימוש חוזר, שדומה לזו של שרת proxy ל-API. חלק גדול מהתוכן במאמר הזה אם אתם כבר מכירים שרתי proxy ל-API,

אם רוצים ללמוד איך ליצור תהליך משותף, כדאי להתחיל בנושא תהליכים משותפים לשימוש חוזר.

מבנה חבילות של תהליכי עבודה משותפים

חבילת תהליכי עבודה משותפת מורכבת מהתצורה הבאה:

הגדרה בסיסית	הגדרות אישיות ראשיות. ראו הגדרות בסיסיות.
מדיניות	קובצי תצורה בפורמט XML שתואמים לסכימות של מדיניות Apigee Edge. צפייה מדיניות.
מקורות מידע	סקריפטים, קובצי JAR וקובצי Sitelink שיש אליהם הפניה מכללי המדיניות להפעלת לוגיקה מותאמת אישית. צפייה משאבים.
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`	גרסת סכימת התצורה של חבילת תהליכי עבודה משותפת שאליה התהליך המשותף הזה תואמת. הערך הנתמך היחיד כרגע הוא MainVersion 4 ו-mineVersion 0. הזה ותשתמשו בהגדרה הזו בעתיד כדי לאפשר את הפיתוח של חבילת התהליכים המשותפת הפורמט.	4.0	לא
`CreatedAt` וגם `CreatedBy`	התאריך/השעה (בראשית זמן) שבהם נוצר חבילת התהליכים המשותפת, יחד עם כתובת האימייל של המשתמש שיצר אותם.
`Description`	תיאור טקסטואלי של התהליך המשותף. אם התיאור יישלח, הוא יוצג ממשק המשתמש של ניהול Edge.	לא רלוונטי	לא
`DisplayName`	שם ידידותי למשתמש, שעשוי להיות שונה מהמאפיין `name` של הגדרה של תהליך משותף.	לא רלוונטי	לא
`LastModifiedAt` וגם `LastModifiedBy`	התאריך/השעה (בראשית זמן) שבהם חבילת התהליך המשותפת שונתה לאחרונה, יחד עם את כתובת האימייל של המשתמש שערך את השינוי.
`Policies`	רשימה של כללי מדיניות בספרייה `/policies` של התהליך המשותף הזה. שלך לרוב יראו את הרכיב הזה רק כשהתהליך המשותף נוצר באמצעות Edge ממשק המשתמש לניהול. זה פשוט 'מניפסט' שנועדה לספק שקיפות של תהליך העבודה המשותף.	לא רלוונטי	לא
`Resources`	רשימת משאבים (JavaScript, Python, Java, XSX) ב`/resources` של התהליך המשותף הזה. הרכיב הזה יוצג בדרך כלל רק כשהתהליך המשותף נוצר באמצעות ממשק המשתמש של ניהול Edge. זה פשוט 'מניפסט' בהגדרה הזו, לאפשר צפייה בתוכן של התהליך המשותף.	לא רלוונטי	לא
`SharedFlows`	מציינת את התהליך המשותף שהחבילה הזו כוללת. לתשומת ליבכם: בשלב זה, הרכיב הזה תומך רק בתת-סוג <SharedFlow> אחד. רק אחד ניתן להוסיף תהליך משותף לחבילת תהליכי עבודה משותפת.	לא רלוונטי	כן

תהליכי עבודה משותפים

/sharedflowbundle/sharedflows/default.xml

תצורת SharedFlow מגדירה את הרצף שבו יש לבצע רכיבי זרימה. רכיב <SharedFlow> <שלב> של הרכיב כל אחד מרכיבי צאצא מציין חלק מהרצף, כמו קריאה למדיניות.

ההגדרות הבאות של SharedFlow מציינת שלושה סוגים של כללי מדיניות שצריך להפעיל רצף מלמעלה למטה (משמאל לימין במסוף הניהול), עם מדיניות Spike Arrest קודם המדיניות בנושא זרימה של נכסי יתרונות מרכזיים האחרון.

<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 שאפשר לצרף לתהליכים משותפים באמצעות כללי מדיניות. האירועים האלה מופיעים בקטע 'סקריפטים' בעורך התהליך המשותף בניהול המשתמשים. ממשק משתמש.

מידע נוסף זמין במאמר קובצי משאבים בסוגי המשאבים.

לפרסם שאלות בפורום המפתחים של Apigee.