流程呼叫政策

驗證共用流程中的 API 金鑰

在此範例中，共用流程可用來執行常見的安全性相關工作。這裡的 共用流程會驗證 API 金鑰API Proxy 和其他共用流程可以使用「流程摘要」 政策對這個共用流程進行呼叫。

下列共用流程定義包含會執行的 Verify-API-Key 政策 在 API Proxy 中透過資料流呼叫政策呼叫共用流程時。

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

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

將參數傳遞至共用流程

本範例說明如何將參數從資料流政策傳遞至 共用流程在這裡，資料流呼叫政策會呼叫共用流程，以便執行常見的 字串處理函式。共用流程包含用來串連輸入內容的 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 政策回推到共用流程，再流回 來源 API Proxy 中的流程呼叫政策。

語法

這個元素可與下列任一語法格式搭配使用。請注意 使用常值，您指定的值格式將取決於 也可以使用

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