數字格式化器

​

常用數字格式化器

​

add(value)

​

範例

<!-- count the number of loops in an XML document using xmlDOMSearch -->

<arc:set attr="xml.uri" value="[FilePath]" />
<arc:set attr="xml.xpath" value="/Items/test/loop" />

<arc:call op="xmlDOMSearch" in="xml">
  <!-- this code executes for each occurrence of the 'xpath' in the XML document -->
  <arc:set attr="loopCount" value="[loopCount | def(0) | add(1)]" />
</arc:call>

​

greaterthan(value[, ifgreater][, ifnotgreater])

​

範例

<arc:set attr="totalCost" value="[xpath(Items/Order/TotalCost)]" />
<arc:if exp="[totalCost | greaterthan(1000)]">
  <arc:set attr="highValueOrder" value="true" />
</arc:if>

​

lessthan(value[, ifless][, ifnotless])

​

範例

<arc:set attr="totalCost" value="[xpath(Items/Order/TotalCost)]" />
<arc:if exp="[totalCost | lessthan(0)]">
  <arc:throw code="1" desc="ERROR: Invalid order total." />
</arc:if>

​

multiply(value)

​

範例

<!-- find the total cost by multiplying the price and the quantity of a purchased item -->
<arc:set attr="item.price" value="[xpath(lineitem/costperunit)]" />
<arc:set attr="item.quantity" value="[xpath(lineitem/quantitypurchased)]" />
<arc:set attr="item.totalcost" value="[item.price | multiply([item.quantity])]" />

​

rand(upperBound)

​

範例

<!-- add a random number to the end of a filename -->
<arc:set attr="myFilename" value="myfile-[rand(100000)].xml" />

​

其它數字格式化器

​

abs()

​

and(value)

• value：用於比較的布林值。

​

ceiling()

​

currency([integer_count])

• count：可選數字，指定小數點右側顯示的位數。預設值為 2。

​

decimal([integer_count])

• count：可選數字，指定小數點右側顯示的位數。預設值為 2。

​

div([value])

• value：可選數值，用於除以數字屬性值。預設值為 2。

​

divide([value])

• value：可選數值，用於除以數字屬性值。預設值為 2。

​

expr(expression)

• expression：自由形式運算式。

​

支援的運算子

​

範例

1. 用於 <= 檢查的等效鏈式格式化器和 expr() 方法
   <!-- Using chained formatters -->
   [a | lessthan([b]) | or([a | equals([b])])]
   <!-- Using expr() -->
   [_ | expr("[a] <= [b]")]
   
   <arc:set attr="order.orderQty" value="5" />
   <arc:set attr="warehouse.stockLevel" value="10" />
   <arc:set attr="result.canFulfill" value="" />
   
   <arc:if exp="[_ | expr("[order.orderQty] <= [warehouse.stockLevel]")]">
     <arc:set attr="result.canFulfill" value="true" />
   <arc:else>
     <arc:set attr="result.canFulfill" value="false" />
   </arc:else>
   </arc:if>
   
   <arc:set attr="out.filename" value="order_fulfillment_result.txt" />
   <arc:set attr="out.data" value="canFulfill=[result.canFulfill]" />
   <arc:push item="out" />
   
   預期輸出 將寫入名為 order_fulfillment_result.txt 的檔案，其內容為 canFulfill=true，並且傳出訊息標頭 X-Can-Fulfill 設定為 true。
2. >= 檢查
   <arc:set attr="data.score" value="85" />
   <arc:set attr="data.minimum" value="80" />
   <arc:set attr="data.target" value="85" />
   <arc:set attr="data.stretch" value="90" />
   <arc:set attr="_log.info" value="score >= minimum: [ | expr('[data.score] >= [data.minimum]')]" />
   <arc:set attr="_log.info" value=" score >= target: [ | expr('[data.score] >= [data.target]')]" />
   <arc:set attr="_log.info" value="score >= stretch: [ | expr('[data.score] >= [data.stretch]')]" />
   
   預期輸出
   • score >= minimum: true
   • score >= target: true
   • score >= stretch: false
3. 包含多個變數的複合條件
   <arc:set attr="item.price" value="49.99" />
   <arc:set attr="item.minPrice" value="10" />
   <arc:set attr="item.maxPrice" value="500" />
   <arc:set attr="item.priceValid" value="" />
   
   <arc:if exp="[_ | expr("[item.price] >= [item.minPrice] && [item.price] <= [item.maxPrice]")]">
     <arc:set attr="item.priceValid" value="true" />
   <arc:else>
     <arc:set attr="item.priceValid" value="false" />
   </arc:else>
   </arc:if>
   
   預期輸出 priceValid = true
4. 從 XML 輸入檔案讀取值 當 Script 端口處理傳入訊息時，訊息正文可透過 [FilePath] 存取。以下範例展示如何開啟該輸入，使用 xpath() 從中讀取值，然後使用 expr() 計算這些值。給定以下輸入訊息：
   <Order>
     <Quantity>5</Quantity>
     <StockLevel>10</StockLevel>
   </Order>
   
   此指令碼讀取這些值並判斷訂單是否可以履行：
   <arc:set attr="order.orderQty" value="" />
   <arc:set attr="order.stockLevel" value="" />
   <arc:set attr="result.canFulfill" value="" />
   
   <arc:set attr="xml.uri" value="[FilePath]" />
   <arc:call op="xmlOpen" in="xml">
     <arc:set attr="order.orderQty" value="[xpath(Order/Quantity)]" />
     <arc:set attr="order.stockLevel" value="[xpath(Order/StockLevel)]" />
   </arc:call>
   
   <arc:if exp="[_ | expr("[order.orderQty] <= [order.stockLevel]")]">
     <arc:set attr="result.canFulfill" value="true" />
   <arc:else>
     <arc:set attr="result.canFulfill" value="false" />
   </arc:else>
   </arc:if>
   
   預期輸出 canFulfill = true

​

floor()

​

format(pattern)

• pattern：要使用的格式化模式。

​

範例

<arc:set attr="tmp" value="$1,440.123" />
[tmp]
<br>
[tmp | format("#.##")]

<arc:set attr="rnd" value="1055.68" />
[rnd]
<br>
[rnd | format("#.#")]

​

isbetween(integer_lowvalue, integer_highvalue[, ifbetween][, ifnotbetween])

• lowvalue：要檢查範圍的下限。
• highvalue：要檢查範圍的上限。
• ifbetween：可選值，如果屬性值大於或等於第一個參數值且小於或等於第二個參數值，則傳回此值。
• ifnotbetween：可選值，如果屬性值小於第一個參數值或大於第二個參數值，則傳回此值。

​

isequal(value[, ifequal][, ifnotequal])

• value：要與屬性值比較的數值。
• ifequal：可選值，如果屬性值等於參數值，則傳回此值。
• ifnotequal：可選值，如果屬性值不等於參數值，則傳回此值。

​

modulus(value)

• value：用於除以屬性值的數字。

​

number(value[, format][, locale])

• format：可選的十進位制數字格式。預設值為 #.00。可以使用以下特殊字元：

  字元	描述
  0	數字
  #	數字；零顯示為空
  .	小數分隔符號或貨幣小數分隔符號
  -	負號
  ,	分組分隔符號

• locale：區域設定資訊。預設值為不變區域性或區域設定，這意味著它不與特定國家或地區關聯。它接受語言標籤（例如 en、fr、en-US、en-IN、fr-FR 和 zh-CN）。

​

or(value)

• value：用於比較的布林值。

​

percentage([integer_count])

• count：可選數字，表示小數點右側顯示的位數。

​

pow([value])

• value：可選的冪，用於將屬性值提升到該冪。預設值為 2。

​

round([integer_value])

• value：可選的小數位數。預設值為 2。
• rounding_mode：指定能夠丟棄精度的數值運算的舍入行為。可接受的值為：Default、ToEven、AwayFromZero、ToZero、ToNegativeInfinity、ToPositiveInfinity。使用的預設舍入策略取決於你的作業系統。.NET 使用 ToEven，Java 使用 Half Even。

1. rounding_mode 輸入
2. RoundingMode 環境變數
3. 如上所述，由作業系統確定的預設值

​

sqrt()

​

subtract([value])

• value：可選數值，用於從屬性值中減去。預設值為 1。