자산 보기를 사용하여 자산 일괄 가져오기 bulk-import-assets-view
AEM Assets 보기의 일괄 가져오기는 관리자에게 데이터 소스에서 AEM Assets로 수많은 자산을 가져올 수 있는 기능을 제공합니다. 관리자는 더 이상 개별 자산 또는 폴더를 AEM Assets에 업로드할 필요가 없습니다.
다음 데이터 소스에서 자산을 가져올 수 있습니다.
- Azure
- AWS
- Google Cloud
- Dropbox
- OneDrive
사전 요구 사항 prerequisites
- Azure 스토리지 계정
- Azure Blob 컨테이너
- 인증 모드 기반의 Azure 액세스 키 또는 SAS 토큰
- AWS 지역
- AWS 버킷
- AWS 액세스 키
- AWS 액세스 암호
- GCP 버킷
- GCP 서비스 계정 이메일
- GCP 서비스 계정 비공개 키
- Dropbox 클라이언트 ID(앱 키)
- Dropbox 클라이언트 암호(앱 암호)
- 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를 추가하려면 다음 단계를 실행합니다.
-
플랫폼 선택 드롭다운 메뉴에서 웹 을 선택합니다.
-
리디렉션 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
다음에 자동으로 추가됩니다.
note note NOTE OneDrive를 데이터 원본으로 사용하는 경우 다음 규칙에 따라 원본 폴더 경로를 지정하십시오. - 도메인 없이 루트 폴더 이름만 지정하십시오. 폴더의 전체 URL 경로가
https://my.sharepoint.com/my?id=/personal/user/Documents/Importfolder/
인 경우 Source 폴더 필드에/Importfolder/
을(를) 지정하십시오. - 폴더 이름에 공백으로 구분된 여러 단어가 포함된 경우 대량 가져오기 구성에서 공백을 사용하여 이름을 지정합니다.
- 소스 폴더는 디렉터리의 루트에 있어야 합니다. 폴더 경로는 지원되지 않습니다.
- Dropbox 애플리케이션 및
-
(선택사항) 가져오기 후 소스 파일 삭제 옵션을 선택하여 파일을 Experience Manager Assets로 가져온 후에 소스 데이터 저장소에서 원본 파일을 삭제합니다.
-
가져오기 모드 를 선택합니다. 건너뛰기, 바꾸기 또는 버전 만들기 를 선택합니다. 건너뛰기 모드는 기본값이고, 자산이 이미 존재하는 경우 이 모드에서 수집기는 자산 가져오기를 건너뜁니다.
-
(선택 사항) 메타데이터 파일 필드에서 가져올 메타데이터 파일(CSV 형식으로 제공)을 지정합니다. 메타데이터 소스 파일은 소스 폴더에 있어야 합니다. 다음 을 클릭하여 위치 및 필터 로 이동합니다.
note note NOTE 조직의 보안 규칙에 따라 일괄 가져오기 도구에 연결하려면 이 응용 프로그램에 대한 관리자 동의가 필요할 수 있습니다. 필요한 경우 벌크 가져오기 구성을 저장하기 전에 관리자가 동의해야 합니다. -
자산 대상 폴더 필드를 사용하여 자산을 가져올 수 있는 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
일회성 일괄 가져오기 또는 반복 일괄 가져오기를 예약하려면 다음 단계를 실행합니다.
-
실행된 가져오기 탭 또는 저장된 가져오기 탭에서 사용 가능한 구성 이름에 해당하는 을 클릭하고 예약 을 클릭합니다. 예약된 가져오기 탭으로 이동하고 예약 을 클릭하여 기존 예약된 가져오기를 다시 예약할 수도 있습니다.
-
일회성 수집을 설정하거나 매시간, 매일 또는 매주 단위로 일정을 예약합니다. 제출 을 클릭합니다.
가져오기 상태 검사 수행 import-health-check
데이터 소스에 대한 연결을 확인하려면 구성 이름에 해당하는 을 클릭한 다음 확인 을 클릭합니다. 정상적으로 연결되면 Experience Manager Assets에는 다음과 같은 메시지가 표시됩니다.
가져오기 실행 전에 시험 실행을 수행합니다. dry-run-bulk-import
구성 이름에 해당하는 을 클릭하고 시험 실행 을 클릭하여 일괄 가져오기 작업에 대한 테스트 실행을 호출합니다. Experience Manager Assets에는 일괄 가져오기 작업에 대한 다음 세부 정보가 표시됩니다.
일괄 가져오기 실행 run-bulk-import
구성을 만드는 동안 가져오기를 저장한 경우 저장된 가져오기 탭으로 이동하고 구성 이름에 해당하는 을 클릭한 다음 실행 을 클릭합니다.
마찬가지로 이미 실행된 가져오기를 실행해야 할 경우 실행된 가져오기 탭으로 이동하고 구성 이름에 해당하는 을 클릭한 다음 실행 을 클릭합니다.
진행 중인 가져오기 중지 또는 예약 schedule-stop-ongoing-report
가져오기 도중 일괄 가져오기 홈 페이지에 표시되는 일괄 가져오기 상태 대화 상자를 사용하여 진행 중인 일괄 가져오기를 예약하거나 중지할 수 있습니다.
또한 자산 보기 를 클릭하여 대상 폴더에서 가져온 자산을 볼 수 있습니다.
일괄 가져오기 구성 삭제 delete-bulk-import-configuration
실행된 가져오기 탭, 예약된 가져오기 탭 또는 저장된 가져오기 탭에 있는 구성 이름에 해당하는 을 클릭하고 삭제 를 클릭하여 일괄 가져오기 구성을 삭제합니다.
일괄 가져오기를 수행하고 자산으로 이동 view-assets-after-bulk-import
일괄 가져오기 작업 실행 후 자산을 가져오는 자산 대상 위치를 보려면 구성 이름에 해당하는 을 클릭한 다음 자산 보기 를 클릭합니다.