Importer des ressources en bloc à l’aide de la vue 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.

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

• Azure
• AWS
• Google Cloud
• Dropbox
• OneDrive

Conditions préalables requises

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.

Configuration de l’application de développement de Dropbox

Avant d’importer des ressources de votre compte de Dropbox vers AEM Assets, créez et configurez l’application de développement de Dropbox.

Procédez comme suit :

1. Connectez-vous à Compte Dropbox et cliquez sur Création d’applications.

2. Dans le Choix d’une API , sélectionnez le seul bouton radio disponible.

3. Dans le Choisissez le type d'accès dont vous avez besoin , sélectionnez l’une des options suivantes :

   • Sélectionner Dossier de l’application, si vous avez besoin d’accéder à un seul dossier créé dans votre application dans votre compte de Dropbox.

   • Sélectionner Dropbox complet, si vous devez accéder à tous les fichiers et dossiers de votre compte de Dropbox.

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

5. Dans le Paramètres dans l’onglet de votre application, ajoutez ce qui suit au URI de redirection section :

   • https://exc-unifiedcontent.experience.adobe.net

   • https://exc-unifiedcontent.experience-stage.adobe.net (valide uniquement pour les environnements intermédiaires)

6. Copiez les valeurs de la variable Clé de l’application et Secret de l’application des champs. Les valeurs sont requises lors de la configuration de l’outil d’importation en bloc dans AEM Assets.

7. Sur le Autorisations , ajoutez les autorisations suivantes dans la Portées individuelles .

   • account_info.read

   • files.metadata.read

   • files.content.read

   • files.content.write

8. Cliquez sur Envoyer pour enregistrer les modifications.

Configuration de l’application de développement OneDrive

Avant d’importer des ressources de votre compte OneDrive vers AEM Assets, créez et configurez l’application de développement OneDrive.

Procédez comme suit :

1. Connectez-vous à 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, puis cliquez sur Enregistrer. L’application est créée avec succès.

3. Copiez les valeurs des champs ID client de l’application et ID client. Les valeurs sont requises lors de la configuration de l’outil d’importation en bloc dans AEM Assets.

4. Pour ajouter un certificat, procédez comme suit :

   1. Sur la page d’aperçu de l’application, cliquez sur Ajouter un certificat ou un secret puis cliquez sur Nouveau secret client.
   2. Indiquez la description et l’expiration du secret client, puis cliquez sur Ajouter.
   3. Après avoir créé le secret client, copiez la variable Valeur (Ne copiez pas le champ Identifiant secret ). Elle est requise lors de la configuration de l’importation en bloc dans AEM Assets.

5. Exécutez les étapes suivantes pour ajouter des URI de redirection :

   1. Sur la page d’aperçu de l’application, cliquez sur Ajout d’un URI de redirection > Ajouter une plate-forme > Web.

   2. Ajoutez ce qui suit au URI de redirection section :

      • https://exc-unifiedcontent.experience.adobe.net

      • https://exc-unifiedcontent.experience-stage.adobe.net (valide uniquement pour les environnements intermédiaires)

      Ajoutez le premier URI et cliquez sur Configurer pour l’ajouter. Vous pouvez en ajouter d’autres en cliquant sur Ajouter un URI , disponible dans la variable Web de la section Authentification page.

6. Pour ajouter des autorisations d’API à l’application, procédez comme suit :

   1. Cliquez sur Autorisations d’API dans le volet de gauche, puis cliquez sur Ajouter une autorisation.
   2. Cliquez sur Graphique Microsoft > Autorisations déléguées. La variable Sélectionner l’autorisation affiche les autorisations disponibles.
   3. Sélectionner offline_access autorisation de OpenId permissions et Files.ReadWrite.All autorisation de Files.
   4. Cliquez sur Ajout d’autorisations pour enregistrer les mises à jour.

Créer une configuration d’import en bloc

Pour créer une configuration d’import en bloc, procédez comme suit :

1. Accédez à Paramètres > Import en bloc et cliquez sur Créer un import.

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

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 contenant les ressources dans la source de données dans la variable Dossier source champ .

   REMARQUE

   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 Dropbox complet lors de la création de l’application de Dropbox et le dossier contenant les ressources existe à l’adresse https://www.dropbox.com/home/bulkimport-assets, puis spécifiez bulkimport-assets dans le Dossier source champ .
   • Si vous sélectionnez Dossier de l’application lors de la création de l’application de Dropbox et le dossier contenant les ressources existe à l’adresse https://www.dropbox.com/home/Apps/BulkImportAppFolderScope/bulkimport-assets, puis spécifiez bulkimport-assets dans le Dossier source champ, 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à.
   

8. (Facultatif) Indiquez le fichier de métadonnées à importer, fourni au format CSV, dans le champ Fichier de métadonnées, puis 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.

    

14. Cliquez sur Suivant. Sélectionnez Enregistrer et exécuter l’import pour enregistrer la configuration et exécuter l’import en bloc. Sélectionnez Enregistrer l’import pour enregistrer la configuration afin de pouvoir l’exécuter ultérieurement.

    

15. Cliquez sur Enregistrer pour exécuter l’option sélectionnée.

Gestion des noms de fichier lors de l’importation en bloc

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

Si vous choisissez d’enregistrer la configuration après sa création, celle-ci s’affiche dans l’onglet Imports enregistrés.

Si vous choisissez d’enregistrer et d’exécuter l’import, la configuration de celui-ci s’affiche dans l’onglet Imports exécutés.

Si vous planifiez un import, il s’affiche dans l’onglet Imports planifiés.

Modifier la configuration d’import en bloc

Pour modifier les détails de configuration, cliquez sur Plus d’options (…) correspondant au nom de la configuration, puis 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.

Planifier des imports ponctuels ou récurrents

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

1. Cliquez sur Plus d’options (…) correspondant au nom de configuration disponible dans la 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.

   

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

Pour valider la connexion à la source de données, cliquez sur Autres options (…) correspondant au nom de la configuration, puis cliquez sur Vérifier. Si la connexion est établie, Experience Manager Assets affiche le message suivant :

Effectuer un essai avant l’exécution d’un import

Cliquez sur Autres options (…) correspondant au nom de la configuration, puis 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 :

Exécuter un import en bloc

Si vous avez enregistré l’importation lors de la création de la configuration, vous pouvez accéder à l’onglet Imports enregistrés , cliquer sur Plus d’options (…) correspondant à la configuration et cliquer 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 Plus d'options (…) correspondant au nom de la configuration et cliquez sur Exécuter.

Arrêter ou planifier un import en cours

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

Cliquez sur Autres options (…) 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

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 Autres options (…) correspondant au nom de la configuration, puis cliquez sur Affichage des ressources.