運算式產生器中的遠端函式 remote-functions-in-expression-builder

使用運算式產生器,您可以建立運算式或條件,對資料字典或一般使用者提供的資料值進行計算。 「通訊管理」使用運算式評估的結果來選取資產,例如文字、影像、清單和條件,並視需要將其插入通訊中。

使用運算式產生器建立運算式及遠端函式 creating-expressions-and-remote-functions-with-expression-builder

運算式產生器內部使用JSP EL程式庫,因此運算式會遵循JSPEL語法。 如需詳細資訊,請參閱範例運算式

運算式產生器

運算子 operators

運算式產生器頂列的運運算元可用於運算式。

運算式範例 exampleexpressions

以下是一些您可在通訊管理解決方案中使用的常用JSP EL範例:

  • 若要新增兩個數字: $
  • 若要串連兩個字串: ${str1} $
  • 比較兩個數字: ${age < 18}

您可以在JSP EL規格中找到更多資訊。 使用者端運算式管理員不支援JSP EL規格中的某些變數和函式,特別是:

  • 在使用者端評估之運算式的變數名稱中不支援集合索引和對應金鑰(使用[]標籤法)。

  • 以下是運算式中使用的引數型別或函式的傳回型別:

    • java.lang.String
    • java.lang.Character
    • Char
    • java.lang.Boolean
    • 布林值
    • java.lang.Integer
    • 整數
    • java.util.list
    • java.lang.Short
    • java.lang.Byte
    • 位元組
    • java.lang.Double
    • 兩倍
    • java.lang.Long
    • java.lang.Float
    • 浮點數
    • java.util.Calendar
    • java.util.Date
    • java.util.List

遠端函式 remote-function

遠端函式提供在運算式中使用自訂邏輯的功能。 您可以撰寫自訂邏輯,作為Java中的方法用於運算式中,而相同的函式可用於運算式中。 可用的遠端函式會列在運算式編輯器左側的「遠端函式」標籤下。

remotefunction

新增自訂遠端函式 adding-custom-remote-functions

您可以建立自訂套件組合來匯出您自己的遠端函式,以便在運算式中使用。 若要建立自訂套件組合以匯出您自己的遠端函式,請執行下列工作。 它示範如何撰寫將輸入字串轉換為大寫的自訂函式。

  1. 定義OSGi服務的介面,其中包含要匯出以供Expression Manager使用的方法。

  2. 在介面A上宣告方法,並使用@ServiceMethod註解(com.adobe.exm.expeval.ServiceMethod)加上註解。 Expression Manager會忽略任何未加上註解的方法。 ServiceMethod註解具有下列可選屬性,也可以指定這些屬性:

    1. 已啟用:判斷此方法是否已啟用。 Expression Manager會忽略停用的方法。
    2. familyId:指定方法的系列(群組)。 如果空白,Expression Manager會假設方法屬於預設系列。 沒有家族登入(預設家族除外),無法從中選擇函式。 Expression Manager會使用由各種組合匯出的所有函式所指定的所有系列ID的聯合,以動態建立登入。 請確定他們在此指定的ID可合理讀取,因為它也會顯示在運算式編寫使用者介面中。
    3. displayName:可讀取的函式名稱。 此名稱用於製作使用者介面中的顯示目的。 如果空白,Expression Manager會使用函式的前置詞和local-name來建構預設名稱。
    4. 描述:函式的詳細描述。 此說明用於製作使用者介面中的顯示目的。 如果空白,Expression Manager會使用函式的前置詞和local-name來建構預設描述。
    code language-java
    package mergeandfuse.com;
    import com.adobe.exm.expeval.ServiceMethod;
    
    public interface RemoteFunction {
     @ServiceMethod(enabled=true,displayName="Returns_all_caps",description="Function to convert to all CAPS", familyId="remote")
     public String toAllCaps(String name);
    
    }
    

    您也可以選擇使用@ServiceMethodParameter註解(com.adobe.exm.expeval.ServiceMethodParameter)標註方法的引數。 此註解僅用於指定在編寫使用者介面中使用的人類可讀名稱與方法引數說明。 確定介面方法的引數和傳回值屬於下列其中一種型別:

    • java.lang.String
    • java.lang.Character
    • Char
    • java.lang.Boolean
    • 布林值
    • java.lang.Integer
    • 整數
    • java.lang.Short
    • java.lang.Byte
    • 位元組
    • java.lang.Double
    • 兩倍
    • java.lang.Long
    • java.lang.Float
    • 浮點數
    • java.util.Calendar
    • java.util.Date
    • java.util.List
  3. 定義介面的實作、將其設定為OSGI服務,並定義以下服務屬性:

@org.apache.felix.scr.annotations.Properties({
  @org.apache.felix.scr.annotations.Property(name = "connectors.jsoninvoker", boolValue = true),
  @org.apache.felix.scr.annotations.Property(name = "connectors.jsoninvoker.alias", value = "<service_id>"),
  @org.apache.felix.scr.annotations.Property(name = "exm.service", boolValue = true)})

exm.service=true專案會指示Expression Manager服務包含適合在運算式中使用的遠端函式。 <service_id>值必須是有效的Java識別碼(英數、$、_不含其他特殊字元)。 此值的前置詞為REMOTE_關鍵字,會構成運算式內部使用的前置詞。 例如,如果介面在服務屬性中具有已註解的方法bar()和服務ID foo,則可在使用REMOTE_foo:bar()的運算式內參照。

package mergeandfuse.com;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;

@Component(metatype = true, immediate = true, label = "RemoteFunctionImpl")
@Service(value = RemoteFunction.class)
@org.apache.felix.scr.annotations.Properties({
  @org.apache.felix.scr.annotations.Property(name = "connectors.jsoninvoker", boolValue = true),
  @org.apache.felix.scr.annotations.Property(name = "connectors.jsoninvoker.alias", value = "test1"),
  @org.apache.felix.scr.annotations.Property(name = "exm.service", boolValue = true)})
public class RemoteFuntionImpl implements RemoteFunction {

 @Override
 public String toAllCaps(String name) {
  System.out.println("######Got######"+name);

  return name.toUpperCase();
 }

}

以下是要使用的範例封存:

  • GoodFunctions.jar.zip ​是包含範例遠端函式定義的套件組合的jar檔案。 下載GoodFunctions.jar.zip檔案並將其解壓縮,以取得jar檔案。
  • GoodFunctions.zip ​是定義自訂遠端函式及為其建立套件組合的原始程式碼套件。

GoodFunctions.jar.zip

取得檔案

GoodFunctions.zip

取得檔案

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2