DokumentationHandbuch zu Assets Essentials

Massenimport von Assets mithilfe von Assets Essentials bulk-import-essentials

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende
  • Führungskraft

Der Massenimport in AEM Assets Essentials bietet Admins die Möglichkeit, eine große Anzahl von Assets aus einer Datenquelle in AEM Assets zu importieren. Die Admins müssen keine einzelnen Assets oder Ordner mehr in AEM Assets hochladen.

NOTE
Die Massenimport-Funktion von Assets Essentials verwendet dasselbe Backend wie die Massenimport-Funktion von Assets as a Cloud Service. Sie bietet jedoch mehr Datenquellen, aus denen importiert werden kann, und ein stärker optimiertes Anwendererlebnis.

Sie können Assets aus den folgenden Datenquellen importieren:

  • AWS
  • Google Cloud
  • Dropbox
  • OneDrive
  • Azure

Voraussetzungen prerequisites

Datenquelle
Voraussetzungen
Azure
  • Azure-Speicherkonto
  • Azure-Blob-Container
  • Azure-Zugriffsschlüssel oder SAS-Token basierend auf dem Authentifizierungsmodus
AWS
  • AWS-Region
  • AWS-Bucket
  • AWS-Zugriffsschlüssel
  • AWS-Zugriffsgeheimnis
Google Cloud
  • GCP-Bucket
  • E-Mail für GCP-Service-Konto
  • Privater Schlüssel für GCP-Service-Konto
Dropbox
  • Dropbox-Client-ID
  • Dropbox-Client-Geheimnis
OneDrive
  • OneDrive Mandanten-ID
  • OneDrive Client-ID
  • OneDrive Client-Geheimnis

Zusätzlich zu diesen Voraussetzungen, die auf der Datenquelle basieren, müssen Sie den in Ihrer Datenquelle verfügbaren Namen des Quellordners kennen, der alle Assets enthält, die in AEM Assets importiert werden müssen.

Konfigurieren der Dropbox-Entwickleranwendung dropbox-developer-application

Bevor Sie Assets aus Ihrem Dropbox-Konto in AEM Assets importieren können, müssen Sie die Dropbox-Entwickleranwendung erstellen und konfigurieren.

Führen Sie die folgenden Schritte aus:

  1. Melden Sie sich bei Ihrem Dropbox-Konto an und klicken Sie auf Apps erstellen.
    Wenn Sie ein Enterprise Dropbox-Konto verwenden, benötigen Sie Zugriff auf die Rolle „Content-Administrator“.

  2. Wählen Sie im Abschnitt API auswählen das einzige verfügbare Optionsfeld aus.

  3. Wählen Sie im Abschnitt Benötigten Zugriffstyp auswählen eine der folgenden Optionen aus:

    • Wählen Sie App-Ordner, wenn Sie Zugriff auf einen einzelnen Ordner benötigen, der in Ihrer Anwendung in Ihrem Dropbox-Konto erstellt wurde.

    • Wählen Sie Vollständige Dropbox, wenn Sie Zugriff auf alle Dateien und Ordner in Ihrem Dropbox-Konto benötigen.

  4. Geben Sie einen Namen für das Formular ein und klicken Sie auf App erstellen.

  5. Fügen Sie in der Registerkarte  Einstellungen  Ihrer Anwendung „https://experience.adobe.com“ zum Abschnitt Umleitungs-URIs  hinzu.

  6. Kopieren Sie die Werte für die Felder App-Schlüssel und App-Geheimnis. Die Werte sind erforderlich, um das Tool für den Massenimport in AEM Assets zu konfigurieren.

  7. Fügen Sie in der Registerkarte Berechtigungen folgende Berechtigungen im Abschnitt Individuelle Bereiche hinzu.

    • account_info.read

    • files.metadata.read

    • files.content.read

    • files.content.write

  8. Klicken Sie auf Senden, um die Änderungen zu speichern.

Konfigurieren der OneDrive-Entwickleranwendung onedrive-developer-application

Bevor Sie Assets aus Ihrem OneDrive-Konto in AEM Assets importieren können, müssen Sie die OneDrive-Entwickleranwendung erstellen und konfigurieren.

Erstellen eines Programms

  1. Melden Sie sich bei Ihrem OneDrive-Konto an und klicken Sie auf Neue Registrierung.

  2. Geben Sie einen Namen für die Anwendung ein und wählen Sie Nur Konten in diesem Organisationsverzeichnis (nur Adobe – Einzelmandant) unter Unterstützte Kontotypen.

  3. Gehen Sie wie folgt vor, um Umleitungs-URIs hinzuzufügen:

    1. Wählen Sie im Dropdown-Menü Plattform auswählen die Option Web.

    2. Fügen Sie „https://experience.adobe.com“ zum Abschnitt Umleitungs-URIs hinzu.

  4. Klicken Sie auf Registrieren. Die Anwendung wurde erfolgreich erstellt.

  5. Kopieren Sie die Werte für die Felder Anwendungs-(Client)-ID und Verzeichnis-(Mandanten)-ID. Die Werte sind erforderlich, um das Tool für den Massenimport in AEM Assets zu konfigurieren.

  6. Klicken Sie auf  Zertifikat oder Geheimnis hinzufügen neben der Option Client-Anmeldeinformationen.

  7. Klicken Sie auf  Neues Client-Geheimnis, geben Sie eine Beschreibung für das Client-Geheimnis an und klicken Sie auf  Hinzufügen.

  8. Kopieren Sie nach der Erstellung des Client-Geheimnisses das Feld Wert (das Feld „Geheimnis-ID“ nicht kopieren). Dies ist erforderlich, um den Massenimport in AEM Assets zu konfigurieren.

Hinzufügen von API-Berechtigungen

Gehen Sie wie folgt vor, um API-Berechtigungen für die Anwendung hinzuzufügen:

  1. Klicken Sie auf API-Berechtigungen im linken Bereich und dann auf Berechtigung hinzufügen.
  2. Klicken Sie auf Microsoft-Diagramm > Delegierte Berechtigungen. Im Abschnitt Berechtigung auswählen werden die verfügbaren Berechtigungen angezeigt.
  3. Wählen Sie offline_access-Berechtigung von OpenId permissions und Files.ReadWrite.All-Berechtigung von Files.
  4. Klicken Sie auf Berechtigungen hinzufügen, um die Aktualisierungen zu speichern.

Erstellen einer Konfiguration für den Massenimport create-bulk-import-configuration

Führen Sie die folgenden Schritte aus, um in Experience Manager Assets eine Konfiguration für den Massenimport zu erstellen:

  1. Klicken Sie im linken Bereich auf  Massenimport und dann auf Import erstellen.

  2. Wählen Sie die Datenquelle aus. Zu den verfügbaren Optionen gehören Azure, AWS, Google Cloud, Dropbox und OneDrive.

  3. Geben Sie im Feld Name einen Namen für die Konfiguration des Massenimports an.

  4. Geben Sie die datenquellenspezifischen Anmeldeinformationen an, wie unter Voraussetzungen beschrieben.

  5. Geben Sie im Feld  Quellordner  den Namen des Stammordners an, der Assets in der Datenquelle enthält.

    note note
    NOTE
    Wenn Sie Dropbox als Datenquelle verwenden, geben Sie den Quellordnerpfad anhand der folgenden Regeln an:
    • Wenn Sie beim Erstellen der Dropbox-Anwendung die Option Vollständige Dropbox wählen und der Ordner mit den Assets in https://www.dropbox.com/home/bulkimport-assets vorhanden ist, geben Sie bulkimport-assets in das Feld Quellordner ein.
    • Wenn Sie beim Erstellen der Dropbox-Anwendung die Option App-Ordner wählen und der Ordner mit den Assets in https://www.dropbox.com/home/Apps/BulkImportAppFolderScope/bulkimport-assets vorhanden ist, geben Sie bulkimport-assets in das Feld Quellordner ein, wobei sich BulkImportAppFolderScope auf den Namen der Anwendung bezieht. Apps wird in diesem Fall automatisch hinter home eingefügt.

  6. (Optional) Wählen Sie die Option  Quelldatei nach Import löschen, um die Originaldateien aus dem Quelldatenspeicher zu löschen, nachdem die Dateien in Experience Manager Assets importiert wurden.

  7. Wählen Sie den Importmodus. Wählen Sie Überspringen, Ersetzen oder Version erstellen. Der Modus „Überspringen“ ist der Standardmodus. In diesem Modus überspringt das Aufnahme-Tool den Import eines Assets, wenn es bereits vorhanden ist.
    Importieren von Quelldetails

  8. (Optional) Geben Sie im Feld Metadatendatei die zu importierende Metadatendatei im CSV-Format an. Die Metadaten-Quelldatei muss sich im Quellordner befinden. Klicken Sie auf Weiter, um zu Speicherort und Filter zu navigieren.

  9. Um einen Speicherort in DAM zu definieren, in den Assets importiert werden sollen, geben Sie im Feld Zielordner für Assets einen Pfad an. Zum Beispiel: /content/dam/imported_assets.

  10. (Optional) Geben Sie im Abschnitt Filter wählen im Feld Filtern nach Mindestgröße die minimale Dateigröße der Assets in MB an, die in den Aufnahmeprozess einbezogen werden sollen.

  11. (Optional) Geben Sie im Feld Filtern nach max. Größe die maximale Dateigröße der Assets in MB an, die in den Aufnahmeprozess einbezogen werden sollen.

  12. (Optional) Wählen Sie mithilfe des Felds MIME-Typ einschließen die MIME-Typen aus, die in den Aufnahmeprozess miteinbezogen werden sollen. In diesem Feld können Sie mehrere MIME-Typen auswählen. Wenn Sie keinen Wert definieren, werden alle MIME-Typen in den Aufnahmeprozess einbezogen.

  13. (Optional) Wählen Sie mithilfe des Feldes MIME-Typ ausschließen die MIME-Typen aus, die ausgeschlossen werden sollen. In diesem Feld können Sie mehrere MIME-Typen auswählen. Wenn Sie keinen Wert definieren, werden alle MIME-Typen in den Aufnahmeprozess einbezogen.

    Massenimport-Filter

  14. Klicken Sie auf Weiter. Wählen Sie eine der folgenden Optionen entsprechend Ihren Vorlieben aus:

    • Import speichern, um die Konfiguration vorerst zu speichern, damit Sie sie später ausführen können.
    • Import speichern und ausführen, um die Konfiguration zu speichern und den Massenimport auszuführen.
    • Import speichern und planen, um die Konfiguration zu speichern und den Massenimport für einen späteren Zeitpunkt zu planen. Sie können die Häufigkeit des Massenimports auswählen und Datum und Uhrzeit für den Import festlegen.  Der Massenimport wird am festgelegten Datum und zur festgelegten Uhrzeit in der ausgewählten Häufigkeit ausgeführt.

    Massenimport ausführen

  15. Klicken Sie auf Speichern, um die ausgewählte Option auszuführen.

Umgang mit Dateinamen beim Massenimport filename-handling-bulkimport-assets-view

Wenn Sie Assets oder Ordner massenhaft importieren, importiert Experience Manager Assets die gesamte Struktur dessen, was in der Importquelle vorhanden ist. Experience Manager befolgt die integrierten Regeln für Sonderzeichen in den Asset- und Ordnernamen. Daher müssen diese Dateinamen bereinigt werden. Sowohl für den Ordnernamen als auch für den Asset-Namen bleibt der von den Benutzerinnen oder Benutzern definierte Titel unverändert und wird in jcr:title gespeichert.

Während des Massenimports sucht Experience Manager nach den vorhandenen Ordnern, um das erneute Importieren der Assets und Ordner zu vermeiden, und überprüft auch die Bereinigungsregeln, die im übergeordneten Ordner angewendet werden, in dem der Import stattfindet. Wenn die Bereinigungsregeln im übergeordneten Ordner angewendet werden, werden dieselben Regeln auf die Importquelle angewendet. Für neue Importe werden die folgenden Bereinigungsregeln angewendet, um die Dateinamen von Assets und Ordnern zu verwalten.

Weitere Informationen zu unzulässigen Namen und zum Umgang mit Asset-Namen und Ordnernamen beim Massenimport finden Sie unter Umgang mit Dateinamen beim Massenimport.

Anzeigen der vorhandenen Massenimportkonfigurationen view-import-configuration

Um die vorhandenen Massenimporte anzuzeigen, wählen Sie die Option  Massenimporte im linken Bereich. Die Seite mit den Massenimporten mit der Liste Ausgeführte Importe wird angezeigt.

Sie können auch die gespeicherten Importe und die geplanten Importe über die Dropdown-Option anzeigen.

Speichern der Massenimportkonfiguration

Bearbeiten einer Massenimportkonfiguration edit-import-configuration

Um die Konfigurationsdetails zu bearbeiten, klicken Sie auf das Symbol  Mehr neben dem Konfigurationsnamen und dann auf Bearbeiten. Sie können den Titel der Konfiguration und die Importdatenquelle beim Ausführen des Bearbeitungsvorgangs nicht bearbeiten. Sie können die Konfiguration mit den Registerkarten „Ausgeführte Importe“, „Geplante Importe“ oder „Gespeicherte Importe“ bearbeiten.

Bearbeiten einer Massenimportkonfiguration

Planen von einmaligen oder wiederkehrenden Importen schedule-imports

Gehen Sie wie folgt vor, um einen einmaligen oder einen wiederkehrenden Massenimport zu planen:

  1. Klicken Sie auf das Symbol  Mehr neben dem Konfigurationsnamen auf der Registerkarte Ausgeführte Importe oder Gespeicherte Importe und dann auf Planen. Sie können auch einen vorhandenen geplanten Import neu planen, indem Sie zur Registerkarte Geplante Importe gehen und auf Planen klicken.

  2. Legen Sie eine einmalige Aufnahme fest oder erstellen Sie einen stündlichen, täglichen oder wöchentlichen Zeitplan. Klicken Sie auf Senden.

    Planen einer Massenimportkonfiguration

Durchführen einer Konsistenzprüfung für den Import import-health-check

Um die Verbindung mit der Datenquelle zu überprüfen, klicken Sie auf das Symbol Mehr  neben dem Konfigurationsnamen und dann auf Überprüfen. Wenn die Verbindung erfolgreich hergestellt wurde, zeigt Experience Manager Assets die folgende Meldung an:

Konsistenzprüfung des Massenimports

Führen Sie vor dem Ausführen eines Imports einen Probelauf durch. dry-run-bulk-import

Klicken Sie auf das Symbol Mehr neben dem Konfigurationsnamen und dann auf Probelauf, um einen Testlauf für den Massenimportvorgang aufzurufen. Experience Manager Assets zeigt die folgenden Details zum Massenimportvorgang an:

Konsistenzprüfung des Massenimports

Ausführen eines Massenimports run-bulk-import

Wenn Sie den Import bei der Erstellung der Konfiguration gespeichert haben, können Sie zur Registerkarte „Gespeicherte Importe“ navigieren, auf das Symbol Mehr neben der Konfiguration klicken und dann auf Ausführen klicken.

Ebenso, wenn Sie einen bereits ausgeführten Import ausführen müssen, navigieren Sie zur Registerkarte „Ausgeführte Importe“, klicken Sie auf das Symbol Mehr neben dem Konfigurationsnamen und klicken Sie dann auf Ausführen.

Stoppen oder Planen eines laufenden Imports schedule-stop-ongoing-report

Sie können einen fortlaufenden Massenimport planen oder stoppen, indem Sie das Dialogfeld mit dem Massenimport-Status verwenden, das während eines Imports auf der Startseite des Massenimports angezeigt wird.

Laufender Import

Sie können auch die im Zielordner importierten Assets anzeigen, indem Sie auf Assets anzeigen klicken.

Löschen einer Konfiguration für den Massenimport delete-bulk-import-configuration

Klicken Sie auf das Symbol Mehr neben dem Konfigurationsnamen auf der Registerkarte Ausgeführte Importe, Geplante Importe oder Gespeicherte Importe und dann auf Löschen, um die Massenimportkonfiguration zu löschen.

Um den Asset-Zielspeicherort anzuzeigen, in den die Assets importiert werden, nachdem der Massenimportauftrag ausgeführt wurde, klicken Sie auf das Symbol Mehr neben dem Konfigurationsnamen und dann auf Assets anzeigen.

Video: Massenimport von Assets mithilfe von Assets Essentials

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

recommendation-more-help
7f481dbd-d5d0-4232-820e-84b31133bcac