Assets Essentials를 사용하여 자산 일괄 가져오기 bulk-import-essentials

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

주제:
Assets Essentials

작성 대상:

사용자
기본

AEM Assets Essentials의 일괄 가져오기는 관리자에게 데이터 소스에서 AEM Assets로 수많은 자산을 가져올 수 있는 기능을 제공합니다. 관리자는 더 이상 개별 자산 또는 폴더를 AEM Assets에 업로드할 필요가 없습니다.

NOTE

Assets Essentials 일괄 가져오기 도구는 Assets as a Cloud Service 일괄 가져오기 도구와 동일한 백엔드를 사용합니다. 그러나 Assets Essentials는 가져올 수 있는 더 많은 데이터 소스와 더욱 간소화된 사용자 경험을 제공합니다.

다음 데이터 소스에서 자산을 가져올 수 있습니다.

AWS
Google Cloud
Dropbox
OneDrive
Azure

사전 요구 사항 prerequisites

데이터 소스

사전 요구 사항

Azure

Azure 스토리지 계정
Azure Blob 컨테이너
인증 모드 기반의 Azure 액세스 키 또는 SAS 토큰

AWS

AWS 지역
AWS 버킷
AWS 액세스 키
AWS 액세스 암호

Google Cloud

GCP 버킷
GCP 서비스 계정 이메일
GCP 서비스 계정 비공개 키

Dropbox

Dropbox 클라이언트 ID
Dropbox 클라이언트 보안

OneDrive

OneDrive 테넌트 ID
OneDrive 클라이언트 ID
OneDrive 클라이언트 암호

데이터 소스 기반의 이러한 사전 요구 사항 외에도, AEM Assets로 가져와야 할 모든 자산이 포함된 데이터 소스에서 사용할 수 있는 소스 폴더 이름을 파악해야 합니다.

Dropbox 개발자 애플리케이션 구성 dropbox-developer-application

Dropbox 계정에서 AEM Assets로 자산을 가져오기 전에 Dropbox 개발자 애플리케이션을 만들고 구성해야 합니다.

다음 단계를 실행합니다.

Dropbox 계정으로 로그인한 다음 앱 만들기 를 클릭합니다.
기업용 Dropbox 계정을 사용하는 경우 콘텐츠 관리자 역할을 사용할 수 있어야 합니다.
API 선택 섹션에서 사용 가능한 라디오 버튼만 선택합니다.
필요한 액세스 유형 선택 섹션에서 다음 옵션 중 하나를 선택합니다.
- Dropbox 계정의 애플리케이션 내에 생성된 단일 폴더에 액세스해야 하는 경우 앱 폴더 를 선택합니다.
- Dropbox 계정 내의 모든 파일과 폴더에 액세스해야 하는 경우 전체 Dropbox 를 선택합니다.
애플리케이션 이름을 지정하고 앱 만들기 를 클릭합니다.
애플리케이션의 설정 탭에서 리디렉션 URI 섹션에 https://experience.adobe.com을 추가합니다.
앱 키 및 앱 암호 필드의 값을 복사합니다. 이 값은 AEM Assets에서 일괄 가져오기 도구를 구성하는 동안 필요합니다.
권한 탭에서 개별 범위 섹션 내에 다음 권한을 추가합니다.
- account_info.read
- files.metadata.read
- files.content.read
- files.content.write
제출 을 클릭하여 변경 내용을 저장합니다.

OneDrive 개발자 애플리케이션 구성 onedrive-developer-application

OneDrive 계정에서 AEM Assets로 자산을 가져오기 전에 OneDrive 개발자 애플리케이션을 만들고 구성해야 합니다.

애플리케이션 만들기

OneDrive 계정으로 로그인한 다음 신규 등록 을 클릭합니다.
애플리케이션 이름을 지정하고 지원되는 계정 유형 에서 이 조직 디렉터리에 있는 계정만(Adobe에만 해당 - 단일 테넌트) 을 선택합니다.
리디렉션 URI를 추가하려면 다음 단계를 실행합니다.
1. 플랫폼 선택 드롭다운 메뉴에서 웹 을 선택합니다.
2. 리디렉션 URI 섹션에 https://experience.adobe.com을 추가합니다.
등록 을 클릭합니다. 애플리케이션이 성공적으로 생성됩니다.
애플리케이션(클라이언트) ID 및 디렉터리(테넌트) ID 필드의 값을 복사합니다. 이 값은 AEM Assets에서 일괄 가져오기 도구를 구성하는 동안 필요합니다.
클라이언트 자격 증명 옵션에 맞는 인증서 또는 암호 추가 를 클릭합니다.
새 클라이언트 암호 를 클릭하고 클라이언트 암호 설명과 만료일을 입력한 다음 추가 를 클릭합니다.
클라이언트 암호를 만든 다음에는 값 필드를 복사합니다. 암호 ID 필드는 복사하지 마십시오. 값 필드는 AEM Assets에서 일괄 가져오기를 구성하는 동안 필요합니다.

API 권한 추가

애플리케이션에 대한 API 권한을 추가하려면 다음 단계를 실행하십시오.

왼쪽 창에서 API 권한 을 클릭하고 권한 추가 를 클릭합니다.
Microsoft Graph > 위임된 권한 을 클릭합니다. 권한 선택 섹션에 사용 가능한 권한이 표시됩니다.
OpenId permissions에서 offline_access 권한을 선택한 다음 Files에서 Files.ReadWrite.All 권한을 선택합니다.
권한 추가 를 클릭하여 업데이트를 저장합니다.

일괄 가져오기 구성 만들기 create-bulk-import-configuration

Experience Manager Assets에서 일괄 가져오기 구성을 만들려면 다음 단계를 실행합니다.

왼쪽 창에서 일괄 가져오기 를 클릭한 다음 가져오기 만들기 를 클릭합니다.
데이터 소스를 선택합니다. 사용 가능한 옵션에는 Azure, AWS, Google Cloud, Dropbox 및 OneDrive 가 있습니다.
이름 필드에 일괄 가져오기 구성의 이름을 지정합니다.
사전 요구 사항에서 언급한 대로 데이터 소스별 자격 증명을 지정합니다.

소스 폴더 필드에 데이터 소스의 자산이 포함된 루트 폴더의 이름을 입력합니다.

note note
NOTE
Dropbox를 데이터 소스로 사용하는 경우 다음 규칙에 따라 소스 폴더 경로를 지정합니다.
Dropbox 애플리케이션 및 `https://www.dropbox.com/home/bulkimport-assets`에 있는 자산이 포함된 폴더를 만드는 동안 전체 Dropbox 를 선택하는 경우 소스 폴더 필드에서 `bulkimport-assets`를 지정합니다. Dropbox 애플리케이션 및 `https://www.dropbox.com/home/Apps/BulkImportAppFolderScope/bulkimport-assets`에 있는 자산이 포함된 폴더를 만드는 동안 앱 폴더 를 선택하는 경우 소스 폴더 필드에서 `bulkimport-assets`를 지정합니다. 여기에서 `BulkImportAppFolderScope`은 애플리케이션의 이름을 나타냅니다. 이 경우 `Apps`가 `home` 다음에 자동으로 추가됩니다.

(선택사항) 가져오기 후 소스 파일 삭제 옵션을 선택하여 파일을 Experience Manager Assets로 가져온 후에 소스 데이터 저장소에서 원본 파일을 삭제합니다.
가져오기 모드 를 선택합니다. 건너뛰기, 바꾸기 또는 버전 만들기 를 선택합니다. 건너뛰기 모드는 기본값이고, 자산이 이미 존재하는 경우 이 모드에서 수집기는 자산 가져오기를 건너뜁니다.
(선택 사항) 메타데이터 파일 필드에서 가져올 메타데이터 파일(CSV 형식으로 제공)을 지정합니다. 메타데이터 소스 파일은 소스 폴더에 있어야 합니다. 다음 을 클릭하여 위치 및 필터 로 이동합니다.
자산 대상 폴더 필드를 사용하여 자산을 가져올 수 있는 DAM에 위치를 정의하려면 경로를 지정합니다. 예: /content/dam/imported_assets
(선택 사항) 필터 선택 섹션에 자산의 최소 파일 크기(MB)를 제공하여 최소 크기로 필터링 필드의 수집 프로세스에 자산을 포함시킵니다.
(선택 사항) 자산의 최대 파일 크기(MB)를 제공하여 최대 크기로 필터링 필드의 수집 프로세스에 자산을 포함시킵니다.
(선택 사항) MIME 유형 포함 필드를 사용하여 수집 프로세스에 포함할 MIME 유형을 선택합니다. 이 필드 내에서 여러 MIME 유형을 선택할 수 있습니다. 값을 정의하지 않은 경우 모든 MIME 유형이 수집 프로세스에 포함됩니다.
(선택 사항) MIME 유형 제외 필드를 사용하여 수집 프로세스에 제외할 MIME 유형을 선택합니다. 이 필드 내에서 여러 MIME 유형을 선택할 수 있습니다. 값을 정의하지 않은 경우 모든 MIME 유형이 수집 프로세스에 포함됩니다.
다음 을 클릭합니다. 다음 옵션 중 원하는 옵션 하나를 선택합니다.
- 가져오기 저장 은 나중에 실행할 수 있도록 현재 구성을 저장합니다.
- 저장 및 가져오기 실행 은 구성을 저장하고 일괄 가져오기를 실행합니다.
- 저장 및 가져오기 예약 은 구성을 저장하고 나중에 일괄 가져오기를 수행하도록 예약합니다. 일괄 가져오기의 빈도를 선택하고 가져오기를 수행할 날짜와 시간을 설정합니다. 일괄 가져오기는 선택된 빈도에 따라 설정된 날짜 및 시간에 실행됩니다.
저장 을 클릭하여 선택한 옵션을 실행합니다.

일괄 가져오기 도중 파일 이름 처리 filename-handling-bulkimport-assets-view

자산이나 폴더를 대량으로 가져올 때 Experience Manager Assets는 가져오기 소스에 존재하는 전체 구조를 가져옵니다. Experience Manager는 자산 및 폴더 이름의 특수 문자에 대해 내장된 규칙을 따르므로 이러한 파일 이름을 정리해야 합니다. 폴더 이름과 자산 이름 모두 사용자가 정의한 제목은 변경되지 않으며 jcr:title에 저장됩니다.

일괄 가져오기 도중 Experience Manager는 자산과 폴더를 다시 가져오는 것을 방지하기 위해 기존 폴더를 찾고, 가져오기가 수행되는 상위 폴더에 적용된 정리 규칙도 확인합니다. 정리 규칙이 상위 폴더에 적용되면 가져오기 소스에도 동일한 규칙이 적용됩니다. 새로운 가져오기의 경우 자산 및 폴더의 파일 이름을 관리하기 위해 다음과 같은 정리 규칙이 적용됩니다.

허용되지 않는 이름, 자산 이름 처리, 일괄 가져오기 도중 폴더 이름 처리에 대한 자세한 내용은 일괄 가져오기 도중 파일 이름 처리를 참조하십시오.

기존 일괄 가져오기 구성 보기 view-import-configuration

기존의 일괄 가져오기를 보려면 왼쪽 창에서 일괄 가져오기 옵션을 선택합니다. 실행된 가져오기 목록과 함께 일괄 가져오기 페이지가 나타납니다.

드롭다운 옵션에서 저장된 가져오기 및 예약된 가져오기 를 볼 수도 있습니다.

일괄 가져오기 구성 저장

일괄 가져오기 구성 편집 edit-import-configuration

구성 세부 정보를 편집하려면 구성 이름에 해당하는 을 클릭하고 편집 을 클릭합니다. 편집 작업을 수행하면서 구성 및 가져오기 데이터 소스의 제목을 편집할 수 없습니다. 실행된 가져오기 탭, 예약된 가져오기 탭 또는 저장된 가져오기 탭을 사용하여 구성을 편집할 수 있습니다.

일괄 가져오기 구성 편집

일회성 가져오기 또는 반복 가져오기 예약 schedule-imports

일회성 일괄 가져오기 또는 반복 일괄 가져오기를 예약하려면 다음 단계를 실행합니다.

실행된 가져오기 탭 또는 저장된 가져오기 탭에서 사용 가능한 구성 이름에 해당하는 을 클릭하고 예약 을 클릭합니다. 예약된 가져오기 탭으로 이동하고 예약 을 클릭하여 기존 예약된 가져오기를 다시 예약할 수도 있습니다.
일회성 수집을 설정하거나 매시간, 매일 또는 매주 단위로 일정을 예약합니다. 제출 을 클릭합니다.