적응형 양식 제출 액션 configuring-the-submit-action

버전
문서 링크
AEM 6.5
여기 클릭
AEM as a Cloud Service
이 문서

적용 대상: ✔️ Form Foundation 구성 요소 적응형 양식 핵심 구성 요소를 ❌. Adobe은 핵심 구성 요소를 사용하여 AEM Sites 페이지에 적응형 Forms을 추가하거나 독립 실행형 적응형 Forms 만들기할 것을 권장합니다.

사용자가 적응형 양식에서 제출 단추를 클릭하면 제출 액션이 트리거됩니다. Formsas a Cloud Service 에서 제출 액션 실행

기본 제출 액션을 확장하여 자신의 제출 액션을 만들 수도 있습니다.

사이드바의 적응형 양식 컨테이너 속성에 있는 제출 섹션에서 제출 액션을 구성할 수 있습니다.

제출 액션 구성

REST 엔드포인트에 제출 submit-to-rest-endpoint

REST 엔드포인트에 제출 액션을 사용하여 제출된 데이터를 REST URL에 게시합니다. URL은 내부 서버(양식이 렌더링되는 서버) 또는 외부 서버일 수 있습니다.

데이터를 내부 서버에 게시하려면 리소스 경로를 제공합니다. 데이터는 리소스 경로에 게시됩니다. 예: /content/restEndPoint. 해당 게시 요청이 있는 경우 제출 요청에 대한 인증 정보가 사용됩니다.

데이터를 외부 서버에 게시하려면 URL을 제공합니다. URL 형식은 https://host:port/path_to_rest_end_point입니다. POST 요청을 익명으로 처리하는 경로를 구성해야 합니다.

감사 페이지 매개변수로 전달된 필드 값 매핑

위 예에서 사용자는 매개변수 param1을 사용하여 캡처한 정보를 textbox에 입력했습니다. param1을 사용하여 캡처한 데이터를 게시하는 구문은 다음과 같습니다.

String data=request.getParameter("param1");

마찬가지로 XML 데이터와 첨부 파일 게시에 사용되는 매개변수는 dataXmlattachments입니다.

예를 들어 스크립트의 이 두 매개변수를 사용하여 데이터를 REST 엔드포인트로 구문 분석합니다. 다음 구문을 사용하여 데이터를 저장하고 구문 분석합니다.

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

이 예에서 data는 XML 데이터를 저장하고 att는 첨부 파일 데이터를 저장합니다.

REST 엔드포인트에 제출 제출 액션은 양식에 입력된 데이터를 HTTP GET 요청의 일부로 구성된 확인 페이지에 제출합니다. 요청할 필드 이름을 추가할 수 있습니다. 요청의 형식은 다음과 같습니다.

{fieldName}={request parameter name}

아래 이미지에 표시된 대로 param1param2는 다음 액션의 텍스트 상자숫자 상자 필드에서 복사된 값이 포함된 매개변수로 전달됩니다.

REST 엔드포인트 제출 액션 구성

또한 POST 요청을 활성화 ​하고 요청을 게시하는 URL을 제공할 수 있습니다. 양식을 호스팅하는 AEM 서버에 데이터를 제출하려면 AEM 서버 루트 경로에 해당되는 상대 경로를 사용합니다. 예, /content/forms/af/SampleForm.html. 데이터를 다른 서버에 제출하려면 절대 경로를 사용합니다.

NOTE
REST URL에서 필드를 매개변수로 전달하려면 필드가 다른 패널에 배치되는 경우에도 모든 필드의 요소 이름이 서로 달라야 합니다.

이메일 보내기 send-email

전자 메일 보내기 제출 액션을 사용하여 양식을 성공적으로 제출하면 한 명 이상의 받는 사람에게 전자 메일을 보낼 수 있습니다. 생성된 이메일에는 사전 정의된 형식의 양식 데이터가 포함될 수 있습니다. 예를 들어 다음 템플릿에서 고객 이름, 배송 주소, 주 이름 및 우편 번호는 제출된 양식 데이터에서 검색됩니다.

```

${customer_Name} 님, 안녕하세요.

기본 배송 주소가 다음과 같이 설정됩니다.
${customer_Name},
${customer_Shipping_Address},
${customer_State},
${customer_ZIPCode}

감사합니다.
WKND

```
NOTE
  • 필드가 적응형 양식의 서로 다른 패널에 배치된 경우에도 모든 양식 필드에는 서로 다른 요소 이름이 있어야 합니다.
  • AEM as a Cloud Service을 사용하려면 아웃바운드 메일을 암호화해야 합니다. 기본적으로 아웃바운드 이메일은 비활성화됩니다. 활성화하려면 액세스 요청에 지원 티켓을 제출하세요.

이메일에 첨부 파일과 기록 문서(DoR)를 포함할 수도 있습니다. 기록 문서 첨부 옵션을 활성화하려면 DoR(기록 문서)을 생성하도록 적응형 양식을 구성하십시오. 옵션을 활성화하여 적응형 양식 속성에서 기록 문서를 생성할 수 있습니다.

양식 데이터 모델(FDM)을 사용하여 제출 submit-using-form-data-model

양식 데이터 모델을 사용하여 제출 제출 액션은 FDM(양식 데이터 모델)의 지정된 데이터 모델 개체에 대해 제출된 적응형 양식 데이터를 해당 데이터 소스에 기록합니다. 제출 액션을 구성할 때 데이터 소스에 다시 쓰려는 제출된 데이터가 있는 데이터 모델 오브젝트를 선택할 수 있습니다.

또한 FDM(양식 데이터 모델) 및 DoR(기록 문서)을 사용하여 양식 첨부 파일을 데이터 소스에 제출할 수 있습니다. 양식 데이터 모델(FDM)에 대한 자세한 내용은 AEM Forms 데이터 통합을 참조하십시오.

AEM Workflow 호출 invoke-an-aem-workflow

AEM Workflow 호출 제출 액션은 적응형 양식을 AEM Workflow와 연결합니다. 양식이 제출되면 연결된 워크플로가 작성자 인스턴스에서 자동으로 시작됩니다. 데이터 파일, 첨부 파일과 기록 문서를 워크플로의 페이로드 위치 또는 변수에 저장할 수 있습니다. 워크플로가 외부 데이터 스토리지로 표시되고 외부 데이터 스토리지로 구성되면 변수 옵션만 제공됩니다. 워크플로 모델에 제공되는 변수 목록에서 선택할 수 있습니다. 워크플로 생성 시점이 아닌 이후 단계에서 워크플로가 외부 데이터 스토리지로 표시되면 필수 변수 구성이 마련되었는지 확인합니다.

제출 액션은 워크플로가 외부 데이터 스토리지로 표시되면 워크플로의 페이로드 위치 또는 변수에 다음을 배치합니다.

  • 데이터 파일: 적응형 양식에 제출된 데이터가 포함됩니다. 데이터 파일 경로 옵션을 사용하여 페이로드를 기준으로 파일 이름과 파일 경로를 지정할 수 있습니다. 예를 들어 /addresschange/data.xml 경로는 addresschange라는 폴더를 만들고 페이로드를 기준으로 배치합니다. 또한 data.xml만 지정하여 폴더 계층 구조를 만들지 않고도 제출된 데이터만 전송할 수 있습니다. 워크플로가 외부 데이터 스토리지로 표시되면 변수 옵션을 사용하고 워크플로 모델에 제공되는 변수 목록에서 변수를 선택합니다.

  • 첨부 파일: 첨부 파일 경로 옵션을 사용하여 폴더 이름을 지정하면 적응형 양식에 업로드된 첨부 파일을 저장할 수 있습니다. 페이로드를 기준으로 폴더를 생성합니다. 워크플로가 외부 데이터 스토리지로 표시되면 변수 옵션을 사용하고 워크플로 모델에 제공되는 변수 목록에서 변수를 선택합니다.

  • 기록 문서: 적응형 양식에 생성된 기록 문서가 포함됩니다. 기록 문서 경로 옵션을 사용하여 페이로드를 기준으로 기록 문서 파일 이름과 파일 경로를 지정할 수 있습니다. 예를 들어 /addresschange/DoR.pdf 경로는 addresschange라는 폴더를 만들고 페이로드를 기준으로 DoR.pdf를 배치합니다. 또한 DoR.pdf만 지정하여 폴더 계층 구조를 만들지 않고도 기록 문서만 저장할 수 있습니다. 워크플로가 외부 데이터 스토리지로 표시되면 변수 옵션을 사용하고 워크플로 모델에 제공되는 변수 목록에서 변수를 선택합니다.

AEM Workflow 호출 제출 액션을 사용하기 전에 AEM DS 설정 서비스 구성에 다음을 구성합니다.

  • 처리 서버 URL: 처리 서버는 Forms 또는 AEM Workflow가 트리거되는 서버입니다. AEM 작성자 인스턴스 또는 다른 서버의 URL과 동일할 수 있습니다.

  • 처리 서버 사용자 이름: 워크플로 사용자의 사용자 이름

  • 처리 서버 암호: 워크플로 사용자의 암호

SharePoint에 제출 submit-to-sharedrive

SharePoint에 제출 제출 액션은 적응형 양식을 Microsoft® SharePoint Storage와 연결합니다. 양식 데이터 파일, 첨부 파일 또는 기록 문서를 연결된 Microsoft® Sharepoint Storage에 제출할 수 있습니다.

SharePoint에 제출을 사용하여 다음과 같은 작업을 수행할 수 있습니다.

적응형 양식을 SharePoint 문서 라이브러리에 연결 connect-af-sharepoint-doc-library

적응형 양식에서 SharePoint 문서 라이브러리에 제출 제출 액션을 사용하려면:

  1. SharePoint 문서 라이브러리 구성 만들기: AEM Forms을 Microsoft® Sharepoint 저장소에 연결합니다.
  2. 적응형 양식에서 SharePoint에 제출 액션 사용: Adaptive Form을 구성된 Microsoft® SharePoint에 연결합니다.

SharePoint 문서 라이브러리 구성 만들기 create-sharepoint-configuration

AEM Forms을 Microsoft® Sharepoint Document Library 스토리지에 연결하려면:

  1. AEM Forms 작성자 인스턴스 > 도구 > Cloud Service > Microsoft® SharePoint(으)로 이동합니다.

  2. Microsoft® SharePoint ​을(를) 선택하면 SharePoint 브라우저(으)로 리디렉션됩니다.

  3. 구성 컨테이너 ​를 선택합니다. 선택한 구성 컨테이너에 구성을 저장합니다.

  4. 드롭다운 목록에서 만들기 > SharePoint 문서 라이브러리 ​를 클릭합니다. SharePoint 구성 마법사가 나타납니다.

    SharePoint 구성

  5. 제목, 클라이언트 ID, 클라이언트 보안OAuth URL ​을 지정합니다. OAuth URL의 클라이언트 ID, 클라이언트 보안, 테넌트 ID를 검색하는 방법에 대한 자세한 내용은 Microsoft® Documentation을 참조하십시오.

    • Microsoft® Azure 포털에서 앱의 Client IDClient Secret를 검색할 수 있습니다.
    • Microsoft® Azure 포털에서 리디렉션 URI를 https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html로 추가합니다. [author-instance]를 작성자 인스턴스의 URL로 대체합니다.
    • offline_accessSites.Manage.All API 권한을 추가하여 읽기/쓰기 권한을 제공합니다.
    • OAuth URL 사용: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Microsoft® Azure 포털에서 <tenant-id>를 앱의 tenant-id로 대체합니다.
    note note
    NOTE
    클라이언트 보안 필드는 Azure Active Directory 애플리케이션 구성에 따라 필수 또는 선택 사항입니다. 애플리케이션을 구성하여 클라이언트 보안을 사용하는 경우 클라이언트 보안을 제공해야 합니다.
  6. 연결 ​을 클릭합니다. 연결이 완료되면 Connection Successful 메시지가 나타납니다.

  7. 이제 SharePoint 사이트 > 문서 라이브러리 > SharePoint 폴더 ​를 선택하여 데이터를 저장합니다.

    note note
    NOTE
    • 기본적으로 forms-ootb-storage-adaptive-forms-submission은(는) 선택한 SharePoint 사이트에 있습니다.
    • 폴더 만들기 ​를 클릭하여 선택한 SharePoint 사이트의 Documents 라이브러리에 아직 없는 경우 폴더를 forms-ootb-storage-adaptive-forms-submission(으)로 만듭니다.

이제 적응형 양식의 제출 작업에 이 SharePoint Sites 구성을 사용할 수 있습니다.

적응형 양식에서 SharePoint 문서 라이브러리 구성 사용 use-sharepoint-configuartion-in-af

적응형 양식에서 생성된 SharePoint 문서 라이브러리 구성을 사용하여 데이터나 생성된 기록 문서를 SharePoint 폴더에 저장할 수 있습니다. 적응형 양식에서 SharePoint 문서 라이브러리 스토리지 구성을 다음으로 사용하려면 다음 단계를 수행하십시오.

  1. 적응형 양식을 만듭니다.

    note note
    NOTE
    • 적응형 양식에 대해 동일한 구성 컨테이너를 선택합니다. 여기서 SharePoint 문서 라이브러리 저장소를 만들었습니다.
    • 구성 컨테이너가 선택되지 않은 경우 제출 액션 속성 창에 글로벌 스토리지 구성 폴더가 나타납니다.
  2. 제출 액션 ​을 SharePoint에 제출 ​로 선택합니다.
    Sharepoint GIF

  3. 데이터를 저장하려는 경우 스토리지 구성 ​을 선택합니다.

  4. 저장 ​을 클릭하여 제출 설정을 저장합니다.

양식을 제출하면 데이터가 지정된 Microsoft® Sharepoint 문서 라이브러리 저장소에 저장됩니다.
데이터를 저장하는 폴더 구조는 /folder_name/form_name/year/month/date/submission_id/data입니다.

Microsoft® SharePoint 목록에 적응형 양식 연결 connect-af-sharepoint-list

적응형 양식에서 SharePoint 목록에 제출 제출 액션을 사용하려면:

  1. SharePoint 목록 구성 만들기: AEM Forms을 Microsoft® Sharepoint 목록 저장소에 연결합니다.
  2. 적응형 양식에서 FDM(양식 데이터 모델)을 사용하여 제출: 적응형 양식을 구성된 Microsoft® SharePoint에 연결합니다.

SharePoint 목록 구성 만들기 create-sharepoint-list-configuration

AEM Forms을 Microsoft® Sharepoint 목록에 연결하려면:

  1. 도구 > Cloud Service > Microsoft® SharePoint ​로 이동합니다.

  2. 구성 컨테이너 ​를 선택합니다. 선택한 구성 컨테이너에 구성을 저장합니다.

  3. 드롭다운 목록에서 만들기 > SharePoint 목록 ​을 클릭합니다. SharePoint 구성 마법사가 나타납니다.

  4. 제목, 클라이언트 ID, 클라이언트 보안OAuth URL ​을 지정합니다. OAuth URL의 클라이언트 ID, 클라이언트 보안, 테넌트 ID를 검색하는 방법에 대한 자세한 내용은 Microsoft® Documentation을 참조하십시오.

    • Microsoft® Azure 포털에서 앱의 Client IDClient Secret를 검색할 수 있습니다.

    • Microsoft® Azure 포털에서 리디렉션 URI를 https://[author-instance]/libs/cq/sharepointlist/content/configurations/wizard.html로 추가합니다. [author-instance]를 작성자 인스턴스의 URL로 대체합니다.

    • 읽기/쓰기 권한을 제공하려면 Microsoft® 그래프 탭에서 API 권한 offline_accessSites.Manage.All을(를) 추가하십시오. SharePoint 데이터와 원격으로 상호 작용하려면 Sharepoint 탭에 AllSites.Manage 권한을 추가하십시오.

    • OAuth URL 사용: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Microsoft® Azure 포털에서 <tenant-id>를 앱의 tenant-id로 대체합니다.

      note note
      NOTE
      클라이언트 보안 필드는 Azure Active Directory 애플리케이션 구성에 따라 필수 또는 선택 사항입니다. 애플리케이션을 구성하여 클라이언트 보안을 사용하는 경우 클라이언트 보안을 제공해야 합니다.
  5. 연결 ​을 클릭합니다. 연결이 완료되면 Connection Successful 메시지가 나타납니다.

  6. 드롭다운 목록에서 SharePoint 사이트SharePoint 목록 ​을 선택합니다.

  7. Microsoft® SharePointList에 대한 클라우드 구성을 만들려면 만들기 ​를 선택하십시오.

적응형 양식에서 FDM(양식 데이터 모델)을 사용하여 제출 사용 use-submit-using-fdm

적응형 양식에서 생성된 SharePoint 목록 구성을 사용하여 데이터나 생성된 기록 문서를 SharePoint 목록에 저장할 수 있습니다. 적응형 양식에서 SharePoint 목록 스토리지 구성을 다음으로 사용하려면 다음 단계를 수행하십시오.

양식을 제출하면 데이터가 지정된 Microsoft® Sharepoint 목록 저장소에 저장됩니다.

NOTE
Microsoft® SharePoint 목록에서는 다음 열 유형이 지원되지 않습니다.
  • 이미지 열
  • 메타데이터 열
  • 개인 열
  • 외부 데이터 열

OneDrive에 제출 submit-to-onedrive

OneDrive에 제출 제출 액션은 적응형 양식을 Microsoft® OneDrive와 연결합니다. 양식 데이터, 파일, 첨부 파일 또는 기록 문서를 연결된 Microsoft® OneDrive Storage에 제출할 수 있습니다. 적응형 양식에서 OneDrive에 제출 제출 액션을 사용하려면

  1. OneDrive 구성 만들기: AEM Forms를 Microsoft® OneDrive Storage에 연결합니다.
  2. 적응형 양식에서 OneDrive에 제출 액션 사용: Adaptive Form을 구성된 Microsoft® OneDrive에 연결합니다.

OneDrive 구성 만들기 create-onedrice-configuration

AEM Forms를 Microsoft® OneDrive Storage에 연결하려면

  1. AEM Forms 작성자 인스턴스 > 도구 > 클라우드 서비스 > Microsoft® OneDrive ​로 이동합니다.

  2. Microsoft® OneDrive ​를 선택하면 OneDrive 브라우저 ​로 리디렉션됩니다.

  3. 구성 컨테이너 ​를 선택합니다. 선택한 구성 컨테이너에 구성을 저장합니다.

  4. 만들기 ​를 클릭합니다. OneDrive 구성 마법사가 나타납니다.

    OneDrive 구성 화면

  5. 제목, 클라이언트 ID, 클라이언트 보안OAuth URL ​을 지정합니다. OAuth URL의 클라이언트 ID, 클라이언트 보안, 테넌트 ID를 검색하는 방법에 대한 자세한 내용은 Microsoft® Documentation을 참조하십시오.

    • Microsoft® Azure 포털에서 앱의 Client IDClient Secret를 검색할 수 있습니다.
    • Microsoft® Azure 포털에서 리디렉션 URI를 https://[author-instance]/libs/cq/onedrive/content/configurations/wizard.html로 추가합니다. [author-instance]를 작성자 인스턴스의 URL로 대체합니다.
    • offline_accessFiles.ReadWrite.All API 권한을 추가하여 읽기/쓰기 권한을 제공합니다.
    • OAuth URL 사용: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Microsoft® Azure 포털에서 <tenant-id>를 앱의 tenant-id로 대체합니다.
    note note
    NOTE
    클라이언트 보안 필드는 Azure Active Directory 애플리케이션 구성에 따라 필수 또는 선택 사항입니다. 애플리케이션을 구성하여 클라이언트 보안을 사용하는 경우 클라이언트 보안을 제공해야 합니다.
  6. 연결 ​을 클릭합니다. 연결이 완료되면 Connection Successful 메시지가 나타납니다.

  7. 이제 OneDrive 컨테이너 > [OneDrive 폴더] ​를 선택하여 데이터를 저장합니다.

    note note
    NOTE
    • 기본적으로 forms-ootb-storage-adaptive-forms-submission은 OneDrive 컨테이너에 존재합니다.
    • 아직 존재하지 않는 경우 폴더 만들기 ​를 클릭하여 폴더를 forms-ootb-storage-adaptive-forms-submission로 만듭니다.

이제 적응형 양식에서 제출 액션에 대한 OneDrive 스토리지 구성을 사용할 수 있습니다.

적응형 양식에서 OneDrive 구성 사용 use-onedrive-configuartion-in-af

적응형 양식에서 만든 OneDrive 스토리지 구성을 사용하여 데이터 또는 생성된 기록 문서를 OneDrive 폴더에 저장할 수 있습니다. 적응형 양식에서 OneDrive 스토리지 구성을 다음과 같이 사용하려면 다음 단계를 수행하십시오.

  1. 적응형 양식을 만듭니다.

    note note
    NOTE
    • OneDrive 스토리지가 생성되면 적응형 양식에 대한 구성 컨테이너를 선택합니다.
    • 구성 컨테이너가 선택되지 않은 경우 제출 액션 속성 창에 글로벌 스토리지 구성 폴더가 나타납니다.
  2. 제출 액션 ​을 OneDrive에 제출 ​로 선택합니다.
    OneDrive GIF

  3. 데이터를 저장하려는 경우 스토리지 구성 ​을 선택합니다.

  4. 저장 ​을 클릭하여 제출 설정을 저장합니다.

양식이 제출되면 지정된 Microsoft® OneDrive Storage에 데이터가 저장됩니다.
데이터를 저장하는 폴더 구조는 /folder_name/form_name/year/month/date/submission_id/data입니다.

Azure Blob 스토리지에 제출 submit-to-azure-blob-storage

Azure Blob Storage에 제출 제출 액션은 적응형 양식을 Microsoft® Azure 포털과 연결합니다. 양식 데이터, 파일, 첨부 파일 또는 기록 문서를 연결된 Azure Storage 컨테이너에 제출할 수 있습니다. Azure Blob Storage에 대한 제출 액션을 사용하려면

  1. Azure Blob Storage 컨테이너 만들기: AEM Forms를 Azure Storage 컨테이너에 연결합니다.
  2. 적응형 양식에서 Azure Storage 구성 사용: Adaptive Form을 구성된 Azure Storage 컨테이너에 연결합니다.

Azure Blob Storage 컨테이너 만들기 create-azure-configuration

AEM Forms를 Azure Storage 컨테이너에 연결하려면

  1. AEM Forms 작성자 인스턴스 > 도구 > 클라우드 서비스 > Azure Storage ​로 이동합니다.

  2. Azure Storage ​를 선택하면 Azure Storage 브라우저 ​로 리디렉션됩니다.

  3. 구성 컨테이너 ​를 선택합니다. 선택한 구성 컨테이너에 구성을 저장합니다.

  4. 만들기 ​를 클릭합니다. Azure Storage 구성 만들기 마법사가 나타납니다.

    Azure Storage 구성

  5. 제목, Azure Storage 계정Azure 액세스 키 ​를 지정합니다.

    • Microsoft® Azure 포털의 스토리지 계정에서 Azure Storage Account 이름과 Azure Access key를 검색할 수 있습니다.
  6. 저장 ​을 클릭합니다.

이제 적응형 양식에서 제출 액션에 대한 Azure Storage 컨테이너 구성을 사용할 수 있습니다.

적응형 양식에서 Azure Storage 구성 사용 use-azure-storage-configuartion-in-af

적응형 양식에서 만든 Azure Storage 컨테이너 구성을 사용하여 데이터 또는 생성된 기록 문서를 Azure Storage 컨테이너에 저장할 수 있습니다. 적응형 양식에서 Azure Storage 컨테이너 구성을 다음과 같이 사용하려면 다음 단계를 수행하십시오.

  1. 적응형 양식을 만듭니다.

    note note
    NOTE
    • OneDrive 스토리지가 생성되면 적응형 양식에 대한 구성 컨테이너를 선택합니다.
    • 구성 컨테이너가 선택되지 않은 경우 제출 액션 속성 창에 글로벌 스토리지 구성 폴더가 나타납니다.
  2. 제출 액션 ​을 Azure Blob Storage에 제출 ​로 선택합니다.
    Azure Blob Storage GIF

  3. 데이터를 저장하려는 경우 스토리지 구성 ​을 선택합니다.

  4. 저장 ​을 클릭하여 제출 설정을 저장합니다.

양식이 제출되면 지정된 Azure Storage 컨테이너 구성에 데이터가 저장됩니다.
데이터를 저장하는 폴더 구조는 /configuration_container/form_name/year/month/date/submission_id/data입니다.

구성의 값을 설정하려면 AEM SDK를 사용하여 OSGi 구성을 생성하고 Cloud Service 인스턴스에 구성을 배포합니다.

Power Automate에 제출 microsoft-power-automate

제출 시 Microsoft® Power Automate Cloud Flow를 실행하도록 적응형 양식을 구성할 수 있습니다. 구성된 적응형 양식은 캡처된 데이터, 첨부 파일 및 기록 문서를 처리를 위해 Power Automate Cloud Flow로 전송합니다. 이렇게 하면 Microsoft® Power Automate의 강력한 기능을 활용하면서 사용자 정의 데이터 캡처 환경을 빌드하여 캡처된 데이터를 중심으로 비즈니스 논리를 빌드하고 고객 워크플로를 자동화할 수 있습니다. 다음은 적응형 양식을 Microsoft® Power Automate와 통합한 후 수행할 수 있는 작업에 대한 몇 가지 예입니다.

  • Power Automate 비즈니스 프로세스에서 적응형 양식 데이터 사용
  • Power Automate를 사용하여 캡처된 데이터를 500개 이상의 데이터 소스 또는 공개적으로 사용 가능한 API로 전송
  • 캡처된 데이터에 대해 복잡한 계산 수행
  • 미리 정의된 일정에 따라 적응형 양식 데이터를 스토리지 시스템에 저장

적응형 양식 편집기는 Microsoft® Power Automate 흐름 호출 제출 액션을 제공하여 적응형 양식 데이터, 첨부 파일 및 기록 문서를 Power Automate Cloud Flow로 전송합니다. 제출 작업을 사용하여 캡처된 데이터를 Microsoft® Power Automate로 전송하려면 Forms as a Cloud Service 인스턴스를 Microsoft® Power Automate와 연결합니다.

성공적으로 구성한 후 Microsoft® Power Automate 흐름 호출 제출 액션을 사용하여 데이터를 Power Automate 흐름으로 전송합니다.

Workfront Fusion에 제출 workfront-fusion

제출 시 Workfront Fusion에 데이터를 제출하도록 적응형 양식을 구성할 수 있습니다. Workfront Fusion을 사용하면 동일한 작업을 반복해서 반복하지 않고 새로운 작업에 집중할 수 있도록 프로세스를 자동화할 수 있습니다. 이 제품은 단순하고 복잡한 작업을 모두 자동화하여 시간을 절약하고 일관된 프로세스 실행을 보장합니다.

적응형 Forms 편집기는 적응형 Forms 데이터 또는 첨부 파일을 Workfront Fusion 시나리오로 전송하는 Workfront Fusion 시나리오 호출 제출 액션을 제공합니다. 캡처된 데이터를 Workfront Fusion 시나리오에 전송하는 데 제출 액션을 사용하려면 Adobe Workfront Fusion에 적응형 양식 제출을 참조하십시오.

동기 제출 또는 비동기 제출 사용 use-synchronous-or-asynchronous-submission

제출 액션은 동기 제출 또는 비동기 제출을 사용할 수 있습니다.

동기 제출: 일반적으로 웹 양식은 동기적으로 제출하도록 구성되어 있습니다. 동기 제출 시 사용자가 양식을 제출하면 승인 페이지, 감사 페이지 또는 제출 오류가 발생하는 경우 오류 페이지로 리디렉션됩니다. 비동기 제출 사용 옵션을 선택하여 사용자를 웹 페이지로 리디렉션하거나 제출 시 메시지를 표시합니다.

제출 액션 구성

비동기 제출: 클라이언트-서버 상호 작용이 백그라운드에서 발생하는 동안 웹 페이지가 정적으로 유지되면 단일 페이지 애플리케이션 등 최신 웹 경험의 인지도가 높아집니다. 이제 비동기 제출을 구성하여 적응형 양식을 통해 이 경험을 제공할 수 있습니다.

적응형 양식에서 서버측 유효성 재검사 server-side-revalidation-in-adaptive-form

일반적으로 온라인 데이터 캡처 시스템에서 개발자는 몇 가지 비즈니스 규칙을 적용하기 위해 클라이언트측에 대해 JavaScript 유효성 검사를 일부 실시합니다. 단, 최신 브라우저에서 최종 사용자는 이러한 유효성 검사를 무시하고 웹 브라우저 DevTools 콘솔과 같은 다양한 기술을 사용하여 수동으로 제출 액션을 수행할 수 있습니다. 이러한 기술은 적응형 양식에도 유효합니다. 양식 개발자는 다양한 유효성 검사 논리를 만들 수 있지만 기술적 측면에서 최종 사용자는 이러한 유효성 검사 논리를 무시하고 잘못된 데이터를 서버에 제출할 수 있습니다. 잘못된 데이터로 인해 양식 작성자가 적용한 비즈니스 규칙이 깨질 수 있습니다.

서버측 유효성 재검사 기능을 통해 서버에서 적응형 양식을 디자인하면서 적응형 양식 작성자가 제공한 유효성 검사를 실행할 수도 있습니다. 양식 유효성 검사에 표시되는 데이터 제출 및 비즈니스 규칙 위반 사항에 발생할 수 있는 잠재적 손상을 방지할 수 있습니다.

서버에서의 유효성 검사 대상은 무엇입니까? what-to-validate-on-server-br

서버에서 다시 실행되는 적응형 양식에 대한 즉시 사용할 수 있는(OOTB) 필드 유효성 검사는 다음과 같습니다.

  • 필수
  • 유효성 검사 픽처 구절
  • 유효성 검사 표현식

서버측 유효성 검사 활성화 enabling-server-side-validation-br

사이드바의 적응형 양식 컨테이너 아래에 있는 서버측 유효성 재검사 ​를 사용하여 현재 양식에 대해 서버측 유효성 검사를 활성화하거나 비활성화합니다.

서버측 유효성 검사 활성화

서버측 유효성 검사 활성화

최종 사용자가 이러한 유효성 검사를 무시하고 양식을 제출하면 서버에서 다시 유효성 검사를 수행합니다. 유효성 검사가 서버 끝에서 실패하면 제출 트랜잭션이 중지됩니다. 사용자에게 다시 원본 양식이 표시됩니다. 캡처된 데이터와 제출된 데이터는 사용자에게 오류로 표시됩니다.

NOTE
서버측 유효성 검사는 양식 모델의 유효성을 검사합니다. 별도의 클라이언트 라이브러리를 만들어 유효성을 검사하고 동일한 클라이언트 라이브러리에서 HTML 스타일링과 DOM 조작과 같은 다른 항목과 혼합하지 않는 것이 좋습니다.

유효성 검사 표현식에서 사용자 정의 함수 지원 supporting-custom-functions-in-validation-expressions-br

복잡한 유효성 검사 규칙 ​이 있는 경우에는 정확한 유효성 검사 스크립트는 사용자 정의 함수에 있고 작성자는 필드 유효성 검사 표현식에서 이러한 사용자 정의 함수를 호출합니다. 서버측 유효성 검사를 수행하면서 이 사용자 정의 함수 라이브러리를 이해하고 사용할 수 있도록 양식 작성자는 아래와 같이 적응형 양식 컨테이너 속성의 기본 탭 아래에서 AEM 클라이언트 라이브러리 이름을 구성할 수 있습니다.

유효성 검사 표현식에서 사용자 정의 함수 지원

유효성 검사 표현식에서 사용자 정의 함수 지원

작성자는 적응형 양식별로 사용자 정의 JavaScript 라이브러리를 구성할 수 있습니다. jquery 및 underscore.js 서드파티 라이브러리에 종속된 재사용 가능한 함수만 라이브러리에 유지됩니다.

제출 액션의 오류 처리 error-handling-on-submit-action

AEM 보안 및 강화 지침의 일부로, 400.jsp, 404.jsp 및 500.jsp와 같은 사용자 정의 오류 페이지를 구성합니다. 이러한 핸들러는 양식 제출 시 400, 404 또는 500 오류가 나타나면 호출됩니다. 게시 노드에서 이러한 오류 코드가 트리거되면 핸들러가 호출되기도 합니다. 또한 다른 HTTP 오류 코드에 대한 JSP 페이지를 만들 수 있습니다.

데이터에 <afData>, <afBoundData></afUnboundData> 태그가 포함되어 있지 않은 스키마에 대해 XML 또는 JSON 데이터 컴플레인을 사용하여 FDM(양식 데이터 모델) 또는 스키마 기반 적응형 양식을 미리 채우면 적응형 양식의 무제한 필드 데이터가 손실됩니다. 스키마는 XML 스키마, JSON 스키마 또는 양식 데이터 모델(FDM)일 수 있습니다. 무제한 필드는 bindref 속성이 없는 적응형 양식 필드입니다.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab