Création d’un nouveau modèle de message SQL

Remarque : Les modèles de message SQL ne sont pas disponibles pour les clients StoreFlow Cloud.

Les requêtes SQL sont utilisées pour récupérer des données pour créer un message.

Les requêtes SQL sont utilisées pour générer le code XML qui est, à son tour, utilisé par le XSL pour créer un message au format HTML.

Pour créer un nouveau modèle de message SQL :

  1. Sur la barre d'outils cliquez sur Outils, puis sélectionnez Paramétrage du système.

  2. Cliquez sur le lien Message Template SQL (Modèle de message SQL).

    La page Message Template SQL(modèle de message SQL) est affichée.

  3. Cliquez sur Ajouter.

  4. Remplissez les champs suivants :

    • Id du modèle de message : Numéro d’identification du modèle de message avec lequel ce modèle de message SQL est associé.

    • Texte SQL : Instruction SQL. Le modèle SQL est susceptible d’utiliser un certain nombre de paramètres, comme indiqué dans le tableau suivant.

    • Nom : Un nom unique pour l’ensemble des enregistrements qui seront récupérés.

Exemples SQL

exec ('SELECT FirstName, LastName FROM Users WHERE Users.UserID = ' + @UserId)

exec('SELECT Store.[Name] as StoreName, LandingDomain, LandingFolder FROM Store WHERE StoreId = ' + @StoreId)

exec('SELECT EncryptedOrderId FROM Orders WHERE OrderId = ' + @OrderId)

Remarque : D'autres exemples de requêtes SQL peuvent être prévisualisés dans le BackOffice. Allez à Outils > Paramétrage du système > Message Template SQL et cliquez sur le lien Afficher .

Les outils qui sont passés à l’instruction SQL par des points d’événement sont:

Type d’événement

Evénement

Paramètres

Événements de cycle de vie de l’utilisateur

Identifiant client

@StoreId

@CultureID

@UserId

@ExternalUserID

@UserEmail

Enregistrement d'un client

@StoreId

@CultureID

@UserId

@ExternalUserID

@UserEmail

Client en attente d’inscription

@StoreId

@CultureID

@UserId

@ExternalUserID

@UserEmail

Récupération d'un mot de passe

@StoreId

@CultureID

@UserId

@ExternalUserID

@UserEmail

Création d'un utilisateur dans l'application Admin

@StoreId

@CultureID

@UserId

@ExternalUserID

@UserEmail

Mise à jour des informations de l'utilisateur dans l'application admin

@StoreId

@CultureID

@UserId

@ExternalUserID

@UserEmail

Mise à jour des informations de l’utilisateur dans Storefront

@StoreId

@CultureID

@UserId

@ExternalUserID

@UserEmail

Événements de cycle de vie de la commande

Création d'une livraison

@StoreId

@CultureID

@OrderId

@UserId

@DeliveryId

Produit commandé dans le panier

@StoreId

@CultureID

@OrderId

@UserId

@OrderProductId

Changement de l'état d'une commande

@StoreId

@CultureID

@OrderProductId,

@FromState

@Tostate

Soumission d'une commande client

@StoreId

@CultureID

@UserId

@ApproverUserId le cas échéant)

@OrderId

Recommander

@StoreId

@CultureID

@OrderProductId

@OldOrderProductId

Événements de processus d’approbation de commande

Modification de l'Approbateur - Notification au Nouvel Approbateur

@StoreId

@CultureID

@OrderId

@OrderId @ApproverUserId (au nouvel approbateur)

Modification de l'Approbateur - Notification à l'Ancien Approbateur

@StoreId

@CultureID

@OrderId

@ApproverUserId (à l’ancien approbateur)

Commande approuvée

@StoreId

@CultureID

@OrderId @ApproverUserId

Rejet de la commande

@StoreId

@CultureID

@OrderId

@RejecterUserId

Sélectionner les adresses de livraison à qui vous désirez envoyer

@StoreId

@CultureID

@OrderId

@UserId

@ApproverUserId (si un approbateur spécifique a été sélectionné)

Désaisir le groupe du processus d'approbation

@StoreId

@CultureID

@UserId

@ApproverUserId

@ApproveeGroupId

Événements d’inventaire

Niveau de Stock Bas

@StoreId

@CultureID

@OrderId

@ProductId

@OrderProductId

Stock modifié

@StoreId

@CultureID

@OrderId

@ProductId

@OrderProductId

Autres événements

Fiche de travail de l'article commandé sur une création de nouvelle commande

@StoreId

@CultureID

@OrderId

@UserId

@OrderProductId

Le paiement redirigé a échoué

@StoreId

@CultureID

@OrderId

@UserId

La vérification USADATA a échoué

@StoreId

@CultureID

@OrderId

Les requêtes SQL que vous créez seront formatées par uStore en XML qui, à son tour, sera transformé en objet et corps du message courriel à l’aide des XSL.

Le modèle de message XML est formaté comme suit :

<sqls>
   <RecordSetName>
      <Row>
         <FieldName>value</FieldName>
      </Row>
   </RecordSetName>
</sqls>

Où :

  • RecordSetName est le nom du modèle de message SQL (le nombre de nœuds RecordSetName est identique au nombre de modèles de message SQL).

  • Row encapsule tous les champs d’un enregistrement (le nombre de nœuds de Row est identique au nombre d’enregistrements retourné de la requête SQL)

  • FieldName est le nom du champ qui récupère le modèle de message SQL (le nombre de nœuds FieldName est identique au nombre de tous les champs qui sont déclarés dans le SQL)

  • Value est la valeur de ce champ.

Exemple de données XML récupérées de la base de données

<Sqls>
   <CustomerName>
      <Row>
         <FirstName>d</FirstName>
         <LastName>d</LastName>
      </Row>
   </CustomerName>
   <StoreName>
      <Row>
         <StoreName>MyStore</StoreName>
         <LandingDomain>www.xmpie.com</LandingDomain>
         <LandingFolder>MyStore</LandingFolder>
      </Row>
   </StoreName>
   <Order>
      <Row>
         <EncryptedOrderId>82104</EncryptedOrderId>
      </Row>
   </Order>
</Sqls>