OrgEntityUpdate command
This command updates information about an organization or organizational
unit. Information for the organizations or organizational units are stored in
the MEMBER,
ORGENTITY,
MBRREL, and
ADDRESS database tables.
Use this command with SSL (Secure Sockets Layer) to ensure that the
information are encrypted. To do so type the command with the HTTPS secure
protocol.
Command structure
- http://host_name/path/
- The fully qualified name of your WebSphere Commerce Server and the
configuration path.

Parameter values
- URL (Required)
- The URL to be called when the command completes successfully.
- orgEntityId (Required)
- The ID for this organization or organizational unit; a foreign key to the
MEMBER table.
- orgEntityName
- The name of the organization or organizational unit.
- administratorFirstName
- The first name of the administrator.
- administratorLastName
- The last name of the administrator.
- administratorMiddleName
- The middle name of the administrator.
- businessCategory
- Describes the kind of business performed by an organization or
organizational unit.
- description
- A description of the registrant.
- legalId
- Registered organization identifier; may be null for an organizational
unit.
- orgEntityField1 through orgEntityField3
- Customizable fields.
- taxPayerId
- The ID for the tax payer as specified in the ORGENTITY table.
- address1 thtough address3
- The registrant's street address, to a maximum of three lines of
information.
- addressField1 through addressField3
- Customizable fields.
- addressType
- Type of address, valid values
are configurable by using a properties file: S (shipto), B (billto), and SB
(both shipto and billto). A single address may be of different types. If a
properties file cannot be found, a default of SB will be used.
- bestCallingTime
- D=An indicator that daytime is the best time to call
the registrant.
- E=An indicator that evening is the best time to call
the registrant.
- billingCode
- The registrant's organization's code to identify the shipping or billing
addresses and cost center.
- billingCodeType
- Code designating the method of code structure used for the billing code.
The default value is D, assigned by buyer. The value 02 indicates that it is
assigned by Ariba.
- city
- The name of the city where the registrant resides.
- country
- The name of the country or region where the registrant resides.
- email1
- The registrant's primary e-mail or Web address.
- email2
- The registrant's secondary e-mail or Web address.
- fax1
- The registrant's primary facsimile number.
- fax2
- The registrant's secondary facsimile number.
- firstName
- The first name of the registrant.
- lastName
- (Required if the authentication mode is LDAP) The last name of the
registrant. If the authentication mode is LDAP, this parameter is mandatory.
- middleName
- The middle name of the registrant.
- organizationName
- The name of the organization that the registrant represents.
- organizationUnitName
- The name of the unit within the organization that the registrant
represents.
- packageSuppression
- 1=An indicator to include package inserts when the
order is shipped
- 0=An indicator to not include package inserts when the
order is shipped
There is no default for this field. If the field is left unused, it
remains null in the database.
- personTitle
- The title of the user whose address is being entered (for example, Dr.,
Rev., Mr. or Ms.).
- phone1
- The registrant's primary phone number.
- phone1Type
- The type of phone used for the registrant's primary phone number, for
example TTY for hearing impaired, PCM for pulse-coded modulation, or CEL for
mobile. This is a field of 3 characters.
- phone2
- The registrant's secondary phone number.
- phone2Type
- The type of phone used for the registrant's secondary phone number, for
example TTY for hearing impaired, PCM for pulse-coded modulation, or CEL for
mobile. This is a field of 3 characters.
- publishPhone1
- 1=An indicator that the registrant's primary phone
number is listed
- 0=An indicator that the registrant's primary phone
number is unlisted
There is no default for these publishPhone fields. If the field is
left unused, it remains null in the database.
- publishPhone2
- 1=An indicator that the registrant's secondary phone
number is listed
- 0=An indicator that the registrant's secondary phone
number is unlisted
- shippingGeoCode
- A shipping code based on geographical region, especially useful with tax
software.
- state
- The name of the state, province, or equivalent where the registrant
resides.
- taxGeoCode
- A tax code based on geographical region, especially useful with tax
software.
- zipCode
- The ZIP or postal code of the registrant's address.
Example
The following example updates the legal ID of an organization for an
organization with an entity ID of 7000000000000000001.
https://myhostname/webapp/wcs/stores/servlet/OrgEntityUpdate?
orgEntityId=7000000000000000001&legalId=newlegalId&URL=OrgEntityManageForm
Behavior
- Calls an empty task command called
PreOrgEntityUpdateCmd. Store Developers can overwrite it to change the
input to the command.
- Checks the required parameters.
- Calls the
AuditAddressCmd task command to perform additional parameter checking.
Store Developers need to add new code to the AuditAddressCmd task command if
they want to customize the check.
- If any field related to the ADDRESS table is specified, the self address
(also called a register address, with the selfAddress field set to '1' and the
nickname is the same as the logonId) will also be updated. The old address
will be marked as 'T' (temporary) and a new record will be created in the
ADDRESS table.
- If the command fails, the OrgEntityErrorView view command is called. Upon
successful completion, the specified URL is called.
Exception conditions
- If the URL parameter is null, the system throws an exception with the
message key _ERR_CMD_MISSING_PARAM
- If the length of the value of the URL parameter equals 0, the system
throws an exception with the message key _ERR_CMD_INVALID_PARAM.
- If the orgEntityId parameter is null, the system throws an exception with
the message key _ERR_CMD_MISSING_PARAM.
- If the orgEntityId parameter is not a foreign key set to the ORGENTITY
table, the system throws an exception with the message key
_ERR_CMD_INVALID_PARAM.
- If the orgEntityName parameter is null, the system throws an exception
with the message key _ERR_CMD_MISSING_PARAM.
- If the orgEntityName parameter is not null but the its length equals 0,
the system throws an exception with the message key _ERR_CMD_INVALID_PARAM.

© Copyright IBM Corporation 1996, 2003. All Rights Reserved.