流程呼叫政策

在共用流程中驗證 API 金鑰

在這個範例中，共用流程用於執行常見的安全性相關工作。這裡的共用流程會驗證 API 金鑰。API Proxy 和其他共用流程可以使用 FlowCallout 政策，對這個共用流程發出呼叫。

以下共用流程定義包含 Verify-API-Key 政策，當共用流程從 API Proxy 中的 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 政策用於 API Proxy，會呼叫上述共用流程來驗證 API 金鑰。verify-apikey-shared 共用流程組合 (未顯示於此) 會以 APIProxy 組合設定 Proxy 的方式設定共用流程。

<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 政策傳回至共用流程，然後傳回至來源 API Proxy 中的 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>