Esquemas de mensaje para las operaciones de componentes empresariales

Esquemas de mensajes para operaciones de componentes empresariales de Siebel

En la tabla siguiente se enumeran los esquemas de mensaje para las operaciones expuestas por el adaptador de Siebel en los componentes empresariales de Siebel.

Operación	Estructura XML	Descripción
Insertar	Insertar mensaje: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [FIELD1_NAME] = Nombre del campo de componente de negocio; por ejemplo, Account_x0020_Status. Insertar mensaje de respuesta: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03" [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [ID] = Id. de registro; por ejemplo, 42-6ODBL.	Inserta uno o varios registros en un componente empresarial. La respuesta contiene los identificadores de registro de todos los registros insertados. Si al menos una inserción se realiza correctamente, no se produce ninguna excepción y la respuesta contendrá los identificadores de los registros insertados correctamente. Sin embargo, si se produce un error en todas las inserciones, se producirá una excepción (XmlReaderParsingException o TargetSystemException).
Consultar	Mensaje de consulta: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [View_mode] = Modo de vista que se va a aplicar. Se trata de un parámetro opcional. Consulte la documentación de Siebel para obtener una explicación de los valores posibles. [Search_expr] = Expresión de búsqueda de Siebel; por ejemplo, [Name] LIKE "3Com*". [Sort_spec] = Especificación de ordenación de Siebel; por ejemplo, Name (DESC), Location. [FIELD1_NAME] = Nombre del campo de componente de negocio; por ejemplo, Estado de la cuenta. Mensaje de respuesta de consulta: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [FIELD1_NAME] = Nombre del campo de componente de negocio; por ejemplo, Account_x0020_Status.	Consulta uno o varios registros del componente empresarial de destino. La operación Query toma los parámetros siguientes: <SearchExpr> Todos los registros del componente empresarial de destino se comparan con la expresión de búsqueda y se devuelven los registros coincidentes. <SortSpec> La especificación de ordenación determina el orden en el que se devuelven los registros que coinciden con la expresión de búsqueda. Este parámetro es opcional. <QueryFields> Una lista de nombres de campo que especifica los campos del componente empresarial de destino que debe recuperar la operación de consulta. Solo se devuelven los campos de esta lista en cada registro. Cada campo debe especificarse utilizando el nombre original del campo en el componente de negocio, no el nombre codificado en XML; por ejemplo, "First Name" en lugar de "First_x0032_Name". Este parámetro es opcional. Si no se especifican campos de consulta, se devuelven todos los campos.
Actualizar	Mensaje de actualización: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [View_mode] = Modo de vista que se va a aplicar al consultar los registros que deben actualizarse. Se trata de un parámetro opcional. Consulte la documentación de Siebel para obtener una explicación de los valores posibles. [FIELD1_NAME] = Nombre del campo de componente de negocio; por ejemplo, Account_x0020_Status. [Record_ID] = Id. de registro de un registro que se va a actualizar; por ejemplo, 42-60DBL. Mensaje de respuesta de actualización: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [ID] = Id. de registro; por ejemplo, 42-6ODBL.	Actualice uno o varios registros especificados por una lista de registros de actualización. Cada registro de actualización contiene una lista de los campos que se van a actualizar y un único elemento Id> obligatorio <que identifica el registro que se va a actualizar. La respuesta contiene una lista de los identificadores de registro de todos los registros actualizados. Si al menos una actualización se realiza correctamente, no se produce ninguna excepción y la respuesta contendrá los identificadores de los registros actualizados correctamente. Sin embargo, si se produce un error en todas las actualizaciones, se producirá una excepción (XmlReaderParsingException o TargetSystemException).
Eliminar	Eliminar mensaje: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [View_mode] = Modo de vista que se va a aplicar al consultar los registros que deben eliminarse. Se trata de un parámetro opcional. Consulte la documentación de Siebel para obtener una explicación de los valores posibles. [ID] = Id. de registro; por ejemplo, 42-6ODBL. Search_expr = Expresión de búsqueda de Siebel; por ejemplo, [Name] LIKE "3Com*". Eliminar mensaje de respuesta <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [ID] = Id. de registro; por ejemplo, 42-6ODBL.	Elimine uno o varios registros que coincidan con un conjunto de identificadores de registro o una expresión de búsqueda. Importante: La operación Delete toma una expresión de búsqueda o un conjunto de identificadores de registro. No se pueden especificar ambos parámetros en la misma operación Delete. La respuesta contiene una lista de los identificadores de registro de todas las filas eliminadas. Si al menos una eliminación se realiza correctamente, no se produce ninguna excepción y la respuesta contendrá los identificadores de los registros eliminados correctamente. Sin embargo, si se produce un error en todas las eliminaciones, se producirá una excepción (XmlReaderParsingException o TargetSystemException).
Asociado	Mensaje asociado: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [View_mode] = Modo de vista que se va a aplicar a la consulta de los registros de componentes empresariales primarios y secundarios. Si se especifica un valor, ese valor se aplicará a la búsqueda primaria y a la búsqueda secundaria. Es un argumento opcional. Para obtener una explicación de los valores posibles, consulte la documentación de Siebel. [Par_search] = Expresión de búsqueda que coincide exactamente con un registro de componente de negocio primario; por ejemplo, [Id] LIKE AB-12345. [Chld_search] = Expresión de búsqueda que coincide exactamente con un registro de componente de negocio secundario que se asociará con el registro de componente de negocio primario; por ejemplo, [Id] LIKE CD-12345. [Field_name] = Nombre de campo de grupo de varios valores del componente de negocio primario; por ejemplo, "Facturar a nombre" en el componente de negocio Cuenta. Mensaje de respuesta asociado: <AssociateResponse xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <AssociateResult> <ChildID>[CHILD_ID]</ChildID> <ParentID>[PARENT_ID]</ParentID> </AssociateResult> </AssociateResponse> [VERSION] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [CHILD_ID] = Id. de registro secundario; por ejemplo, 42-6ODBL. [PARENT_ID] = Id. de registro primario; por ejemplo, 42-6ODBL.	La operación Associate solo se muestra para los componentes empresariales con campos de grupo de varios valores (MVG). Asocia registros especificando expresiones de búsqueda para los registros primarios y secundarios. La operación Associate: - Asocia un registro de componente de negocio primario seleccionado con un registro de componente de negocio secundario seleccionado. - Establece una asociación 1:1. un registro primario se asociará a un registro secundario - Se deben crear varias asociaciones 1:1 para una asociación 1:N y se deben crear varias asociaciones 1:N para una asociación M:N Tenga en cuenta lo siguiente: La expresión de búsqueda primaria debe coincidir con un registro único en la tabla primaria. La expresión de búsqueda secundaria debe coincidir con un registro único en la tabla secundaria. El valor devuelto contiene el identificador de registro de la fila secundaria asociada y el identificador de registro de la fila primaria asociada. Si la expresión de búsqueda primaria o la expresión de búsqueda secundaria devuelve más de un registro coincidente, se producirá una excepción.
Disociar	Desasociar mensaje: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [View_mode] = Modo de vista que se va a aplicar a la consulta de los registros de componentes empresariales primarios y secundarios. Si se especifica un valor, ese valor se aplicará a la búsqueda primaria y a la búsqueda secundaria. Es un argumento opcional. Para obtener una explicación de los valores permitidos, consulte la documentación de Siebel. [Par_search] = Expresión de búsqueda que coincide exactamente con un registro de componente de negocio primario; por ejemplo, [Id] LIKE AB-12345. [Chld_search] = Expresión de búsqueda que coincida exactamente con un registro de componente de negocio secundario que se desasociará con el registro del componente de negocio primario; por ejemplo, [Id] LIKE CD-12345. [Field_name] = nombredecampo de grupo de varios valores del componente empresarial primario; por ejemplo, "Facturar a nombre" en el componente de negocio Cuenta. Mensaje de respuesta desasociación: <DissociateResponse xmlns="[VERSION]/BusinessObjects/[BO]/[BC]/Operation"> <DissociateResult> <ChildID>[CHILD_ID]</ChildID> <ParentID>[PARENT_ID]</ParentID> </DissociateResult> </DisocciateResponse> [VERSION] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [CHILD_ID] = Id. de registro secundario; por ejemplo, 42-6ODBL. [PARENT_ID] = Id. de registro primario; por ejemplo, 42-6ODBL.	La operación Desasociar solo se muestra para los componentes empresariales con campos de grupo de varios valores (MVG). Desasocia los registros especificando expresiones de búsqueda para los registros primarios y secundarios. La operación Desasociar: Desasocia un registro de componente de negocio primario seleccionado con un registro de componente de negocio secundario seleccionado Establece una desasociación 1:1. un registro primario se desasociará con un registro secundario Se deben realizar varias desasociaciones 1:1 para una desasociación 1:N y se deben realizar varias desasociaciones 1:N para una desasociación M:N Tenga en cuenta que la expresión de búsqueda secundaria debe coincidir con un registro único entre los registros asociados con los registros primarios que coinciden con la expresión de búsqueda primaria. Importante: Hay una diferencia en la expresión de búsqueda secundaria para las operaciones ASSOCIATE y DISSOCIATE. En una operación ASSOCIATE, la expresión de búsqueda secundaria busca en todos los registros del componente empresarial secundario. En una operación DISSOCIATE, la expresión de búsqueda secundaria busca solo los registros del componente empresarial secundario que están asociados a los registros del componente de negocio primario, donde los registros primarios coinciden con la expresión de búsqueda primaria. El valor devuelto contiene el identificador de registro del registro secundario desasociado y el identificador de registro del registro primario desasociado. Si la expresión de búsqueda primaria o la expresión de búsqueda secundaria devuelve más de un registro coincidente, se producirá una excepción.
Query_[MVG_Child_Business_Comp]	Query_[MVG_Child_Business_Comp] mensaje: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [View_mode] = Modo de vista que se va a aplicar; puede ser de 0 a 9. Se trata de un parámetro opcional. Consulte la documentación de Siebel para obtener una explicación de estos valores posibles. [CHILD_BC] = Nombre del componente de negocio secundario asociado al campo MVG del componente de negocio primario; por ejemplo, Contacto (para el componente de negocio principal de la cuenta). [Par_search] = Expresión de búsqueda que coincide con 1 registro de componente de negocio primario; por ejemplo, [Id] LIKE AB-12345. [Field_name] = nombrecampo de grupo de varios valores del componente de negocio primario; por ejemplo, "Facturar a nombre" en el componente de negocio Cuenta. [Chld_search] = Expresión de búsqueda que coincide con 1 o más registros de componentes empresariales secundarios; por ejemplo, [Id] LIKE CD-12345. [field1], [field2], and so on = Query fields in the child business component. Lista de nombres de campo que especifica los campos del componente empresarial secundario que debe recuperar la operación. Solo se devuelven los campos de esta lista en cada registro. Cada campo debe especificarse utilizando el nombre original del campo en el componente empresarial secundario, no el nombre codificado XML; por ejemplo, "First Name" en lugar de "First_x0032_Name". Este parámetro es opcional. Query_[MVG_Child_Business_Comp] mensaje de respuesta: <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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03". [BO] = Nombre del objeto de negocio; por ejemplo, Account. [BC] = Nombre del componente de negocio; por ejemplo, Account. [FIELD1_NAME] = nombre del campo de componente de negocio; por ejemplo, Account_x0020_Status. [CHILD_BC] = Nombre del componente de negocio secundario asociado al campo MVG del componente de negocio primario; por ejemplo, Contacto (para el componente de negocio principal de la cuenta).	Esta operación se expone para los componentes empresariales con campos MVG. Consulta los registros secundarios asociados a un registro primario asociado a un campo MVG en el componente de negocio primario.

Acciones de mensaje para operaciones de componentes empresariales de Siebel

En la tabla siguiente se muestra la acción SOAP para cada una de las operaciones de componente de negocio de Siebel. Solo se muestran las acciones de los mensajes de solicitud, la acción del mensaje de respuesta se forma anexando "/response" a la acción del mensaje de solicitud; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert/response".

Operación	Acción	Ejemplo
Insertar	[VERSION]/BusinessObjects/[BO]/[BC]/Insert	http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert
Consultar	[VERSION]/BusinessObjects/[BO]/[BC]/Query	http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Query
Actualizar	[VERSION]/BusinessObjects/[BO]/[BC]/Update	http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Update
Eliminar	[VERSION]/BusinessObjects/[BO]/[BC]/Delete	http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Delete
Asociado	[VERSION]/BusinessObjects/[BO]/[BC]/Associate	http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Associate
Disociar	[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] = La cadena de versión del mensaje; por ejemplo, "http://Microsoft.LobServices.Siebel/2007/03".

[BO] = Nombre del objeto de negocio; por ejemplo, Account.

[BC] = Nombre del componente empresarial; por ejemplo, Account.

Nombre del componente de negocio secundario asociado al campo MVG del componente de negocio primario; por ejemplo, Contacto (para el componente de negocio principal de la cuenta).

Debe especificar explícitamente la acción de mensaje al consumir el adaptador de Siebel en una solución de BizTalk Server o mediante el modelo de canal de Windows Communication Foundation (WCF). Para obtener más información, consulte Desarrollo de aplicaciones de Siebel.

Métodos de cliente de WCF del componente empresarial Siebel

En la tabla siguiente se muestran las firmas del método del modelo de servicio WCF generadas por el complemento Agregar referencia de servicio de adaptador de Visual Studio para componentes empresariales de Siebel.

Operación	WcF Service Model (método)
Insertar	string[] client.Insert([BC]InsertRecord[] ArrayOf[BC]InsertRecord); [BC] = Nombre del componente de negocio; por ejemplo, Account.
Consultar	[BC]QueryRecord[] client.Query(System.Nullable<short> ViewMode, [BC]QueryInputRecord [BC]QueryInputRecord); [BC] = Nombre del componente empresarial, por ejemplo, Cuenta.
Actualizar	string[] client.Update(System.Nullable<short> ViewMode, [BC]UpdateRecord[] ArrayOf[BC]UpdateRecord); [BC] = Nombre del componente de negocio; por ejemplo, Account.
Eliminar	string[] client.Delete(System.Nullable<short> ViewMode, string[] Id, string SearchExpr);
Asociado	ParentChildRecord client.Associate(System.Nullable<short> ViewMode, string ParentSearchExpr, string ParentMVGField, string ChildSearchExpr);
Disociar	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] = Nombre del componente de negocio secundario asociado al campo MVG del componente de negocio primario; por ejemplo, Contacto (para el componente de negocio principal de la cuenta).

Consulte también

Mensajes y esquemas de mensajes para el adaptador de BizTalk para aplicaciones de siebel eBusiness