Schemi di messaggio per le operazioni del componente business
Schemi di messaggio per operazioni del componente business Siebel
Nella tabella seguente sono elencati gli schemi dei messaggi per le operazioni esposte dall'adapter Siebel nei componenti aziendali Siebel.
| Operazione | Struttura XML | Descrizione |
|---|---|---|
| Insert | Inserisci messaggio:<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] = Stringa di versione del messaggio; ad esempio . "http://Microsoft.LobServices.Siebel/2007/03"[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente aziendale; Ad esempio, Account. [FIELD1_NAME] = Nome campo componente business; ad esempio, Account_x0020_Status. Inserisci messaggio di risposta: <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] = Stringa di versione del messaggio; Per esempio "http://Microsoft.LobServices.Siebel/2007/03"[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente aziendale; Ad esempio, Account. [ID] = ID record; ad esempio 42-6ODBL. |
Inserisce uno o più record in un componente aziendale. La risposta contiene gli ID record di tutti i record inseriti. Se almeno un inserimento ha esito positivo, non viene generata alcuna eccezione e la risposta conterrà gli ID dei record inseriti correttamente. Tuttavia, se tutti gli inserimenti hanno esito negativo, verrà generata un'eccezione (XmlReaderParsingException o TargetSystemException). |
| Query | Messaggio di query:<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] = Stringa di versione del messaggio; ad esempio . "http://Microsoft.LobServices.Siebel/2007/03"[View_mode] = Modalità di visualizzazione da applicare. Questo parametro è facoltativo. Per una spiegazione dei possibili valori, vedere la documentazione di Siebel. [Search_expr] = Espressione di ricerca Siebel; ad esempio [Name] LIKE "3Com*". [Sort_spec] = Specifica di ordinamento Siebel; Ad esempio, Name (DESC), Location. [FIELD1_NAME] = Nome campo componente business; Ad esempio, Stato account. Messaggio di risposta della query: <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] = Stringa di versione del messaggio; ad esempio . "http://Microsoft.LobServices.Siebel/2007/03"[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente aziendale; Ad esempio, Account. [FIELD1_NAME] = Nome campo componente business; ad esempio, Account_x0020_Status. |
Esegue una query su uno o più record dal componente business di destinazione. L'operazione query accetta i parametri seguenti: <> Vengono restituiti tutti i record nel componente business di destinazione rispetto all'espressione di ricerca e ai record corrispondenti. <SortSpec> La specifica di ordinamento determina l'ordine in cui vengono restituiti i record che corrispondono all'espressione di ricerca. Questo parametro è facoltativo e, <QueryFields> Elenco di nomi di campo che specifica i campi nel componente business di destinazione che devono essere recuperati dall'operazione di query. In ogni record vengono restituiti solo i campi di questo elenco. Ogni campo deve essere specificato utilizzando il nome originale del campo nel componente business, non il nome con codifica XML; Ad esempio, "First Name" invece di "First_x0032_Name". Questo parametro è facoltativo e, Se i campi di query non vengono specificati, vengono restituiti tutti i campi. |
| Aggiornamento | Messaggio di aggiornamento:<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] = Stringa di versione del messaggio; ad esempio . "http://Microsoft.LobServices.Siebel/2007/03"[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente aziendale; Ad esempio, Account. [View_mode] = Modalità di visualizzazione da applicare quando si eseguono query sui record che devono essere aggiornati. Questo parametro è facoltativo. Per una spiegazione dei possibili valori, vedere la documentazione di Siebel. [FIELD1_NAME] = Nome campo componente business; ad esempio, Account_x0020_Status. [Record_ID] = ID record di un record da aggiornare; ad esempio 42-60DBL. Aggiornare il messaggio di risposta: <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] = Stringa di versione del messaggio; ad esempio . "http://Microsoft.LobServices.Siebel/2007/03"[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente aziendale; Ad esempio, Account. [ID] = ID record; ad esempio 42-6ODBL. |
Aggiornare uno o più record specificati da un elenco di record di aggiornamento. Ogni record di aggiornamento contiene un elenco dei campi da aggiornare e un singolo elemento ID> obbligatorio <che identifica il record da aggiornare. La risposta contiene un elenco degli ID record di tutti i record aggiornati. Se almeno un aggiornamento ha esito positivo, non viene generata alcuna eccezione e la risposta conterrà gli ID dei record aggiornati correttamente. Tuttavia, se tutti gli aggiornamenti hanno esito negativo, verrà generata un'eccezione (XmlReaderParsingException o TargetSystemException). |
| Delete | Elimina messaggio:<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] = Stringa di versione del messaggio; ad esempio . "http://Microsoft.LobServices.Siebel/2007/03"[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente aziendale; Ad esempio, Account. [View_mode] = Modalità di visualizzazione da applicare quando si eseguono query sui record da eliminare. Questo parametro è facoltativo. Per una spiegazione dei possibili valori, vedere la documentazione di Siebel. [ID] = ID record; ad esempio 42-6ODBL. Search_expr = Espressione di ricerca Siebel; ad esempio [Name] LIKE "3Com*". Eliminare il messaggio di risposta <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] = Stringa di versione del messaggio; ad esempio . "http://Microsoft.LobServices.Siebel/2007/03"[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente aziendale; Ad esempio, Account. [ID] = ID record; ad esempio 42-6ODBL. |
Eliminare uno o più record corrispondenti a un set di ID record o a un'espressione di ricerca. Importante: L'operazione Delete accetta un'espressione di ricerca o un set di ID record. Non è possibile specificare entrambi i parametri nella stessa operazione di eliminazione. La risposta contiene un elenco degli ID record di tutte le righe eliminate. Se almeno un'eliminazione ha esito positivo, non viene generata alcuna eccezione e la risposta conterrà gli ID dei record eliminati correttamente. Tuttavia, se tutte le eliminazioni hanno esito negativo, verrà generata un'eccezione (XmlReaderParsingException o TargetSystemException). |
| Associate | Messaggio di associazione:<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] = Stringa di versione del messaggio; ad esempio . "http://Microsoft.LobServices.Siebel/2007/03"[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente aziendale; Ad esempio, Account. [View_mode] = Modalità di visualizzazione da applicare alla query per i record dei componenti aziendali padre e figlio. Se viene specificato un valore, tale valore verrà applicato sia alla ricerca padre che alla ricerca figlio. Si tratta di un argomento facoltativo. Per una spiegazione dei valori possibili, vedere la documentazione di Siebel. [Par_search] = Espressione di ricerca che corrisponde esattamente a un record del componente aziendale padre; ad esempio[Id] LIKE AB-12345. [Chld_search] = Espressione di ricerca che corrisponde esattamente a un record di componente aziendale figlio che verrà associato al record del componente aziendale padre; ad esempio [Id] LIKE CD-12345. [Field_name] = Nome del campo gruppo multivalore del componente aziendale padre; Ad esempio, "Bill To First Name" nel componente Account business. Associare il messaggio di risposta: <AssociateResponse xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <AssociateResult> <ChildID>[CHILD_ID]</ChildID> <ParentID>[PARENT_ID]</ParentID> </AssociateResult> </AssociateResponse>[VERSION] = Stringa di versione del messaggio; ad esempio , "http://Microsoft.LobServices.Siebel/2007/03".[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente business; Ad esempio, Account. [CHILD_ID] = ID record figlio; ad esempio, 42-6ODBL. [PARENT_ID] = ID record padre; ad esempio, 42-6ODBL. |
L'operazione Associa viene visualizzata solo per i componenti aziendali con campi MVG (multivalore). Associa i record specificando espressioni di ricerca per i record padre e figlio. Operazione Di associazione: - Associa un record del componente aziendale padre selezionato a un record del componente aziendale figlio selezionato - Stabilisce un'associazione 1:1. un record padre verrà associato a un record figlio - Più associazioni 1:1 devono essere effettuate per un'associazione 1:N e più associazioni 1:N devono essere effettuate per un'associazione M:N Nota bene: L'espressione di ricerca padre deve corrispondere a un record univoco nella tabella padre. L'espressione di ricerca figlio deve corrispondere a un record univoco nella tabella figlio. Il valore restituito contiene l'ID record della riga figlio associata e l'ID record della riga padre associata. Se l'espressione di ricerca padre o l'espressione di ricerca figlio restituisce più di un record corrispondente, verrà generata un'eccezione. |
| Dissociare | Messaggio di dissociazione:<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] = Stringa di versione del messaggio; ad esempio , "http://Microsoft.LobServices.Siebel/2007/03".[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente business; Ad esempio, Account. [View_mode] = Modalità di visualizzazione da applicare alla query per i record dei componenti padre e figlio. Se viene specificato un valore, tale valore verrà applicato sia alla ricerca padre che alla ricerca figlio. Si tratta di un argomento facoltativo. Per una spiegazione dei valori consentiti, vedere la documentazione di Siebel. [Par_search] = Espressione di ricerca corrispondente esattamente a un record del componente aziendale padre; ad esempio[ID] LIKE AB-12345. [Chld_search] = Espressione di ricerca corrispondente esattamente a un record del componente aziendale figlio che verrà dissociato con il record del componente aziendale padre; ad esempio [ID] LIKE CD-12345. [Field_name] = Nome campo gruppo multivalore del componente business padre; Ad esempio, "Bill To First Name" nel componente Account business. Messaggio di risposta dissociato: <DissociateResponse xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <DissociateResult> <ChildID>[CHILD_ID]</ChildID> <ParentID>[PARENT_ID]</ParentID> </DissociateResult> </DisocciateResponse>[VERSION] = Stringa di versione del messaggio; ad esempio , "http://Microsoft.LobServices.Siebel/2007/03".[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente business; Ad esempio, Account. [CHILD_ID] = ID record figlio; ad esempio, 42-6ODBL. [PARENT_ID] = ID record padre; ad esempio, 42-6ODBL. |
L'operazione di dissociazione viene visualizzata solo per i componenti aziendali con campi MVG (multivalore). Separa i record specificando espressioni di ricerca per i record padre e figlio. Operazione di dissociazione: Dissocia un record del componente aziendale padre selezionato con un record del componente aziendale figlio selezionato Stabilisce una dissociazione 1:1. un record padre verrà dissociato con un record figlio È necessario effettuare più dissociazioni 1:1 per una dissociazione 1:N e più dissociazioni 1:N devono essere effettuate per una dissociazione M:N Si noti che l'espressione di ricerca figlio deve corrispondere a un record univoco tra i record associati ai record padre che corrispondono all'espressione di ricerca padre. Importante: Esiste una differenza nell'espressione di ricerca figlio per le operazioni ASSOCIATE e DISSOCIATE. In un'operazione ASSOCIATE l'espressione di ricerca figlio cerca tutti i record nel componente business figlio. In un'operazione DISSOCIATE l'espressione di ricerca figlio cerca solo i record nel componente business figlio associati ai record nel componente business padre, in cui i record padre corrispondono all'espressione di ricerca padre. Il valore restituito contiene l'ID record del record figlio dissociato e l'ID record del record padre dissociato. Se l'espressione di ricerca padre o l'espressione di ricerca figlio restituisce più di un record corrispondente, verrà generata un'eccezione. |
| Query_[MVG_Child_Business_Comp] | Query_[MVG_Child_Business_Comp] messaggio:<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] = Stringa di versione del messaggio; ad esempio , "http://Microsoft.LobServices.Siebel/2007/03".[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente business; Ad esempio, Account. [View_mode] = Modalità di visualizzazione da applicare; può essere da 0 a 9. Questo parametro è facoltativo. Per una spiegazione di questi valori possibili, vedere la documentazione di Siebel. [CHILD_BC] = Nome del componente business figlio associato al campo MVG del componente aziendale padre; Ad esempio, Contact (per il componente Account padre business). [Par_search] = Espressione di ricerca corrispondente al record del componente aziendale padre 1; ad esempio[ID] LIKE AB-12345. [Field_name] = Nome campo gruppo multivalore del componente Business padre; Ad esempio, "Bill To First Name" nel componente Account business. [Chld_search] = Espressione di ricerca corrispondente a 1 o più record dei componenti aziendali figlio; ad esempio [ID] LIKE CD-12345. [field1], [field2]e così via = Campi di query nel componente business figlio. Elenco di nomi di campi che specifica i campi nel componente business figlio che devono essere recuperati dall'operazione. Solo i campi di questo elenco vengono restituiti in ogni record. Ogni campo deve essere specificato usando il nome originale del campo nel componente business figlio, non il nome codificato XML; Ad esempio, "Nome" anziché "First_x0032_Name". Questo parametro è facoltativo e, messaggio di risposta 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] = Stringa di versione del messaggio; ad esempio , "http://Microsoft.LobServices.Siebel/2007/03".[BO] = Nome dell'oggetto business; Ad esempio, Account. [BC] = Nome del componente business; Ad esempio, Account. [FIELD1_NAME] = nome del campo del componente aziendale; ad esempio, Account_x0020_Status. [CHILD_BC] = Nome del componente business figlio associato al campo MVG del componente aziendale padre; Ad esempio, Contact (per il componente Account padre business). |
Questa operazione viene esposta per i componenti aziendali con campi MVG. Esegue una query sui record figlio associati a un record padre associato a un campo MVG nel componente business padre. |
Azioni dei messaggi per operazioni del componente business Siebel
Nella tabella seguente viene illustrata l'azione SOAP per ogni operazione del componente business Siebel. Vengono visualizzate solo le azioni per i messaggi di richiesta, l'azione per il messaggio di risposta viene formata aggiungendo "/response" all'azione del messaggio di richiesta; ad esempio , "http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert/response".
| Operazione | Azione | Esempio |
|---|---|---|
| Insert | [VERSION]/BusinessObjects/[BO]/[BC]/Insert | http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert |
| Query | [VERSION]/BusinessObjects/[BO]/[BC]/Query | http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Query |
| Aggiornamento | [VERSION]/BusinessObjects/[BO]/[BC]/Update | http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Update |
| Delete | [VERSION]/BusinessObjects/[BO]/[BC]/Delete | http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Delete |
| Associate | [VERSION]/BusinessObjects/[BO]/[BC]/Associate | http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Associate |
| Dissociare | [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] = Stringa di versione del messaggio; ad esempio , "http://Microsoft.LobServices.Siebel/2007/03".
[BO] = Nome oggetto business; Ad esempio, Account.
[BC] = Nome componente business; Ad esempio, Account.
Nome del componente business figlio associato al campo MVG del componente aziendale padre; Ad esempio, Contact (per il componente Account padre business).
È necessario specificare in modo esplicito l'azione del messaggio quando si utilizza l'adattatore Siebel in una soluzione BizTalk Server o usando il modello di canale windows Communication Foundation (WCF). Per altre informazioni, vedere Sviluppare applicazioni Siebel.
Metodi client WCF del componente business Siebel
Nella tabella seguente vengono illustrate le firme del metodo del modello di servizio WCF generate dal plug-in di Visual Studio Add Adapter Service Reference per i componenti aziendali siebel.
| Operazione | Metodo del modello di servizio WCF |
|---|---|
| Insert | string[] client.Insert([BC]InsertRecord[] ArrayOf[BC]InsertRecord);[BC] = Nome del componente aziendale; Ad esempio, Account. |
| Query | [BC]QueryRecord[] client.Query(System.Nullable<short> ViewMode, [BC]QueryInputRecord [BC]QueryInputRecord);[BC] = Nome del componente aziendale, ad esempio Account. |
| Aggiornamento | string[] client.Update(System.Nullable<short> ViewMode, [BC]UpdateRecord[] ArrayOf[BC]UpdateRecord);[BC] = Nome del componente aziendale; Ad esempio, Account. |
| Delete | string[] client.Delete(System.Nullable<short> ViewMode, string[] Id, string SearchExpr); |
| Associate | ParentChildRecord client.Associate(System.Nullable<short> ViewMode, string ParentSearchExpr, string ParentMVGField, string ChildSearchExpr); |
| Dissociare | 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] = Nome del componente business figlio associato al campo MVG del componente aziendale padre; Ad esempio, Contact (per il componente Account padre business). |
Vedere anche
Messaggi e schemi di messaggio per l'adapter BizTalk per applicazioni Siebel eBusiness