Deprecated feature

URL OrgEntityAdd

Este mandato registra una nueva organización o unidad de organización.

Este mandato registra una nueva organización o unidad de organización. La información para las nuevas organizaciones o unidades de organización se almacena en las tablas de base de datos MEMBER, ORGENTITY, MBRREL y ADDRESS.

Utilice este mandato con SSL (Secure Sockets Layer) para asegurarse de que la información esté cifrada. Para ello, escriba el mandato con el protocolo seguro HTTPS.

Estructura de URL

http:// host_name/path/
El nombre completo de Transaction server y la vía de acceso de configuración.

Valores de parámetros

URL
Se necesita: El URL al que se debe llamar cuando el mandato se completa satisfactoriamente.
orgEntityName
Se necesita: El nombre de la organización o unidad de organización.
Los espacios iniciales y finales se eliminarán. Cuando el sistema está configurado con LDAP, los caracteres siguientes no están permitidos cuando orgEntityName se utiliza para construir el nombre distinguido:
  • El carácter # cuando aparece al principio de orgEntityName.
  • Cualquiera de los siguientes caracteres: = , + " \ < > ;
orgEntityType
Se necesita: El tipo de entidad de organización que se va a añadir.
O
Organización
OU
Unidad de organización
parentMemberId
Es necesario si orgEntityType es igual a 'OU': El ID de miembro de la entidad de organización padre donde se añadirá la nueva entidad de organización. Para una organización (orgEntityType=O), este parámetro no es obligatorio; por omisión, toma el valor de la organización raíz.
distinguishedName
DN de la organización o unidad de organización, para que lo utilice LDAP.
administratorFirstName
El nombre del administrador.
administratorLastName
El apellido del administrador.
administratorMiddleName
El segundo nombre del administrador.
businessCategory
Describe el tipo de actividad empresarial de la organización o unidad de organización.
descripción
Descripción del usuario que se registra.
legalId
Identificador de organización registrada; puede ser nulo para una unidad de organización.
orgEntityField1 a orgEntityField3
Campos personalizables.
taxPayerId
El ID para el contribuyente como se especifica en la tabla ORGENTITY.
address1 a address3
La dirección del usuario que se registra, hasta un máximo de tres líneas de información.
addressField1 hasta addressField3
Campos personalizables.
addressType
Tipo de dirección, los valores válidos se pueden configurar utilizando un archivo de propiedades: S (shipto), B (billto) y SB (shipto y billt) Una sola dirección puede ser de diferentes tipos. Si no se puede encontrar un archivo de propiedades, se utilizará el valor predeterminado SB.
bestCallingTime
D
Un indicador de que la mejor hora para llamar al usuario que se registra es durante el día.
E
Un indicador de que la mejor hora para llamar al usuario que se registra es durante la tarde.
billingCode
El código de la organización del usuario que se registra utilizado para identificar las direcciones de envío o facturación y el centro de costes.
billingCodeType
El código que designa el método de la estructura de código que se utiliza para el código de facturación. El valor predeterminado es D y lo asigna el comprador.
city
El nombre de la ciudad donde reside el usuario que se registra.
country
El nombre del país o región donde reside el usuario que se registra.
email1
La dirección de correo electrónico o web primaria del usuario que se registra.
email2
La dirección de correo electrónico o web secundaria del usuario que se registra.
fax1
El número de fax primario del usuario que se registra.
fax2
El número de fax secundario del usuario que se registra.
firstName
El nombre del usuario que se registra.
lastName
Es necesario si el modo autenticación es LDAP: El apellido del registrante. Si la modalidad de autenticación es LDAP, este parámetro es obligatorio.
middleName
El segundo nombre o inicial del usuario que se registra.
organizationName
El nombre de la organización a la que representa el usuario que se registra.
organizationUnitName
El nombre de la unidad dentro de la organización a la que representa el usuario que se registra.
packageSuppression
1
Un indicador de que se ha de incluir material publicitario cuando se envíe el pedido
0
Un indicador de que no se ha de incluir material publicitario cuando se envíe el pedido.
No hay ningún valor predeterminado para este campo. Si el campo no se utiliza, permanecerá como nulo en la base de datos.
personTitle
El tratamiento que se dará al usuario cuya dirección se va a entrar (por ejemplo, Dr., Rev., Sr. o Sra.)
phone1
El número de teléfono primario del usuario que se registra.
phone1Type
El tipo de teléfono utilizado para el número de teléfono primario del usuario que se registra, por ejemplo TTY para personas con problemas de audición, PCM para modulación por pulsos codificados o CEL para teléfono móvil. Este campo es de 3 caracteres.
phone2
El número de teléfono secundario del usuario que se registra.
phone2Type
El tipo de teléfono utilizado para el número de teléfono secundario del usuario que se registra, por ejemplo TTY para personas con problemas de audición, PCM para modulación por pulsos codificados o CEL para teléfono móvil. Este campo es de 3 caracteres.
preferredDelivery
La modalidad de entrega preferida del usuario que se registra.
publishPhone1
1
Un indicador de que el número de teléfono primario del usuario que se registra aparece en la lista
0
Un indicador de que el número de teléfono primario del usuario que se registra no aparece en la lista
No hay ningún valor predeterminado para estos campos publishPhone. Si el campo no se utiliza, permanecerá como nulo en la base de datos.
publishPhone2
1
Un indicador de que el número de teléfono secundario del usuario que se registra aparece en la lista
0
Un indicador de que el número de teléfono secundario del usuario que se registra no aparece en la lista
shippingGeoCode
Un código de envío basado en la región geográfica; resulta especialmente útil con software de impuestos.
estado
El nombre de la provincia, estado o equivalente donde reside el usuario que se registra.
taxGeoCode
Un código de impuestos basado en la región geográfica; resulta especialmente útil con software de impuestos.
zipCode
El código postal de la dirección del usuario que se registra.
Atributos de miembro personalizados
Puede gestionar los atributos de miembro personalizados (tabla MBRATTRVAL) para esta organización utilizando la sintaxis siguiente: &attributeName_storeId_action_number=value

Donde:

attributeName
El nombre del atributo personalizado que ya se ha definido en la columna NAME de la tabla MBRATTR.
storeId
El ID de tienda de la tienda para la que se aplica el attributeName. Especifique "null" si el atributo no es específico de la tienda
acción
Especifica la acción que se va a realizar con el valor:
a
añadir valor
r
sustituir valor
d
eliminar valor
number
En el caso de attributeNames de varios valores, especifique este parámetro para asignar varias entradas que tengan el mismo attributeName, storeId o action.
value
El valor que desea asignar al atributo.

A continuación se muestran ejemplos de sintaxis para atributos o parámetros personalizados:

  • El ejemplo siguiente añade un atributo personalizado denominado "OrgEntitySize" con el valor de "100". No es específico de la tienda, por lo tanto, el atributo "IdTienda" se establece en "null": 
    &OrgEntitySize_null_a_1=500
  • El ejemplo siguiente actualiza dos atributos personalizados denominados "OrgEntityOwners" con los valores "Smith" y "Brown", para la tienda 10001. 
    &OrgEntityOwners_10001_r_1=Smith&OrgEntityOwners_10001_r_2=Brown

Ejemplo 1

El ejemplo siguiente añade una organización llamada IBM bajo la Organización raíz. La Organización raíz tiene un ID de entidad de organización de -2001.

https://myhostname/webapp/wcs/stores/servlet/OrgEntityAdd?   
orgEntityName=IBM&orgEntityType=O&parentMemberId=-2001&URL=MallFrontView

Ejemplo 2

El ejemplo siguiente añade una organización llamada Commerce, y la información de dirección asociada de Commerce, bajo una organización existente que tiene un ID de entidad de 7000000000000000001.

https://myhostname/webapp/wcs/stores/servlet/OrgEntityAdd?   
orgEntityName=Torolab&orgEntityType=OU&parentMemberId=7000000000000000001
    &address1=8200
Warden&city=Toronto&URL=MallFrontView

Comportamiento

  • Llama a un mandato de tarea vacío llamado PreOrgEntityUpdateCmd. Los desarrolladores de tiendas pueden sobrescribirlo para cambiar la entrada para el mandato.
  • Comprueba los parámetros necesarios.
  • Llama al mandato de tarea SetBusinessEntityCmd para establecer el atributo BusinessEntity.
  • Llama al mandato de tarea AuditOrgEntityCmd para realizar la comprobación de parámetros adicional. Los desarrolladores de tiendas deben añadir código nuevo al mandato de tarea AuditOrgEntityCmd si desean personalizar la comprobación.
  • Si se especifica algún campo relacionado con la tabla ADDRESS, la dirección automática (también llamada dirección de registro, con el campo selfAddress establecido en '1' y el apodo igual que el logonId) también se actualizará. De lo contrario, no se creará ningún registro en la tabla ADDRESS.
  • Llama a un mandato de tarea vacío llamado PostOrgEntityAddCmd. Los desarrolladores de tiendas pueden sobrescribirlo para realizar operaciones adicionales.
  • Si el mandato no se ejecuta correctamente, se llama al mandato de vista OrgEntityErrorView. Una vez ejecutado satisfactoriamente, se llama al URL especificado.

Condiciones de excepción

  • Si el parámetro URL es nulo, el sistema genera una excepción con la clave de mensaje _ERR_CMD_MISSING_PARAM
  • Si la longitud del valor del parámetro URL es igual a 0, el sistema genera una excepción con la clave de mensaje _ERR_CMD_INVALID_PARAM.
  • Si el parámetro orgEntityType es 'OU' y parentMemberId es nulo, el sistema genera una excepción con la clave de mensaje _ERR_CMD_MISSING_PARAM.
  • Si el parámetro parentMemberId no es una clave externa establecida en la tabla ORGENTITY, el sistema genera una excepción con la clave de mensaje _ERR_CMD_INVALID_PARAM.
  • Si el parámetro orgEntityName es nulo, el sistema genera una excepción con la clave de mensaje _ERR_CMD_MISSING_PARAM.
  • Si la longitud del valor del parámetro orgEntityName es igual a 0, el sistema genera una excepción con la clave de mensaje _ERR_CMD_INVALID_PARAM.
  • Si el parámetro orgEntityType es nulo, el sistema genera una excepción con la clave de mensaje _ERR_CMD_MISSING_PARAM.
  • Si el parámetro orgEntityType no es 'O' ni 'OU', el sistema genera una excepción con la clave de mandato _ERR_CMD_INVALID_PARAM.
  • En modalidad LDAP, si el DN formulado ya existe en el servidor LDAP o en la base de datos de HCL Commerce, el sistema genera una excepción con la clave de mensaje _ERR_RDN_ALREADY_EXIST.
  • En modalidad LDAP, si el nombre especificado para el parámetro distinguishedName ya existe en el servidor LDAP o en la base de datos de HCL Commerce, el sistema genera una excepción con la clave de mensaje _ERR_DN_ALREADY_EXIST.