로컬 개발 환경 및 초기 개발 프로젝트 설정

을 설정하고 구성할 때 Adobe Experience Manager Forms 로서의 Cloud Service 환경에서는 클라우드에 개발, 스테이징 및 프로덕션 환경을 설정합니다. 또한 로컬 개발 환경을 설정하고 구성할 수도 있습니다.

로컬 개발 환경을 사용하여 양식 및 관련 자산(테마, 템플릿, 사용자 지정 제출 작업 등)을 만들고 적응형 Forms으로 PDF forms 변환 클라우드 개발 환경에 로그인하지 않아도 됩니다. 적응형 양식 또는 관련 자산이 로컬 개발 인스턴스에서 준비되면 추가 테스트 및 게시를 위해 로컬 개발 환경에서 Cloud Service 환경으로 적응형 양식 및 관련 자산을 내보낼 수 있습니다.

로컬 개발 환경에서 사용자 지정 구성 요소 및 미리 채우기 서비스와 같은 사용자 지정 코드를 개발하고 테스트할 수도 있습니다. 사용자 지정 코드가 테스트되고 준비되면 Cloud Service 개발 환경의 Git 저장소를 사용하여 사용자 지정 코드를 배포할 수 있습니다.

새 로컬 개발 환경을 설정하고 이를 사용하여 활동에 대해 개발하려면 나열된 순서로 다음 작업을 수행하십시오.

전제 조건

로컬 개발 환경을 설정하려면 다음 소프트웨어가 필요합니다. 로컬 개발 환경 설정을 시작하기 전에 다음 코드를 다운로드하십시오.

소프트웨어 설명 다운로드 링크
Adobe Experience Manager as a Cloud Service SDK SDK에 포함 Adobe Experience Manager QuickStart 및 Dispatcher 도구 에서 최신 SDK를 다운로드합니다. 소프트웨어 배포
Adobe Experience Manager Forms 기능 아카이브(AEM Forms 추가 기능) 적응형 Forms 및 기타 Adobe Experience Manager 양식 기능을 만들고, 스타일을 지정하고, 최적화하는 도구 다운로드 위치 소프트웨어 배포
(선택 사항) Adobe Experience Manager Forms 참조 컨텐츠 적응형 Forms 및 기타 Adobe Experience Manager 양식 기능을 만들고, 스타일을 지정하고, 최적화하는 도구 다운로드 위치 소프트웨어 배포
(선택 사항) Adobe Experience Manager Forms Designer 적응형 Forms 및 기타 Adobe Experience Manager 양식 기능을 만들고, 스타일을 지정하고, 최적화하는 도구 다운로드 위치 소프트웨어 배포

소프트웨어 배포에서 최신 버전의 소프트웨어를 다운로드합니다

최신 버전의 Adobe Experience Manager as a Cloud Service SDK를 다운로드하려면 Experience Manager Forms 기능 아카이브(AEM Forms 추가 기능), 양식 참조 자산 또는 Forms 디자이너를 소프트웨어 배포:

  1. Adobe ID을 사용하여 https://experience.adobe.com/#/downloads에 로그인합니다

    노트

    AEM as a Cloud Service SDK를 다운로드하려면 Adobe 조직에 AEM as a Cloud Service이 제공되어야 합니다.

  2. 로 이동합니다 AEM as a Cloud Service 탭.

  3. 게시된 날짜별로 내림차순으로 정렬합니다.

  4. 최신 Adobe Experience Manager as a Cloud Service SDK, Experience Manager Forms 기능 아카이브(AEM Forms 추가 기능), 양식 참조 자산 또는 Forms 디자이너를 클릭합니다.

  5. EULA를 검토하고 수락하십시오. 탭하기 Download 버튼을 클릭합니다.

AEM 프로젝트용 개발 도구 설정

Adobe Experience Manager Forms 프로젝트는 사용자 지정 코드 베이스입니다. 여기에는 Cloud Manager를 통해 배포되는 코드, 구성 및 컨텐츠가 포함되어 있습니다 Adobe Experience Manager as a Cloud Service. 다음 AEM Project Maven Archetype 프로젝트에 대한 기준 구조를 제공합니다.

에 사용할 다음 개발 도구를 설정합니다. Adobe Experience Manager 개발 프로젝트:

이전에 언급된 개발 도구를 설정하는 자세한 지침은 개발 도구 설정.

개발을 위한 로컬 Experience Manager 환경 설정

Cloud Service SDK는 QuickStart 파일을 제공합니다. 로컬 버전의 Experience Manager을 실행합니다. 로컬로 작성자 또는 게시 인스턴스를 실행할 수 있습니다.

QuickStart는 로컬 개발 환경을 제공하지만 사용 가능한 일부 기능은 없습니다. Adobe Experience Manager as a Cloud Service. 따라서 항상 Adobe Experience Manager 기능을 스테이지 또는 프로덕션으로 이동하기 전에 as a Cloud Service 개발 환경.

로컬 Experience Manager 환경을 설치 및 구성하려면 다음 단계를 수행하십시오.

로컬 작성자 및 게시 인스턴스에 Forms 아카이브 추가 및 Forms 관련 사용자 구성

Forms 아카이브를 Experience Manager 인스턴스에 추가하고 양식별 사용자를 구성하려면 나열된 단계를 수행하십시오.

최신 Forms 추가 기능 아카이브 설치

Adobe Experience Manager Forms as a Cloud Service 기능 아카이브는 로컬 개발 환경에서 적응형 Forms을 생성, 스타일 지정 및 최적화하는 도구를 제공합니다. 패키지를 설치하여 적응형 양식을 만들고 AEM Forms. 패키지를 설치하려면 다음을 수행하십시오.

  1. 최신 다운로드 및 추출 AEM Forms 운영 체제를 위한 아카이브 소프트웨어 배포.

  2. crx-quickstart/install 디렉토리로 이동합니다. 폴더가 없으면 폴더를 만듭니다.

  3. AEM 인스턴스를 중지하고 AEM Forms 추가 기능 아카이브, aem-forms-addon-<version>.far를 누르고 설치 폴더에서 인스턴스를 다시 시작합니다.

사용자 및 권한 구성

Form Developer 및 Form Programming 및 이러한 사용자를 사전 정의된 양식 그룹에 추가 필요한 권한을 제공하려면 다음을 수행하십시오. 아래 표에는 각 양식 사용자 유형에 대한 모든 사용자 유형과 사전 정의된 그룹이 나와 있습니다.

사용자 유형 AEM 그룹
실무자 forms-users (AEM Forms 사용자), template-authors, workflow-users, workflow-editors, 및 fdm-authors
양식 개발자 forms-users (AEM Forms 사용자), template-authors, workflow-users, workflow-editors, 및 fdm-authors
고객 경험 리드 또는 UX 디자이너 forms-users, template-authors
AEM 관리자 aem-administrators, fd-administrators
최종 사용자 사용자가 적응형 양식을 보고 제출하기 위해 로그인해야 하는 경우 이러한 사용자를 forms-users 그룹에 속해 있어야 합니다.
적응형 Forms에 액세스하는 데 사용자 인증이 필요하지 않으면 그러한 사용자에게 그룹을 할당하지 마십시오.

기록 문서(DoR)에 대한 로컬 개발 환경 설정

AEM Forms as a Cloud Services은 문서 작성 및 다른 마이크로서비스 사용을 위한 문서 기반 SDK 환경을 제공합니다. 플랫폼 특정 바이너리 및 적응성을 수동으로 구성할 수 있습니다. 환경을 설정하려면 다음을 수행하십시오.

  1. 설치 및 구성 Docker:

    • (Microsoft Windows의 경우) 설치 Docker Desktop. 컴퓨터에서 Docker 엔진 및 Docker-compose를 구성합니다.

    • (Apple macOS) 설치 Mac용 Docker Desktop. 여기에는 Docker 엔진, Docker CLI 클라이언트, Docker Compose, Docker Content Trust, Kubernetes 및 Credential Helper가 포함됩니다.

    • (Linux용) 설치 Docker 엔진Docker 작성 사용자 시스템에 있는

    노트
    • Apple macOS의 경우 로컬 AEM 작성자 인스턴스가 포함된 폴더를 화이트리스트에 추가합니다.

    • Windows용 Docker Desktop은 두 개의 백엔드인 Hyper-V를 지원합니다.
      (기존) 및 WSL2(최신). 파일 공유 자동
      WSL2 사용 시 Docker에서 관리(최신) 당신은
      Hyper-V(레거시)를 사용하는 동안 파일 공유를 명시적으로 구성합니다.

  2. 작성자 및 게시 인스턴스와 동시에 aem-sdk와 같은 폴더를 만듭니다. 예: C:\aem-sdk

  3. 추출 aem-forms-addon-<version>.zip\aem-forms-addon-native-<version>.zip 파일.

    추출된 aem forms 추가 기본

  4. 환경 변수 AEM_HOME을 만들고 로컬 AEM 작성자 설치를 가리킵니다. 예: C:\aem\author\

  5. 편집할 sdk.bat 또는 sdk.sh를 엽니다. 로컬 AEM 작성자 설치를 가리키도록 AEM_HOME을 설정합니다. 예: C:\aem\author\

  6. 명령 프롬프트를 열고 aem-forms-addon-native-<version> 폴더를 입력합니다.

  7. 로컬 AEM 작성자 인스턴스가 작동되고 실행 중인지 확인합니다. 다음 명령을 실행하여 SDK를 시작합니다.

    • (Microsoft Windows의 경우) sdk.bat start
    • (Linux 또는 Apple Mac OS의 경우) AEM_HOME=[local AEM Author installation] ./sdk.sh start
    노트

    sdk.sh 파일에서 환경 변수를 정의한 경우 명령줄에서 이 변수를 지정하는 것은 선택 사항입니다. 셸 스크립트를 업데이트하지 않고 명령을 실행할 수 있도록 명령줄에서 환경 변수를 정의하는 옵션이 제공됩니다.

    start-sdk-command

이제 로컬 개발 환경을 사용하여 기록 문서를 렌더링할 수 있습니다. 테스트하려면 XDP 파일을 환경에 업로드하고 렌더링합니다. 예를 들어 http://localhost:4502/libs/xfaforms/profiles/default.print.pdf?template=crx:///content/dam/formsanddocuments/check-request.xdp 은 XDP 파일을 PDF 문서로 변환합니다.

Experience Manager 원형 기반 Forms용 개발 프로젝트 설정

이 프로젝트를 사용하여 응용 Forms 만들기, 구성 업데이트, 오버레이 배포, 사용자 지정 적응형 양식 구성 요소 만들기, 테스트 및 로컬 사용자 지정 코드 만들기 Experience Manager Forms SDK. 로컬에서 테스트한 후 프로젝트를 Experience Manager Forms as a Cloud Service 프로덕션 및 비프로덕션 환경 프로젝트를 배포할 때 다음 AEM Forms 자산도 배포됩니다.

테마 템플릿 양식 데이터 모델
캔버스 3.0 기본 Microsoft Dynamics 365
비어 있음 Salesforce
노트

AEM Archetype 버전 30 이상 기반 프로젝트를 설정하여 AEM Forms Dynamics 365 및 Salesforce 양식 데이터 모델을 가져오고 사용할 수 있습니다. 이 모델은 Microsoft as a Cloud Service으로 제공됩니다.

프로젝트를 설정하려면 다음을 수행하십시오.

  1. 로컬 개발 인스턴스에서 Cloud Manager Git 리포지토리 복제: Cloud Manager Git 리포지토리에는 기본 AEM 프로젝트가 포함되어 있습니다. 이것은 AEM Archetype. Cloud Manager UI에서 셀프 서비스 Git 계정 관리를 사용하여 Cloud Manager Git 리포지토리를 복제하여 로컬 개발 환경에서 프로젝트를 가져올 수 있습니다. 리포지토리 액세스에 대한 자세한 내용은 저장소 액세스.
  1. 만들기 Experience Manager Forms 로서의 [Cloud Service] 프로젝트: 만들기 Experience Manager Forms 로서의 [Cloud Service] 프로젝트 기반 AEM Archetype 27 또는 나중에 사용합니다. Archetype은 개발자가 을 위한 개발을 쉽게 시작할 수 있도록 지원합니다 AEM Forms as a Cloud Service. 또한 빠르게 시작할 수 있도록 몇 가지 샘플 테마 및 템플릿이 포함되어 있습니다.

    명령 프롬프트를 열고 아래 명령을 실행하여 Experience Manager Forms as a Cloud Service 프로젝트. 포함하려면 Forms 특정 구성, 테마 및 템플릿, includeForms=y.

    mvn -B archetype:generate -DarchetypeGroupId=com.adobe.aem -DarchetypeArtifactId=aem-project-archetype -DarchetypeVersion=30 -DaemVersion="cloud" -DappTitle="My Site" -DappId="mysite" -DgroupId="com.mysite" -DincludeForms="y"
    

    또한, appTitle, appId, 및 groupId를 입력하여 환경을 반영하십시오.

  2. 프로젝트를 로컬 개발 환경에 배포합니다. 다음 명령을 사용하여 로컬 개발 환경에 배포할 수 있습니다

    mvn -PautoInstallPackage clean install

    전체 명령 목록이 필요하면 빌드 및 설치

  3. 코드를 AEM Forms as a Cloud Service 환경.

로컬 Dispatcher 도구 설정

Dispatcher는 CDN과 AEM 게시 계층 간에 보안 및 성능 레이어를 제공하는 Apache HTTP 웹 서버 모듈입니다. Dispatcher는 전체 Experience Manager 아키텍처의 필수적인 부분이며 로컬 개발 환경에 포함되어야 합니다.

다음 단계를 수행하여 로컬 Dispatcher를 구성한 다음 Forms 관련 규칙을 추가합니다.

로컬 Dispatcher 설정

다음 Experience Manager as a Cloud Service SDK에는 권장 Dispatcher 도구 버전이 포함되어 있어서 Dispatcher를 로컬에서 구성, 유효성 검사 및 시뮬레이션을 용이하게 합니다. Dispatcher 도구는 Docker 기반이며 Apache HTTP Web Server 및 Dispatcher 구성 파일을 호환되는 형식으로 변환하고 Docker 컨테이너에서 실행되는 Dispatcher에 배포하는 명령줄 도구를 제공합니다.

Dispatcher에서 캐싱이 AEM Forms 클라이언트에서 적응형 Forms을 미리 채우려면 다음을 수행하십시오. 미리 입력된 양식의 렌더링 속도가 향상됩니다.

Dispatcher 설정에 대한 자세한 지침은 로컬 Dispatcher 도구 설정

Dispatcher에 Forms 특정 규칙 추가

다음 단계를 수행하여 Experience Manager Forms as a Cloud Service에 대한 Dispatcher 캐시를 구성합니다.

  1. AEM 프로젝트를 열고 다음 위치로 이동합니다. \src\conf.dispatcher.d\available_farms

  2. 의 사본 만들기 default.farm 파일. 예, forms.farm.

  3. 새로 만든 forms.farm 파일을 편집하고 다음 코드를 바꿉니다.

    #/ignoreUrlParams {
    #/0001 { /glob "*" /type "deny" }
    #/0002 { /glob "q" /type "allow" }
    #}
    

    with

    /ignoreUrlParams {
    /0001 { /glob "*" /type "deny" }
    /0002 { /glob "dataRef" /type "allow" }
    }
    
  4. 파일을 저장하고 닫습니다.

  5. 이동 conf.d/enabled_farms 그리고 forms.farm 파일.

  6. 프로젝트를 컴파일하고 AEM Forms as a Cloud Service 환경.

캐싱에 대한 고려 사항

  • Dispatcher 캐싱은 AEM Forms 클라이언트에서 적응형 Forms을 미리 채우려면 다음을 수행하십시오. 미리 입력된 양식의 렌더링 속도가 향상됩니다.
  • 보안 콘텐츠 기능 캐싱은 기본적으로 비활성화됩니다. 이 기능을 활성화하려면 보안 콘텐츠 캐싱 문서
  • Dispatcher는 일부 응용 Forms 및 관련 응용 Forms을 무효화하지 못할 수 있습니다. 이러한 문제를 해결하려면 AEM Forms 캐싱 문제 해결 섹션 을 참조하십시오.
  • 현지화된 적응형 Forms 캐싱:
    • URL 형식 사용 http://host:port/content/forms/af/<afName>.<locale>.html 를 입력하여 대신 현지화된 적응형 양식 버전을 요청합니다. http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
    • 브라우저 로케일 옵션은 기본적으로 비활성화됩니다. 브라우저 로케일 설정을 변경하려면
  • URL 형식을 사용하는 경우 http://host:port/content/forms/af/<adaptivefName>.html및 구성 관리자에서 브라우저 로케일 사용 이 비활성화되어 있으면 현지화되지 않은 적응형 양식 버전이 제공됩니다. 현지화되지 않은 언어는 적응형 양식을 개발하는 동안 사용되는 언어입니다. 브라우저(브라우저 로케일)에 대해 구성된 로케일은 고려되지 않으며, 현지화되지 않은 적응형 양식 버전이 제공됩니다.
  • URL 형식을 사용하는 경우 http://host:port/content/forms/af/<adaptivefName>.html, 구성 관리자에서 브라우저 로케일 사용 을 활성화하면 현지화된 버전의 적응형 양식이 제공됩니다(사용 가능한 경우). 현지화된 적응형 양식의 언어는 브라우저(브라우저 로케일)에 대해 구성된 로케일을 기반으로 합니다. 이로 인해 [적응형 양식의 첫 번째 인스턴스만 캐싱]. 인스턴스에서 문제가 발생하지 않도록 하려면 다음을 참조하십시오 적응형 양식의 첫 번째 인스턴스만 캐시됩니다 문제 해결 섹션 을 참조하십시오.

로컬 개발 환경이 준비되었습니다.

로컬 개발 환경 업그레이드

SDK를 새 버전으로 업그레이드하려면 전체 로컬 개발 환경을 대체해야 하므로 로컬 리포지토리의 모든 코드, 구성 및 컨텐츠가 손실됩니다. 파기하지 않아야 하는 모든 코드, 구성 또는 컨텐츠가 Git에 안전하게 커밋되거나 로컬 Experience Manager 인스턴스에서 CRX-Packages로 내보내지지 않도록 합니다.

SDK를 업그레이드할 때 컨텐츠 손실을 방지하는 방법

SDK를 업그레이드하면 새 저장소(AEM 프로젝트 설정). 즉, 이전 SDK의 리포지토리에 수행된 모든 변경 사항이 손실됩니다. SDK 업그레이드 사이에 컨텐츠를 유지할 수 있는 실용적인 전략을 보려면 를 참조하십시오 AEM SDK를 업그레이드할 때 컨텐츠 손실을 방지하는 방법

새로운 SDK 환경에 Forms 관련 컨텐츠를 백업하고 가져옵니다

기존 SDK에서 새 SDK 환경으로 자산을 백업하고 이동하려면 다음을 수행하십시오.

  • 기존 컨텐츠의 백업을 만듭니다.

  • 새로운 SDK 환경을 설정합니다.

  • 새 SDK 환경에 백업을 가져옵니다.

기존 컨텐츠의 백업 만들기

응용 Forms, 템플릿, 양식 데이터 모델, 테마, 구성 및 사용자 지정 코드를 백업합니다. 다음 작업을 수행하여 백업을 만들 수 있습니다.

  1. 다운로드 적응형 Forms, 테마 및 PDF forms.

  2. 적응형 양식 템플릿을 내보냅니다.

  3. 양식 데이터 모델 다운로드

  4. 편집 가능한 템플릿, 클라우드 구성 및 워크플로우 모델을 내보냅니다. 기존 SDK에서 이전에 언급된 모든 항목을 내보내려면 CRX-Package 다음 필터를 사용하여 다음을 수행하십시오.

    • /conf/ReferenceEditableTemplates
    • /conf/global/settings/cloudconfigs
    • /conf/global/settings/wcm
    • /var/workflow/models
    • /conf/global/settings/workflow
  5. 로컬 개발 환경에서 전자 메일 구성, 제출 및 미리 채우기 작업 코드를 내보냅니다. 이러한 설정 및 구성을 내보내려면 로컬 개발 환경에서 다음 폴더 및 파일의 복사본을 만드십시오.

    • [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
    • [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
    • [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

새 SDK 환경에 백업 가져오기

적응형 Forms, 템플릿, 양식 데이터 모델, 테마, 구성 및 사용자 지정 코드를 새로운 환경에 가져올 수 있습니다. 다음 작업을 수행하여 백업을 가져올 수 있습니다.

  1. 가져오기 새로운 SDK 환경에 적응형 Forms, 테마 및 PDF forms.

  2. 새 SDK 환경에 적응형 양식 템플릿을 가져옵니다.

  3. 양식 데이터 모델을 새 SDK 환경에 업로드합니다.

  4. 편집 가능한 템플릿, 클라우드 구성 및 워크플로우 모델을 가져옵니다. 이전에 언급된 모든 항목을 새 SDK 환경에 가져오려면 이러한 항목이 포함된 CRX-Package를 새 SDK 환경으로 가져옵니다.

  5. 로컬 개발 환경에서 이메일 구성, 제출 및 미리 채우기 작업 코드를 가져옵니다. 이러한 설정 및 구성을 가져오려면 이전 Archetype 프로젝트의 다음 파일을 새 Archetype 프로젝트로 배치합니다.

    • [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
    • [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
    • [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

이제 새 환경에 이전 환경의 양식 및 관련 자산이 있습니다.

이 페이지에서는