[AEM_Assets]{class="badge positive" title="S’applique à AEM Assets)."}

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

La vue Importation en bloc dans Adobe Experience Manager (AEM) Assets permet aux administrateurs d’importer un grand nombre de ressources directement d’une source de données externe dans AEM Assets en une seule opération rationalisée. Cette fonctionnalité élimine la nécessité de charger des ressources ou des dossiers individuels un par un, ce qui la rend particulièrement utile pour les migrations de ressources à grande échelle, la consolidation des ressources numériques et l’intégration de contenu à partir de référentiels de stockage cloud existants.

En connectant directement AEM Assets à une source de données prise en charge, les administrateurs peuvent migrer des bibliothèques entières d’images, de vidéos, de documents et d’autres ressources numériques de manière efficace, ce qui réduit les efforts manuels et accélère le délai de rentabilisation lors du remplissage d’un environnement AEM Assets.

Sources de données prises en charge pour l’importation en bloc supported-data-sources

Les administrateurs peuvent importer des ressources à partir des sources de données suivantes, qui couvrent les principales plateformes de stockage dans le cloud et de partage de fichiers couramment utilisées dans les environnements d’entreprise :

Grâce à l’étendue des sources prises en charge, les administrateurs peuvent consolider les ressources stockées sur plusieurs plateformes en un seul référentiel AEM Assets, ce qui permet de rationaliser la gouvernance et de s’assurer que les ressources numériques sont gérées de manière centralisée.

Conditions préalables prerequisites

Avant d’importer du contenu dans Adobe Experience Manager (AEM) Assets, assurez-vous que les informations d’identification et les valeurs de configuration requises sont disponibles pour la source de données cloud de votre choix. Chaque source de données nécessite un ensemble spécifique de paramètres d’authentification et de connexion, comme résumé ci-dessous.

Ces informations d’identification authentifient la connexion entre Adobe Experience Manager (AEM) Assets et le fournisseur de stockage externe. Par conséquent, collectez-les à partir de la console de votre fournisseur de cloud avant de commencer l’importation.

Outre les conditions préalables spécifiques à la source répertoriées ci-dessus, vous devez identifier le nom du dossier source dans votre source de données. Il s’agit du dossier qui contient toutes les ressources que vous avez l’intention d’importer dans AEM Assets. Il est essentiel de connaître le nom exact du dossier source, car AEM l’utilise pour localiser et récupérer l’ensemble correct de ressources pendant le processus d’importation.

Configurer l’application de développement Dropbox dropbox-developer-application

Avant d’importer des ressources de votre compte Dropbox vers Adobe Experience Manager (AEM) Assets, vous devez créer et configurer l’application de développement Dropbox. Cette application génère les informations d’identification et accorde les portées d’autorisation dont AEM Assets a besoin pour s’authentifier auprès de Dropbox et transférer les fichiers en toute sécurité.

Pour créer et autoriser l’application de développement Dropbox, procédez comme suit :

Configurer l’application de développement OneDrive onedrive-developer-application

L’importation de ressources à partir de votre compte Microsoft OneDrive dans Adobe Experience Manager (AEM) Assets nécessite une application de développement OneDrive enregistrée. Vous devez créer et configurer cette application de développement avant toute importation, car l’application établit la connexion authentifiée qui permet à AEM d’accéder aux fichiers stockés dans OneDrive.

L’application de développement OneDrive sert d’intermédiaire approuvé entre AEM Assets et votre compte OneDrive. L’enregistrement de l’application fournit à AEM les informations d’identification dont il a besoin pour s’authentifier via Microsoft Identity Platform et récupérer les ressources en toute sécurité pour votre compte.

Principales raisons pour lesquelles l’application de développeur est une condition préalable :

Commencez par terminer la création et la configuration de l’application de développement OneDrive. Une fois l’application configurée, AEM Assets peut se connecter à OneDrive et commencer à importer vos ressources.

Créer une application pour l’importation en bloc OneDrive

L’enregistrement d’une application dans votre portail OneDrive (Azure) établit l’identité approuvée et les informations d’identification qui authentifient la connexion entre votre stockage OneDrive et Adobe Experience Manager (AEM) Assets. Pour créer l’application et rassembler les informations d’identification requises pour la configuration de l’importation en bloc, procédez comme suit :

Ajouter des autorisations d’API

La configuration des autorisations d’API accorde à l’application enregistrée les droits d’accès spécifiques dont elle a besoin pour communiquer avec Microsoft Graph au nom d’un utilisateur connecté. Les autorisations de l’interface de programmation d’application (API) définies ici déterminent exactement les données et actions que l’application est autorisée à demander. Pour ajouter les autorisations d’API requises pour l’application, procédez comme suit :

Créer une configuration d’import en bloc create-bulk-import-configuration

Pour créer une configuration d’importation en bloc dans Experience Manager Assets, procédez comme suit. Cette configuration définit la source de données, les informations d’identification, l’emplacement de la cible et les règles de filtrage qui régissent la manière dont les ressources sont ingérées dans Experience Manager Assets à partir d’un fournisseur de stockage externe :

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 l’ensemble de la structure qui existe dans la source d’importation. Experience Manager suit ses 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 s’assurer qu’ils sont conformes aux contraintes de dénomination du référentiel et qu’ils s’affichent de manière fiable sur l’ensemble de la plateforme. Pour les noms de dossier et de ressource, le titre défini par l’utilisateur reste inchangé et est stocké dans la propriété jcr:title. Cela signifie que l’assainissement affecte le nom du nœud sous-jacent tandis que le titre affiché lisible par l’utilisateur est conservé tel qu’il a été saisi à l’origine.

Lors de l’importation en bloc, Experience Manager effectue les vérifications suivantes avant d’appliquer des règles d’assainissement pour les nouvelles importations :

Par conséquent, lorsque des règles d’assainissement sont déjà appliquées dans le dossier parent, Experience Manager applique les mêmes règles à la source d’importation, assurant ainsi la cohérence dans toute la hiérarchie importée. Pour une nouvelle importation, les règles d’assainissement sont ensuite appliquées pour gérer les noms de fichier des ressources et des 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 Administration.

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

La page Imports en bloc fournit une vue centralisée de toutes les configurations d’importation en bloc, ce qui permet aux administrateurs de surveiller l’activité passée, de réutiliser des définitions enregistrées et de gérer les exécutions automatisées à venir à partir d’un seul emplacement.

Pour afficher les imports en bloc existants, procédez comme suit :

Types d’import disponibles import-types-available

La liste déroulante organise les configurations d’importation en bloc en trois catégories distinctes :

L’examen de ces configurations permet de s’assurer que les importations terminées comme prévu, que les définitions réutilisables restent exactes et que les exécutions planifiées sont correctement configurées avant leur exécution.

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

Modifiez les détails de configuration d’un import en bloc existant en procédant comme suit :

Le titre de la configuration et la source de données d’importation ne peuvent pas être modifiés au cours d’une opération de modification. Ces deux champs restent fixes une fois la configuration créée. Cela permet de s’assurer que l’importation conserve une identité stable et que les données source précédemment mappées continuent à s’aligner correctement, tout en préservant l’intégrité des exécutions exécutées et planifiées.

Modifiez une configuration à partir de l’un des onglets suivants : Exécuté, Planifié ou Importations enregistrées. Chaque onglet expose les mêmes contrôles de modification, de sorte qu’un administrateur peut mettre à jour une configuration à partir de n’importe quelle vue qui la répertorie, que l’importation ait déjà été exécutée, qu’elle soit planifiée ou qu’elle ait été enregistrée pour une utilisation ultérieure.

Planifier des imports ponctuels ou récurrents schedule-imports

La planification des imports vous permet d’automatiser l’ingestion des données afin que vos jeux de données restent à jour sans rechargement manuel. Pour planifier un import en bloc ponctuel ou récurrent, procédez comme suit :

Exécuter un contrôle de l’intégrité de l’import import-health-check

Le contrôle de l’intégrité de l’importation valide la connexion entre votre configuration d’importation et sa source de données avant l’exécution ou la planification d’une importation. L’exécution de cette vérification confirme qu’Adobe Experience Manager (AEM) Assets peut atteindre la source configurée, s’authentifier avec succès et récupérer les ressources, ce qui empêche les imports incomplets ou partiels en raison d’informations d’identification endommagées, de points d’entrée incorrects ou de services inaccessibles.

Pour valider la connexion à la source de données, procédez comme suit :

AEM Assets teste ensuite la connexion et affiche le résultat :

L’exécution de ce contrôle de l’intégrité avant chaque exécution d’importation réduit le risque d’erreurs d’importation et garantit que votre configuration source reste valide et accessible.

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

Une exécution d’essai est une exécution de test non destructive qui valide une tâche d’importation en bloc avant l’importation réelle des ressources. Il est vivement recommandé d’exécuter d’abord une exécution d’essai, car cela permet de prévisualiser et de vérifier la configuration de la tâche sans valider les modifications apportées au référentiel. Cela empêche l’apparition de problèmes courants tels que des conflits inattendus, des chemins d’accès source mal configurés ou des remplacements involontaires lors de l’importation en direct.

Pour effectuer une exécution d’essai, cliquez sur correspondant au nom de configuration, puis cliquez sur Exécution d’essai pour appeler une exécution de test pour la tâche d’importation en bloc. Comme l’exécution d’essai ne simule que l’opération, aucune ressource n’est ingérée et aucun contenu existant n’est modifié.

Experience Manager Assets affiche ensuite un résumé des détails détectés pour la tâche Importation en bloc, ce qui vous permet de confirmer la portée avant de continuer. Ce résumé comprend généralement les éléments suivants :

La consultation de ces résultats d’essai avant l’exécution de l’importation garantit que la tâche se comporte comme prévu. Par conséquent, vous pouvez corriger rapidement tout problème de configuration, ce qui réduit le risque d’échec des imports ou d’imports partiels lorsque la tâche d’importation en bloc est exécutée pour de vrai.

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

Une importation en bloc peut être déclenchée à partir de l’un des deux emplacements, selon que la configuration d’importation a été enregistrée pendant la configuration ou a déjà été exécutée au moins une fois. Les deux chemins utilisent l’icône située en regard de la configuration pour lancer l’exécution.

Exécuter un import enregistré run-saved-import

Si vous avez enregistré l’importation lors de la création de la configuration, exécutez-la à partir de l’onglet Importations enregistrées :

Réexécution d’un import précédemment exécuté rerun-executed-import

Pour exécuter un import qui a déjà été exécuté, utilisez l’onglet Imports exécutés. Vous pouvez ainsi retraiter ou actualiser les données précédemment ingérées sans recréer la configuration :

Arrêter ou planifier un import en cours schedule-stop-ongoing-report

Vous pouvez planifier ou arrêter un import en bloc en cours directement à partir de la boîte de dialogue statut de l’import en bloc qui s’affiche sur la page d’accueil de l’import en bloc pendant l’importation. Cette boîte de dialogue vous permet de contrôler l’opération en temps réel. Ainsi, une importation active peut être suspendue, différée à une heure planifiée ou complètement arrêtée sans quitter la page d’accueil.

Gestion d’un import actif managing-active-import

Utilisez la boîte de dialogue Statut de l’importation en bloc pour contrôler l’importation en cours :

Comme ces commandes s’affichent pendant l’importation elle-même, vous pouvez ajuster ou annuler l’opération dès que la boîte de dialogue d’état indique qu’une action est nécessaire.

Vérification des ressources importées verify-imported-assets

Vous pouvez également afficher les ressources déjà importées dans le dossier cible en cliquant sur Afficher Assets. Vous pouvez ainsi confirmer que l’importation se déroule comme prévu et valider les résultats directement dans le dossier cible, en vous assurant que les ressources appropriées ont été transférées avant la fin de l’importation.

Supprimer une configuration d’import en bloc delete-bulk-import-configuration

Supprimez toute configuration d’importation en bloc directement à partir de l’interface à l’aide de l’action Supprimer. Une configuration d’importation en bloc peut apparaître dans l’un des trois onglets en fonction de son état : l’onglet Imports exécutés (configurations qui ont déjà été exécutées), l’onglet Imports planifiés (configurations mises en file d’attente pour s’exécuter à un moment défini) ou l’onglet Imports enregistrés (configurations enregistrées pour une utilisation ultérieure). L’action de suppression est disponible à partir de l’onglet répertoriant actuellement la configuration.

Pour supprimer une configuration d’importation en bloc :

La configuration d’importation en bloc sélectionnée est alors définitivement supprimée de la liste, s’assurant qu’elle ne s’exécute plus, qu’elle reste planifiée ou qu’elle peut être réutilisée.

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

Une fois la tâche d’importation en bloc Bulk Import terminée, vous pouvez accéder directement à l’emplacement cible où les ressources importées sont stockées. La confirmation de cette destination est une étape de vérification essentielle : elle vous permet de vérifier que les ressources ont atterri dans le dossier prévu, de passer en revue leurs métadonnées et de confirmer que l’importation s’est correctement exécutée avant de commencer à utiliser le contenu.

Pour afficher l’emplacement cible d’Assets où les ressources sont importées après l’exécution de la tâche d’importation en bloc :

Sélectionnez Afficher Assets pour ouvrir l’emplacement cible d’Assets, vous menant directement au dossier qui a reçu les fichiers importés. Vous bénéficiez ainsi d’un accès immédiat aux ressources importées afin de pouvoir vérifier les résultats, inspecter des éléments individuels et continuer les tâches en aval telles que le balisage, la révision ou la publication.

Limites et contraintes d’authentification limitations-authentication-constraints

Voir également