4D Business Kit version 2.0 MISE À JOUR

Transcription

1 4D Business Kit version 2.0 MISE À JOUR Bienvenue dans la version 2.0 de 4D Business Kit. Ce document décrit les nouveautés proposées par cette version du programme. Toutes ces nouveautés ont été intégrées à la documentation. Veuillez vous y référer pour plus de détails sur les fonctions décrites dans ce document. Application 4D Business Kit La version 2.0 de 4D Business Kit propose de nombreuses nouveautés concernant les parties suivantes de l application : Protection des accès Préférences du serveur 4D Business Kit Informations sur le serveur 4D Business Kit Module Boutiques Module Articles Module Taxes Modules Clients et Commandes Outils Protection des accès La gestion des accès a été renforcée dans 4D Business Kit 2.0 : l accès à plusieurs fonctions avancées du serveur Web (Démarrage/Arrêt, Synchronisations, etc.) peut désormais être désactivé à l aide d options dans la boîte de dialogue des Préférences (page Droits d accès). l accès à la boîte de dialogue des Préférences peut être protégé par un mot de passe. l accès aux modules du serveur (articles, commandes, etc.) s effectue désormais au sein d une session utilisateur. Pour ouvrir une session, chaque utilisateur doit saisir un nom et un mot de passe. La page Comptes d accès de la fenêtre de paramétrage des boutiques permet de définir précisément les droits de chaque utilisateur. 4D Business Kit Mise à jour 1

2 4D Business Kit version 2.0 Mise à jour l accès à la fenêtre de paramétrage des boutiques peut être protégé par un mot de passe. Voir : Manuel de référence, page 49 Zones d accès 4D Business Kit vous permet de définir des zones d accès protégé dans vos boutiques. Ces zones, définies via un URL spécifique, sont accessibles à l aide d un code et un mot de passe. Voir : Manuel de référence, page 180 Préférences du serveur Fonctions Réseau La nouvelle page Réseau contient plusieurs nouvelles options : Utiliser la technologie UpBeat : 4D Business Kit 2.0 permet d utiliser la technologie UpBeat avec les systèmes de redémarrage automatique. Serveur Proxy : Il est possible de désigner l adresse d un serveur proxy. Cette nouvelle option est utile notamment lorsque 4D Business Kit est utilisé conjointement à d autres serveurs Web et est placé derrière un serveur proxy. Page introuvable : Cette nouvelle option permet de choisir si la page d accueil par défaut du serveur 4D Business Kit doit afficher ou non la liste des boutiques. Voir : Manuel de référence, page 96 Intégration avec d autres serveurs Web Il est possible d utiliser conjointement 4D Business Kit 2.0 avec d autres serveurs Web (4D WebSTAR, Apache et MS IIS). L adresse du serveur associé doit être saisie dans les Préférences de 4D Business Kit. Des fichiers de configuration sont également fournis. Voir : Manuel de référence, page D Business Kit Mise à jour

3 Application 4D Business Kit Réglages avancés La page Réglages avancés comporte divers réglages permettant de protéger et d optimiser l utilisation de la mémoire. De nouvelles options de debug permettent également de générer des fichiers d historique ou d afficher un logo sur chaque page afin d identifier le serveur d origine. Voir : Manuel de référence, page 102 Gestion des adresses IP dynamiques Une nouvelle fonction située dans la page Hébergement des Préférences permet d utiliser un serveur 4D Business Kit sur une adresse IP dynamique (cas de l auto-hébergement). Voir : Manuel de référence, page 99 Informations sur le serveur Accès Web direct Il est désormais possible d accéder directement à la page Web d accueil du serveur 4D Business Kit via un clic sur un lien dans la fenêtre d activité du serveur Web. Voir : Manuel de référence, page 384 Utilisateurs uniques La zone Données Web servies de la fenêtre d activité du serveur Web (ainsi que le Journal des requêtes Web) affiche désormais les Utilisateurs uniques. La notion d utilisateurs uniques correspond au nombre de pages visitées au cours de la session et traduit l intérêt de l utilisateur pour la boutique (et inversement). Voir : Manuel de référence, page 385 Informations mémoire L affichage des informations sur l occupation des ressources mémoire a été modifié afin de mieux tenir compte des spécificités de chaque plate-forme. Voir : Manuel de référence, page 386 4D Business Kit Mise à jour 3

4 4D Business Kit version 2.0 Mise à jour Maintenance Une nouvelle page dans la fenêtre d activité du serveur Web permet d utiliser des options de maintenance : écriture immédiate des données sur le disque clichés des données Web servies (état des connexions à différents instants). Voir : Manuel de référence, page 390 Module Boutiques Utilisation de serveurs SMTP avec authentification De nouvelles options dans la page Courrier de la fenêtre de paramétrage des boutiques permettent d utiliser des serveurs SMTP requérant l authentification CRAM-MD5. Voir : Manuel de référence, page 154 Devise de saisie Il est désormais possible de définir une devise de saisie différente pour chaque boutique (fenêtre Boutiques, page Données). Voir : Manuel de référence, page 156 Jeu de caractères Il est désormais possible de modifier pour chaque boutique le jeu de caractères utilisé par 4D Business Kit pour encoder les pages servies (page Publication Web). Voir : Manuel de référence, page 149 Enregistrer les sessions sur disque Sous Windows, lorsque les cookies du navigateur sont activés, 4D Business Kit permet de stocker dans un fichier texte sur disque les sessions des utilisateurs. Les utilisateurs retrouvent ainsi leur environnement à chaque visiste sur le site (fenêtre Boutiques, page Sessions Web). Voir : Manuel de référence, page D Business Kit Mise à jour

5 Application 4D Business Kit Sécurité des connexions avec le composant Les échanges des boutiques avec le composant 4DBK peuvent désormais être sécurisés via un mot de passe (fenêtre Boutiques, page Composant 4D). Voir : Manuel de référence, page 166 Module Articles Modification globale La nouvelle fonction Affecter de nouvelles valeurs... (menu contextuel de la fenêtre des articles) permet d appliquer en une seule opération diverses modifications à une sélection d articles. Voir : Manuel de référence, page 205 Ne pas appliquer de frais de port Une nouvelle option de la fenêtre de définition des articles (page Prix) permet d exclure l article du calcul des frais de port. Voir : Manuel de référence, page 224 Garder les paramètres originaux des images Une nouvelle option de la fenêtre de définition des articles (page Vues) permet d importer directement des fichiers image en conservant leurs propriétés de taille et de compression. Voir : Manuel de référence, page 228 Module Taxes Gestion des taxes La gestion des taxes a été entièrement revue : les modules TVA et Taxe sur état ont été remplacés par un module unique, Taxes. Il est possible de définir plusieurs taxes, appliquées en fonction de critères géographiques. Chaque taxe peut comporter différents taux, spécifiés par l article. Ce nouveau fonctionnement permet de prendre en compte les spécificités de chaque pays. Note : 4D Business Kit 2.0 convertit automatiquement les taxes définies dans la version 1.x. Désormais, 4D Business Kit ne stocke plus le prix TTC d un article, mais son prix HT. Le prix TTC est toujours calculé à la volée. 4D Business Kit Mise à jour 5

6 4D Business Kit version 2.0 Mise à jour Lorsque le client n est pas encore identifié, le programme applique la taxe définie comme taxe par défaut. Voir : Manuel de référence, page 319 Module Modes d expédition Mode de calcul des frais de port Il est désormais possible de baser le calcul des frais de port sur une formule. Voir : Manuel de référence, page 308 Franco de port Cette nouvelle option (fenêtre Modes d expédition, page Comportement) permet d annuler les frais de port lorsque le montant de la commande dépasse une valeur donnée. Voir : Manuel de référence, page 312 Modules Clients et Commandes Import/Export Il est désormais possible d importer et d exporter les données des modules Clients et Commandes. Voir : Manuel de référence, page 259 et page 283 Nouveaux champs De nouveaux champs d information sont disponibles dans les fiches Clients et Commandes. Voir : Manuel de référence, page 268 et page 289 Outils Synchronisation 4D Business Kit comporte des fonctions avancées permettant de synchroniser les pages Web ainsi que les articles, les commandes et les clients entre deux serveurs. Cette fonction répond aux besoins liés à l hébergement à distance : le marchand et l hébergeur disposent chacun d une copie identique de la boutique. La synchronisation permet au marchand d ajouter ou de mettre à jour des articles et de rapatrier les commandes ou les clients. Voir : Manuel de référence, page D Business Kit Mise à jour

7 Langage : nouvelles commandes Analyse des journaux Web Une nouvelle boîte de dialogue, accessible via le menu Outils, permet de générer un fichier texte au format CLF pour chaque boutique, à partir du fichier d historique principal. Il est également possible d archiver le fichier d historique principal. Voir : Manuel de référence, page 401 Nettoyer le dossier des vues Cette nouvelle commande, accessible via le menu Outils, permet de retirer du dossier Vues de chaque boutique tout fichier inutilisé par 4D Business Kit. Voir : Manuel de référence, page 183 Langage : nouvelles commandes 4DBKShippingComment <!--#4DBKShippingComment/index--> 4DBKVATNumberSet index Numéro d indice du mode d expédition dans la liste des frais de port De 0 à 4DBKShippingSize Objectif : Afficher le commentaire du Nième mode d expédition. Voir : Manuel Langage, page 106 <!--#4DBKVATNumberSet/numéro--> numéro Numéro de TVA Chaîne intracommunautaire Objectif : Définir le numéro de TVA intracommunautaire du client courant. Voir : Manuel Langage, page 97 4D Business Kit Mise à jour 7

8 4D Business Kit version 2.0 Mise à jour 4DBKVATNumber <!--#4DBKVATNumber--> Cette commande ne requiert pas de paramètre. Objectif : Retourner le numéro de TVA intracommunautaire du client courant. Voir : Manuel Langage, page 97 4DBKOrderComment2Set, 4DBKOrderComment3Set 4DBKInfoUpdate Ces deux nouvelles commandes permettent de stocker tout type d information personnalisée liée à la ligne de commande dans les champs Commentaire n 2 et Commentaire n 3. Voir la commande 4DBKOrderCommentSet. Voir : Manuel Langage, page 113 <!--#4DBKInfoUpdate/index=valeur--> index Numéro de la ligne du Numérique panier =valeur Nouvelle valeur Chaîne de caractères Objectif : Modifier le texte discriminant associé à une ligne de commande. Voir : Manuel Langage, page D Business Kit Mise à jour

9 Langage : nouvelles commandes 4DBKHttpGet <!--#4DBKHttpGet/serveur,port,requête[,début,fin]--> serveur Adresse du serveur Web à Adresse HTTP contacter port Port du serveur Web à Numérique contacter requête Requête http de type get Chaîne de caractères début Chaîne de départ du résultat Chaîne de caractères fin Chaîne de fin du résultat Chaîne de caractères Objectif : Utiliser des informations contenues dans des pages Web externes ou effectuer des requêtes vers des sites externes. Voir : Manuel Langage, page 169 4DBKCounterSet <!--#4DBKCounterSet/valeur,compteur,+ - = N--> valeur Valeur du champ code C01 de l article Alpha 30 compteur N du compteur à afficher Numérique +N Valeur à ajouter au compteur -N Valeur à supprimer du compteur Numérique =N Nouvelle valeur du compteur Objectif : Définir la valeur d un des compteurs d une fiche article. Voir : Manuel Langage, page 80 4D Business Kit Mise à jour 9

10 4D Business Kit version 2.0 Mise à jour 4DBKCounter <!--#4DBKCounter/valeur,compteur[,format]--> 4DBKCustomerForm valeur Valeur du champ code C01 de Alpha 30 l article compteur N du compteur à afficher Numérique format Format d affichage réel valide Format Objectif : Afficher un des compteurs d une fiche article. Voir : Manuel Langage, page 81 <form method="post" action="/4daction/4dbkcustomerform/boutique/page"> 4DBKCustomerCodeNew boutique Code boutique Chaîne de 4 caractères page Page à afficher après le stockage des champs Chaîne de caractères Objectif : Traiter automatiquement la validation du formulaire de compte client à l aide d une requête HTTP POST. Voir : Manuel Langage, page 93 <!--#4DBKCustomerCodeNew--> Cette commande ne requiert pas de paramètre. Objectif : Réserver le numéro de client utilisé lors de la création d un nouveau compte client. Voir : Manuel Langage, page D Business Kit Mise à jour

11 Langage : nouvelles commandes 4DBKCustomerMemo <!--#4DBKCustomerMemo/code--> 4DBKCustomerMailPwd code Code client Chaîne de caractères Objectif : Retourner le mémo de l utilisateur pour lui permettre de se souvenir de son mot de passe. Voir : Manuel Langage, page 95 <!--#4DBKCustomerMailPwd/code[,sujet[,fichier]]--> 4DBKCookieSet code Code client Chaîne de caractères sujet Sujet du message à envoyer Chaîne de caractères fichier Nom du fichier texte ou de la page html à envoyer Chaîne de caractères Objectif : Envoyer par son mot de passe à un client. Voir : Manuel Langage, page 96 <!--#4DBKCookieSet/nom=valeur--> nom Nom du cookie Texte valeur Texte à stocker dans le cookie Texte Objectif : Ecrire une valeur dans un cookie. Voir : Manuel Langage, page 171 4D Business Kit Mise à jour 11

12 4D Business Kit version 2.0 Mise à jour 4DBKCookie <!--#4DBKCookie/nom[,format]--> 4DBKHttpPostProcess nom Nom du cookie Texte format Format d affichage valide Format Objectif : Afficher le contenu d un cookie. Voir : Manuel Langage, page 172 <form method="post" action="/4daction/4dbkhttppostprocess/page"> 4DBKHttpPostParms page Page à afficher après validation Chaîne de caractères Objectif : Traiter les champs saisis dans un formulaire après sa validation. Voir : Manuel Langage, page 165 <!--#4DBKHttpPostParms/nomChamp--> nomchamp Nom du champ du formulaire Chaîne de caractères dont il faut récupérer la valeur Objectif : Lire la valeur d un champ passé dans un HTTP POST. Voir : Manuel Langage, page D Business Kit Mise à jour

13 Langage : nouvelles commandes 4DBKHttpPostCallBack 4DBKHttpPostResponse 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. Voir : Manuel Langage, page 167 <!--#4DBKHttpPostResponse/données--> 4DBKOrderCodeNew données Message de réponse Alpha Objectif : Envoyer un message de réponse à la machine initiatrice d un HTTP POST. Voir : Manuel Langage, page 168 <!--#4DBKOrderCodeNew--> Cette commande ne requiert pas de paramètre. Objectif : Réserver le numéro de commande utilisé à la validation de commande. Voir : Manuel Langage, page 117 4D Business Kit Mise à jour 13

14 4D Business Kit version 2.0 Mise à jour 4DBKStringRandom <!--#4DBKStringRandom/longueur--> longueur Longueur de la chaîne à générer Numérique Objectif : Retourner une chaîne composée de caractères choisis au hasard. Voir : Manuel Langage, page 173 4DBKExtCallParm1Set, 4DBKExtCallParm2Set, 4DBKExtCallParm3Set <!--#4DBKExtCallParm1Set/données--> 4DBKMD5 données Données à communiquer aux méthodes 4DBKPrice et 4DBKShipping d une autre application 4D Texte Objectif : Passer des paramètres supplémentaires lors de la délégation de calcul de prix ou de modes d expédition. Voir : Manuel Langage, page 174 <!--#4DBKMD5/chaîne--> chaîne Chaîne dont on veut produire un Texte digest de type MD5 Objectif : Produire un Message digest 5 (MD5) à partir d une chaîne de caractères. Voir : Manuel Langage, page D Business Kit Mise à jour

15 Langage : commandes modifiées 4DBKMD5_HMAC <!--#4DBKMD5_HMAC/clé,chaîne--> clé Clé de hachage Texte chaîne Chaîne dont on veut produire un digest de type HMAC MD5 Texte Objectif : Produire un Message digest 5 (MD5) de type HMAC à partir d une chaîne de caractères. Voir : Manuel Langage, page 175 Langage : commandes modifiées Paramètres dynamiques Sélections Variables 4DBKQuerySet Toutes les commandes 4DBK acceptent désormais en paramètre des résultats de fonctions. 4D Business Kit permet désormais d utiliser jusqu à 9 sélections, numérotées de 1 à 9. 4D Business Kit permet désormais d utiliser 100 variables de type entier long (30 Ko), 100 variables réelles (30 Ko) et 100 variables texte (30 Ko). Cette commande accepte une nouvelle syntaxe. Nouvelle syntaxe : <!--#4DBKQuerySet/*requête--> Le préfixage de la requête par un * retourne le nombre d articles et remplit la sélection. Voir : Manuel Langage, page 36 4DBKText 4DBKText accepte un paramètre de format. Voir : Manuel Langage, page 79 4D Business Kit Mise à jour 15

16 4D Business Kit version 2.0 Mise à jour 4DBKPrefsSet <!--#4DBKPrefsSet/pref=valeur--> Cette commande accepte 4 nouvelles valeurs dans le paramètre pref : CusErrorDuplicateAdd CusErrorDuplicateUpd CusErrorLocked CusErrorMode Ces champs permettent au développeur d avoir un meilleur contrôle en cas d erreur lorsqu un utilisateur tente de créer un compte client. Voir : Manuel Langage, page 143 4DBKPicture, 4DBKThumbnail, 4DBKIcon <!--#4DBKPicture/index[,info]--> Ces commandes acceptent à présent le paramètre info, permettant d afficher la largeur (W), la hauteur (H) ou la taille (S) de l image. Voir : Manuel Langage, page 76 4DBKToday Un nouveau format de date et d heure peuvent être utilisé pour obtenir un nombre de secondes écoulés depuis une autre date. (ex. 4DBKToday,e retournera le nombre de secondes depuis le ). Voir : Manuel Langage, page 161 4DBKBasketSet Cette commande peut également être appelée 4DBKCartSet. Voir : Manuel Langage, page D Business Kit Mise à jour

17 Langage : champs 4DBKTraceOnPage <!--#4DBKTraceOnPage[type][début]--> Cette commande accepte désormais deux paramètres permettant de définir les valeurs à afficher dans la fenêtre de trace. Par défaut, les 10 premières variables Entier long sont affichées. Voir : Manuel Langage, page 154 Commandes supprimées 4DBKShippingVAT Suite aux changements apportés au système de gestion des taxes, les commandes suivantes ont été supprimées. Cette commande n est plus reconnue par 4D Business Kit DBKShippingVATrate Langage : champs Cette commande n est plus reconnue par 4D Business Kit 2.0. Nouveaux champs De nombreux nouveaux champs sont disponibles dans 4D Business Kit 2.0. Vous trouverez ci-dessous la liste de ces nouveaux champs, classée par ordre alphabétique. Certains champs sont disponibles pour l affichage ou l import-export uniquement. Pour une description détaillée, reportez-vous au chapitre Champs du manuel Langage de 4D Business Kit. AdIP BskId BskInfo CdCountry CdCurrency CdStore CusBAIBank, CusBAICity, CusBAIPlace, CusBAITeller, CusBAIAccount CusBAIKey CusCCKey CusCCNameOnCard CusCCType CusCCZIPCode CusDiscountA-E 4D Business Kit Mise à jour 17

18 4D Business Kit version 2.0 Mise à jour CusId CusPersoT1 à T3 DaActive DaCityList DaComment / 2 / 3 DaCountryList DaDiscount1-4 DaOrderInfo DaPaymentInfo DaStateList DaStatus1-2 DtDay DtLogEnd DtLogStart Formula FreeOfCharge HrLogEnd HrLogStart LbBrowser LbName LbOrderVATByType1-5 LbReferer LbTax LbVATByType1-5 NbItems NbObjects NbPages NbSingle_users_1_page NbSingle_users_2_to_3_pages NbSingle_users_4_and_more_pages Page Path PcOrderVATByType1-5 PrOrderVATByType1-5 PrOrderVATRate1-5 RtCurrency RtTaxA-E SessionID StFavorite StNoShipping StOrderVATByType1-5 StoreID StVATNumberSet TySaleMode URL 18 4D Business Kit Mise à jour

19 Langage : champs VaCounter1-3 VaCPUTime VaTimeConnected VaVolume Voir : Manuel Langage, page 177 Champs supprimés Les champs suivants utilisés pour la saisie ne sont plus reconnus dans la version 2.0 : PcItemVATRate PrItemVAT PrItemINV Ces champs n existent plus car en version 2.0 4D Business Kit a seulement besoin du Prix HT. 4D Business Kit Mise à jour 19

20 4D Business Kit version 2.0 Mise à jour Composant 4DBK Nouvelles méthodes 4DBKC_ImportFileFrom4DBK Le composant 4DBK 2.0 vous permet de mettre à jour ou de synchroniser les articles, les clients ou les commandes d un serveur 4D Business Kit. 4DBKC_ImportFileFrom4DBK(adresseServeur; portserveur; timeoutsec; maxtimesec; motdepasse; boutique; module; critèresrecherche; cheminfichier{; àpartirde{; nombre}}) Alpha Paramètre Type Description adresseserveur Alpha 30 Adresse IP du serveur 4DBK portserveur Entier Port du serveur 4DBK timeoutsec Entier TimeOut en secondes maxtimesec Entier Durée maximale de traitement en secondes motdepasse Texte Mot de passe boutique Alpha 4 Code boutique module Texte Module concerné critèresrecherche Texte Critères de recherche cheminfichier Texte Chemin d accès vers le fichier résultat àpartirde Entier Numéro de la fiche de départ long nombre Entier long Nombre de fiches à récupérer Résultat Alpha Code résultat de l opération ou Nombre de fiches rapatriées Cette fonction permet d interroger un serveur 4D Business Kit et de ramener des données de type articles, clients ou commandes. Voir : Manuel technique avancé, page D Business Kit Mise à jour

21 Composant 4DBK 4DBKC_ExportFileTo4DBK 4DBKC_ExportFileTo4DBK(adresseServeur; portserveur; timeoutsec; maxtimesec; motdepasse; boutique; module; critèresrecherche; cheminfichier[; options]) Alpha 4DBKC_ToolsData Paramètre Type Description adresseserveur Alpha 30 Adresse IP du serveur 4DBK portserveur Entier Port du serveur 4DBK timeoutsec Entier TimeOut en secondes maxtimesec Entier Durée max. de traitement en secondes motdepasse Texte Mot de passe boutique Alpha 4 Code boutique module Texte Module concerné critèresrecherche Texte Critères de recherche cheminfichier Texte Chemin d accès du fichier source options Texte Options de mise à jour Résultat Alpha Code résultat de l opération Cette fonction permet de créer ou de mettre à jour des données articles ou clients sur un serveur 4D Business Kit depuis une application 4D disposant du composant 4DBK. Voir : Manuel technique avancé, page 48 4DBKC_ToolsData (sélecteur[; chemin[; données1[; données2]]]) Alpha Paramètre Type Description sélecteur Alpha 32 Code opération à effectuer chemin Texte Chemin d accès données1 Pointeur Pointeur vers un tableau de données données2 Pointeur Pointeur vers un tableau de données Résultat Alpha Code d erreur La méthode 4DBKC_ToolsData permet d effectuer diverses opérations utilitaires avec les fichiers échangés entre le composant 4DBK et les serveurs 4D Business Kit. 4D Business Kit Mise à jour 21

22 4D Business Kit version 2.0 Mise à jour Méthodes modifiées Voir : Manuel technique avancé, page 56 4DBKC_KeysNew La méthode 4DBKC_KeysNew est supprimée du composant de 4D Business Kit DBKC_ItemUpdateSend 4DBKC_ItemUpdateSend (adresseserveur; portserveur; timeoutsec; maxtimesec; motdepasse; boutique; C01; blobdonnées) Texte Paramètre Type Description adresseserveur Alpha 30 Adresse IP du serveur 4DBK portserveur Entier Port du serveur 4DBK timeoutsec Entier TimeOut en secondes maxtimesec Entier Durée maximale de traitement en secondes motdepasse Texte Mot de passe boutique Alpha 4 Code boutique C01 Alpha 30 Code C01 de l article à modifier ou à créer blobdonnées Pointeur Pointeur vers le BLOB de données Résultat Texte Code résultat de l opération Cette méthode admet désormais les paramètres timeoutsec, maxtimesec et motdepasse. Voir : Manuel technique avancé, page D Business Kit Mise à jour