Mise en place des dépôts de documents

Remarque : Cela n'est pas disponible pour les clients StoreFlow Cloud.

La configuration des dépôts de documents permet à l’administrateur de uStore de définir des dépôts de fichiers externes pour les produits composites. L’administrateur définit l’emplacement du dépôt, le type de fichiers pouvant être téléchargés et si le visiteur peut changer l’ordre des pages ou modifier les propriétés du produit pour des pages spécifiques du fichier téléchargé. Les visiteurs du magasin pourront télécharger des documents depuis ces dépôts lors de la commande d’un produit composite.

Pour configurer un dépôt de documents :

  1. Dans la barre d’outils , cliquez sur Outils puis sélectionnez Définition de référentiel de document.
    La page Détails des dépôts des documents s’ouvre

  2. Cliquez sur Nouveau pour ajouter un nouveau dépôt de documents.

  3. Saisissez le Nom et la Description du dépôt.

  4. Dans le champ Type de dépôt, sélectionnez dépôt de document sur disque. Il s’agit d’un type de dépôt prédéfini par défaut par uStore.

  5. Dans la section Extensions autorisées,
    sélectionnez les extensions de fichiers dont le téléchargement est autorisé. uStore supporte le téléchargement des extensions de fichiers suivantes : PDF, PPT, PPTX,DOC, DOCX.

  6. Si vous souhaitez permettre aux clients du magasin à modifier les fichiers téléchargés, sélectionnez Autoriser les modifications au niveau de la page. Si cette option est activée, les clients pourront changer l'ordre des pages et modifier les propriétés des produits sur des pages spécifiques
    .

  7. Dans la liste Afficher le fichier par , sélectionnez le mode de tri du dépôt de document externe et définissez les paramètres nécessaires pour le mode sélectionné. Il existe quatre options :

    • Dossier : permet de télécharger des documents à partir d'un dossier situé sur un serveur uStore. Dans le champ Chemin d’accès , saisissez le chemin d’accès d’un dossier sur un serveur uStore.

    • Chemin du réseau : permet de télécharger des documents à partir d'un dossier situé dans un réseau accessible par un serveur uStore. Saisissez les paramètres suivants :

    • Chemin : entrez le chemin du dossier dans le réseau.

    • Nom d'utilisateur, mot de passe, domaine : si le chemin du réseau requiert une authentification, entrez le nom d'utilisateur, le mot de passe et le nom de domaine requis pour accéder à l'emplacement du réseau défini dans le champ Chemin.

    • Fichier d'informations : permet de télécharger des documents à partir d'un dossier dont la structure et le contenu sont représentés à l'aide d'un fichier d'information XML. Dans le champ Chemin d’accès, saisissez le chemin d’accès du dossier dans lequel se trouve le fichier info XML (folderinfo.xml). Pour obtenir plus de détails sur folderinfo.xml, consultez Configurer les paramètres du fichier Info.

    • HTTP Web Handler : permet de télécharger des documents à partir d'un serveur distant (tel que Dropbox) en utilisant le fichier HTTP Web Handler représentant le chemin du dossier et le contenu. Dans le champ URL, saisissez l’URL d’un dossier à distance dans lequel se trouve le fichier Gestionnaire Internet HTTP. Pour plus de détails, voir Définir les paramètres du gestionnaire Web HTTP.

  8. Cliquez sur Save (Sauvegarder).

Après avoir configuré votre dépôt de document, vous pouvez autoriser son utilisation par un produit téléchargé spécifique. Pour obtenir plus d’informations, consultez Configuration de produits téléchargés

Configurer les paramètres du fichier Info

Le fichier folderinfo.xml sert à représenter la structure et le contenu d’un dossier particulier. Ce fichier peut être utilisé dans les cas suivants :

Le nom de dossier réel peut être remplace par un nom affiché virtuel.

Le nom de fichier réel peut être remplace par un nom affiché virtuel.

Dans un dossier, vous pouvez choisir quels fichiers spécifiques seront visibles dans le dépôt et quels fichiers seront cachés.

Vous pouvez définir une icône de vignette personnalisée pour un fichier.

Le fichier folderinfo.xml possède la structure suivante :

<FolderInfo>

   <subfolders>

     <folder folderName="<Folder Name>" path="<Folder
     Path>" iconClass="fileExtensionFolder"
     iconPath=""></folder>

   </subfolders>

   <files>

     <file fileName="<File Name>" extension="<File
     Extension>" path="<File Path>" iconClass="<File
     Extension Type>"iconPath="<Icon Path>"></file>

   </files>

</FolderInfo>

 

Paramètre

Valeur

folderName

Le nom affiché d’un dossier. Le nom affiché peut être différent du véritable nom du dossier.

path

Le chemin d’accès réel du fichier ou du dossier. Le chemin d’accès doit être situé sous le dossier dans lequel se trouve folderinfo.xml.

iconClass

Lors de la définition de paramètres de dossier, le paramètre iconClass doit posséder une valeur fileExtensionFolder.

Lors de la définition de paramètres du fichier, le paramètre iconClassdoit posséder une valeur fileExtension<Extension Type> , par exemple fileExtensionpptx, si l’extension du fichier est PPTX.

iconPath

Le chemin d’accès complet de l’emplacement du fichier icône.

fileName

Le nom affiché d’un fichier. Le nom affiché peut être différent du véritable nom du fichier.

extension

L’extension du fichier. Par exemple, PPTX, PPT, DOCX, DOC, PDF.

Exemple

Dans l’exemple suivant, le dépôt de document a été défini pour contenir un dossier nommé Cartes_Cadeaux avec un fichier nommé Anniversaire.pptx. Le fichier possède une icône de vignette située dans https://play.google.com/intl/en-US_us/about/images/giftcards/birthday_120x120.png. 

<FolderInfo>

   <subfolders>

     <folder folderName="Giftcards" path="My Files"
     iconClass="fileExtensionFolder" iconPath="">
     </folder>

   </subfolders>

   <files>

     <file fileName="Birthday" extension="pptx"
     path="Projects/Giftcards/Birthday.pptx"
     iconClass="fileExtensionpptx" iconPath="https://
     play.google.com/intl/en-US_us/about/images/
     giftcards/birthday_120x120.png"></file>

   </files>

</FolderInfo>

Configurer les paramètres du gestionnaire Web HTTP

Un fichier gestionnaire Internet HTTP sert à représenter la structure et le contenu d’un dossier à distance. Vous pouvez par exemple utiliser un fichier gestionnaire Internet pour avoir accès au contenu d’un dépôt à distance, comme Dropbox.

Quand un client veut télécharger un document depuis un dépôt de document à distance à l’aide d’un gestionnaire Internet HTTP, uStore envoie une requête au fichier gestionnaire pour avoir accès au dossier demandé. Quand un client clique sur un fichier, une requête supplémentaire est envoyée pour avoir accès au fichier.

Le fichier Gestionnaire Internet HTTP s’attend à recevoir les deux paramètres suivants :

  • chemin : renvoie le chemin du dépôt. Quand vous choisissez le dossier racine, le paramètre de chemin d’accès est vide.

  • mode : renvoie les valeurs du fichierou de la liste .

    • liste : renvoie le fichier folderinfo.xml. Cette valeur est utilisée pour récupérer le contenu du dossier.

    • fichier: renvoie le fichier. Cette valeur est utilisée pour récupérer le fichier réel.