Télécharger et diffuser des fichiers statiques

Article
03/08/2023

Cet article décrit comment charger un fichier statique dans le générateur de site Microsoft Dynamics 365 Commerce et comment créer une URL et un nom de fichier personnalisés pouvant être utilisés pour demander ce fichier.

Certains connecteurs tiers nécessitent qu’un fichier soit hébergé et diffusé à partir du site d’e-commerce. Ces connecteurs s’attendent à ce que le fichier soit renvoyé par des requêtes adressées à un chemin d’URL de rappel et à un nom de fichier spécifiques. Par conséquent, cet article explique comment charger et diffuser un fichier statique qui a une URL et un nom de fichier définissables par l’utilisateur sur un site d’e-commerce Dynamics 365 Commerce.

Créer une URL de site qui renvoie un fichier statique

Pour créer une URL de site qui renvoie un fichier statique dans le générateur de site Commerce, procédez comme suit.

Accédez à la médiathèque de votre site et chargez le fichier qui doit être servi par les requêtes à l’URL que vous définirez. Si vous avez déjà chargé le fichier, vous pouvez ignorer cette étape.
Aller à URL pour votre site.
Sélectionnez Nouveau > Nouvelle URL.
Dans la boîte de dialogue Nouvelle URL, sélectionnez Élément de bibliothèque multimédia.
Dans le champ Chemin de l’URL, entrez le chemin de l’URL. Incluez le nom du fichier dans le chemin.
Sélectionnez Suivant. La médiathèque s’ouvre et affiche tous les éléments multimédias de type document qui ont été chargés.
Sélectionnez le fichier qui doit être servi pour les demandes à l’URL que vous avez définie à l’étape 5.
Sélectionnez Enregistrer.

À ce stade, l’URL créée est dans un état de brouillon. Le fichier vers lequel pointe l’URL ne sera pas renvoyé tant que vous n’aurez pas publié l’URL. Avant de publier l’URL, vous pouvez valider qu’elle renvoie les données correctes.

Validation et publication d’une URL

Pour valider une URL avant de la oublier, procédez comme suit.

Aller à URL pour votre site et sélectionnez l’URL à prévisualiser.
Dans le volet des propriétés à droite, sous le bouton Modifier, sélectionnez le lien URL correct. Une nouvelle fenêtre de navigateur s’ouvre et vous devriez recevoir une erreur 404.
Ajouter la chaîne de requête ?preview=inprogress à l’URL (par exemple, https://yoursite.com/callback.html?preview=inprogress) et rechargez la page. Le fichier que vous avez chargé dans la médiathèque doit être renvoyé dans la réponse.

Après avoir validé l’URL, vous pouvez la publier.

Aller à URL pour votre site et sélectionnez l’URL.
Sélectionnez Publier dans la barre de commande.

Mettre à jour le fichier vers lequel pointe une URL

Une fois l’URL publiée, vous pouvez la mettre à jour afin qu’elle pointe vers un autre fichier. Vous pouvez également mettre à jour l’URL afin qu’elle pointe vers un autre type de ressource, comme décrit dans la section suivante. Par exemple, vous pouvez pointer l’URL vers une page interne ou une redirection.

Pour mettre à jour le fichier vers lequel pointe une URL, procédez comme suit.

Aller à URL pour votre site et sélectionnez l’URL à mettre à jour.
Dans le volet de propriétés de droite, sélectionnez Modifier.
Sous Attribution d’URL, sélectionnez la zone Étape 2, puis sélectionnez un nouveau document dans la bibliothèque multimédia.
Sélectionnez Appliquer.

Mettre à jour le type d’actif vers lequel pointe une URL

Vous pouvez également mettre à jour une URL afin qu’elle pointe vers un autre type d’actif (ressource), tel qu’une page interne ou une redirection.

Pour mettre à jour le type d’actif vers lequel pointe une URL, procédez comme suit.

Aller à URL pour votre site et sélectionnez l’URL à mettre à jour.
Dans le volet de propriétés de droite, sélectionnez Modifier.
Sous Attribution d’URL, sous Étape 1, sélectionnez un autre type d’actif.
Sélectionnez la zone Étape 2, puis sélectionnez le nouvel actif.
Sélectionnez Appliquer.

Changer le chemin de l’URL

Une fois l’URL créée, son chemin ne peut pas être modifié. Si vous devez modifier le chemin d’URL qui sert un fichier ou tout autre type de ressource, vous devez créer une URL, la mapper au fichier existant ou à une autre ressource, puis annuler la publication et supprimer l’ancienne URL.

Pour modifier le chemin de l’URL, procédez comme suit.

Pour créer une URL et la mapper au fichier existant ou à une autre ressource, suivez les instructions de la section précédente Créer une URL de site qui renvoie un fichier statique dans cet article.
Sélectionnez la nouvelle URL, puis sélectionnez Publier sur la barre de commandes. La nouvelle URL est publiée.
Pour annuler la publication de l’ancienne URL, sélectionnez-la, puis sélectionnez Annuler la publication sur la barre de commandes. Vous pouvez à présent supprimer l’ancienne URL si nécessaire.