นโยบายข้อความไฮไลต์สำหรับโฟลว์

ยืนยันคีย์ API ในขั้นตอนที่แชร์

ในตัวอย่างนี้ เราจะใช้ขั้นตอนที่แชร์เพื่อทำงานเกี่ยวกับความปลอดภัยทั่วไป ที่นี่ ขั้นตอนที่แชร์จะตรวจสอบคีย์ API พร็อกซี API และขั้นตอนอื่นๆ ที่แชร์จะใช้ Flowข้อความไฮไลต์ ได้ นโยบายในการเรียกเข้าสู่ขั้นตอนที่แชร์นี้

คำจำกัดความของโฟลว์ที่แชร์ต่อไปนี้มีนโยบาย Verify-API-Key ที่ดำเนินการ เมื่อมีการเรียกใช้โฟลว์ที่แชร์จากนโยบาย FlowCall ในพร็อกซี API

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

นโยบาย Flowข้อความไฮไลต์ ต่อไปนี้ซึ่งใช้ในพร็อกซี API เรียกใช้โฟลว์ที่แชร์ก่อนหน้าไปยัง ยืนยันคีย์ API กลุ่มขั้นตอนที่แชร์ของ 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>

ส่งต่อพารามิเตอร์ไปยังขั้นตอนที่แชร์

ตัวอย่างนี้แสดงวิธีส่งพารามิเตอร์จากนโยบาย Flowข้อความไฮไลต์ ไปยัง ขั้นตอนที่แชร์ ในตัวอย่างนี้ นโยบาย Flowข้อความไฮไลต์ เรียกไปยังขั้นตอนที่แชร์ซึ่งออกแบบมาเพื่อดำเนินการโดยทั่วไป ของฟังก์ชันการจัดการสตริง ขั้นตอนที่แชร์มี JavaScript ที่เชื่อมโยงอินพุตเข้าด้วยกัน ไม่ว่าอินพุตจะเป็นตัวพิมพ์เล็กหรือตัวพิมพ์ใหญ่ หรือทั้งสองอย่างก็ได้ นโยบาย Flowข้อความไฮไลต์ จะกำหนดพารามิเตอร์ที่ระบุ อินพุตสตริง เอาต์พุต และสิ่งที่ต้องทำกับอินพุต

1. นโยบาย Flowข้อความไฮไลต์ ของ 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 ต่อไปนี้มีนโยบาย JavaScript SharedStringFunctions ที่จะดำเนินการเมื่อมีการเรียกใช้โฟลว์ที่แชร์จากนโยบาย Flowcallout

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <SharedFlow name="default">
     <Step>
       <Name>SharedStringFunctions</Name>
     </Step>
   </SharedFlow>

3. ในขั้นตอนที่แชร์ นโยบาย JavaScript ของ SharedStringFunctions ต่อไปนี้ ระบุไฟล์ JavaScript SharedStringFunctions.js กับโค้ดที่จะดำเนินการ

   <?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 ต่อไปนี้ทำงานจาก นโยบาย JavaScript SharedStringFunctions รายการ สคริปต์นี้ดึงค่าจาก ตัวแปรที่สร้างจากองค์ประกอบ 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 ไปยังขั้นตอนที่แชร์ จากนั้นไปยัง นโยบาย Flowข้อความไฮไลต์ ในพร็อกซี API ต้นทาง

ไวยากรณ์

คุณสามารถใช้องค์ประกอบนี้กับรูปแบบไวยากรณ์อย่างใดอย่างหนึ่งต่อไปนี้ โปรดทราบว่าตำแหน่ง ใช้ค่าลิเทอรัล รูปแบบของค่าที่คุณระบุจะขึ้นอยู่กับโค้ดที่ ถึงขนาดนั้น

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

ตัวอย่าง

พารามิเตอร์การส่งของนโยบาย Flowcallout ของ 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>