פתרון בעיות הקשורות לשגיאות בפריסה של מדיניות תוסף היתרונות המרכזיים

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

InvalidConnectorInstance

הודעת שגיאה

כשפורסים את שרת ה-proxy ל-API דרך ממשק המשתמש של Edge או Edge management API, מופיעה הודעת השגיאה הבאה:

Error Saving Revision revision_number
In policy_name: Connector must not be empty.

הודעת שגיאה לדוגמה

Error Saving Revision 1
In Extension Callout-1: Connector must not be empty.

צילום מסך של שגיאה לדוגמה

הודעת שגיאה לגבי מופע מחבר לא חוקי

סיבה

שגיאה זו מתרחשת אם הרכיב <Connector> במדיניות תוסף היתרונות המרכזיים חסר או מוגדר כערך ריק.

אבחון

  1. מאתרים את השם של מדיניות תוספי היתרונות המרכזיים שמופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות בנושא תוספי יתרונות מרכזיים הוא Extension Callout-1:

    Error Saving Revision 1
In Extension Callout-1: Connector must not be empty

  2. יש לבדוק את קובץ ה-XML של מדיניות תוספי היתרונות המרכזיים של תוסף שנכשל ולוודא שהרכיב <Connector> קיים ושהוא לא ריק. לדוגמה, במדיניות שבהמשך <Connector> האלמנט ריק ולא מכיל את שם התוסף:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector></Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

מכיוון שהרכיב <Connector> ריק, הפריסה של שרת ה-proxy ל-API נכשלת.

רזולוציה

חשוב לוודא שהערך של הרכיב <Connector> במדיניות תוספי היתרונות המרכזיים של התוספים מוגדר תמיד ותואם לשם של התוסף שנוצר בפועל בארגון.

כדי לתקן את הדוגמה לדוגמה של מדיניות תוסף היתרונות המרכזיים שמוצגת למעלה, אפשר להגדיר את הרכיב <Connector> לשם התוסף שקיים בסביבה הספציפית שבה מתבצעת פריסה של שרת ה-proxy ל-API.

כדי לברר את שם התוסף, אפשר לעבור לקטע אדמין > בממשק המשתמש של Edge תוספים. השמות של כל התוספים בארגון יופיעו שם. צריך להגדיר את שם התוסף ברכיב <Connector>.

הצגת השמות של כל התוספים בממשק המשתמש של Edge.

בהמשך מוצגת הדוגמה שבה שם התוסף מוגדר בצורה נכונה ברכיב <Connector>:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

ConnectorInstanceDoesNotExists

הודעת שגיאה

כשפורסים את שרת ה-proxy ל-API דרך ממשק המשתמש של Edge או Edge management API, מופיעה הודעת השגיאה הבאה:

Error Deploying Revision revision_number to environment
In policy_name: Connector <extension_name> does not exist in environment environment.

הודעת שגיאה לדוגמה

Error Deploying Revision 1 to test
In Extension Callout-1: Connector cloud_storage does not exist in environment test.

צילום מסך של שגיאה לדוגמה

הודעת השגיאה &quot;מופע המחבר לא קיים&quot;

סיבה

שגיאה זו מתרחשת אם הרכיב <Connector> במדיניות ExtensionCallout מוגדר לשם שאינו קיים בסביבה שבה שרת ה-proxy ל-API נפרס.

אבחון

  1. יש לזהות את שם המדיניות בנושא יתרונות מרכזיים של תוסף, את שם התוסף הלא חוקי שנעשה בו שימוש ברכיב <Connector> במדיניות בנושא תוספי יתרונות מרכזיים, ואת הסביבה שבה אירעה השגיאה. כל הפריטים האלה מופיעים בהודעת השגיאה.

    לדוגמה, בשגיאה הבאה, שם המדיניות של תוסף היתרונות המרכזיים הוא Extension Callout-1,לא רשמיd שם התוסף הוא cloud_storage ושם הסביבה הוא test:

        Error Deploying Revision 1 to test
    In Extension Callout-1: Connector cloud_storage does not exist in environment test.

  2. יש לבדוק את קובץ ה-XML של מדיניות תוספי היתרונות המרכזיים של התוספים שנכשלה ולוודא ששם התוסף שצוין ברכיב <Connector> תואם למידע שמופיע בהודעת השגיאה.

    בדוגמה הזו, שם התוסף שצוין ברכיב <Connector> הוא cloud_storage:

        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
        <DisplayName>Extension Callout-1</DisplayName>
        <Connector>cloud_storage</Connector>
        <Action>downloadFile</Action>
        <Input><![CDATA[
             {}
         ]]></Input>
        <Output>context-variable-name</Output>
    </ConnectorCallout>

  3. מוודאים ששם התוסף נוצר בסביבה (כפי שמופיעה בשלב 1).

    בממשק המשתמש של Edge, עוברים לקטע אדמין > תוספים ובודקים אם התוסף קיים והשם תואם לזה שצוין ברכיב <Connector> במדיניות בנושא תוספי יתרונות מרכזיים.

    שימו לב בצילום המסך שבהמשך שהתוסף cloud_storage_ext קיים, אבל הוא לא תואם לרכיב <Connector> שצוין במדיניות לדוגמה בנושא תוספי יתרונות מרכזיים שמוצגת למעלה:

    הצגת השמות של כל התוספים בממשק המשתמש של Edge.

    מכיוון ששם התוסף שצוין ברכיב <Connector> לא קיים, תתקבל שגיאת הפריסה:

    In Extension Callout-1: Connector cloud_storage does not exist in environment test.

רזולוציה

חשוב לוודא שהתוסף שצוין ברכיב <Connector> של מדיניות תוספי היתרונות המרכזיים נוצר, ושהשם צוין כראוי.

כדי לקבל מידע נוסף על יצירת התוסף, אפשר לעיין במדריך: שימוש בתוספים.

כדי לתקן את הדוגמה שלמעלה, מתקנים את השם כך שיתאים לתוסף עצמו:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

InvalidAction

הודעת שגיאה

כשפורסים את שרת ה-proxy ל-API דרך ממשק המשתמש של Edge או Edge management API, מופיעה הודעת השגיאה הבאה:

Error Saving Revision revision_number
In policy_name: Action must not be empty.

הודעת שגיאה לדוגמה

Error Saving Revision 1
In Extension Callout-1: Action must not be empty.

צילום מסך של שגיאה לדוגמה

הודעת שגיאה לגבי פעולה לא חוקית

סיבה

שגיאה זו מתרחשת אם הרכיב <Action> במדיניות תוסף היתרונות המרכזיים חסר או מוגדר כערך ריק.

אבחון

  1. מציינים את שם המדיניות של תוסף היתרונות המרכזיים של התוסף. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות בנושא תוספי יתרונות מרכזיים הוא Extension Callout-1:

        Error Saving Revision 1
    In Extension Callout-1: Action must not be empty.

  2. יש לבדוק את ה-XML של מדיניות תוספי היתרונות המרכזיים שנכשלה ולוודא שהפעולה צוינה ברכיב <Action>. אם הרכיב <Action> חסר או אם הוא ריק, זו הסיבה לשגיאה.

    בדוגמה הזו, הרכיב <Action> ריק:

        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
        <DisplayName>Extension Callout-1</DisplayName>
        <Connector>cloud_storage_ext</Connector>
        <Action></Action>
        <Input><![CDATA[
             {}
         ]]></Input>
        <Output>context-variable-name</Output>
    </ConnectorCallout>

רזולוציה

יש לוודא שהרכיב <Action> תמיד מצוין ולא ריק במדיניות של תוספי יתרונות מרכזיים.

במדריך: שימוש בתוספים מוסבר איך ליצור תוסף ואיך להשתמש בו במדיניות עם רכיב <Action> הנכון.

כדי לפתור את הבעיה שלמעלה, מציינים את הפעולה הנכונה עבור התוסף:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

AllowExtensionsInPostClientFlow

הודעת שגיאה

כשפורסים את שרת ה-proxy ל-API דרך ממשק המשתמש של Edge או Edge Management API, מופיעה הודעת השגיאה הבאה:

Error Deploying Revision revision_number to environment
In policy_name: Policy is not allowed in PostClientFlow.

הודעת שגיאה לדוגמה

Error Deploying Revision 1 to test
In Extension Callout-1: Policy is not allowed in PostClientFlow.

צילום מסך של שגיאה לדוגמה

הודעת שגיאה לגבי &#39;אפשר תוספים&#39; בתהליכי לקוח בפוסט

סיבה

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

אבחון

  1. מציינים את שם המדיניות של תוסף היתרונות המרכזיים של התוסף. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות בנושא תוספי יתרונות מרכזיים הוא Extension Callout-1:

    In Extension Callout-1: Policy is not allowed in PostClientFlow.

  2. בדיקת כל תהליכי ה-PostClient בכל נקודות הקצה של שרת ה-proxy ל-API שבו התרחש הכשל. כדאי לעיין במאמר שליטה באופן הפעולה של שרת proxy באמצעות תהליכים.

    אם המדיניות בנושא יתרונות מרכזיים של תוסף (שמוגדרת בשלב 1) ממוקמת בתהליך של לקוח PostClient, זו הסיבה לשגיאה.

    לדוגמה, התהליך הבא של לקוחות לאחר השימוש (PostClient) כולל מדיניות בנושא תוספי יתרונות מרכזיים:

        ...
    <PostClientFlow>
            <Request/>
            <Response>
                <Step>
                    <Name>Extension-Callout-1</Name>
                </Step>
            </Response>
        </PostClientFlow>
    ...

רזולוציה

צריך לוודא שהמדיניות של 'יתרונות מרכזיים של תוסף' לא נמצאת בתהליך של לקוח PostClient.

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

...
<PreFlow name="PreFlow">
    <Request/>
    <Response>
        <Step>
            <Name>Extension-Callout-1</Name>
        </Step>
    </Response>
</PreFlow>
...