Bibliothèque client des composants membres

La classe de la bibliothèque client des membres, MemberFacadeClient, contient des méthodes Web conviviales qui facilitent l'appel de diverses opérations.

La bibliothèque client du composant de gestion des membres se trouve dans le package com.ibm.commerce.member.facade.client.

La liste ci-dessous établit une correspondance entre les méthodes de MemberFacadeClient et les commandes d'URL :
  • Map registerPerson(Map) - UserRegistrationAdd
  • Map updatePerson(Map) - UserRegistrationUpdate
  • Map addAddressForPerson(Map) - AddressAdd
  • Map updateAddressForPerson(Map) - AddressUpdate
  • Map deleteAddressForPerson(Map) - AddressDelete
  • Map registerOrganization(Map) - OrgEntityAdd
  • Map updateOrganization(Map) - OrgEntityUpdate
  • Map addAddressForOrganization(Map) - AddressAdd
  • Map updateAddressForOrganization(Map) - AddressUpdate
  • Map deleteAddressForOrganization(Map) - AddressDelete
Remarque : Les méthodes d'URL conviviales pour le client contiennent une prise en charge intégrée des données utilisateur pour transmettre des paramètres supplémentaires vers la commande de contrôleur. Pour ce faire, il faut étendre la bibliothèque client et la commande de contrôleur.

L'accès au composant de gestion des membres depuis le serveur est facilité par la façade de gestion des membres.

Erreurs client

Les erreurs client affichées dans les sections ci-après, définies dans MemberFacadeConstants.java, font partie d'une exception PersonException ou OrganizationException si des données incorrectes sont indiquées, lors d'une requête avec les méthodes Map d'un client MemberFacadeClient. Ces erreurs se produisent lorsque l'objet SDO du nom ne peut pas être formé à cause de données d'entrée non valides. Par exemple, /Person/@passwordExpired est du type booléen et attend les valeurs "true" ou "false". Si une autre valeur est entrée, une exception de type PersonException est émise, contenant l'erreur client "INVALID_PARAMETER_PASSWORD_EXPIRED".

En dehors de ces nouvelles erreurs de type ClientError, les exceptions et les codes d'erreur standard émis par les commandes de gestion des membres, par exemple UserRegistrationAdd, continuent à être renvoyées au client dans l'élément ChangeStatus de la réponse du serveur, et sont disponibles dans l'exception client.

Personne


/**
* The value specified for /Person/@passwordExpired is invalid
*/
public static final String INVALID_PARAMETER_PASSWORD_EXPIRED =
"INVALID_PARAMETER_PASSWORD_EXPIRED";

/**
* The value specified for
/Person/PersonalProfile/ReceiveEmailPreference/Value is invalid
*/
public static final String INVALID_PARAMETER_RECEIVE_EMAIL =
"INVALID_PARAMETER_RECEIVE_EMAIL";

/**
* The value specified for /Person/@profileType is invalid
*/
public static final String INVALID_PARAMETER_PROFILE_TYPE =
"INVALID_PARAMETER_PROFILE_TYPE";

/**
* The value specified for /Person/@accountStatus is invalid
*/
public static final String INVALID_PARAMETER_ACCOUNT_STATUS =
"INVALID_PARAMETER_ACCOUNT_STATUS";

/**
* The value specified for /Person/PersonalProfile/Gender is invalid
*/
public static final String INVALID_PARAMETER_GENDER =
"INVALID_PARAMETER_GENDER";

Organisation


/**
* The value specified for /Organization/@type is invalid
*/
public static final String INVALID_PARAMETER_ORGENTITY_TYPE =
"INVALID_PARAMETER_ORGENTITY_TYPE";

Communs à Person et Organization:


/**
* The value specified for /../Telephone1/@publish is invalid
*/
public static final String INVALID_PARAMETER_PUBLISH_PHONE_1 =
"INVALID_PARAMETER_PUBLISH_PHONE_1";

/**
* The value specified for /../Telephone2/@publish is invalid
*/
public static final String INVALID_PARAMETER_PUBLISH_PHONE_2 =
"INVALID_PARAMETER_PUBLISH_PHONE_2";

/**
* The value specified for
/../ContactInfo/Attributes/packageSuppression is invalid
*/
public static final String INVALID_PARAMETER_PACKAGE_SUPPRESSION =
"INVALID_PARAMETER_PACKAGE_SUPPRESSION";

/**
* The value specified for /../ContactInfo/Address/@primary is
invalid
*/
public static final String INVALID_PARAMETER_PRIMARY =
"INVALID_PARAMETER_PRIMARY";