共用方式為

商務元件作業的訊息結構描述

  • 發行項

Siebel 商務元件作業的訊息架構

下表列出 Siebel 商務元件上 Siebel 配接器所公開作業的訊息架構。

作業 XML 結構 Description
插入 插入訊息：

<Insert xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <ArrayOf[BC]InsertRecord> <[BC]InsertRecord> <[FIELD1_NAME]>value1</[FIELD1_NAME]> <[FIELD2_NAME]>value2</[FIELD2_NAME]> … </[BC]InsertRecord> … </ArrayOf[BC]InsertRecord> </Insert>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[FIELD1_NAME] = 商務元件功能變數名稱;例如，Account_x0020_Status。

插入回應訊息：

<InsertResponset xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <InsertResult> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[ID1]</string> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[ID2]</string> … </InsertResult> </InsertResponse>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03"

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[ID] = 記錄識別碼;例如 42-6ODBL。		 將一或多個記錄插入商務元件。

回應包含插入之所有記錄的記錄識別碼。

如果至少有一個插入成功，則不會擲回任何例外狀況，且回應將包含成功插入記錄的識別碼。 不過，如果所有插入失敗，則會在 XmlReaderParsingException 或 TargetSystemException) (擲回例外狀況。
查詢 查詢訊息：

<Query xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <ViewMode>[View_mode]</ViewMode> <[BC]QueryInputRecord> <SearchExpr>[Search_expr]</SearchExpr> <SortSpec>Sort_spec</SortSpec> <QueryFields> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[Field1_name]</string> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[Field2_name]</string> … </QueryFields> </[BC]QueryInputRecord> </Query>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[View_mode] = 要套用的檢視模式。 這是選擇性參數。 如需可能值的說明，請參閱 Siebel 檔。

[Search_expr] = Siebel 搜尋運算式;例如，[Name] LIKE 「3Com*」。

[Sort_spec] = Siebel 排序規格;例如，名稱 (DESC) 、Location。

[FIELD1_NAME] = 商務元件功能變數名稱;例如，帳戶狀態。

查詢回應訊息：

<QueryResponse xmlns=" [VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <QueryResult> <[BC]QueryRecord> <[FIELD1_NAME]>value1</[FIELD1_NAME]> <[FIELD2_NAME]>value2</[FIELD2_NAME]> … </[BC]QueryRecord > </QueryResult> </QueryResponse>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[FIELD1_NAME] = 商務元件功能變數名稱;例如，Account_x0020_Status。		 從目標商務元件查詢一或多個記錄。 查詢作業會採用下列參數：

<搜尋Expr > 目標商務元件下的所有記錄都會與搜尋運算式進行比較，並傳回相符的記錄。

<SortSpec > 排序規格會決定傳回符合搜尋運算式之記錄的順序。 這是選擇性參數。

<QueryFields > 功能變數名稱清單，指定應該由查詢作業擷取之目標商務元件中的欄位。 每個記錄只會傳回此清單中的欄位。 每個欄位都應該使用商務元件中欄位的原始名稱來指定，而不是 XML 編碼的名稱;例如，「名字」，而不是「First_x0032_Name」。 這是選擇性參數。 如果未指定查詢欄位，則會傳回所有欄位。
更新 更新訊息：

<Update xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <ViewMode>[View_mode]</ViewMode> <ArrayOf[BC]UpdateRecord> <[BC]UpdateRecord> <[FIELD1_NAME]>value1</[FIELD1_NAME]> <[FIELD2_NAME]>value2</[FIELD2_NAME]> … <Id>[Record_ID]</Id> </[BC]UpdateRecord> … </ArrayOf[BC]UpdateRecord> </Update>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[View_mode] = 查詢需要更新之記錄時要套用的檢視模式。 這是選擇性參數。 如需可能值的說明，請參閱 Siebel 檔。

[FIELD1_NAME] = 商務元件功能變數名稱;例如，Account_x0020_Status。

[Record_ID] = 要更新之記錄的記錄識別碼;例如，42-60DBL。

更新回應訊息：

<UpdateResponse xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <UpdateResult> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[ID1]</string> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[ID2]</string> … </UpdateResult> </UpdateResponse>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[ID] = 記錄識別碼;例如 42-6ODBL。		 更新更新記錄清單所指定的一或多個記錄。

每個更新記錄都包含要更新的欄位清單，以及識別要更新之記錄的單一必要 < Id > 元素。

回應包含所有已更新記錄的記錄識別碼清單。

如果至少有一個更新成功，則不會擲回任何例外狀況，且回應將包含已成功更新記錄的識別碼。 不過，如果所有更新都失敗，則會 (XmlReaderParsingException 或 TargetSystemException) 擲回例外狀況。
刪除 刪除訊息：

<Delete xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <ViewMode>[View_mode]</ViewMode> <Id> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[ID1]</string> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[ID2]</string> … </Id> <SearchExpr>Search_expr</SearchExpr> </Delete>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[View_mode] = 查詢需要刪除的記錄時要套用的檢視模式。 這是選擇性參數。 如需可能值的說明，請參閱 Siebel 檔。

[ID] = 記錄識別碼;例如 42-6ODBL。

Search_expr = Siebel 搜尋運算式;例如，[Name] LIKE 「3Com*」。

刪除回應訊息

<DeleteResponse xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <DeleteResult> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[ID1]</string> <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">[ID2]</string> … </DeleteResult> </DeleteResponse>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[ID] = 記錄識別碼;例如 42-6ODBL。		 刪除一或多個符合一組記錄識別碼或搜尋運算式的記錄。

重要： Delete 作業會採用搜尋運算式或一組記錄識別碼。 您無法在相同的 Delete 作業中指定這兩個參數。

回應包含已刪除所有資料列的記錄識別碼清單。

如果至少有一個刪除成功，則不會擲回任何例外狀況，且回應會包含成功刪除記錄的識別碼。 不過，如果所有刪除都失敗，則會 (XmlReaderParsingException 或 TargetSystemException) 擲回例外狀況。
副學士 建立訊息的關聯：

<Associate xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <ViewMode>[View_mode]</ViewMode> <ParentSearchExpr>Par_search</ParentSearchExpr> <ParentMVGField>Field_name</ParentMVGField> <ChildSearchExpr>Chld_search</ChildSearchExpr> </Associate>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[View_mode] = 檢視模式，以套用至父項和子商務元件記錄的查詢。 如果指定值，該值將會同時套用至父搜尋和子搜尋。 這是選擇性引數。 如需可能值的說明，請參閱 Siebel 檔。

[Par_search] = 搜尋運算式完全符合一個父商務元件記錄;例如，[Id] LIKE AB-12345。

[Chld_search] = 搜尋運算式，完全符合與父商務元件記錄相關聯的一個子商務元件記錄;例如，[Id] LIKE CD-12345。

[Field_name] = 父商務元件的多重值組功能變數名稱;例如，帳戶商務元件中的「帳單至名字」。

建立回應訊息的關聯：

<AssociateResponse xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <AssociateResult> <ChildID>[CHILD_ID]</ChildID> <ParentID>[PARENT_ID]</ParentID> </AssociateResult> </AssociateResponse>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[CHILD_ID] = 子記錄識別碼;例如 42-6ODBL。

[PARENT_ID] = 父記錄識別碼;例如 42-6ODBL。		 [關聯] 作業只會針對具有多重值群組 (MVG) 欄位的商務元件呈現。 它會藉由指定父記錄和子記錄的搜尋運算式來關聯記錄。

關聯作業：

- 將選取的父商務元件記錄與一個選取的子商務元件記錄產生關聯

- 建立 1：1 關聯。 一個父記錄會與一個子記錄相關聯

- 應該針對 1：N 關聯建立多個 1：1 關聯，而應該針對 M：N 關聯建立多個 1：N 關聯

請注意：

父搜尋運算式必須符合父資料表中的唯一記錄。

子搜尋運算式必須符合子資料工作表中的唯一記錄。

傳回值包含相關聯子資料列的記錄識別碼，以及相關聯父資料列的記錄識別碼。 如果父搜尋運算式或子搜尋運算式傳回一個以上的相符記錄，將會擲回例外狀況。
解除關聯 解除關聯訊息：

<Dissociate xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <ViewMode>[View_mode]</ViewMode> <ParentSearchExpr>Par_search</ParentSearchExpr> <ParentMVGField>Field_name</ParentMVGField> <ChildSearchExpr>Chld_search</ChildSearchExpr> </Dissociate>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[View_mode] = 檢視模式，以套用至父系和子商務元件記錄的查詢。 如果指定值，該值將會同時套用至父搜尋和子搜尋。 這是選擇性引數。 如需允許值的說明，請參閱 Siebel 檔。

[Par_search] = 搜尋運算式，完全符合一個父商務元件記錄;例如，[Id] LIKE AB-12345。

[Chld_search] = 搜尋運算式，與父商務元件記錄完全相符的一個子商務元件記錄;例如，[Id] LIKE CD-12345。

[Field_name] = 父商務元件的多重值群組功能變數名稱;例如，帳戶商務元件中的「帳單至名字」。

解除回應訊息的關聯：

<DissociateResponse xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <DissociateResult> <ChildID>[CHILD_ID]</ChildID> <ParentID>[PARENT_ID]</ParentID> </DissociateResult> </DisocciateResponse>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[CHILD_ID] = 子記錄識別碼;例如 42-6ODBL。

[PARENT_ID] = 父記錄識別碼;例如 42-6ODBL。		 解除關聯作業只會針對具有多重價值群組 (MVG) 欄位的商務元件呈現。 它會藉由指定父記錄和子記錄的搜尋運算式來解除記錄的關聯。

解除關聯作業：

將選取的父商務元件記錄與一個選取的子商務元件記錄中斷關聯

建立 1：1 分離。 一個父記錄會與一個子記錄解除關聯

應該針對 1：N 解除關聯進行多個 1：1 的分離，並針對 M：N 解除關聯進行多個 1：N 分離

請注意，子搜尋運算式必須符合相關聯記錄與父搜尋運算式相符之父記錄之間的唯一記錄。

重要： ASSOCIATE 和 DISSOCIATE 作業的子搜尋運算式有差異。 在 ASSOCIATE 作業中，子搜尋運算式會搜尋子商務元件中的所有記錄。 在 DISSOCIATE 作業中，子搜尋運算式只會搜尋與父商務元件中記錄相關聯的子商務元件中的記錄，其中父記錄符合父搜尋運算式。

傳回值包含已解除關聯子記錄的記錄識別碼，以及已解除關聯父記錄的記錄識別碼。 如果父搜尋運算式或子搜尋運算式傳回一個以上的相符記錄，將會擲回例外狀況。
Query_[MVG_Child_Business_Comp] Query_[MVG_Child_Business_Comp] 訊息：

<Query_[CHILD_BC] xmlns="BusinessObjects/[BO]/[BC]/Operation"> <ViewMode>View_mode</ViewMode> <ParentSearchExpr>Par_search</ParentSearchExpr> <ParentMVGField>Field_name</ParentMVGField> <[CHILD_BC]QueryInputRecord> <SearchExpr>Chld_search </SearchExpr> <QueryFields> <string>field1</string> <string>field2</string> … </QueryFields> </[CHILD_BC]QueryInputRecord> </Query_[CHILD_BC]>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[View_mode] = 要套用的檢視模式;可以是 0 到 9。 這是選擇性參數。 如需這些可能值的說明，請參閱 Siebel 檔。

[CHILD_BC] = 與父商務元件 MVG 欄位相關聯的子商務元件名稱;例如，帳戶父商務元件) 的連絡人 (。

[Par_search] = 搜尋運算式比對 1 個父商務元件記錄;例如，[Id] LIKE AB-12345。

[Field_name] = 父業務元件的多重值群組功能變數名稱;例如，帳戶商務元件中的「帳單至名字」。

[Chld_search] = 搜尋符合 1 或更多子商務元件記錄的運算式;例如，[Id] LIKE CD-12345。

[field1]、 [field2]， 等等 = 子商務元件中的查詢欄位。 功能變數名稱清單，指定作業應該擷取之子商務元件中的欄位。 每個記錄中只會傳回此清單中的欄位。 每個欄位都應該使用子商務元件中欄位的原始名稱來指定，而不是 XML 編碼的名稱;例如，「名字」而非「First_x0032_Name」。 這是選擇性參數。

Query_[MVG_Child_Business_Comp] 回應訊息：

<Query_[CHILD_BC]Response xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <Query_[CHILD_BC]Result> <[CHILD_BC]QueryRecord> <[FIELD1_NAME]>value1</[FIELD1_NAME]> <[FIELD2_NAME]>value2</[FIELD2_NAME]> … </[CHILD_BC]QueryRecord > </QueryResult> </QueryResponse>

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = 商務物件的名稱;例如，帳戶。

[BC] = 商務元件的名稱;例如，帳戶。

[FIELD1_NAME] = 商務元件功能變數名稱;例如，Account_x0020_Status。

[CHILD_BC] = 與父商務元件 MVG 欄位相關聯的子商務元件名稱;例如，帳戶父商務元件) 的連絡人 (。		 此作業會針對具有 MVG 欄位的商務元件公開。

它會查詢與父代記錄相關聯的子記錄，該記錄與父商務元件中的 MVG 欄位相關聯。

Siebel 商務元件作業的訊息動作

下表顯示每個 Siebel 商務元件作業的 SOAP 動作。 只有顯示要求訊息的動作，回應訊息的動作會藉由將 「/response」 附加至要求訊息動作來形成;例如， "http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert/response" 。

作業 動作 範例
插入 [VERSION]/BusinessObjects/[BO]/[BC]/Insert http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert
查詢 [VERSION]/BusinessObjects/[BO]/[BC]/Query http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Query
更新 [VERSION]/BusinessObjects/[BO]/[BC]/Update http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Update
刪除 [VERSION]/BusinessObjects/[BO]/[BC]/Delete http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Delete
副學士 [VERSION]/BusinessObjects/[BO]/[BC]/Associate http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Associate
解除關聯 [VERSION]/BusinessObjects/[BO]/[BC]/Dissociate http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Dissociate
Query_[CHILD_BC] [VERSION]/BusinessObjects/[BO]/[BC]/Query_[CHILD_BC] http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Query_Contact

[VERSION] = 訊息版本字串;例如， "http://Microsoft.LobServices.Siebel/2007/03" 。

[BO] = Business 物件名稱;例如，帳戶。

[BC] = 商務元件名稱;例如，帳戶。

與父商務元件 MVG 欄位相關聯的子商務元件名稱;例如，帳戶父商務元件) 的連絡人 (。

當您在BizTalk Server解決方案中使用 Siebel 配接器或使用 Windows Communication Foundation (WCF) 通道模型時，您必須明確指定訊息動作。 如需詳細資訊，請參閱 開發 Siebel 應用程式。

Siebel Business Component WCF 用戶端方法

下表顯示新增配接器服務參考 Visual Studio 外掛程式 for Siebel 商務元件所產生的 WCF 服務模型方法簽章。

作業 WCF 服務模型方法
插入 string[] client.Insert([BC]InsertRecord[] ArrayOf[BC]InsertRecord);

[BC] = 商務元件的名稱;例如，帳戶。
查詢 [BC]QueryRecord[] client.Query(System.Nullable<short> ViewMode, [BC]QueryInputRecord [BC]QueryInputRecord);

[BC] = 商務元件的名稱，例如帳戶。
更新 string[] client.Update(System.Nullable<short> ViewMode, [BC]UpdateRecord[] ArrayOf[BC]UpdateRecord);

[BC] = 商務元件的名稱;例如，帳戶。
刪除 string[] client.Delete(System.Nullable<short> ViewMode, string[] Id, string SearchExpr);
副學士 ParentChildRecord client.Associate(System.Nullable<short> ViewMode, string ParentSearchExpr, string ParentMVGField, string ChildSearchExpr);
解除關聯 ParentChildRecord client.Dissociate(System.Nullable<short> ViewMode, string ParentSearchExpr, string ParentMVGField, string ChildSearchExpr);
Query_[MVG Child Business Comp] [CHILD_BC]QueryRecord[] client.Query_[CHILD_BC](../../core/system.md ViewModeshort ViewMode, string ParentSearchExpr, string ParentMVGField, [CHILD_BC]QueryInputRecord [CHILD_BC]QueryInputRecord);

[CHILD_BC] = 與父商務元件 MVG 欄位相關聯的子商務元件名稱;例如，針對帳戶父商務元件) 連絡 (。

另請參閱

BizTalk Adapter for Siebel eBusiness 應用程式的訊息和訊息架構