定義外傳訊息業務物件與類型

產品會對現成功能提供許多外傳訊息業務物件以及外傳訊息類型。

此外,實作可能需要定義自訂外傳訊息的組態。針對每個必須傳送至外部系統的外傳訊息,建立外傳訊息維護物件的業務物件。使用業務物件的結構定義,實作可以定義構成 XML 來源欄位 (XML_​SOURCE) 的元素。這些是 XML 訊息基礎的元素。XSL 轉換可以套用至此 XML 來源以產生 XML 訊息。

如果您的整合不但即時且預期收到回應,則外傳訊息業務物件也應該對應至 XML 回應欄位 (XML_​RESPONSE)。

  • 您可以決定依現況擷取回應並將元素定義為「原始」。例如:

    <responseDetail mapXML="XML_RESPONSE" type="raw"/>

    在此情況下,不一定需要有回應 XSL。

  • 或者,如果需要有回應的明細,您可以定義回應的特定元素。對於此選項,視整合的設計方式而定,可能需要有回應 XSL 來將回應轉換為預期的 XML 格式。

在您具有業務物件與結構之後,對每個唯一的外傳訊息定義外傳訊息類型

參考 XSL

系統支援將 XSL 定義為受管理的內容記錄。針對回溯相容性,系統支援將 XSL 定義為檔案系統中的檔案。這是使用功能組態選項定義的全系統設定。功能類型為外部訊息,而選項類型為 XSL 位置。將值設為 F1FL 以支援檔案系統中的 XSL。檔案位置是使用系統特性所設定。若要支援受管理的內容中的 XSL,並不需要任何選項,因為這是預設值。您可以視需要明確地定義 F1MC 的值。

擷取訊息中的外傳訊息 ID

如果您的整合想要使用系統產生的外傳訊息 ID 作為外部系統的唯一識別碼,則需要下列組態:

  • 在 XML 來源中定義應植入系統產生之外傳訊息的元素。

  • 使用外傳訊息 ID XPath 選項類型,設定外傳訊息業務物件中的業務物件選項,並將選項值設定為擷取 ID 所定義之元素的 XPath。

備註:只有在外傳訊息受到保存時,此功能才適用。

支援動態 URL

產品支援建立動態 URL 的功能。這適用於 URL 需要在執行時間決定資訊的情況。建立外傳訊息時,透過業務物件結構定義、URL 組態及適當代碼的組合支援此功能。下列各點標明支援此功能所需的步驟。

  • 定義訊息寄送方的 URL 時,在必須插入執行時間資訊的 URL 位置中使用 ${pathParms} 語法。例如:http://[SERVER_​NAME]:1000/rest/services/${pathParms}

  • 包含外傳訊息之業務物件結構中的資料區域 F1-OM-DynamicConfig (外傳訊息動態組態)。此資料區域包含 pathParmsqueryParms 的元素。

  • 在建立外傳訊息的代碼中,以適當資訊植入 pathParms 元素,以及 queryParms 元素 (如果適用的話)。系統會在 URL 的 ${pathParms} 位置中外掛 pathParms 元素值,後面接著問號以及 queryParms 元素值來建立 URL。

下列是執行時間值的範例。

    <dynamicConfiguration>
        <pathParms>job/1234</pathParms>
        <queryParms>firstName=John&lastName=Doe</queryParms>
     <dynamicConfiguration> 

在執行時間新增 SOAP 標頭參數

產品支援在執行時間將 SOAP 標頭參數新增至外部訊息的功能。下列各點標明支援此功能所需的步驟。

  • 包含外傳訊息之業務物件結構中的資料區域 F1-OM-DynamicConfig (外傳訊息動態組態)。此資料區域包含 soapHeaders 元素。

  • 在建立外傳訊息的代碼中,以獨立 XML 植入 soapHeaders 元素,以新增至傳出 SOAP 要求的 SOAP 標頭區段。