फ़्लो कॉलआउट नीति

शेयर किए गए फ़्लो में एपीआई पासकोड की पुष्टि करें

इस उदाहरण में, सुरक्षा से जुड़े सामान्य टास्क करने के लिए, शेयर किए गए फ़्लो का इस्तेमाल किया गया है. यहां शेयर किया गया फ़्लो, एपीआई पासकोड की पुष्टि करता है. एपीआई प्रॉक्सी और अन्य शेयर किए गए फ़्लो, फ़्लो कॉलआउट का इस्तेमाल कर सकते हैं कॉल करने की नीति का इस्तेमाल किया जा रहा है.

शेयर किए गए फ़्लो की इस परिभाषा में, लागू होने वाली Verify-API-Key नीति शामिल है जब शेयर किए गए फ़्लो को, एपीआई प्रॉक्सी में फ़्लोकॉलआउट नीति से कॉल किया जाता है.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SharedFlow name="default">
    <Step>
        <Name>Verify-API-Key</Name>
    </Step>
</SharedFlow>

पिछले शेयर किए गए फ़्लो में मौजूद VerifyAPIKey नीति, कुंजी की वैल्यू को वापस लाती है और उसकी पुष्टि करता है.

<VerifyAPIKey async="false" continueOnError="false" enabled="true" name="Verify-API-Key">
    <DisplayName>Verify API Key</DisplayName>
    <APIKey ref="request.queryparam.apikey"/>
</VerifyAPIKey>

एपीआई प्रॉक्सी में इस्तेमाल की जाने वाली फ़्लोकॉलआउट नीति, पिछले शेयर किए गए फ़्लो को की पुष्टि करें. verify-apikey-shared शेयर किया गया फ़्लो बंडल (यहां नहीं दिखाया गया है) शेयर किए गए फ़्लो को उसी तरह कॉन्फ़िगर करता है जिस तरह एपीआई प्रॉक्सी बंडल, प्रॉक्सी को कॉन्फ़िगर करता है.

<FlowCallout async="false" continueOnError="false" enabled="true" name="Auth-Flow-Callout">
    <DisplayName>Auth Flow Callout</DisplayName>
    <SharedFlowBundle>verify-apikey-shared</SharedFlowBundle>
</FlowCallout>

पैरामीटर को शेयर किए गए फ़्लो में पास करना

इस उदाहरण में बताया गया है कि फ़्लोकॉलआउट नीति से पैरामीटर को शेयर किया गया फ़्लो. यहां फ़्लोकॉलआउट नीति, सामान्य तरीके से काम करने के लिए डिज़ाइन किए गए शेयर किए गए फ़्लो को कॉल करती है स्ट्रिंग हैंडलिंग फ़ंक्शन. शेयर किए गए फ़्लो में JavaScript शामिल होता है, जो इसके इनपुट को जोड़ता है, इसके इनपुट को लोअरकेस में लिखता है या दोनों. फ़्लो कॉलआउट नीति ऐसे पैरामीटर के बारे में बताती है जो स्ट्रिंग इनपुट, आउटपुट, और इनपुट से क्या करना है.

1. String-Handler फ़्लोकॉलआउट नीति, शेयर किए गए फ़्लो को कॉल करती है. पासिंग पैरामीटर, जो शेयर किए गए फ़्लो के आउटपुट को स्टोर करने के लिए वैरिएबल तय करता है, कौनसा शेयर किया गया फ़्लो कैसे काम करना है और किस इनपुट का इस्तेमाल करना है (यहां एक स्ट्रिंग लिटरल है, लेकिन यह फ़्लो वैरिएबल). Parameter एलिमेंट, वैरिएबल के नाम और वैल्यू बताते हैं रनटाइम बनाने के लिए. शेयर किया गया फ़्लो, इन वैरिएबल को अपने कोड में इस्तेमाल करने के लिए फिर से पा सकता है.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <FlowCallout async="false" continueOnError="false" enabled="true" name="String-Handler">
     <DisplayName>String Handler</DisplayName>
     <Parameters>
       <Parameter name="input">Gladys Kravitz</Parameter>
       <Parameter name="operations">concatenate tolowercase</Parameter>
       <Parameter name="outputVariable">string.handler.output</Parameter>
     </Parameters>
     <SharedFlowBundle>StringHandler</SharedFlowBundle>
   </FlowCallout>

2. नीचे दिए गए default शेयर किए गए फ़्लो में, SharedStringFunctions JavaScript नीति शामिल है. यह नीति तब लागू होती है, जब फ़्लोकॉलआउट नीति से, शेयर किए गए फ़्लो को कॉल किया जाता है.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <SharedFlow name="default">
     <Step>
       <Name>SharedStringFunctions</Name>
     </Step>
   </SharedFlow>

3. शेयर किए गए फ़्लो में, यहां दी गई SharedStringFunctions JavaScript नीति एक्ज़ीक्यूट करने के लिए कोड के साथ SharedStringFunctions.js JavaScript फ़ाइल तय करता है.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="SharedStringFunctions">
     <DisplayName>SharedStringFunctions</DisplayName> <Properties/>
     <ResourceURL>jsc://SharedStringFunctions.js</ResourceURL>
   </Javascript>

4. नीचे दिया गया JavaScript, SharedStringFunctions.js, SharedStringFunctions JavaScript की नीति. यह स्क्रिप्ट इनसे वैल्यू लेती है फ़्लोकॉलआउट नीति Parameter एलिमेंट से बनाए गए वैरिएबल.

   // Input value from the calling API proxy.
   var handledString = context.getVariable("input");
   // Variable to use for output from this script.
   var outputVariable = context.getVariable("outputVariable");
   // A space-separated list of things to do to the input string.
   // Convert to lower case to handle unintentional capitals in configuration.
   var operation = context.getVariable("operations").toLowerCase();
   
   // If "lowercase" was given as an operation, convert the input to lowercase.
   if (operation.includes("tolowercase")) {
       handledString = handledString.toLowerCase();
   }
   
   // If "concatenate" was given as an operation, concatenate the input.
   if (operation.includes("concatenate")) {
       handledString = handledString.replace(/\s+/g, '');
   }
   // Assign the resulting string to the output variable specified by
   // the calling API proxy.
   context.setVariable(outputVariable, handledString);

5. एक्ज़ीक्यूशन फ़्लो, JavaScript नीति से लेकर शेयर किए गए फ़्लो तक, फिर ओरिजनल एपीआई प्रॉक्सी में फ़्लोकॉलआउट नीति.

सिंटैक्स

इस एलिमेंट का इस्तेमाल, इनमें से किसी भी सिंटैक्स फ़ॉर्म के साथ किया जा सकता है. ध्यान दें कि जहां आपने लिटरल वैल्यू का इस्तेमाल करते हैं, तो आपके तय किए गए वैल्यू का फ़ॉर्मैट, उस कोड पर निर्भर करेगा इसका इस्तेमाल करता है.

<!- A literal value in an attribute. --/>
<Parameter name="parameter-name" value='parameter-value' />
<!- A reference to a variable in an attribute. --/>
<Parameter name="parameter-name" ref='source-variable-name' />
<!- A literal value in the element content. --/>
<Parameter name="parameter-name">parameter-value</Parameter>
<!- An reference to an attribute in the element content. --/>
<Parameter name="parameter-name">{source-variable-name}</Parameter>

उदाहरण

यह String-Handler फ़्लोकॉलआउट नीति पास करने वाले पैरामीटर से पता चलता है कि का इस्तेमाल करें. Parameter एलिमेंट रनटाइम बनाने के लिए, वैरिएबल के नाम और वैल्यू की जानकारी देता है. शेयर किए गए फ़्लो की मदद से, में इस्तेमाल करने के लिए इन वैरिएबल का इस्तेमाल करें.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<FlowCallout async="false" continueOnError="false" enabled="true" name="String-Handler">
  <DisplayName>String Handler</DisplayName>
  <Parameters>
    <Parameter name="input">Gladys Kravitz</Parameter>
    <Parameter name="outputVariable">string.handler.output</Parameter>
  </Parameters>
  <SharedFlowBundle>StringHandler</SharedFlowBundle>
</FlowCallout>

सिंटैक्स

<Parameters>
  <Parameter name="parameter-name" value='parameter-value' />
</Parameters>