4D Business Kit version 2.2 ADDENDUM

Transcription

1 4D Business Kit version 2.2 ADDENDUM Bienvenue dans 4D Business Kit version 2.2. Ce document décrit les nouveautés et modifications proposées dans cette version. Ces nouveautés concernent les thèmes suivants : Préférences du serveur 4D Business Kit, Paramétrages des boutiques, Gestion des articles, Règles de comportement, Gestion des clients, Nouveau module Outils pour la base de données, Modifications diverses, Langage. Préférences De nouvelles préférences générales sont disponibles dans la boîte de dialogue des Préférences de 4D Business Kit 2.2 : Ne pas demander de confirmation lors de la validation d une fiche (page Interface ) : cette nouvelle option permet de supprimer l affichage d une boîte de dialogue de confirmation lors de la validation d une fiche des modules Articles, Commandes et Clients. Par défaut, cette option n est pas cochée (la boîte de dialogue est affichée). Ne pas afficher la page Web en cas d erreur sur une instruction 4DBK (page Réglages avancés ) : cette nouvelle option permet d inactiver le mécanisme affichant par défaut dans les pages Web des boutiques les erreurs de traitement liées à des instructions incorrectes. Ce mécanisme est plutôt destiné au débogage du site lors de la phase de mise au point. 4D Business Kit Addendum 1

2 4D Business Kit version 2.2 Addendum Pour les serveurs hébergeant des sites finalisés, cette option peut être cochée (en cas d erreur dans les pages, un simple message apparaît). Utiliser 4D Business Kit comme serveur secondaire pour les requêtes HTTP / pour les requêtes HTTPS (page 4D WebSTAR/Apache/Microsoft IIS ) : cette nouvelle option permet de préciser le type de requêtes Web pour lesquelles 4D Business Kit sera utilisé comme serveur secondaire. Archiver et purger automatiquement le log Web principal si sa taille atteint... (page Réseau ) : lorsque cette option est cochée, 4D Business Kit archive automatiquement le journal Web (logweb.txt) principal dès lors que la taille critique fixée par défaut à 10 Mo est atteinte. Cette taille est modifiable. L option est cochée par défaut. L archivage automatique provoque la création d un fichier d archive pour chaque boutique. Lorsque le fichier logweb.txt atteint la taille définie, les données concernant chaque boutique sont extraites de ce fichier et sauvegardées dans le dossier Logs de chaque boutique. Le fichier logweb.txt est alors recopié dans le dossier Logs du serveur et effacé. Cette option est particulièrement intéressante pour les hébergeurs qui pourront ainsi disposer des hits pour chaque boutique via le fichier d archive par boutique. Le fichier général logweb.txt contient, en plus des hits, toutes les erreurs et virus enregistrés par le serveur. Notes L outil d analyse des journaux Web permet toujours d archiver manuellement le fichier logweb.txt. Un nouvel outil permet d archiver les journaux spécifiques dans 4D Business Kit 2.2 (cf. paragraphe Module Outils pour la base de données, page 17). 2 4D Business Kit Addendum

3 Paramètres des boutiques Paramètres des boutiques Publication Web La page Publication Web et la nouvelle page Publication Web (2) des boutiques comportent plusieurs nouveaux paramètres relatifs à la publication des boutiques (URLs d accès, accès en SSL et gestion de page introuvable) : Nouveaux URLs Accès en HTTPS Gestion de page introuvable Nombre d URLs d accès à la boutique : il est désormais possible de définir jusqu à 6 URLs différents par boutique. URL d accès direct en HTTPS : cette nouvelle option permet de spécifier un URL provoquant l accès direct aux pages de la boutique en mode SSL dès la page d accueil. Par exemple, si vous saisissez Secure.store.com, cet URL dans un navigateur chargera la page d accueil du site en HTTPS. Cette option est très utile dans le cadre de l utilisation conjointe de 4DBK et de 4D WebSTAR où 4DBK gère la partie HTTP et 4D WebSTAR la partie HTTPS (dans le cas par exemple d utilisation de multicertificats SSL). 4D Business Kit Addendum 3

4 4D Business Kit version 2.2 Addendum Numéro de TVA intracommunautaire Page introuvable : il est désormais possible de paramétrer la gestion des pages introuvables (erreur HTTP 404) au niveau de chaque boutique. Rappelons que par défaut dans ce cas, 4D Business Kit affiche la page PageNotFound.htm, commune à toutes les boutiques du serveur (il est possible de paramétrer le contenu de cette page dans les Préférences du serveur). Les nouvelles options de la page Publication Web (2) permettent de modifier ce fonctionnement et de définir une page d erreur spécifique pour chaque boutique : Renvoyer sur la page d accueil / Oui : si cette option est cochée, 4D Business Kit retourne la page d accueil de la boutique en cas de page introuvable. Ou plutôt sur cette page : cette zone vous permet d indiquer le nom et l emplacement d une page d erreur personnalisée que 4D Business Kit enverra en cas de page introuvable dans la boutique. Il est conseillé de placer cette page dans le dossier WebPagesXX de votre boutique en n oubliant pas de la dupliquer dans chaque dossier WebPagesXX si le site est multilingue. Deux nouvelles options dans la page Taxes des boutiques permettent de paramétrer le mode d application de la TVA intracommunautaire : Ne pas utiliser la commande 4DBKVATNumberSet pour déclarer un numéro de TVA : cette option permet au marchand de définir si le numéro de TVA intracommunautaire sera utilisé dans le calcul des taxes par sa simple présence dans la fiche client (nouveau mode) ou via la commande 4DBKVATNumberSet (fonctionnement précédent). 4 4D Business Kit Addendum

5 Paramètres des boutiques Cette option est cochée par défaut : la TVA intracommunautaire est automatiquement appliquée si un numéro est défini dans la fiche client. N accepter un numéro par la commande 4DBKFieldSet/CusNuVAT que s il est valide (délai de quelques secondes) : lorsque cette option est cochée, 4D Business Kit vérifie en ligne la validité des numéros de TVA intracommunautaires en utilisant les bases de données de l Union Européenne dès qu un tel numéro est saisi dans une page web (à l aide de l instruction 4DBKFieldSet/CusNuVAT). Ce mode pouvant ralentir le traitement des pages Web, cette option n est pas cochée par défaut. Note Cette vérification peut également être effectuée manuellement dans la fiche de chaque client. Purge automatique des messages Pour ne pas alourdir le journal des messages sortants et donc la base de données, tout message envoyé automatiquement par 4D Business Kit au marchand via la commande 4DBKOrderValidate lorsqu une commande est validée peut être supprimé de l historique des messages sortants après son envoi. Cette option est disponible dans la page Commandes. Elle n est pas cochée par défaut : Option de suppression des messages 4D Business Kit Addendum 5

6 4D Business Kit version 2.2 Addendum Champs personnalisés La nouvelle page Champs personnalisés de la fenêtre des boutiques permet de stocker des informations spécifiques à la boutique : Ces champs sont utilisables notamment pour stocker des éléments de configuration transmis par les solutions de paiement (login, mot de passe, etc.). Il est ensuite possible d accéder à ces éléments lors d un paiement en ligne via les nouveaux champs StoreCustom1, StoreCustom2, StoreCustom3 (cf. page 42). Ces champs peuvent également être utilisés pour stocker des informations d un tout autre type relatives à la boutique. Scripts programmés La nouvelle page Scripts programmés de la fenêtre de paramétrage des boutiques permet au marchand de définir des scripts à exécuter chaque jour : 6 4D Business Kit Addendum

7 Paramètres des boutiques Un script est une page contenant des balises 4DBK et qui, une fois exécuté par 4D Business Kit, génère un fichier de résultat au format texte, xml ou html. Ce fichier de résultat est destiné aux services de catalogues et de référencement tels que Kelkoo de Yahoo ou Froogle de Google. Par défaut, 4D Business Kit regénère les scripts actifs une fois par jour ; il est également possible de les regénérer manuellement, par exemple après une mise à jour des articles du site. En principe, le site de référencement téléchargera régulièrement le fichier généré afin de mettre à jour ses propres pages. Publier un catalogue de boutiques sur un site tel que Kelkoo peut être très intéressant pour les marchands : de plus en plus d internautes utilisent ce type de catalogue pour trouver les sites proposant les articles qu ils recherchent. Le format, le contenu et l emplacement du fichier généré dépendent de chaque site de référencement. Des exemples de scripts destinés notamment aux sites LeGuide.com ou Froogle sont fournis dans le site de test (TEST_site). Pour mettre en place un script, vous devez d abord placer le fichier de script dans le dossier du site (par exemple, dans le dossier WebPages de la langue du site). Ensuite, saisissez un nouveau libellé dans la zone correspondante, puis désignez le fichier source à l aide du bouton de sélection situé à droite de la zone. Indiquez ensuite le chemin d accès et le nom du fichier à créer dans la zone correspondante ce fichier sera récupéré par le site de référencement. Enfin, cliquez sur le bouton Ajouter pour créer le script programmé. Vous pouvez créer autant de scripts que vous voulez par boutique. Il est possible d activer ou désactiver chaque script à l aide de l option située en regard de la ligne. Les boutons Modifier et Supprimer permettent respectivement de valider les modifications effectuées dans une ligne de script et de supprimer une ligne. L option Générer automatiquement toutes les 24 heures provoque la mise à jour quotidienne de tous les scripts actifs. Il est également possible de regénérer manuellement tous les scripts à l aide du bouton Générer maintenant. 4D Business Kit Addendum 7

8 4D Business Kit version 2.2 Addendum Raccourcis d URLs La nouvelle page Raccourcis de la fenêtre de paramétrage des boutiques permet de définir des raccourcis d URLs qui pourront être utilisés en lieu et place des véritables URLs vers les pages de la boutique. Cette fonction permet notamment d afficher des URLs simplifiés dans les catalogues Web et les moteurs de recherche (par exemple au lieu de : Une fois que vous avez défini et activé un raccourci d URL, 4D Business Kit le remplace automatiquement par l URL complet lorsqu il reçoit une requête contenant ce raccourci. L URL peut contenir une partie variable (par exemple le numéro de l article). Cette partie est définie par la chaîne [arg] : 4D Business Kit ne remplace pas les arguments situés à droite de cette chaîne. Pour reprendre l exemple précédent, le raccourci peut être associé à l URL Si 4D Business Kit reçoit l URL raccourci il le transforme automatiquement en et la requête aboutit. Pour créer un raccourci, saisissez son libellé, l URL raccourci et l URL réel dans les zones correspondantes puis cliquez sur le bouton Ajouter. Vous pouvez créer autant de raccourcis que vous voulez par boutique. Il est possible d activer ou désactiver chaque raccourci à l aide de 8 4D Business Kit Addendum

9 Gestion des articles l option située en regard de la ligne. Pour modifier un raccourci, sélectionnez-le dans la liste, modifiez ses paramètres dans les zones correspondantes puis cliquez sur le bouton Modifier. Pour supprimer un raccourci, sélectionnez-le dans la liste puis cliquez sur le bouton Supprimer. Gestion des articles Gestion d objets externes 4D Business Kit 2.2 permet d associer tout type de fichier à un article sous forme de vue. Ce fichier peut être multimedia (son, séquence animée, film vidéo, etc.) ou de tout type (par exemple un fichier exécutable). Cette nouveauté a deux finalités : permettre l illustration des articles à l aide de fichiers multimedias, permettre la mise en place de fichiers externes téléchargeables payants. L association d un fichier externe s effectue dans la page Vues/Fichier externe de la fenêtre de paramétrage des articles. A noter que désormais, chaque type de vue (image, icône...) est accessible dans une page séparée : Accès aux différents types de vues Page de définition d un fichier externe Affichage du nom ou de l URL du fichier externe 4D Business Kit Addendum 9

10 4D Business Kit version 2.2 Addendum Vous pouvez associer un fichier externe à la vue courante de deux manières : en référençant le fichier lui-même, en référençant un lien vers le fichier. Une fois un fichier externe associé à un article, vous pouvez l insérer dans les pages Web de la boutique soit via un URL direct, soit à l aide des nouvelles commandes 4DBKExternalFile et 4DBKDownloadKeyNew. Affecter un fichier externe Pour associer un fichier externe à la vue courante, il suffit de cliquer sur la commande standard Affecter un fichier externe à la vue courante. Une boîte de dialogue d ouverture de fichier vous permet de désigner le fichier à utiliser. Son nom apparaît alors en bas de la fenêtre. Vous devrez ensuite copier le fichier multimedia dans le nouveau dossier External du dossier de la boutique pour que 4D Business Kit puisse le traiter automatiquement. Cas particulier : Par défaut, les fichiers JPEG et GIF sont traités par le serveur Web de manière spécifique. Pour pouvoir utiliser un fichier JPEG ou GIF comme fichier externe à télécharger, il est impératif d ajouter le caractère de soulignement _ à la fin de son nom, par exemple : monimage.jpg_. Affecter un lien Un fichier externe peut également être référencé sous forme de lien vers un autre emplacement ou un autre serveur Web. 10 4D Business Kit Addendum

11 Gestion des articles Pour cela, il suffit de cliquer sur le bouton Affecter un lien externe à la vue courante et de saisir l URL complet du fichier dans la boîte de dialogue : L URL est alors affiché en bas de la page de vue. Téléchargement du fichier L option Ce fichier ne peut être téléchargé que par un lien protégé correspond au second type d utilisation des fichiers externes : la mise à disposition de fichiers téléchargeables payants. Lorsque cette option est cochée, il n est pas possible de télécharger le fichier autrement que via un lien protégé (la saisie d un URL ou la commande 4DBKExternalFile sont inopérantes). Un lien de téléchargement protégé n est généralement valide que durant un certain temps et son contenu est entièrement encodé. Les liens protégés sont uniquement générés par la commande 4DBKDownloadKeyNew (pour plus d informations, reportez-vous à la description de cette commande). Note Les liens de téléchargement sont stockés sous forme de lignes de commandes (cf. paragraphe Gérer les liens de téléchargement, page 21). Supprimer un fichier externe Pour supprimer un fichier externe ou un lien vers un fichier externe associé à une vue, cliquez sur le bouton Ne plus afficher de fichier externe à la vue courante. Le fichier est alors immédiatement supprimé. 4D Business Kit Addendum 11

12 4D Business Kit version 2.2 Addendum Règles de comportement Client identifié Ajout d articles Une nouvelle option dans la page de Définition des règles permet de n appliquer la règle que si le client est identifié : N appliquer que si un client est identifié. Par défaut, cette option n est pas cochée. L ajout d un article en utilisant une règle de comportement peut être configuré de façon plus précise. Lorsqu une règle est appliquée, un article peut à présent être ajouté avec une quantité différente de 1. Cette quantité peut également être négative, ce qui permet d enlever un article du panier. Cette quantité peut également être négative en fonction du nombre d articles trouvés par la formule : Ordre de traitement Il est désormais possible de définir l ordre de traitement des règles de comportement. 12 4D Business Kit Addendum

13 Clients Cette opération s effectue en mode Liste à l aide des commandes Monter et Descendre du menu contextuel : Ordre de traitement courant Commandes de modification de l ordre de traitement La modification de l ordre de traitement s effectue ligne par ligne (une seule règle de comportement peut être déplacée à la fois). Clients Exonération de taxes Il est possible d appliquer des exonérations (temporaires ou permanentes) de taxes pour chaque client. Ces exonérations peuvent être basées sur deux critères : la catégorie de taxe (A, B, C, D ou E) la règle de taxe. 4D Business Kit Addendum 13

14 4D Business Kit version 2.2 Addendum Ces paramétrages sont définis dans la page Divers du module Clients : Paramétrage des exonérations de taxes Ne pas appliquer ces catégories de taxes : ce paramètre permet d exonérer le client d une ou plusieurs catégorie(s) parmi les règles de taxes auxquelles il est assujetti. Jusqu au : cette option permet de définir la durée pendant laquelle le client sera exonéré des catégories de taxe définies. Ne pas appliquer ces règles de taxe : ce paramètre permet d exonérer le client d une ou plusieurs règle(s) de taxe. Cette exonération est permanente. Informations personnelles Cinq champs booléens supplémentaires ont été ajoutés dans chaque fiche client (page Personnel) : Nouveaux champs Ces champs peuvent être utiles pour stocker des spécificités sur le client telles que a souscrit à un programme spécifique, nouveau client, etc. 14 4D Business Kit Addendum

15 Clients Ces champs sont accessibles dans les pages Web via les libellés CusPersoB1 à CusPersoB5. Envoi de messages en nombre Il peut être intéressant d envoyer des mailings promotionnels ou informatifs à un ensemble de clients. La nouvelle commande Envoyer un à ce(s N) clients(s)..., disponible depuis le menu contextuel du module Clients, permet au marchand d envoyer par une page HTML personnalisée à l ensemble des clients sélectionnés dans la liste : Lorsque vous choisissez cette commande, une boîte de dialogue s affiche, vous permettant de configurer l envoi : 4D Business Kit Addendum 15

16 4D Business Kit version 2.2 Addendum Serveur Lors de l envoi de messages en nombre, vous pouvez utiliser un serveur SMTP différent du serveur défini pour la boutique (page Courrier). Pour cela, saisissez l adresse et les options de configuration du serveur alternatif dans les champs de la zone Serveur. Si vous souhaitez utiliser le serveur SMTP de la boutique, cliquez sur le bouton Valeurs par défaut : 4D Business Kit remplit alors les champs de la zone avec les valeurs définies pour la boutique. La zone vous permet de définir le message envoyé au(x) client(s) sélectionné(s). Si vous avez cliqué sur le bouton Valeurs par défaut, 4D Business Kit utilise automatiquement comme expéditeur du message le compte défini pour la réception des commandes (dans la page Commandes des paramètres de la boutique). Vous pouvez toutefois utiliser un compte différent. Saisissez dans le champ Sujet le sujet du message, tel qu il apparaîtra dans le logiciel de réception de courrier de l utilisateur. Le champ Corps du message indique l emplacement du fichier à envoyer en tant que message. Ce fichier peut être de type texte ou html. Il prend en charge toutes les balises 4DBK. Les champs clients peuvent être affichés en utilisant des balises spécifiques placées entre guillemets. Les noms de ces balises sont les mêmes que celles utilisées avec la commande 4DBKField, par exemple [CusCode], [CusLabel], etc. Pour désigner le fichier à envoyer, vous pouvez saisir manuellement un chemin d accès absolu ou cliquer sur le bouton Parcourir... afin d utiliser une boîte de dialogue standard d ouverture de fichiers. Faire un test Avant d envoyer un à un ensemble de personnes, il est conseillé de contrôler que le message envoyé est bien conforme au résultat attendu. Pour cela, vous pouvez utiliser le bouton Faire un test..., permettant d envoyer un exemplaire du message en situation à une adresse spécifique. Lorsque vous cliquez sur ce bouton, 4D Business Kit permet d indiquer l adresse de réception du message de test. Par défaut, le programme propose l adresse de l expéditeur. Le message est expédié dès que vous cliquez sur OK. 16 4D Business Kit Addendum

17 Module Outils pour la base de données Si le message reçu est correct, vous pouvez déclencher l envoi des messages en cliquant sur le bouton Continuer dans la boîte de dialogue Envoyer un . Une boîte de dialogue de confirmation s affiche, cliquez sur OK pour déclencher l envoi. Module Outils pour la base de données Le nouveau module Outils pour la base de données permet de bénéficier d un outil de réinitialisation des fiches de la boutiques et d une fonction d archivage des fichiers d historique. Activation du module Par défaut, ce module n est pas accessible dans 4D Business Kit, vous devez l activer explicitement en cochant l option correspondante dans la page Droits d accès de la fenêtre des Préférences : Option d activation du module Une fois cette option cochée, la commande Outils pour la base de données est disponible dans le menu Outils : 4D Business Kit Addendum 17

18 4D Business Kit version 2.2 Addendum Lorsque vous sélectionnez cette commande, la boîte de dialogue suivante apparaît : Renumérotation des fiches La renumérotation des fiches permet de nettoyer le fichier de données en cas d anomalies issues de multiples ajouts, suppressions, duplications, etc. Lorsqu une telle anomalie est constatée dans une ou plusieurs boutiques (par exemple, deux fiches articles différentes ont le même numéro), il est souhaitable d effectuer une renumérotation des fiches. De même, il peut être utile de renuméroter toutes les fiches d une boutique avant de procéder à une première synchronisation chez votre hébergeur, afin de s assurer que les fiches de la boutique ne comporteront aucune anomalie. Pour effectuer la renumérotation des fiches d une ou de plusieurs boutique(s), cliquez sur le bouton Lancer l opération. 18 4D Business Kit Addendum

19 Module Outils pour la base de données Une boîte de dialogue de sélection vous permet de désigner la ou les boutique(s) à traiter parmi toutes les boutiques de l espace courant : Boutique sélectionnée Lorsque vous cliquez sur le bouton OK, une boîte de dialogue de confirmation apparaît. Après validation, une boîte de dialogue affiche la progression du traitement. A l issue de l opération, vous retournez directement au module courant. Archivage des journaux La zone Archivage des journaux du module Outils pour la base de données permet d archiver tous les journaux du serveur Web : connexions Web requêtes Web messages sortants Note Une nouvelle option des Préférences permet d archiver automatiquement le journal Web principal (cf. paragraphe Préférences, page 1). Par défaut, l archivage est réalisé à partir de la date du jour moins un mois. Autrement dit, la base de données conserve les données du dernier mois d activité. Le tableau indique le nombre d éléments 4D Business Kit Addendum 19

20 4D Business Kit version 2.2 Addendum présents pour chaque type de donnée et chaque boutique en fonction de la date sélectionnée. Vous devez cocher chaque élément à archiver : Liste des éléments et des boutiques Nombre d éléments à archiver Elément sélectionné Date jusqu à laquelle archiver les éléments La date est modifiable ; vous pouvez décider d archiver par exemple la totalité des données des boutiques jusqu à aujourd hui. Pour modifier la date, cliquez sur les flèches de sélection. Une fois la date définie, cliquez sur le bouton Afficher : 4D Business Kit met à jour les données des tableaux en fonction de la nouvelle date. Pour lancer l archivage des journaux sélectionnés, cliquez sur le bouton Archiver... Une boîte de dialogue de confirmation apparaît. Cliquez sur OK pour lancer la copie. A l issue de l archivage, les compteurs sont remis à zéro. Les archives sont stockées sous forme de fichiers texte dans le dossier de chaque boutique. Modifications diverses Diverses modifications ont été apportées à plusieurs parties de 4D Business Kit Fermeture des sessions La nouvelle commande Fermer toutes les sessions... du menu Fichier permet de refermer en une opération toutes les sessions utilisateur ouvertes sur le serveur : 20 4D Business Kit Addendum

21 Modifications diverses Réexpédier des messages Une nouvelle commande du menu contextuel du module des Messages sortants permet au marchand de renvoyer une sélection de messages. Cette option est utile dans le cas où l expédition initiale des messages semble avoir échoué. Pour réexpédier un ou plusieurs messages, effectuez une sélection dans le module puis choisissez la commande Réexpédier ce(s N) message(s) dans le menu contextuel : Une boîte de dialogue vous indique que le mécanisme de répétition automatique des envois de messages va être remis à zéro pour le(s) message(s) sélectionné(s). Cliquez sur OK pour expédier le message. Gérer les liens de téléchargement Il est désormais possible de générer des liens périssables protégés pour le téléchargement d objets externes (cf. paragraphe Gestion d objets externes, page 9). Ces liens sont stockés sous forme de lignes dans le 4D Business Kit Addendum 21

22 4D Business Kit version 2.2 Addendum module Commandes et peuvent être visualisés dans la nouvelle page Divers des fiches de ce module : Si un article propose plusieurs liens de téléchargement via plusieurs vues, chaque lien génère une ligne dans la liste des liens. L option Regénérer les liens de téléchargement permet de rétablir pour une nouvelle durée limitée les URLs de téléchargement après qu ils aient expiré (par exemple si le client n a pas téléchargé le fichier pendant le délai imparti). Cette option est également accessible via une nouvelle ligne du menu contextuel du module Commandes en mode liste : Référencement des sites par les moteurs de recherche Désormais, lorsque 4D Business Kit reçoit une requête HTTP provenant d un robot ou spider (tel que Google), l URL de la page d accueil n est pas encodé avec une extension du type &&valeurs afin de permettre le référencement. Pour identifier la provenance de la requête, 4D Business Kit utilise la liste de toutes les signatures user-agent des robots, placée dans le fichier Robots_Agents.txt dans le dossier principal de 4D Business Kit. Cette liste est mise à jour automatiquement : 4D Business Kit y inscrit la 22 4D Business Kit Addendum

23 Modifications diverses signature user-agent des auteurs des requêtes demandant le fichier robots.txt (ce fichier est généralement utilisé par les robots et les spiders). Le fichier robots.txt doit être configuré de manière à autoriser l accès à la page d accueil de chaque site. Par exemple, il peut contenir une ligne du type : Allow: /TEST_Site/WebPagesUS/home.htm Synchronisation Assistant de synchronisation La fonction de synchronisation des sites a été modifiée dans 4D Business Kit 2.2 : l assistant de synchronisation a été remodelé et un nouveau mode de synchronisation est désormais disponible. L assistant de synchronisation comporte désormais deux pages représentant les deux étapes principales de la procédure de synchronisation des serveurs : la connexion et la synchronisation. Créer un compte gratuit : la première page de l assistant contient le bouton Créer un compte gratuit... permettant d accéder à une page de création d un compte gratuit chez un hébergeur partenaire : Cette formule vous permet de tester gratuitement, pendant une durée limitée (30 jours), toutes les possibilités liées à l hébergement à distance d une boutique 4D Business Kit. 4D Business Kit Addendum 23

24 4D Business Kit version 2.2 Addendum Nouveau mode de synchronisation Un nouveau mode de synchronisation est disponible dans la seconde page de l assistant de synchronisation : le mode remplacement. Dans ce mode, les fiches éventuellement présentes sur le serveur distant sont supprimées avant la synchronisation. Ce mode peut être activé ou non pour chaque module synchronisé. Pour cela, il suffit de cocher les options correspondantes en regard de chaque ligne, dans la partie droite de la fenêtre de synchronisation. Le bouton Remplacement permet de cocher toutes les options : Options de choix du mode de synchronisation Ce mode permet de s assurer que les deux serveurs sont parfaitement synchronisés. Il peut être utile par exemple après de nombreuses modifications effectuées dans les modules du marchand. Synchronisation des paramètres de la boutique Nouvel organisme de génération de certificat SSL Il est désormais possible de sélectionner ou de désélectionner les paramètres de la boutique pour la synchronisation (dans les versions précédentes de 4D Business Kit, ces paramètres étaient automatiquement mis à jour). Ce principe permet par exemple de maintenir des paramétrages différents chez le marchand et chez l hébergeur. Un nouvel organisme certifié SSL en plus de Thawte et de VeriSign est disponible dans l outil de génération de certificat SSL : QualitySSL. Pour plus d informations, rendez-vous sur D Business Kit Addendum

25 Modifications diverses Solutions de paiement Composant 4D Business Kit 2.2 propose les nouveautés suivantes : CyberPlus/Banque Populaire (France) CyberPlus est une solution de paiement sécurisé française proposée par le Groupe Banques Populaires, basée sur la plate-forme PC pour effectuer des paiements par carte bancaire. Cette solution de paiement fonctionne sur le même principe que la solution Sogenactif de la Société Générale. Un guide d utilisation de cette solution (4DBK_et_Sogenactif.pdf) est disponible sur le site Cette solution est visible dans la boutique TEST (payment_cyberplus.htm, payment_cyberplus _auto.htm). WorldPay (international) WorldPay est une solution de paiement mondiale fonctionnant sur les plates-formes Mac et PC et acceptant les principales cartes de crédit. Veuillez consulter le guide d utilisation de cette solution (4DBK_and_WorldPay.pdf) sur le site Cette solution est visible dans la boutique TEST (payment_worldpay.htm, payment_worldpay_cb.htm). Par ailleurs, plusieurs solutions de paiment existantes ont été mises à jour : PayPal (USA, Europe) : Cette solution fonctionne à présent pour l Europe en plus des Etats-Unis. Pour plus d informations, reportezvous au fichier de script US_PayPal.txt placé dans le dossier Services/Payments/CreditCards ainsi qu au manuel 4DBK_and_PayPal.pdf téléchargeable à l adresse Cette solution est visible dans la boutique TEST (payment_paypal_cb.htm). PayBox (France) : Une nouvelle implémentation pour PayBox a été réalisée (voir le manuel 4DBK_and_PayBox.pdf). BancaSella (Italie) : la solution BancaSella a été mise à jour (voir le manuel 4DBK_and_BancaSella.pdf). SP+ (France) : La solution SP+ est maintenant correctement prise en charge dans 4D Business Kit. Il est à présent possible d utiliser un proxy lors de l utilisation du composant 4DBK dans une base 4D conjointement avec un serveur 4D Business Kit. Une nouvelle boîte de dialogue d alerte demandant de préciser les paramètres réseau du proxy a été ajoutée dans la base de démonstration fournie avec le composant. 4D Business Kit Addendum 25

26 4D Business Kit version 2.2 Addendum Langage Thème Fiches Quatre nouvelles commandes permettent de vérifier l existence d un fichier externe, de l afficher et/ou de lui associer un lien protégé : 4DBKExternalFile, 4DBKExternalFileExists, 4DBKExternalFileToDownload et 4DBKDownloadKeyNew. La nouvelle commande 4DBKItemLoad permet de charger directement la fiche d un article. 4DBKExternalFileExists <!--#4DBKExternalFileExists/index--> Paramètre Description Valeur(s) index Numéro de vue de Numérique l article courant Objectif : Tester l existence d un fichier externe (image, son, vidéo...) pour la vue N de l article courant. Description La commande 4DBKExternalFileExists retourne True ou False selon que la vue numéro index de l article courant contient ou non un fichier externe. Cette commande est utilisée dans le cadre de l utilisation d un fichier son, vidéo associé à la vue d un article (cf. paragraphe Gestion d objets externes, page 9). Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet, la sélection courante à l aide de la commande 4DBKSelectionSet et la fiche courante à l aide de la commande 4DBKRecordSet. 26 4D Business Kit Addendum

27 Langage Exemples L exemple suivant vérifie s il existe un fichier externe pour une fiche donnée dans la sélection et le cas échéant l affiche : <!--#4DBKStoreSet/MCOM--> //passer sur la boutique MCOM <!--#4DBKSelectionSet/1--> //passer sur la sélection numéro 1 <!--#4DBKRecordSet/1--> //passer sur la 1re fiche <!--#4DBKIf(4DBKExternalFileExists/1)--> //s il y a un fichier externe associé à la vue 1 de l article courant <img src= <!---#4DBKExternalFile/1--> //alors afficher ce fichier externe <!--4DBKEndIf--> L exemple suivant définit une image qui se trouve sur un autre serveur Web ( : <!--#4DBKIf(4DBKExternalFileExists/1)--> <img src="<!--#4dbkexternalfile/1-->"> <!--#4DBKEndIf--> // Si on a défini un film qui se trouve dans le dossier External, par exemple monfilm.mov <!--#4DBKIf(4DBKExternalFileExists/1)--> <embed src="monfilm.mov" width="240" height="136" type="video/quicktime" href="<!--#4dbkexternalfile/1-->" autoplay="false" controller="true" target= "myself"> </embed> <!--#4DBKEndIf--> Référence : 4DBKExternalFile, 4DBKThumbnailExists, 4DBKIconExists, 4DBKTextExists, 4DBKPictureExists. 4DBKExternalFile <!--#4DBKExternalFile/index[,info]--> Paramètre Description Valeur(s) index Numéro de vue de Numérique l article courant info Information à obtenir S : Taille en octets ES : Taille exprimée en Ko, Mo, Go Objectif : Retourner le chemin d accès ou une caractéristique spécifique du fichier externe associé à la vue courante de l article courant. Description La commande 4DBKExternalFile retourne le chemin d accès disque ou Web du fichier externe associé à la vue courante de l article courant. 4D Business Kit Addendum 27

28 4D Business Kit version 2.2 Addendum 4DBKExternalFileToDownload Dans un lien, si vous souhaitez que la valeur soit retournée au moment du chargement de la page et non au moment où l utilisateur clique sur le lien, utilisez l instruction!4dbkexternalfile. Lorsque la syntaxe 4DBKExternalFile/index,S est utilisée, la fonction retourne la taille en octets du fichier (par exemple ). Lorsque la syntaxe 4DBKExternalFile/index,ES est utilisée, la fonction retourne la taille du fichier exprimée en Ko, Mo ou Go en fonction de sa taille (par exemple 2,54 Ko ). Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet, la sélection courante à l aide de la commande 4DBKSelectionSet et la fiche courante à l aide de la commande 4DBKRecordSet. Exemple Voir l exemple de la commande 4DBKExternalFileExists. Référence : 4DBKExternalFileExists, 4DBKThumbnailExists, 4DBKIconExists, 4DBKTextExists, 4DBKPictureExists. <!--#4DBKExternalFileToDownload/index--> Paramètre Description Valeur(s) index Numéro de vue de Numérique l article courant Objectif : Permet de savoir si la vue d un article est liée à un fichier externe téléchargeable. Description La commande 4DBKExternalFileToDownload retourne True si la vue index de l article courant est liée à un fichier externe téléchargeable. Cette option est définie à l aide d une case à cocher dans le module Articles, page Vues (cf. paragraphe Téléchargement du fichier, page 11). 28 4D Business Kit Addendum

29 Langage Note Avant de vérifier si le fichier est téléchargeable, il est conseillé de vérifier qu un fichier externe existe à l aide de la commande 4DBKExternalFileExists. 4DBKDownloadKeyNew Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet, la sélection courante à l aide de la commande 4DBKSelectionSet et avoir vérifié qu un fichier externe est associé à la vue à l aide de la commande 4DBKExternalFileExists. Exemple Voir l exemple de la commande 4DBKDownloadKeyNew. Référence : 4DBKDownloadKeyNew. <!--#4DBKDownloadKeyNew/valeur,index[,commande][,jours]--> Paramètre Description Valeur(s) valeur Valeur du champ code C01 de Numéro d article l article index Numéro de vue de l article à laquelle Numéro de vue est associé un fichier externe commande Numéro de la commande Numéro de commande jours Période durant laquelle le fichier sera téléchargeable Nombre de jours Objectif : Permet de créer un lien protégé pour télécharger un fichier externe. Description La commande 4DBKExternalFileToDownload génère un lien protégé vers le fichier externe de la vue index de l article désigné par le paramètre valeur. Le paramètre commande permet de désigner le numéro de la commande associée au lien. Vous pouvez omettre ce paramètre dans le cadre d un téléchargement gratuit par exemple. 4D Business Kit Addendum 29

30 4D Business Kit version 2.2 Addendum En général, pour des raisons de sécurité, la durée de vie de ce type de lien doit être limitée. Vous pouvez donc fixer dans le paramètre jours le nombre de jours pendant lequel il sera disponible. Des liens protégés doivent être générés pour le téléchargement de fichiers payants (par exemple des programmes, des images, etc.). Ces liens sont encodés de manière à ce que leur contenu, notamment l emplacement du fichier, soit totalement masqué. Pour qu un fichier téléchargeable ne puisse être chargé autrement que via un lien protégé, vous devez cocher l option correspondante dans la page Vues de l article (cf. paragraphe Téléchargement du fichier, page 11). Note Avant de tenter de générer un lien protégé, il est conseillé de vérifier qu un fichier externe existe à l aide de la commande 4DBKExternalFileExists et qu il est téléchargeable à l aide de 4DBKExternalFileToDownload. Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet, la sélection courante à l aide de la commande 4DBKSelectionSet et avoir vérifié qu un fichier externe est associé à la vue à l aide de la commande 4DBKExternalFileExists. Exemple L exemple suivant peut être utilisé sur un site de vente d images en haute résolution. Dans un premier temps, l utilisateur remplit son panier en cliquant sur des imagettes, puis paye. La page Web appelée à son retour de la passerelle de paiement peut contenir le code suivant : <!--#4DBKSelectionSet/B--> <!--#4DBKRecordSet/1--> <!--#4DBKLoop/VL01,1,4DBKSelectionSize--> <!--#4DBKIf(4DBKRecordExists)--> <!--#4DBKIf(4DBKExternalFileExists/1)--> // y a-t-il un fichier externe? <!--#4DBKIf(4DBKExternalFileToDownload/1)--> // ce fichier est-il téléchargeable? <a href="<!--#4dbkdownloadkeynew/4dbkfield/c01,1,,3-->">téléchargez le produit <!-#4DBKField/C01--> (<!--#4DBKExternalFile/1,ES-->) </a> //affiche un lien de téléchargement actif pendant 3 jours, indiquant la taille du fichier <!--#4DBKEndIf--> <!--#4DBKEndIf--> 30 4D Business Kit Addendum

31 Langage <!--#4DBKEndIf--> <!--#4DBKRecordNext/1--> <!--#4DBKEndLoop/VL01--> Référence : 4DBKExternalFileToDownload. 4DBKItemLoad <!--#4DBKItemLoad/valeur--> Paramètre Description Valeur(s) valeur Valeur du champ code C01 Chaîne (30 caractères) de l article ou variable Objectif : Charger directement un article, sans qu il soit nécessaire de définir une sélection ni une recherche. Description La commande 4DBKItemLoad définit un article qui sera chargé. Cette commande est adaptée aux nouveaux utilisateurs de 4D Business Kit car elle ne nécessite pas de définir de sélection ni de recherche. Elle est adaptée également aux personnes qui souhaitent publier la référence d un article auprès d un portail ou d un listing Web (par exemple Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet. Exemples L exemple suivant charge l article 1 : <!--#4DBKItemLoad/0001--> L exemple suivant charge le énième élément d une liste à partir du contenu d une variable. On passe l URL suivant : loaditem.htm&&2bxblu0obduox2nvxmpolgxolobo24kax_saws_awa?it m=0001,0002,0003&op=add 4D Business Kit Addendum 31

32 4D Business Kit version 2.2 Addendum //<!--#4DBKURLParms--> retourne itm=0001,0002,0003&op=add //<!--#4DBKURLParms/1,&--> retourne itm=0001,0002,0003 //<!--#4DBKURLParms/1,&,LST&2&=--> retourne 0001,0002,0003 <!--#4DBKVarSet/VT01=4DBKURLParms/1,&,LST&2&=--> fixe VT01 à 0001,0002,0003 //<!--#4DBKVar/VT01,LST&N&,--> retourne 3 (3 articles dans la liste) <!--#4DBKVarSet/VL02=4DBKVar/VT01,LST&N&,--> fixe VL02 à 3 <!--#4DBKLoop/VL01,1,VL02--> boucle de 1 à 3 //<!--#4DBKVar/VT01,LST&4DBKVar/VL01&,--> retourne 0001 ou 0002 ou 0003 en fonction de la valeur de VL01 <!--#4DBKVarSet/VT02=4DBKVar/VT01,LST&4DBKVar/VL01&,--> fixe VT02 au énième élément de la liste //<!--#4DBKItemLoad/0001--> charge l article 0001 <!--#4DBKItemLoad/4DBKVar/VT02--> charge le énième élément de la liste <!--#4DBKIf(4DBKRecordExists)--> affiche les champs article <!--#4DBKEndIf--> <!--#4DBKEndLoop/VL01--> Thème Utilitaires Trois nouvelles commandes utilitaires ont été ajoutées dans 4D Business Kit 2.2 : 4DBKBeep, 4DBKHttpPost et 4DBKHttpGetCallBack. 4DBKBeep <!--#4DBKBeep[/son]--> Paramètre Description Valeur(s) son Nom de fichier son.wav à jouer Chaîne Objectif : Générer un son dans la page Web. Description La commande 4DBKBeep génère un tag <embed> indiquant au navigateur de jouer un son sur le poste de l utilisateur. Le son doit être contenu dans un fichier.wav stocké dans le dossier WebGenericMedia. Par défaut, 4D Business Kit utilise le fichier son Beep.wav (installé dans le dossier WebGenericMedia). Vous pouvez toutefois utiliser tout fichier son personnalisé en passant le paramètre son. Cette commande est utile en phase de développement pour vérifier par exemple que 4D Business Kit a bien traité une commande. Conditions Aucune. 32 4D Business Kit Addendum

33 Langage Exemples Les deux instructions suivantes renvoient le son par défaut contenu dans le dossier WebGenericMedia : <!--#4DBKBeep--> <!--#4DBKBeep/Beep.wav--> Pour tester en développement que les commandes sont stockées sur le serveur, il peut être intéressant de placer un 4DBKBeep après la commande 4DBKOrderValidate : <!--#4DBKOrderValidate-->// stocke donc la commande sur le serveur 4DBK <!--#4DBKBeep/Yes.wav-->// joue le son contenu dans Yes.wav stocké dans WebGenericMedia 4DBKHttpPost <!--#4DBKHttpPost/fichier,debug[,arg1[,arg2[,arg3[,arg4[,arg5]]]]]--> Paramètre Description Valeur(s) fichier Nom du fichier de POST Chaîne debug Noter les données échangées dans le fichier d historique 0=Noter les échanges 1=Ne pas noter les échanges arg1...arg5 Paramètres à passer au POST Chaîne Objectif : Générer un POST et récupérer les résultats dans des champs. Description La commande 4DBKHttpPost permet d envoyer une requête à un autre serveur Web via le protocole HTTP POST et de récupérer des résultats. La requête POST doit être définie dans un fichier texte, placé dans le dossier Scripts de la boutique. Le nom du fichier doit être passé dans le paramètre fichier. Lorsque le paramètre debug est à 1, un fichier de résultat est créé dans le dossier [Logs] de la boutique. Ce fichier de résultat contient la réponse du serveur Web auquel la requête a été envoyée. Les paramètres arg1 à arg5 peuvent être utilisés pour passer des valeurs à la requête POST. Ces paramètres devront être référencés dans le fichier de POST sous la forme [arg1], [arg2], etc. Ces marqueurs seront remplacés par leur valeur au moment de l envoi de la requête. 4D Business Kit Addendum 33

34 4D Business Kit version 2.2 Addendum Le résultat de la requête est retourné dans les champs 4DBKScriptCode1, 4DBKScriptCode2, 4DBKScriptCode3, 4DBKScriptCode4, 4DBKScriptCode5, 4DBKScriptCode6 ainsi que dans le champ 4DBKScriptText. Ces champs sont référencés dans le fichier de POST sous la forme [res_code1=] à [res_code6=] et [res_text=]. La valeur associée à chaque balise res_code indique la position, dans la réponse, de la valeur à affecter au champ 4DBKScriptCode ou 4DBKScriptText correspondant (cf. paragraphe suivant). Traitement du résultat de la requête dans le fichier de script fichier Le fichier de script fichier peut contenir diverses balises spécifiques permettant de formater le POST ainsi que la réponse. Pour accuser réception de la réponse du serveur Web, 4D Business Kit se base sur la présence du champ Content-length dans l en-tête HTTP de la réponse du serveur Web. Cependant, si ce champ n est pas renvoyé par le serveur Web, il est possible de fixer d autres points de repère à 4D Business Kit à l aide des balises suivantes : Balise [erx=] [erx2=] Fonction de la balise Chaîne de caractères servant de point d'arrêt à 4DBK pour accuser réception de la réponse du serveur Web Fonction identique à la balise [erx=] Note En l absence du champ Content-length ou de points de repères, la requête envoyée par 4D Business Kit se terminera en timeout. La façon dont la réponse du serveur Web est traitée par la commande 4DBKHttpPost est définie dans le fichier de script fichier via une série de balises : Balise [res_start=] [res_offset=] [res_end=] [res_fields=] Fonction de la balise Balise de début. Elle permet à 4DBK de reconnaître le début du texte qui sera traité. Si c'est un chiffre, définit le nombre de caractères dont on doit se décaler par rapport au marqueur de début pour obtenir le début de la réponse. Si c'est une chaîne de caractères, définit la chaîne de caractères qui marquera le début de la réponse. Balise de fin. Elle permet à 4DBK de reconnaître la fin du texte qui sera traité. Séparateur de champ. Elle permet de scinder la réponse obtenue du serveur web en plusieurs champs. 34 4D Business Kit Addendum

35 Langage [res_code1=] [res_coden=] [res_text=] Conditions En fonction du séparateur de champ, la valeur numérique associée à cette balise définit la position du champ dans la réponse finale dont la valeur doit être passée à 4DBKScriptCode1 Le fonctionnement des autres balises [res_code2=] à [res_code6=] et [res_text=] est identique. Aucune. Exemple Un exemple complet est fourni dans la page HTTPservices.htm du site TEST, il permet de vérifier la validité d un numéro de TVA intracommunautaire. POST entre serveurs 4DBK Il est désormais possible d effectuer des requêtes POST entre deux serveurs 4D Business Kit. Le POST doit être formaté de la façon suivante : action="/4daction/4dbkexecute/4dbkstoreset/test;4dbkgo/page.htm". Dans la page page.htm, les paramètres POST peuvent être récupérés via la commande 4DBKHttpPostParms. 4DBKHttpGetCallBack <!--#4DBKHttpGetCallBack/champSession,page,debug--> Paramètre Description Valeur(s) champsession Nom du champ dans Nom de champ lequel l identifiant de la session a été stocké page Nom de la page appelée Chaîne de caractères debug Créer un fichier de résultat 0 : Ne pas créer de fichier 1 : Créer un fichier Objectif : Définir le point de rappel d une passerelle de paiement vers le serveur 4D Business Kit. Description La commande 4DBKHttpGetCallBack permet de prendre en charge les passerelles de paiement qui utilisent des requêtes basées sur un GET HTTP. La syntaxe et le fonctionnement de cette commande sont 4D Business Kit Addendum 35

36 4D Business Kit version 2.2 Addendum strictement identiques à ceux de la commande 4DBKHttpPostCallBack. 4DBKHttpGetCallBack et 4DBKHttpPostCallBack sont équivalentes et ont le même rôle. Simplement, certaines solutions de paiement utilisent des POST, d autres des GET. Pour plus d informations sur le principe de fonctionnement de cette commande, reportez-vous à la description de la commande 4DBKHttpPostCallBack. A noter toutefois : Cette commande ne s utilise pas dans des pages Web ni dans un fichier de configuration de paiement. Elle s utilise dans les pages Web de configuration de la passerelle de paiement, c est-à-dire dans l interface marchande de la passerelle de paiement. Voir le manuel 4DBK_and_VeriSign_PayFlowLink.pdf Dans le cadre d un formulaire HTML, on passe la commande dans une chaîne (non traitée par 4DBK mais communiquée à la passerelle pour qu elle puisse à son tour communiquer avec le serveur 4DBK). Voir le fichier payment_paypal.htm. Exemple Reportez-vous, dans le site TEST, aux pages payment_paybox.htm et payment_paybox_cb.htm. Thème Commandes Il est désormais possible d afficher les commentaires associés aux commandes à l aide des nouvelles commandes 4DBKOrderComment. 4DBKOrderComment, 4DBKOrderComment2, 4DBKOrderComment3 <!--#4DBKOrderComment/ligne--> Paramètre Description Valeur(s) ligne Ligne de commande de laquelle Numéro de ligne afficher le commentaire Objectif : Afficher le(s) commentaire(s) associé(s) à la commande en cours. 36 4D Business Kit Addendum

37 Langage Description Les commandes 4DBKOrderComment, 4DBKOrderComment2 et 4DBKOrderComment3 permettent d afficher chacune des trois zones de commentaires associées à la commande courante. Passez dans le paramètre ligne le numéro de la ligne de commande dont vous souhaitez afficher le commentaire. Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet. Exemple L exemple suivant affiche le premier commentaire de la ligne définie par la variable VL01, si elle n est pas vide : <!---#4DBKIf(4DBKOrdersComment/4DBKVar/VL01,F)--> <!---#4DBKOrdersComment/4DBKVar/VL01--> <!---#4DBKEndIf--> Référence : 4DBKOrderCommentSet. Thème Suivi de commandes De nouvelles commandes peuvent être utilisées pour afficher les fichiers et les URLs téléchargeables associés à des vues (cf. paragraphe Gestion d objets externes, page 9). 4DBKOrdersCode <!--#4DBKOrdersCode/index--> Paramètre Description Valeur(s) index Numéro d indice de la commande De 0 à dans la liste des commandes 4DBKOrdersSize Objectif : Afficher le code C01 d une ligne de commande. La commande 4DBKOrdersCode retourne la valeur du code C01 de la ligne numéro index de la commande courante. Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet et un client doit être identifié à l aide de la commande 4DBKCustomerLogin. 4D Business Kit Addendum 37

38 4D Business Kit version 2.2 Addendum 4DBKOrdersDownloadLink <!--#4DBKOrdersDownloadLink[N]/index--> 4DBKOrdersDownloadFile Paramètre Description Valeur(s) N Numéro de vue Numéro de vue index Numéro d indice de la commande dans la liste des commandes De 0 à 4DBKOrdersSize Objectif : Afficher l URL de téléchargement associé à une vue. La commande 4DBKOrdersDownloadLink permet d afficher l URL de téléchargement de la ligne numéro index de la commande courante. Si la ligne de commande comporte plusieurs liens de téléchargement, utilisez la commande 4DBKOrdersDownloadLinkN où N représente le numéro de la vue de l URL à afficher. Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet et un client doit être identifié à l aide de la commande 4DBKCustomerLogin. <!--#4DBKOrdersDownloadFile[N]/index--> Paramètre Description Valeur(s) N Numéro de vue Numéro de vue index Numéro d indice de la commande dans la liste des commandes De 0 à 4DBKOrdersSize Objectif : Afficher le nom du fichier associé à une vue. La commande 4DBKOrdersDownloadFile permet d afficher le nom du fichier de téléchargement de la ligne numéro index de la commande courante. Si la ligne de commande comporte plusieurs liens de téléchargement, utilisez la commande 4DBKOrdersDownloadFileN où N représente le numéro de la vue du fichier à télécharger. 38 4D Business Kit Addendum

39 Langage 4DBKOrdersDownloadSize Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet et un client doit être identifié à l aide de la commande 4DBKCustomerLogin. <!--#4DBKOrdersDownloadSize[N]/index--> Paramètre Description Valeur(s) N Numéro de vue Numéro de vue index Numéro d indice de la commande dans la liste des commandes De 0 à 4DBKOrdersSize Objectif : Afficher la taille du fichier associé à une vue. La commande 4DBKOrdersDownloadSize permet d afficher la taille en octets du fichier de téléchargement de la ligne numéro index de la commande courante. Si la ligne de commande comporte plusieurs liens de téléchargement, utilisez la commande 4DBKOrdersDownloadSizeN où N représente le numéro de la vue du fichier dont vous souhaitez afficher la taille. Conditions Il faut avoir préalablement fixé la boutique courante à l aide de la commande 4DBKStoreSet et un client doit être identifié à l aide de la commande 4DBKCustomerLogin. Commandes modifiées Cette section détaille les commandes modifiées dans 4D Business Kit 2.2 : 4DBKVarSet, 4DBKPicture, 4DBKMail et 4DBKHttpPostParms. 4DBKVarSet Il est parfois nécessaire d insérer des caractères spéciaux (retour chariot, point d interrogation, espace, etc.) dans le paramètre valeur de la commande 4DBKVarSet. Ces caractères ayant une fonction spécifique dans la syntaxe HTML ou dans 4D Business Kit, ils peuvent être interprétés incorrectement par le programme. 4D Business Kit Addendum 39

40 4D Business Kit version 2.2 Addendum 4DBKPicture Pour remédier à ce problème, il est désormais possible d utiliser une syntaxe alternative pour chaque caractère spécial : Caractère spécial Syntaxe alternative cr (retour chariot) &cr ou ^r cr lf &crlf <br> &br? &query, &comma espace &space & &amp : &colon ; &semicolon Exemple L exemple suivant insère Legrand, Marc dans la variable VT01 : 4DBKVarSet/VT01=Legrand 4DBKVarSet/VT01+=&comma&spaceMarc <!--#4DBKPicture/index[,info]--> Paramètre Description Valeur(s) index Numéro de vue de Numérique l article courant info Information à obtenir W=largeur en pixels H=hauteur en pixels S=taille en octets ES=taille exprimée en Ko, Mo, Go Comme la nouvelle commande 4DBKExternalFile, 4DBKPicture accepte désormais la valeur ES dans le paramètre info. Cette valeur provoque également le retour de la taille de l image, mais interprétée en Ko, Mo (ou Go) en fonction de sa taille. Par exemple, une taille de 1024 octets sera affichée 1,0 Ko. Une taille de octets sera affichée 5,26 Mo (l affichage de l unité dépend de la langue principale de la boutique). 40 4D Business Kit Addendum

41 Langage 4DBKMail La commande 4DBKMail permet désormais d encoder les fichiers de feuilles de styles, les images de fond et davantage de types de fichiers à l intérieur d un mail. La commande a également été améliorée pour prendre en charge la partie texte brut d un message HTML. 4DBKHttpPostParms <!--#4DBKHttpPostParms/nomChamp[,format]--> Paramètre Description Valeur(s) nomchamp Nom du champ du formulaire Chaîne de caractères dont il faut récupérer la valeur format Format d affichage BR : Remplacement des retours chariot Le nouveau paramètre format permet de remplacer dans le champ les codes CRLF (Carriage Return Line Feed) et CR (Carriage Return) par des balises <BR>. Nouveaux champs StHTTP, StHTTPS Plusieurs nouveaux champs sont disponibles dans les thèmes Divers, Panier, Boutique et Client. Nouveaux champs du thème Divers. Champ Field Description [StHTTP] X Retourne True si la page Web a été servie en HTTP [StHTTPS] X Retourne True si la page Web a été servie en HTTPS Ces champs permettent de tester si la page Web a été servie en HTTP ou en HTTPS. Exemple : <!---#4DBKIf(4DBKField/StHTTP--> // si ce champ retourne True HTTP Stream // HTTP stream est affiché <!---#4DBKElse-> //sinon HTTPS Stream // HTTPS stream est affiché <!---#4DBKEndIf--> 4D Business Kit Addendum 41

42 4D Business Kit version 2.2 Addendum BskPrItemEXV, BskPrItemINV Nouveaux champs du thème Panier : Lignes de commandes Field Query Distinct Sort Basket Set Import Export Type X X Réel Indiquent le prix total (quantité X prix) en HT et en TTC de la ligne de commande sans les remises. Ces champs permettent de mettre en évidence le gain que représente l octroi d une remise. Exemple : Prix article = 10 euros Quantité acheté = 5 Prix remisé = 8,50 euros (BskPrUnit) Prix total sans remise = 50 euros (BskPrItemEXV) Prix total avec remise = 42,50 euros (BskPrSale) StoreCustom1, StoreCustom2, StoreCustom3 Nouveaux champs du thème Boutique Champ Field Description StoreCustom1 X Champ personnalisé n 1 de configuration de passerelle de paiement (identifiant, mot de passe...) StoreCustom2 X Champ personnalisé n 2 de configuration de passerelle de paiement StoreCustom3 X Champ personnalisé n 3 de configuration de passerelle de paiement Exemple (extrait de la page payment_cybermut.htm) : <!--Clé (ou hash key)--> <!--#4DBKVarSet/VT23="0x e9f71f a93b2b2e326e532b 00"--> // peut être écrit: <!--Clé (ou hash key)--> <!--#4DBKVarSet/VT23="StoreCustom1"--> la valeur de StoreCustom1 étant stockée dans les paramètres de la boutique : 42 4D Business Kit Addendum