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

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

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

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

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

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

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

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

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

1. String-Handler FlowCallout नीति, शेयर किए गए फ़्लो को कॉल करती है. साथ ही, ऐसे पैरामीटर पास करती है जो शेयर किए गए फ़्लो के आउटपुट को सेव करने के लिए वैरिएबल, शेयर किए गए फ़्लो के किस ऑपरेशन का इस्तेमाल करना है, और किस इनपुट का इस्तेमाल करना है, यह तय करते हैं. यहां, स्ट्रिंग लिटरल का इस्तेमाल किया गया है. हालांकि, यह फ़्लो वैरिएबल भी हो सकता है. 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 नीति शामिल है. यह नीति तब लागू होती है, जब FlowCallout नीति से शेयर किए गए फ़्लो को कॉल किया जाता है.

   <?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 नीति के तहत काम करता है. यह स्क्रिप्ट, FlowCallout नीति के 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 नीति से वापस शेयर किए गए फ़्लो पर, फिर ओरिजनल एपीआई प्रॉक्सी में FlowCallout नीति पर जाता है.

सिंटैक्स

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

<!- 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 FlowCallout नीति, पैरामीटर पास करती है. इन पैरामीटर से यह तय होता है कि शेयर किए गए फ़्लो का आउटपुट कहां सेव करना है और किस इनपुट का इस्तेमाल करना है. 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>