통합 사용
연습
다음 비디오 연습에서는 커넥터 사용에 대해 설명합니다.
설정
이 안내서에서는 커넥터를 시작하고 실행하는 과정을 안내합니다.
통합 패키지 설치
통합 AEM 패키지에 대한 액세스 권한을 받습니다. 통합을 설치하는 두 가지 옵션이 있습니다.
- 패키지 설치 - 앞으로 곧게, 덜 포함됨.
- POM 설치 - 고급 기능이 있지만 AEM Cloud Manager을 사용하고 통합을 업그레이드할 때 유용할 수 있습니다.
패키지 설치
패키지를 설치하려면 온보딩 이메일에 제공된 링크로 패키지를 다운로드합니다. AEM 패키지 설치에 대한 자세한 지침은 여기를 클릭하여 확인할 수 있습니다.
POM 설치
POM에 커넥터를 포함하려면 다음 단계를 따르십시오. 사용자 이름 및 암호를 온보딩 이메일에서 받은 사용자 이름 및 암호로 바꿉니다.
-
프로젝트의
.cloudmanager/maven/settings.xml파일 또는 컴퓨터의~/.m2/settings.xml에 다음 내용을 추가하십시오.YOUR_USERNAME을(를) 사용자 이름으로 바꾸고YOUR_PASSWORD을(를) 온보딩 전자 메일에 입력한 암호로 바꿉니다.note important IMPORTANT Cloud Manager를 사용하는 경우 안전한 접근 방법은 암호로 보호된 Maven 저장소에 대해 여기에 있는 단계를 따르는 것입니다. code language-none <settings> ... <servers> ... <server> <id>repo.ea.adobe.net</id> <username>YOUR_USERNAME</username> <password>YOUR_PASSWORD</password> <filePermissions>BucketOwnerFullControl</filePermissions> <configuration> <wagonProvider>s3</wagonProvider> </configuration> </server> ... </servers> ... </settings> -
프로젝트의
pom.xml파일에 다음 내용을 추가하십시오.code language-none <project> ... <build> ... <extensions> ... <extension> <groupId>com.allogy.maven.wagon</groupId> <artifactId>maven-s3-wagon</artifactId> <version>1.2.0</version> </extension> ... </extensions> ... </build> ... <repositories> ... <repository> <id>repo.ea.adobe.net</id> <url>s3://repo.ea.adobe.net/release</url> <releases> <enabled>true</enabled> </releases> </repository> ... </repositories> ... </project> -
프로젝트의
all/pom.xml파일에 다음 내용을 추가하십시오.project.dependencies.dependency.version을(를) 적절한 버전으로 바꾸고project.build.plugins.plugin.configuration.embeddeds.embedded.target을(를) 올바른 경로로 바꿉니다.code language-none <project> ... <build> ... <plugins> ... <plugin> <groupId>org.apache.jackrabbit</groupId> <artifactId>filevault-package-maven-plugin</artifactId> ... <configuration> ... <embeddeds> ... <embedded> <groupId>com.adobe.acs.aemveeva</groupId> <artifactId>aem-veeva-connector.all</artifactId> <type>zip</type> <target>/apps/APP_NAME-packages/application/install</target> </embedded> ... </embeddeds> </configuration> </plugin> ... </plugins> ... </build> ... <dependencies> ... <dependency> <groupId>com.adobe.acs.aemveeva</groupId> <artifactId>aem-veeva-connector.all</artifactId> <version>1.0.5</version> <type>zip</type> </dependency> ... </dependencies> ... </project>
클라우드 구성
이 통합은 커넥터가 작동할 폴더에 클라우드 구성을 만들어 구성되었습니다. 다음 단계에 따라 클라우드 구성을 만듭니다.
-
Veeva 클라우드 구성으로 이동합니다.
-
적절한 폴더에 새 Veeva 클라우드 구성을 생성하고 다음 섹션에 설명된 대로 을 채웁니다.
구성 탭
구성 탭에서 다음을 입력합니다.
- 필수. Veeva Vault 커넥터 구성 제목 이는 임의의 값이 될 수 있습니다. (예:
Veeva Vault Configuration) - 필수. Veeva 인스턴스의 도메인 URL(예:
https://my-instance.veevavault.com/) - 필수. Veeva Vault API를 호출하는 데 필요한 ClientID. 이 값은 임의의 값이 될 수 있으며 대부분 디버깅에 사용됩니다. (예:
adobe-aem-vvtechpartner) - 필수. Veeva Vault 사용자 이름. Veeva 사용자 만들기를 참조하십시오.
- 필수. Veeva Vault 암호입니다. Veeva 사용자 만들기를 참조하십시오.
Adobe IO 탭
프로젝트가 페이지에 대한 PDF 또는 이미지를 생성해야 하는 경우 이 탭이 필요합니다. adobe io 탭에서 다음을 입력합니다.
- 필수. 온보딩 이메일에 제공된 PDF 이미지를 만들기 위한 Adobe IO 엔드포인트. (예:
https://my-namespace.adobeioruntime.net/api/v1/web/aem-veeva-serverless-0.0.2/trigger-action.json) - 필수. 페이지 이미지 생성을 위한 작업 이름입니다. 이 값은
aem-veeva-integration/get-image-async이어야 합니다. - 필수. HTML 이미지 생성을 위한 작업 이름입니다. 이 값은
aem-veeva-integration/get-pdf-async-new이어야 합니다. - 필수. 온보딩 이메일에 제공된 생성 상태를 가져오기 위한 Adobe IO 엔드포인트.(예:
https://my-namespace.adobeioruntime.net/api/v1/web/aem-veeva-serverless-0.0.2/get-state-value) - 필수. Adobe IO에서 사용할 AEM 사용자 이름입니다. AEM 사용자 만들기를 참조하십시오.
- 필수. Adobe IO에서 사용할 AEM 암호입니다. AEM 사용자 만들기를 참조하십시오.
- 선택 사항입니다. 기본 시간 제한은 AIO 서비스가 응답 가져오기를 중지하는 지정된 시간까지 페이지가 응답할 수 있도록 하는 것입니다. 기본값은
30000입니다. - 선택 사항입니다. 지연은 스크린샷을 찍기 전에 모든 이미지를 렌더링하기 위해 페이지가 200으로 응답한 이후입니다. 기본값은
2000입니다. - 선택 사항입니다. 스크린샷/PDF 생성 URL은 구성된 값(초) 이후 만료됩니다.
- 선택 사항입니다. Adobe IO 스크린샷/PDF 생성 서비스가 비동기화됩니다. AEM 서비스는 AIO 상태 엔드포인트를 호출하여 스크린샷/PDF을 가져옵니다. 이 속성은 각 상태 호출 간의 일시 중지를 밀리초 단위로 결정합니다. 기본값은
10000입니다. - 선택 사항입니다. 스크린샷/PDF 가져오기를 위한 Adobe IO에 대한 상태 호출의 최대 재시도 횟수. 기본값은
10입니다.
고급 탭
고급 탭에서 다음을 입력합니다.
- PDF/이미지 생성에 필요합니다. PDF/이미지를 만들 때 사용되는 파일 이름 패턴입니다.
{name}을(를) 템플릿으로 만들 수 있습니다. (예:{name}-screenshot) - 선택 사항입니다. 데스크탑 이외의 필요한 페이지 스크린샷에 대한 장치 유형입니다. 유효한 형식에는
Tab (iPad)및Mobile (iPhone X)이(가) 포함됩니다. - 선택 사항입니다. 위 렌디션을 나타내는 Veeva의 렌디션 유형 값입니다. (예:
web_ready__c) - PDF/이미지 생성에 필요합니다. 생성할 스크린샷 유형입니다.
PDF또는Image입니다. - PDF/이미지 생성에 필요합니다. 생성할 PDF 유형입니다.
Print CSS Based PDF또는Pixel Perfect Screenshot PDF입니다. - PDF/이미지 생성에 필요합니다. 생성할 이미지 유형입니다.
PNG또는JPEG입니다. - 필수. Veeva Vault 승인 트리거가 실행되면 실행할 워크플로우입니다.
- 필수. 승인됨을 나타내는 상태 속성 값입니다. (예:
Approved for Distribution) - 필수. Veeva Vault 거부 트리거가 실행되면 실행할 워크플로우입니다.
- 필수. 거부됨/승인되지 않음 을 나타내는 상태 속성 값입니다. (예:
Rejected) - 선택 사항입니다. Veeva Vault의 문서 ID에 대한 속성 이름입니다. 기본값은
id입니다. - 선택 사항입니다. Veeva Vault의 상태에 대한 속성 이름입니다. 기본값은
status__v입니다. - 선택 사항입니다. 문서 수정 날짜의 속성 이름입니다. 기본값은
version_modified_date__v입니다. - 선택 사항입니다. 문서 리소스 URL의 속성 이름입니다. 기본값은
external_id__v입니다. 이 필드가 이미 사용 중이면 Veeva에서 다른 필드를 만들고 여기에서 필드 이름을 채웁니다. 이 필드는 AEM 리소스 경로를 보유하기 위해 Veeva에서 사용됩니다. 이 단계는 자동화된 메타데이터 동기화에 필요합니다. - 선택 사항입니다. Veeva Vault의 주요 버전 번호에 대한 속성 이름입니다. 기본값은
major_version_number__v입니다. - 선택 사항입니다. Veeva Vault의 부 버전 번호에 대한 속성 이름입니다. 기본값은
minor_version_number__v입니다. - 선택 사항입니다. Veeva Vault 관계 유형 값입니다. 페이지에 추가된 모든 에셋은 이 값을 기반으로 관련 에셋으로 표시됩니다. 기본값은
supporting_document__c입니다.
페이지 탭
페이지를 동기화하는 경우 페이지 탭에 다음을 입력합니다.
-
필수. AEM에서 Veeva로 속성을 매핑합니다.
a. AEM 속성 이름. AEM 속성에서 선택할 수 있습니다. (예:jcr:title){name}을(를) 템플릿화할 수 있습니다.
b. 정확히 ( )에 입력한 Veeva 속성 이름이 Veeva에 존재합니다. (예:name__v)
c. 속성 유형.Text또는Multiline Text입니다. -
필수. Veeva의 속성을 AEM에 매핑합니다.
a. 정확히 ( )에 입력한 Veeva 속성 이름이 Veeva에 존재합니다. (예:name__v)
b. AEM 속성 이름. AEM 속성에서 선택할 수 있습니다. (예:jcr:title)
c. 속성 유형.Text또는Multiline Text입니다.
자산 탭
에셋을 동기화하는 경우 에셋 탭에 다음을 입력합니다.
-
필수. AEM에서 Veeva로 속성을 매핑합니다.
a. AEM 속성 이름. AEM 속성에서 선택할 수 있습니다. (예:/jcr:content/metadata/jcr:title){name}을(를) 템플릿화할 수 있습니다.
b. 정확히 ( )에 입력한 Veeva 속성 이름이 Veeva에 존재합니다. (예:name__v)
c. 속성 유형.Text또는Multiline Text입니다. -
필수. Veeva의 속성을 AEM에 매핑합니다.
a. 정확히 ( )에 입력한 Veeva 속성 이름이 Veeva에 존재합니다. (예:name__v)
b. AEM 속성 이름. AEM 속성에서 선택할 수 있습니다. (예:/jcr:content/metadata/jcr:title)
c. 속성 유형.Text또는Multiline Text입니다.
추가 설정
AEM 사용자 생성
PDF/이미지를 생성하는 동안 AEM에서 페이지를 가져오려면 AEM 사용자를 만들어야 합니다. 다음 링크를 따라 사용자에게 읽기 전용 권한을 만들고 부여합니다.
AEM 6.5.5+를 사용하는 경우:
AEM Cloud Service을 사용하는 경우:
PDF/이미지로 변환되고 Veeva로 푸시될 컨텐츠에 대한 AEM 서비스 사용자에게 다음 권한이 필요합니다.
- 읽기
사용자를 만들고 권한을 설정할 때는 조직 보안 표준을 준수해야 합니다.
사용자 생성 정보
이 통합을 사용하려면 Veeva Vault에서 사용자를 작성해야 합니다. 사용자를 만들려면 다음 단계를 수행합니다.
-
관리자 -> 사용자 및 그룹 -> 자격 증명 모음 사용자 -> 만들기 로 이동합니다.
-
필요한 입력을 입력합니다. 가장 간단한 설정은
License Type을(를)Full User(으)로 설정하고Security Profile을(를)Vault Owner(으)로 설정하는 것입니다. 완료되면 저장합니다.
사용 중인 특정 Veeva 문서 유형에 대해 다음 권한이 필요합니다.
- 문서 만들기/읽기
- 버전 만들기/읽기
- 메타데이터 만들기/업데이트
- 렌디션 만들기/업데이트
사용자를 만들고 권한을 설정할 때는 조직 보안 표준을 준수해야 합니다.