Importer des ressources en bloc à l’aide de la vue Assets bulk-import-assets-view

L’import en bloc dans la vue AEM Assets permet aux administrateurs et administratrices d’importer un grand nombre de ressources d’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.

NOTE
L’importateur en masse d’affichage des ressources utilise le même serveur principal que celui de l’importateur en masse d’affichage administrateur. Cependant, il offre davantage de sources de données à importer et une expérience utilisateur plus simplifiée.

Vous pouvez importer des ressources à partir des sources de données suivantes :

  • Azure
  • AWS
  • Google Cloud
  • Dropbox
  • OneDrive

Conditions préalables requises prerequisites

Source de données
Conditions préalables requises
Azure
  • Compte de stockage Azure
  • Conteneur d’objets blob Azure
  • Clé d’accès Azure ou jeton SAS en fonction du mode d’authentification
AWS
  • Région AWS
  • Compartiment AWS
  • Clé d’accès AWS
  • Secret d’accès AWS
Google Cloud
  • Compartiment GCP
  • Adresse e-mail du compte de service GCP
  • Clé privée du compte de service GCP
Dropbox
  • Identifiant du client Dropbox (clé d’application)
  • Secret client Dropbox (secret d’application)
OneDrive
  • 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 :

  1. Se connecter à Compte Dropbox et cliquez sur Création d’applications.
    Si vous utilisez un compte Enterprise Dropbox, vous devez avoir accès au rôle d’administrateur de contenu.

  2. Dans la section Choisir une API, sélectionnez le seul bouton radio disponible.

  3. 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.

  4. Indiquez un nom pour votre application, puis cliquez sur Créer l’application.

  5. Dans le Paramètres de votre application, ajoutez https://experience.adobe.com au URI de redirection .

  6. 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.

  7. 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

  8. 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éation d’une application

  1. Se connecter à Compte OneDrive et cliquez sur Nouvelle inscription.

  2. Indiquez un nom pour l’application, puis sélectionnez Comptes dans cet annuaire organisationnel uniquement (Adobe uniquement - client unique) de Types de compte pris en charge.

  3. Suivez les étapes ci-après pour ajouter des URI de redirection :

    1. Dans le Sélectionner une plateforme menu déroulant, sélectionnez Web.

    2. Ajoutez https://experience.adobe.com au URI de redirection .

  4. Cliquez sur Enregistrer. L’application est créée avec succès.

  5. Copiez les valeurs de la variable ID d’application (client) et ID de répertoire (client) des champs. Les valeurs sont requises lors de la configuration de l’outil d’import en bloc dans AEM Assets.

  6. Cliquez sur Ajouter un certificat ou un secret correspondant à Informations d’identification client .

  7. Cliquez sur Nouveau secret client, indiquez la description du secret client, l’expiration et cliquez sur Ajouter.

  8. 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.

Ajout d’autorisations API

Exécutez les étapes suivantes pour ajouter des autorisations d’API pour l’application :

  1. Cliquez sur Autorisations d’API dans le volet de gauche et cliquez sur Ajouter une autorisation.
  2. Cliquez sur Microsoft Graph  > Autorisations déléguées. La section Sélectionner l’autorisation affiche les autorisations disponibles.
  3. Sélectionnez l’autorisation offline_access à partir d’OpenId permissions et l’autorisation Files.ReadWrite.All à partir de Files.
  4. 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’importation en bloc dans le Experience Manager Assets:

  1. Cliquez sur Importation en bloc dans le volet de gauche, puis cliquez sur Créer un import.

  2. Sélectionnez la source de données. Les options disponibles incluent Azure, AWS, Google Cloud, Dropbox et OneDrive.

  3. Indiquez un nom pour la configuration de lʼimport en bloc dans le champ Nom.

  4. Indiquez les informations d’identification spécifiques à la source de données, comme mentionné dans les conditions préalables.

  5. Indiquez le nom du dossier racine qui contient les ressources de la source de données dans la variable Dossier source champ .

    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, indiquez bulkimport-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, indiquez bulkimport-assets dans le champ Dossier source, où BulkImportAppFolderScope fait référence au nom de l’application. Apps est automatiquement ajouté après home dans ce cas.
  6. (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.

  7. 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à.
    Import des détails de la source.

  8. (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.

  9. 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.

  10. (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.

  11. (Facultatif) Indiquez la taille de fichier maximale des ressources en Mo à inclure dans le processus d’ingestion dans le champ Filtrer par taille maximale.

  12. (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.

  13. (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.

    Filtres d’import en bloc.

  14. Cliquez sur Suivant. Sélectionnez l’une des options suivantes en fonction de vos préférences :

    • Enregistrer l'import pour enregistrer la configuration pour maintenant afin de pouvoir l’exécuter ultérieurement.
    • Enregistrer et exécuter l’import pour enregistrer la configuration et exécuter l’importation en bloc.
    • Enregistrement et planification de l’import pour enregistrer la configuration et planifier l’importation en bloc pour une heure ultérieure. Vous pouvez choisir la fréquence de l’importation en bloc et définir la date et l’heure de l’importation. L’importation en bloc s’exécute à la date et à l’heure définies dans la fréquence choisie.

    Exécution de l’import en bloc.

  15. 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 interdits, la gestion des noms de ressources et la gestion des noms de dossiers lors de l’importation en bloc, voir Gestion des noms de fichier lors de l’importation en bloc dans la vue d’administration.

Afficher les configurations d’import en bloc existantes view-import-configuration

Pour afficher les imports en masse existants, sélectionnez le 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 la variable Imports enregistrés et Imports planifiés dans la liste déroulante.

Enregistrement de la configuration d’import en bloc.

Modifier la configuration d’import en bloc edit-import-configuration

Pour modifier les détails de configuration, cliquez sur Icône Plus correspondant au nom de la configuration et cliquez sur Modifier. Notez que certains éléments ne sont pas modifiables, tels que le titre de la configuration et la source de données d’import. Vous pouvez modifier la configuration à l’aide des onglets Imports exécutés, planifiés ou enregistrés.

Modification de la configuration d’import en bloc.

Planifier des imports ponctuels ou récurrents schedule-imports

Pour planifier un import en bloc ponctuel ou récurrent, procédez comme suit :

  1. Cliquez sur Icône Plus correspondant au nom de configuration disponible dans la variable Imports exécutés ou Imports enregistrés et cliquez sur Planification. Vous pouvez également replanifier un import planifié existant en accédant à l’onglet Imports planifiés et en cliquant sur Planifier.

  2. Définissez une ingestion ponctuelle ou planifiez une planification horaire, quotidienne ou hebdomadaire. Cliquez sur Envoyer.

    Planification de la configuration d’import en bloc.

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 Icône Plus correspondant au nom de la configuration, puis cliquez sur Vérifier. Si la connexion est établie, Experience Manager Assets affiche le message suivant :

Vérification de l’intégrité de l’import en bloc.

Effectuer un essai avant l’exécution d’un import dry-run-bulk-import

Cliquez sur Icône Plus correspondant au nom de la configuration et cliquez sur Exécution d’essai pour appeler une exécution de test pour la tâche d’importation en bloc. Experience Manager Assets affiche les informations suivantes sur la tâche d’import en bloc :

Vérification de l’intégrité de l’import en bloc.

Exécuter un import en bloc run-bulk-import

Si vous avez enregistré l’importation lors de la création de la configuration, vous pouvez accéder à l’onglet Imports enregistrés , puis cliquer sur Icône Plus correspondant à la configuration et cliquez sur Exécuter.

De même, si vous devez exécuter un import déjà exécuté, accédez à l'onglet Imports exécutés , cliquez sur Icône Plus correspondant au nom de la configuration et cliquez sur Exécuter.

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.

Import en cours.

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 Icône Plus correspondant au nom de configuration existant dans Imports exécutés, Imports planifiés, ou Imports enregistrés onglets et clic Supprimer pour supprimer la configuration Import en bloc .

Accéder aux ressources après l’exécution de l’import en bloc view-assets-after-bulk-import

Pour afficher l’emplacement cible Ressources où les ressources sont importées après l’exécution de la tâche d’importation en bloc, cliquez sur Icône Plus correspondant au nom de la configuration, puis cliquez sur Affichage des ressources.

Vidéo : Importation en bloc de ressources à l’aide de la vue Assets

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab