DocumentationAEM as a Cloud ServiceGuide de l’utilisateur

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

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Utilisateur ou utilisatrice
Bonnes pratiques de recherche
Bonnes pratiques en matière de métadonnées
Hub de contenus
Dynamic Media avec fonctionnalités OpenAPI
Documentation destinée aux développeurs AEM Assets

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

  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 l’onglet Paramètres de votre application, ajoutez https://experience.adobe.com à la section 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éer une application

  1. Connectez-vous à votre compte OneDrive et cliquez sur Nouvel enregistrement.

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

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

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

    2. Ajoutez https://experience.adobe.com à la section URI de redirection.

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

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

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

  7. Cliquez sur Nouveau secret client, indiquez la description et l’expiration du secret client, puis 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.

Ajouter des autorisations d’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’import en bloc dans Experience Manager Assets, procédez comme suit :

  1. Cliquez sur Import 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 comprennent 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 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, 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.
    note note
    NOTE
    Si vous utilisez OneDrive comme source de données, spécifiez le chemin du dossier source en fonction des règles suivantes :
    • Indiquez uniquement le nom du dossier racine, sans le domaine . Si le chemin URL complet du dossier est https://my.sharepoint.com/my?id=/personal/user/Documents/Importfolder/, spécifiez /Importfolder/ dans le champ Dossier Source .
    • Si le nom du dossier contient plusieurs mots séparés par des espaces, indiquez le nom avec les espaces dans la configuration de l’importation en bloc.
    • Le dossier source doit se trouver à la racine du répertoire. Les chemins de dossier ne sont pas pris en charge.

  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.

    note note
    NOTE
    En fonction des règles de sécurité de votre entreprise, vous devrez peut-être demander le consentement de l’administrateur pour que cette application se connecte à l’outil d’importation en bloc. Si cela est nécessaire, l’administrateur doit fournir son consentement avant que la configuration de l’importation en bloc ne puisse être enregistrée.

  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 :

    • 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’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 masse, voir Gestion des noms de fichier lors de l’importation en masse dans la vue d’administration.

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.

Enregistrement de la configuration d’import en bloc

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

Pour modifier les détails de la configuration, cliquez sur l’ icône Plus correspondant au nom de la configuration, puis 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 l’ icône Plus correspondant au nom de la configuration disponible dans l’onglet Imports exécutés ou Imports enregistrés et cliquez sur Planifier. 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 l’ icône Plus correspondant à la configuration, puis 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 l’ icône Plus correspondant au nom de la configuration et cliquez sur Exécution dʼessai pour lancer une exécution test pour le traitement d’import 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’import lors de la création de la configuration, vous pouvez accéder à l’onglet Imports enregistrés, cliquer sur l’ icône Plus correspondant à la configuration, puis 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 l’ icône Plus correspondant au nom de la configuration, puis 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 l’ icône Plus correspondant au nom de la configuration qui existe dans les onglets Imports exécutés, Imports planifiés ou Imports enregistrés, puis sur Supprimer pour supprimer la configuration d’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 des ressources où les ressources sont importées après l’exécution de la tâche d’import en bloc, cliquez sur l’ icône Plus correspondant au nom de la configuration, puis sur Afficher les ressources.

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

https://video.tv.adobe.com/v/3428012

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