跳至主要內容
Administrator Guide
上次更新時間 :2023-06-23
概念︰自訂集合元素

概念︰自訂集合元素

您可以在 Workday Studio 中建立 5 種類型的自訂程序集元素︰
自訂元素
程序
中介元件
請從
「調色盤」
「元件」
種類新增
自訂中介
元件。
中介步驟
請從
調色盤
上的
「其他」
種類新增
自訂
步驟。
傳出傳輸
請從
調色盤
上的
傳出傳輸
種類新增
自訂傳出
傳出。
錯誤處理程式
選用板
錯誤處理程式
種類中新增一個
custom-error-handler
元件。
路由策略
路由
元件的操作工具列中選取
建立自訂策略
在每種情況下,自訂元素都由 3 個部分組成︰
  • 基礎 Java 實作,定義元素使用的類別和方法。
  • 說明 Workday 如何建立 Java 類別實例的 Spring Bean 配置。
  • 組合體元件配置,用於將自訂元素置於圖形組合體檢視畫面上。
    自訂程序集元素可在處理傳入資料時,以一般方式存取訊息部分。您也可以指定 Workday 將自訂元素的輸出導向其中的訊息部分。
若要共用自訂元素,請將 Java 封裝匯出為二進位 JAR。然後,其他開發人員可以將 JAR 新增至其專案的類別路徑。

自訂步驟

自訂
步驟撰寫 Java 實作時,請考量以下幾點︰
  • 必須聲明該方法
    public
    以便可以從類別外部呼叫。
  • 方法必須為非靜態。
  • 每個方法的名稱不可重複。
  • 參數清單必須符合支援的組合。
  • 此方法可引發任何類型的例外。
  • 若未提供方法名稱,Workday 會選取參數清單與支援方法簽章相符的任何公開方法 (忽略 getter 和 setter)。如有任何不明確之處,Workday 會在部署期間報告錯誤,您可透過指定方法名稱來解決此錯誤。
自訂
步驟必須提供符合下列其中一個簽章的方法︰
簽名
用途
範例
public
return type
method(
input parameter type
input) [throws
any Exception
]
定義方法的傳回類型和輸入參數。
public String addTimestamp(byte[] messageContent) throws IOException {
public void method(
input parameter type
input,
output parameter type
output) [throws
any Exception
]
定義支援的輸入和輸出參數。
public void addTimestamp(byte[] messageContent, OutputStream out) throws IOException {
自訂
步驟支援以下輸入、傳回和輸出參數類型︰
輸入類型
傳回類型
輸出參數類型
  • java.lang.String
  • byte[]
  • java.io.InputStream
  • javax.activation.DataHandler
  • javax.activation.DataSource
  • org.w3c.dom.Element
  • org.w3c.dom.Document
  • javax.xml.transform.Source
  • javax.xml.transform.stream.StreamSource
  • javax.xml.transform.dom.DOMSource
  • void
  • boolean
    (僅限
    自訂
    步驟)
  • java.lang.String
  • byte[]
  • java.io.InputStream
  • javax.activation.DataHandler
  • javax.activation.DataSource
  • org.w3c.dom.Element
  • org.w3c.dom.Document
  • javax.xml.transform.Source
  • java.io.OutputStream
  • javax.xml.transform.Result
如果
自訂
步驟傳回
void
類型或空值,則不會變更中介訊息。