Instruction SetOrderTemplate
Cette instruction définit ou restaure une commande "modèle" ou "modèle en cours".

Valeurs des paramètres
- http://host_name/path/
- (Obligatoire) Nom qualifié complet de votre serveur WebSphere Commerce Server et chemin de configuration
- forUser
- ID de connexion de l'utilisateur au nom duquel l'instruction est exécutée. Seule une personne disposant des droits de traitement des commandes peut spécifier ce paramètre.
- forUserId
- Identique à forUser, mais identifie l'utilisateur par l'ID d'utilisateur interne, tel qu'il est indiqué dans la table USERS.
- langId
- Affecte ou réinitialise la langue préférée pour la durée de la session ; les langues prises en charge pour un magasin figurent dans la table STORELANG
- storeId
- Définit l'ID de magasin de la commande cible. Il sert également à résoudre les abréviations spéciales (".", "*", ".t",".**.", et "*t") lorsqu'elles apparaissent dans fromOrderId_i,
toOrderId, orderInfoFrom et payInfoFrom. Par exemple, l'instruction suivante fait référence à toutes les commandes en suspens du membre 1001 du
magasin 1:
fromOrderId_1=.&memberId_1=1001&storeId=1
- URL
- (Obligatoire)URL de réacheminement appelée lorsque l'instruction aboutit.
- orderId_i
- Spécifie zéro ou plusieurs commandes à l'aide des numéros de référence ou de l'une des
Abréviations de commande ".", "*",
".t", "*t"
- memberId_i
- Référence d'un membre utilisée pour résoudre les abréviations spéciales (".","*", ".t", ".**." et "*t") lorsqu'elles s'affichent dans fromOrderId_i. Par exemple, l'instruction suivante fait référence à toutes les commandes en suspens du membre 1001 :
fromOrderId_1=*&memberId_1=1001
La valeur par défaut correspond à l'ID de membre de l'utilisateur en cours.
Si le client en cours tente d'accéder aux commandes d'autres clients alors qu'il n'y est pas autorisé, une exception
est lancée.
- usage_i
- Si orderId_i est spécifié, il faut également
indiquer la valeur d'usage_i.
Spécifiez 1 pour marquer les commandes spécifiées en tant que
modèles de commande client en cours exécutant l'instruction. Spécifiez 0 pour marquer les commandes en tant que
modèles du client (non en cours) et -1 pour retirer la
marque placée sur les commandes spécifiées du client.
- storeId_i
- Numéro de référence du magasin. Sert à évaluer les abréviations spéciales
".", "*", ".t" et "*t" des valeurs du
paramètre orderIdi. Si elle n'est pas
spécifiée, la valeur par défaut est celle fournie par le paramètre
storeId. Si ni storeIdi ni storeId ne sont spécifiés, les abréviations
spéciales sont évaluées pour tous les magasins.
- outOrderName
- Indique les noms des combinaisons nom-valeur à ajouter à l'URL de réacheminement. La valeur de chaque paire nom-valeur ajoutée est le numéro de référence de la commande cible. La valeur par défaut est "orderId".
Exemple
Dans l'exemple suivant, la commande portant la référence
5137 devient le seul modèle en cours du magasin 2066 et du client
exécutant l'instruction, puis elle est réacheminée vers une URL qui
l'affiche.
http://myhostname/webapp/wcs/stores/servlet/SetOrderTemplate?storeId=2066
&orderId_1=.t&ordert_usage_1=0&orderId_2=5137&ordert_usage_2=1
&URL=/webapp/wcs/stores/servlet/OrderDisplay?status%3DP%26orderId%3D.t
Comportement
- Les commandes sont traitées
suivant l'ordre croissant de i.
- L'instruction CheckOrderTemplateCmd
est appelée pour chaque commande spécifiée
pour vérifier si le client est autorisé à y placer ou à en retirer une commande.
- Si le client a l'autorisation nécessaire, la commande est placée ou retirée de la table ORDERTMPL, à l'aide de l'instruction ResolveOrdersCmd, selon ce que spécifie le paramètre usage_i .
Conditions d'exception
L'instruction CheckOrderTemplateCmd
signale une exception ECApplicationException du type _ERR_ORDER_TEMPLATE avec l'affichage d'erreurs SetOrderTemplateErrorView si l'instruction SetOrderTemplate ne permet pas
d'accéder à une commande. Les paires nom-valeur suivantes seront définies :
- ERROR_CODE=601
- orderId=l'ID de commande à l'origine de l'erreur