OrgEntityUpdate URL

This command updates information about an organization or organizational unit.

This command updates information about an organization or organizational unit. Information for the organizations or organizational units are stored in the MEMBER, ORGENTITY, MBRREL, andADDRESS ADDRBOOK database tables.

Use this command with SSL (Secure Sockets Layer) to ensure that the information is encrypted. To do so type the command with the HTTPS secure protocol.

URL 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.
Note: If orgEntityId parameter is not specified, OrgEntityAdd command is called to add a new organization or organizational unit. If you are not including the org entity, ensure that you add all of the required parameters for the OrgEntityAdd command. For example, the orgEntityType parameter is a required parameter for the OrgEntityAdd command.
orgEntityName
The name of the organization or organizational unit.
administratorFirstName
The given name of the administrator.
administratorLastName
The surname of the administrator.
administratorMiddleName
The middle name of the administrator.
businessCategory
Describes the kind of business that is performed by an organization or organizational unit.
description
A description of the registrant.
legalId
Registered organization identifier; might 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 through 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 can be of different types. If a properties file cannot be found, a default of SB is 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 that is used for the billing code. The default value is D, assigned by buyer.
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 email or Web address.
email2
The registrant's secondary email or Web address.
fax1
The registrant's primary facsimile number.
fax2
The registrant's secondary facsimile number.
firstName
The given name of the registrant.
lastName
Required if the authentication mode is LDAP: The surname 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 that is 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 that is 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.
preferredDelivery
The registrant's preferred mode of delivery.
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.
Custom member attributes
You can manage custom member attributes (MBRATTRVAL table) for this organization by using the following syntax: &attributeName_storeId_action_number=value

Where:

attributeName
The name of the custom attribute that is already defined in the NAME column of the MBRATTR table.
storeId
The store ID of the store for which the attributeName applies. Specify "null" if the attribute is not store specific.
action
Specifies the action to perform with the value:
a
add value
r
replace value
d
delete value
number
In the case of multi-valued attributeNames, specify this parameter to assign multiple entries with the same attributeName, storeId, or action.
value
The value that you want to assign to the attribute.

The following are examples of syntax for customer attributes or parameters:

  • The following example adds a custom attribute named "OrgEntitySize" with the value of "100". It is not store specific, so the "storeId" attribute is set to "null":
    &OrgEntitySize_null_a_1=500
  • The following example updates two custom attributes named "OrgEntityOwners" with the values of "Smith" and "Brown", for store 10001.
    &OrgEntityOwners_10001_r_1=Smith&OrgEntityOwners_10001_r_2=Brown

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 extra 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 is marked as 'T' (temporary) and a new record is 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.