Deprecated feature

URL OrgEntityAdd

Cette commande enregistre une nouvelle organisation ou une nouvelle unité organisationnelle.

Cette commande enregistre une nouvelle organisation ou une nouvelle unité organisationnelle. Les informations relatives aux nouvelles organisations ou unités organisationnelles sont stockées dans les tables de base de données MEMBER, ORGENTITY, MBRREL et ADDRESS.

Utilisez cette commande avec SSL (Secure Sockets Layer) pour garantir le chiffrement des informations. Pour ce faire, entrez la commande avec le protocole sécurisé HTTPS.

Structure de l'adresse URL

http:// host_name/path/
Nom entièrement qualifié de votre Transaction server et du chemin de configuration.

Valeurs des paramètres

URL
Obligatoire : Adresse URL à appeler une fois que la commande a abouti.
orgEntityName
Obligatoire : Nom de l'organisation ou de l'unité organisationnelle.
Les espaces situés avant et après les valeurs sont supprimés. Lorsque le système est configuré avec LDAP, les caractères suivants ne sont pas autorisés lorsque l'orgEntityName est utilisé pour créer le nom distinctif :
  • Caractère # apparaissant au début de orgEntityName.
  • Un des caractères suivants : = , + " \ < > ;
orgEntityType
Obligatoire : Type d'entité organisationnelle en cours d'ajout.
O
Organisation
OU
Service
parentMemberId
Requis si orgEntityType est égal à "OU" : ID de membre de l'entité organisationnelle mère dans laquelle la nouvelle entité organisationnelle sera ajoutée. Pour une organisation (orgEntityType=O), ce paramètre n'est pas obligatoire ; sa valeur par défaut est Root Organization.
distinguishedName
DN de l'organisation ou de l'unité organisationnelle, pour l'utilisation de LDAP.
administratorFirstName
Prénom de l'administrateur.
administratorLastName
Nom de l'administrateur.
administratorMiddleName
Deuxième prénom de l'administrateur.
businessCategory
Décrit le type d'affaires effectuées par une organisation ou une unité organisationnelle.
description
Description de la personne inscrite.
legalId
Identificateur d'organisation enregistré ; peut être nul pour une unité organisationnelle.
orgEntityField1 à orgEntityField3
Zones personnalisables .
taxPayerId
ID du payeur de taxe tel que spécifié dans la table ORGENTITY.
address1 à address3
L'adresse (nom et numéro de rue) de la personne inscrite, jusqu'à un maximum de trois lignes d'information.
addressField1 à addressField3
Zones personnalisables .
addressType
Type d'adresse, les valeurs valides sont configurables à l'aide d'un fichier de propriétés : S (expédition), B (facturation) et SB (expédition et facturation). Une seule adresse peut avoir différents types. Si le fichier de propriétés est introuvable, une valeur par défaut SB sera utilisée.
bestCallingTime
D
Indicateur signifiant que la journée est le meilleur moment pour appeler la personne inscrite.
E
Indicateur signifiant que la soirée est le meilleur moment pour appeler la personne inscrite.
billingCode
Code de l'organisation de la personne inscrite pour identifier les adresses d'expédition ou de facturation et le centre de coûts.
billingCodeType
Code désignant la méthode de structure de code utilisée pour le code de facturation. La valeur par défaut est D, attribuée par l'acheteur.
city
Nom de la ville où réside la personne inscrite.
country
Nom du pays ou de la région où réside la personne inscrite.
email1
Adresse électronique ou adresse Web principale de la personne inscrite.
email2
Adresse électronique ou adresse Web secondaire de la personne inscrite.
fax1
Numéro de fac-similé principal de la personne inscrite.
fax2
Numéro de fac-similé secondaire de la personne inscrite.
firstName
Prénom de la personne inscrite.
lastName
Requis si le mode d'authentification est LDAP : Nom de famille de la personne inscrite. Si le mode d'authentification est LDAP, ce paramètre est obligatoire.
middleName
Deuxième prénom de la personne inscrite.
organizationName
Nom de l'organisation que représente la personne inscrite.
organizationUnitName
Nom de l'unité au sein de l'organisation que représente la personne inscrite.
packageSuppression
1
Indicateur pour inclure les notices lorsque la commande est expédiée
0
Indicateur pour ne pas inclure les notices lorsque la commande est expédiée.
Aucune valeur par défaut n'est indiquée dans ce champ. Si le champ n'est pas utilisé, il reste nul dans la base de données.
personTitle
Le titre de l'utilisateur dont l'adresse est saisie (par exemple, Dr., Rev., M. ou Mme.).
phone1
Numéro de téléphone principal de la personne inscrite.
phone1Type
Type de téléphone utilisé au numéro principal de la personne inscrite ; par exemple, TTY pour une personne malentendante, PCM pour la modulation par impulsions codées ou CEL (cellulaire) pour un mobile. Il s'agit d'un champ à trois caractères.
phone2
Deuxième numéro de téléphone de la personne inscrite.
phone2Type
Type de téléphone utilisé au numéro secondaire de la personne inscrite ; par exemple, TTY pour une personne malentendante, PCM pour la modulation par impulsions codées ou CEL (cellulaire) pour un mobile. Il s'agit d'un champ à trois caractères.
preferredDelivery
Mode de livraison préféré de la personne inscrite.
publishPhone1
1
Indicateur signifiant que le numéro de téléphone principal de la personne inscrite est répertorié
0
Indicateur signifiant que le numéro de téléphone principal de la personne inscrite n'est pas répertorié
Il n'y a pas de valeur par défaut pour ces champs publishPhone. Si le champ n'est pas utilisé, il reste nul dans la base de données.
publishPhone2
1
Indicateur signifiant que le numéro de téléphone secondaire de la personne inscrite est répertorié
0
Indicateur signifiant que le numéro de téléphone secondaire de la personne inscrite n'est pas répertorié
shippingGeoCode
Code d'expédition basé sur la région géographique, particulièrement utile avec les logiciels fiscaux.
état
Nom du pays, de la province ou équivalent où réside la personne inscrite.
taxGeoCode
Code fiscal basé sur la région géographique, particulièrement utile avec les logiciels fiscaux.
zipCode
Code postal de l'adresse de la personne inscrite.
Attributs de membre personnalisés
Vous pouvez gérer les attributs de membres personnalisés (table MBRATTRVAL) pour cette organisation à l'aide de la syntaxe suivante : &attributeName_storeId_action_number=value

Où :

attributeName
Nom de l'attribut personnalisé qui a déjà été défini dans la colonne NAME de la table MBRATTR.
storeId
ID de magasin du magasin auquel attributeName s'applique. Spécifiez "null" si l'attribut n'est pas spécifique au magasin
l'action
Spécifie l'action à effectuer avec la valeur :
a
ajouter la valeur
P
remplacer la valeur
j
supprimer la valeur
number
Dans le cas des noms d'attribut à plusieurs valeurs, spécifiez ce paramètre pour affecter plusieurs entrées avec un(e) même attributeName, storeId ou action.
valeur
Valeur que vous souhaitez attribuer à l'attribut.

Voici des exemples de syntaxe pour les attributs ou les paramètres des clients :

  • L'exemple suivant ajoute un attribut personnalisé nommé "OrgEntitySize" avec une valeur de "100". Il n'est pas spécifique au magasin, de sorte que l'attribut "storeId" est défini sur "null" : 
    &OrgEntitySize_null_a_1=500
  • L'exemple suivant met à jour deux attributs personnalisés nommés "OrgEntityOwners" avec les valeurs "Smith" et "Brown" pour le magasin 10001. 
    &OrgEntityOwners_10001_r_1=Smith&OrgEntityOwners_10001_r_2=Brown

Exemple 1

L'exemple suivant ajoute une organisation nommée IBM sous l'organisation racine. L'organisation racine a un ID d'entité d'organisation de -2001.

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

Exemple 2

L'exemple suivant ajoute une unité d'organisation nommée Commerce et des informations d'adresse associées pour Commerce, sous une organisation existante avec un ID d'entité de 7000000000000000001.

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

Comportement

  • Appelle une instruction de tâche vide appelée PreOrgEntityUpdateCmd. Les développeurs de magasins peuvent la remplacer pour modifier l'entrée de la commande.
  • Vérifie les paramètres requis.
  • Appelle l'instruction de tâche SetBusinessEntityCmd pour définir l'attribut BusinessEntity.
  • Appelle l'instruction de tâche AuditOrgEntityCmd pour effectuer des vérifications de paramètres supplémentaires. Les développeurs de magasins doivent ajouter un nouveau code à l'instruction de tâche AuditOrgEntityCmd s'ils souhaitent personnaliser la vérification.
  • Si un champ lié à la table ADDRESS est spécifié, une adresse perso (également appelée adresse de registre, avec le champ selfAddress défini sur "1" et l'alias identique à orgEntityName) sera créée. Dans le cas contraire, aucun enregistrement ne sera créé dans la table ADDRESS.
  • Appelle une instruction de tâche vide appelée PostOrgEntityAddCmd. Les développeurs de magasins peuvent la remplacer pour effectuer des opérations supplémentaires.
  • Si l'instruction échoue, l'instruction de visualisation OrgEntityErrorView est appelée. Si l'exécution de la commande s'achève normalement, l'URL spécifiée est appelée, puis

Conditions d'exception

  • Si un paramètre d'URL est nul, le système émet une exception accompagnée de la clé de message _ERR_CMD_MISSING_PARAM.
  • Si la longueur de la valeur du paramètre URL est égale à 0, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • Si le paramètre orgEntityType est 'OU' et parentMemberId est null, le système lance une exception avec la clé de message _ERR_CMD_MISSING_PARAM.
  • Si le paramètre parentMemberId n'est pas un ensemble de clés externes sur la table ORGENTITY, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • Si le paramètre orgEntityName est null, le système lance une exception avec la clé de message _ERR_CMD_MISSING_PARAM.
  • Si la longueur de la valeur du paramètre orgEntityName est égale à 0, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • Si le paramètre orgEntityType est null, le système lance une exception avec la clé de message _ERR_CMD_MISSING_PARAM.
  • Si le paramètre orgEntityType n'est pas 'O' ou 'OU', le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • En mode LDAP, si le nom distinctif formulé existe déjà sur le serveur LDAP ou la base de données HCL Commerce, le système lance une exception avec la clé de message _ERR_RDN_ALREADY_EXIST.
  • En mode LDAP, si le nom distinctif spécifié existe déjà sur le serveur LDAP ou la base de données HCL Commerce, le système lance une exception avec la clé de message _ERR_DN_ALREADY_EXIST.