Deprecated feature

URL OrgEntityUpdate

Cette commande met à jour des informations sur une organisation ou une unité organisationnelle.

Cette commande met à jour des informations sur une organisation ou une unité organisationnelle. Les informations relatives aux organisations ou aux unités organisationnelles sont stockées dans les tables de base de données MEMBER, ORGENTITY, MBRREL et ADRESSE ADDRBOOK.

Utilisez cette commande avec SSL pour garantir le chiffrement de toutes les informations personnelles. 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.
orgEntityId
Obligatoire : ID de cette organisation ou unité organisationnelle ; clé externe de la table MEMBER.
Remarque : Si le paramètre orgEntityId n'est pas spécifié, la commande OrgEntityAdd est appelée pour ajouter une nouvelle organisation ou unité organisationnelle. Si vous n'incluez pas l'entité org, assurez-vous d'ajouter tous les paramètres requis pour la commande OrgEntityAdd. Par exemple, le paramètre orgEntityType est un paramètre requis pour la commande OrgEntityAdd.
orgEntityName
Nom de l'organisation ou de l'unité organisationnelle.
administratorFirstName
Nom de l'administrateur donné.
administratorLastName
Le nom de famille 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 inscrite ; 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 avoir différents types. Si un fichier de propriétés est introuvable, une valeur par défaut SB est 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 e-mail ou adresse Web principale de la personne inscrite.
email2
Adresse e-mail 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
Nom de la personne inscrite donné.
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
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 portable. 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é déjà 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.
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

L'exemple suivant met à jour l'ID légal d'une organisation pour une organisation ayant un ID d'entité de 7000000000000000001.


     https://myhostname/webapp/wcs/stores/servlet/OrgEntityUpdate?
   
orgEntityId=7000000000000000001&legalId=newlegalId&URL=OrgEntityManageForm

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 AuditAddressCmd 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 AuditAddressCmd s'ils souhaitent personnaliser la vérification.
  • Si un champ lié à la table ADDRESS est spécifié, l'adresse perso (également appelée adresse d'inscription, avec le champ selfAddress défini sur "1" et l'alias identique à l'ID de connexion) sera également mise à jour. L'ancienne adresse est marquée comme "T" (temporaire) et un nouvel enregistrement est créé dans la table ADDRESS.
  • 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.

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 orgEntityId est null, le système lance une exception avec la clé de message _ERR_CMD_MISSING_PARAM.
  • Si le paramètre orgEntityId 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, the system lance une exception avec la clé de message _ERR_CMD_MISSING_PARAM.
  • Si le paramètre orgEntityName n'est pas nul, mais que la longueur est égale à 0, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.