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

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

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

नीचे दी गई शेयर फ़्लो की परिभाषा में एक 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 का शेयर किया गया फ़्लो बंडल (यहां नहीं दिखाया गया है) शेयर किए गए फ़्लो को उसी तरह कॉन्फ़िगर करता है जिस तरह APIप्रॉक्सी बंडल, प्रॉक्सी को कॉन्फ़िगर करता है.

<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>