Importer des ressources en bloc à l’aide d’Assets Essentials bulk-import-essentials
L’import en bloc dans AEM Assets Essentials permet aux administrateurs et administratrices d’importer un grand nombre de ressources depuis une source de données vers AEM Assets. Les administrateurs et administratrices n’ont plus besoin de charger des ressources ou des dossiers individuels vers AEM Assets.
Vous pouvez importer des ressources à partir des sources de données suivantes :
- AWS
- Google Cloud
- Dropbox
- OneDrive
- Azure
Conditions préalables requises prerequisites
- Compte de stockage Azure
- Conteneur d’objets blob Azure
- Clé d’accès Azure ou jeton SAS en fonction du mode d’authentification
- Région AWS
- Compartiment AWS
- Clé d’accès AWS
- Secret d’accès AWS
- Compartiment GCP
- Adresse e-mail du compte de service GCP
- Clé privée du compte de service GCP
- ID client Dropbox
- Secret client Dropbox
- Identifiant locataire OneDrive
- Identifiant client OneDrive
- Clé secrète client OneDrive
Outre ces conditions préalables en fonction de la source de données, vous devez connaître le nom du dossier source disponible dans votre source de données, qui contient toutes les ressources à importer dans AEM Assets.
Configurer l’application de développement Dropbox dropbox-developer-application
Avant d’importer des ressources de votre compte Dropbox vers AEM Assets, créez et configurez l’application de développement Dropbox.
Procédez comme suit :
-
Connectez-vous à votre compte Dropbox et cliquez sur Créer des applications.
Si vous utilisez un compte Dropbox d’entreprise, vous devez avoir accès au rôle d’administrateur ou d’administratrice de contenu. -
Dans la section Choisir une API, sélectionnez le seul bouton radio disponible.
-
Dans la section Choisir le type d’accès dont vous avez besoin, sélectionnez l’une des options suivantes :
-
Sélectionnez Dossier d’application si vous avez besoin d’accéder à un dossier unique créé dans votre application, dans votre compte Dropbox.
-
Sélectionnez Full Dropbox si vous avez besoin d’accéder à tous les fichiers et dossiers de votre compte Dropbox.
-
-
Indiquez un nom pour votre application, puis cliquez sur Créer l’application.
-
Dans l’onglet Paramètres de votre application, ajoutez https://experience.adobe.com à la section URI de redirection.
-
Copiez les valeurs des champs Clé d’application et Secret d’application. Les valeurs sont requises lors de la configuration de l’outil d’import en bloc dans AEM Assets.
-
Dans l’onglet Autorisations, ajoutez les autorisations suivantes dans la section Portées individuelles.
-
account_info.read
-
files.metadata.read
-
files.content.read
-
files.content.write
-
-
Cliquez sur Soumettre pour enregistrer les modifications.
Configurer l’application de développement OneDrive onedrive-developer-application
Avant d’importer des ressources de votre compte OneDrive vers AEM Assets, créez et configurez l’application de développement OneDrive.
Créer une application
-
Connectez-vous à votre compte OneDrive et cliquez sur Nouvel enregistrement.
-
Spécifiez un nom pour l’application, sélectionnez Comptes dans ce répertoire organisationnel uniquement (Adobe uniquement - client unique) depuis Types de comptes pris en charge.
-
Suivez les étapes ci-après pour ajouter des URI de redirection :
-
Dans le menu déroulant Sélectionner une plateforme, sélectionnez Web.
-
Ajoutez https://experience.adobe.com à la section URI de redirection.
-
-
Cliquez sur Enregistrer. L’application est créée avec succès.
-
Copiez les valeurs des champs ID d’application (client) et ID de répertoire (client). Les valeurs sont requises lors de la configuration de l’outil d’import en bloc dans AEM Assets.
-
Cliquez sur Ajouter un certificat ou un secret correspondant à Informations d’identification du client.
-
Cliquez sur Nouveau secret client, indiquez la description et l’expiration du secret client, puis cliquez sur Ajouter.
-
Après avoir créé le secret client, copiez le champ Valeur (ne copiez pas le champ ID de secret). Ce dernier est requis lors de la configuration de l’import en bloc dans AEM Assets.
Ajouter des autorisations d’API
Exécutez les étapes suivantes pour ajouter des autorisations d’API pour l’application :
- Cliquez sur Autorisations d’API dans le volet de gauche et cliquez sur Ajouter une autorisation.
- Cliquez sur Microsoft Graph > Autorisations déléguées. La section Sélectionner l’autorisation affiche les autorisations disponibles.
- Sélectionnez l’autorisation
offline_access
à partir d’OpenId permissions
et l’autorisationFiles.ReadWrite.All
à partir deFiles
. - Cliquez sur Ajouter des autorisations pour enregistrer les mises à jour.
Créer une configuration d’import en bloc create-bulk-import-configuration
Pour créer une configuration d’import en bloc dans Experience Manager Assets, procédez comme suit :
-
Cliquez sur Import en bloc dans le volet de gauche, puis cliquez sur Créer un import.
-
Sélectionnez la source de données. Les options disponibles comprennent Azure, AWS, Google Cloud, Dropbox et OneDrive.
-
Indiquez un nom pour la configuration de lʼimport en bloc dans le champ Nom.
-
Indiquez les informations d’identification spécifiques à la source de données, comme mentionné dans les conditions préalables.
-
Indiquez le nom du dossier racine qui contient les ressources de la source de données dans le champ Dossier source.
note note NOTE Si vous utilisez Dropbox comme source de données, spécifiez le chemin du dossier source en fonction des règles suivantes : - Si vous sélectionnez Full Dropbox lors de la création de l’application Dropbox et que le dossier contenant les ressources existe dans
https://www.dropbox.com/home/bulkimport-assets
, indiquezbulkimport-assets
dans le champ Dossier source. - Si vous sélectionnez Dossier d’application lors de la création de l’application Dropbox et que le dossier contenant les ressources existe dans
https://www.dropbox.com/home/Apps/BulkImportAppFolderScope/bulkimport-assets
, indiquezbulkimport-assets
dans le champ Dossier source, oùBulkImportAppFolderScope
fait référence au nom de l’application.Apps
est automatiquement ajouté aprèshome
dans ce cas.
- Si vous sélectionnez Full Dropbox lors de la création de l’application Dropbox et que le dossier contenant les ressources existe dans
-
(Facultatif) Sélectionnez lʼoption Supprimer le fichier source après lʼimport afin de supprimer les fichiers originaux du magasin de données source après lʼimport des fichiers dans Experience Manager Assets.
-
Sélectionnez le Mode d’importation. Les modes suivants sont disponibles : Ignorer, Remplacer ou Créer une version. Le mode par défaut est Ignorer. Dans ce mode, l’outil d’ingestion ignore l’import d’une ressource si elle existe déjà.
-
(Facultatif) Spécifiez le fichier de métadonnées à importer, fourni au format CSV, dans le champ Fichier de métadonnées. Le fichier source des métadonnées doit se trouver dans le dossier source. Cliquez sur Suivant pour accéder à Emplacement et filtres.
-
Pour définir un emplacement dans la gestion des ressources numériques (DAM) où les ressources doivent être importées à l’aide du champ Dossier cible des ressources, indiquez un chemin d’accès. Par exemple,
/content/dam/imported_assets
. -
(Facultatif) Dans la section Choisir des filtres, indiquez la taille de fichier minimale des ressources en Mo à inclure dans le processus d’ingestion dans le champ Filtrer par taille minimale.
-
(Facultatif) Indiquez la taille de fichier maximale des ressources en Mo à inclure dans le processus d’ingestion dans le champ Filtrer par taille maximale.
-
(Facultatif) Sélectionnez les types MIME à inclure dans le processus d’ingestion à l’aide du champ Inclure le type MIME. Vous pouvez sélectionner plusieurs types MIME dans ce champ. Si vous ne définissez pas de valeur, tous les types MIME sont inclus dans le processus d’ingestion.
-
(Facultatif) Sélectionnez les types MIME à exclure dans le processus d’ingestion à l’aide du champ Exclure le type MIME. Vous pouvez sélectionner plusieurs types MIME dans ce champ. Si vous ne définissez pas de valeur, tous les types MIME sont inclus dans le processus d’ingestion.
-
Cliquez sur Suivant. Sélectionnez l’une des options suivantes en fonction de vos préférences :
- Sélectionnez Enregistrer l’import pour enregistrer la configuration afin de pouvoir l’exécuter ultérieurement.
- Sélectionnez Enregistrer et exécuter l’import pour enregistrer la configuration et exécuter l’import en bloc.
- Sélectionnez Enregistrer et planifier l’import pour enregistrer la configuration et planifier l’import en bloc ultérieurement. Vous pouvez choisir la fréquence de l’import en bloc et définir la date et l’heure de l’import. L’import en bloc s’exécute à la date et à l’heure définies à la fréquence choisie.
-
Cliquez sur Enregistrer pour exécuter l’option sélectionnée.
Gestion des noms de fichier lors de l’importation en bloc filename-handling-bulkimport-assets-view
Lorsque vous importez des ressources ou des dossiers en bloc, Experience Manager Assets importe toute la structure de ce qui existe dans la source d’import. Experience Manager suit les règles intégrées pour les caractères spéciaux dans les noms de ressources et de dossiers ; par conséquent, ces noms de fichier doivent être assainis. Pour les noms de dossier et de ressource, le titre défini par l’utilisateur reste inchangé et est stocké dans jcr:title
.
Lors de l’importation en bloc, Experience Manager recherche les dossiers existants pour éviter de réimporter les ressources et les dossiers et vérifie également les règles d’assainissement appliquées dans le dossier parent où l’importation a lieu. Si les règles d’assainissement sont appliquées dans le dossier parent, les mêmes règles sont appliquées à la source d’importation. Pour une nouvelle importation, les règles d’assainissement suivantes sont appliquées pour gérer les noms de fichiers des ressources et dossiers.
Pour plus d’informations sur les noms non autorisés, la gestion des noms de ressources et la gestion des noms de dossiers lors de l’import en bloc, consultez Gestion des noms de fichier lors de l’import en bloc.
Afficher les configurations d’import en bloc existantes view-import-configuration
Pour afficher les imports en bloc existants, sélectionnez l’option Imports en bloc dans le volet de gauche. La page Imports en bloc s’affiche avec la liste des Imports exécutés.
Vous pouvez également afficher les Imports enregistrés et les Imports planifiés dans la liste déroulante.
Modifier la configuration d’import en bloc edit-import-configuration
Pour modifier les détails de la configuration, cliquez sur l’
Planifier des imports ponctuels ou récurrents schedule-imports
Pour planifier un import en bloc ponctuel ou récurrent, procédez comme suit :
-
cliquez sur l’
-
Définissez une ingestion ponctuelle ou planifiez une planification horaire, quotidienne ou hebdomadaire. Cliquez sur Envoyer.
Exécuter un contrôle de l’intégrité de l’import import-health-check
Pour valider la connexion à la source de données, cliquez sur l’
Effectuer un essai avant l’exécution d’un import dry-run-bulk-import
Cliquez sur l’
Exécuter un import en bloc run-bulk-import
Si vous avez enregistré l’import lors de la création de la configuration, vous pouvez accéder à l’onglet Imports enregistrés, cliquer sur l’
De même, si vous devez exécuter un import déjà exécuté, accédez à l’onglet Imports exécutés, cliquez sur l’
Arrêter ou planifier un import en cours schedule-stop-ongoing-report
Vous pouvez planifier ou arrêter un import en bloc en cours à l’aide de la boîte de dialogue de statut d’import en bloc qui s’affiche sur la page d’accueil de l’import en bloc au cours d’un import.
Vous pouvez également afficher les ressources importées dans le dossier cible en cliquant sur Afficher les ressources.
Supprimer une configuration d’import en bloc delete-bulk-import-configuration
Cliquez sur l’
Accéder aux ressources après l’exécution de l’import en bloc view-assets-after-bulk-import
Pour afficher l’emplacement cible des ressources où les ressources sont importées après l’exécution de la tâche d’import en bloc, cliquez sur l’