Create/Update Organization

The CreateOrganization outbound service interface is used to notify an external system of the creation or registration of an organization, whereas the UpdateOrganization outbound service interface is used to notify an external system of the update of an organization.

 

Request

Request to the CreateOrganization outbound service interface is in the form of a SyncOrganization business object document (BOD) with action code Create. Request to the UpdateOrganization outbound service interface is in the form of a SyncOrganization BOD with action code Update. The definition of the SyncOrganization BOD can be found in the XML schema file WC_eardir/WebServicesRouter.war/xsd/OAGIS/9.0/Overlays/IBM/Commerce/BODs/SyncOrganization.xsd. The service data object (SDO) interface of the SyncOrganization BOD is com.ibm.commerce.member.datatypes.SyncOrganizationType.

 

Response

Response to a successful request is in the form of a ConfirmBOD BOD. The XML schema of the ConfirmBOD BOD can be found in the XML schema file WC_eardir/WebServicesRouter.war/xsd/OAGIS/9.0/BODs/Developer/ConfirmBOD.xsd. The service data object (SDO) interface of the ConfirmBOD BOD is com.ibm.commerce.oagis9.datatypes.ConfirmBODType.

 

Message type

The CreateOrganization outbound service interface is mapped to the message type com.ibm.commerce.member.CreateOrganization, or com.ibm.commerce.member if the former is not defined. The UpdateOrganization outbound service interface is mapped to the message type com.ibm.commerce.member.UpdateOrganization, or com.ibm.commerce.member if the former is not defined.

 

Client task command

These outbound service interfaces can be invoked by calling the order client task command com.ibm.commerce.member.client.commands.SyncOrganizationCmd with action CreateOrganization or UpdateOrganization. Its default implementation, com.ibm.commerce.member.client.commands.SyncOrganizationCmdImpl , behaves as follows:

 

Usage scenarios

 

Register organization

  1. When an organization registration is approved, the command com.ibm.commerce.usermanagement.commands.OrgEntityRegistrationAddPostApprovalCmd is called.

  2. The service-oriented integration (SOI)-specific implementation of this command, com.ibm.commerce.soi.commands.SOIOrgEntityRegistrationAddPostApprovalCmdImpl , calls the member client task command com.ibm.commerce.member.client.commands.SyncOrganizationCmd with action CreateOrganization to notify the external system of the organization registration.

 

Create organization

  1. When an organization is created by either a shopper or customer service representative (CSR), the command com.ibm.commerce.usermanagement.commands.OrgEntityAddCmd is called.

  2. At the end of its execution, this command calls the command com.ibm.commerce.usermanagement.commands.PostOrgEntityAddCmd to perform additional actions.

  3. The SOI-specific implementation of this command, com.ibm.commerce.soi.commands.SOIPostOrgEntityAddCmdImpl , calls the member client task command com.ibm.commerce.member.client.commands.SyncOrganizationCmd with action CreateOrganization to notify the external system of the organization creation.

 

Update organization

  1. When an organization is updated by a user, the command com.ibm.commerce.usermanagement.commands.OrgEntityUpdateCmd is called.

  2. At the end of its execution, this command calls the command com.ibm.commerce.usermanagement.commands.PostOrgEntityUpdateCmd to perform additional actions.

  3. The SOI-specific implementation of this command, com.ibm.commerce.soi.commands.SOIPostOrgEntityAddCmdImpl , calls the member client task command com.ibm.commerce.member.client.commands.SyncOrganizationCmd with action UpdateOrganization to notify the external system of the organization update.

Related concepts

WebSphere Commerce Web services with JSP pages

WebSphere Commerce as a service consumer

Related tasks

Enabling WebSphere Commerce as a service consumer

Related reference

Outbound service interfaces

Service-oriented outbound integration points