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

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

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

नीचे दिए गए 'शेयर किए गए फ़्लो' की परिभाषा में एक 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>