Utilisation de l'outil Asset File Upload pour charger des actifs numériques

Utiliser l'outil Asset File Upload pour charger des actifs numériques vers HCL Digital Experience.

Téléchargement de l'outil Asset File Upload

L'outil Asset File Upload se trouve dans le conteneur Docker des utilitaires.

Les exemples de fichier de configuration de chargement de données pour l'outil se trouvent dans le répertoire <commerce>/sample/DataLoad/Content/DX. Il existe trois fichiers de configuration :

wc-dataload.xml - le fichier de configuration de chargement des données principal.
wc-dataload-env.xml - le fichier de configuration de l'environnement de chargement de données.
wc-loader-asset-upload.xml - le fichier de configuration d'objet métier.

Remarques

Lorsqu'un fichier est chargé vers HCL Digital Experience, une URL personnalisée est générée et associée au fichier chargé. L'URL personnalisée est générée en fonction du chemin relatif du fichier dans le fichier .zip ou le répertoire chargé.

Configuration de l'outil Asset File Upload

Avant d'exécuter l'outil Asset File Upload, copiez les trois fichiers de configuration dans votre propre répertoire. Mettez à jour le fichier de configuration de chargement de données principal, wc-dataload.xml, pour qu'il corresponde à votre environnement HCL Digital Experience.

Table 1. Propriétés de l'outil Asset File Upload
Propriété	Description
DataSourceLocation	Mettez à jour l'emplacement des actifs numériques dans l'élément DataSourceLocation. Vous pouvez spécifier un fichier .zip ou un répertoire à charger : Charger un fichier .zip : tous les fichiers du fichier .zip sont chargés un par un dans HCL Digital Experience. Charger un répertoire : tous les fichiers de ce répertoire, y compris tous les sous-répertoires, sont chargés un par un dans HCL Digital Experience.
dxURL	L'URL pour le site HCL Digital Experience. Par exemple : https://207.201.197.104.googleusercontent.com
dxUserId	L'utilisateur ID pour se connecter à HCL Digital Experience.
dxPassword	Le mot de passe pour se connecter à HCL Digital Experience. Le mot de passe doit être chiffré à l'aide de wcs_encrypt.sh. Si vous ne fournissez pas le mot de passe ou si le mot de passe ne peut pas être déchiffré, vous êtes invité à entrer le mot de passe lorsque vous exécutez l'outil.
collectionName	Le nom de collection. La collection doit se trouver sous la racine de HCL Digital Experience. Si le nom de collection spécifié ne se trouve pas sous la racine, une nouvelle collection avec le nom est créée sous la racine.
allowDirectoryAsLocation	Définissez cette valeur sur `true` pour charger tous les fichiers sous un répertoire.
numberOfThreads	L'outil peut charger des fichiers avec plusieurs unités d'exécution. La valeur par défaut est 1. Le nombre maximal d'unités d'exécution que vous pouvez spécifier est de 8.
customURLContextRoot	Le préfixe à ajouter à l'URL personnalisée. Le mot clé est facultatif. S'il n'est pas spécifié, aucun préfixe n'est ajouté à l'URL.
replaceInvalidCharacterWith	La commande URL ne permet que les caractères suivants : ". (point), a-z, A-Z, 0-9, - (tiret), _ (trait de soulignement), / (barre oblique)". Si les chemin relatif du fichier contiennent des caractères non valides, ils sont remplacés par le caractère spécifié ici. Il est recommandé d'utiliser le trait de soulignement (_) comme caractère de remplacement. Si cette propriété n'est pas spécifiée et que l'URL personnalisée générée contient des caractères non valides, l'association de l'URL personnalisée au fichier chargé échoue. Le fichier est chargé, mais l'URL personnalisée n'est pas créée.
supportedFileExtension	Une liste d'extensions de fichier séparées par des virgules. Seuls les fichiers avec des extensions dans la liste sont chargés. Si cette propriété n'est pas spécifiée, tous les fichiers du fichier zip ou sous un répertoire sont chargés dans HCL Digital Experience. Par exemple, "jpg, png, pdf".

Chargement de données en masse DX et Commerce de l'amélioration d'actif avec le mode Remplacement et Suppression

Si vous souhaitez charger des fichiers dans la DX avec le mode Remplacement de chargement de données :

Augmentez la charge en masse des images à partir du répertoire ou du fichier zip dans la bibliothèque de supports DX pour prendre en charge le mode Remplacement.
Lorsqu'un utilisateur charge des fichiers vers la DX avec le mode Remplacement de chargement de données, il recherche l'URL personnalisée existante. Si elle existe déjà, il remplacera le fichier existant dans la DX par le nouveau fichier chargé.
Lorsqu'un utilisateur charge des fichiers dans la DX avec le mode Insertion de chargement de données, il recherche une URL personnalisée existante. Si elle existe déjà, le chargement échouera en raison de l'URL personnalisée dupliquée. Le mode Insertion est donc uniquement pour le chargement initial.
Lorsqu'un utilisateur charge des fichiers dans la DX avec le mode Suppression de chargement de données, il supprimera le fichier dans la DX avec la même URL personnalisée.

Note: Si vous êtes confronté à un problème d'API de connexion DX, un paramètre supplémentaire doit être mis à jour. Ajoutez la propriété suivante dans le wc-dataload.xml :

<_config:property name="portalLogin" value="true"/>

Avec ce paramètre, l'outil de téléchargement utilisera l'API de connexion au portail pour obtenir le cookie auth.

Lorsque la DX corrige son code pour que l'API de connexion d'origine fonctionne, ce paramètre n'est pas nécessaire.

Après avoir importé des fichiers, l'utilisateur doit pouvoir importer tous les actifs manquants précédemment. Il est possible d'obtenir l'erreur mentionnée ci-dessous : Les actifs ont été importés dans DAM, mais le journal affiche l'erreur. Cela se produit parce qu'il charge des actifs pour la DX active. Etant donné que les fichiers sont partagés entre l'environnement de production et de création, un utilisateur reçoit une erreur. Pour éviter cela, vous devrez charger vers des environnements de production uniquement.