Forms 개발(클래식 UI) developing-forms-classic-ui

슬링 폴더(sling:Folder) 만들기
예: /etc/designs/<myDesign>/formlistvalues

다중 값 문자열(String[]) 유형의 새 속성(예: myList)을 추가하여 드롭다운 항목 목록을 포함합니다. JSP 스크립트나 셸 스크립트의 cURL과 같이 스크립트를 사용하여 컨텐츠를 가져올 수도 있습니다.

항목 로드 경로 필드의 전체 경로 사용:
예: /etc/designs/geometrixx/formlistvalues/myList

sling:Folder 유형의 노드를 만듭니다. 구현할 작업을 반영하는 이름을 지정합니다.

예:

/apps/myProject/components/customFormAction

이 노드에서 다음 속성을 정의한 다음 모두 저장 ​을 클릭하여 변경 내용을 유지합니다.

• sling:resourceType - foundation/components/form/action(으)로 설정

• componentGroup - .hidden(으)로 정의

• 선택적으로:

  • jcr:title - 선택한 제목을 지정합니다. 드롭다운 선택 목록에 표시됩니다. 설정하지 않으면 노드 이름이 표시됩니다

  • jcr:description - 선택한 설명을 입력하십시오.

폴더에서 대화 상자 노드를 만듭니다.

1. 작업을 선택한 후 작성자가 양식 대화 상자를 편집할 수 있도록 필드를 추가합니다.

폴더에서 다음 중 하나를 만듭니다.

1. 게시물 스크립트.
   스크립트 이름은 post.POST.<extension>입니다. 예: post.POST.jsp
   양식을 처리하기 위해 양식을 제출할 때 POST 양식에서 도착하는 데이터를 처리하는 코드가 포함되어 있는 POST 스크립트가 호출됩니다.

2. 양식 제출 시 호출되는 전달 스크립트를 추가합니다.
   스크립트 이름은 forward.<extension>입니다(예: forward.jsp).
   이 스크립트는 경로를 정의할 수 있습니다. 그런 다음 현재 요청이 지정된 경로로 전달됩니다.

필요한 호출은 FormsHelper#setForwardPath(variant 2개)입니다. 일반적인 사례는 유효성 검사 또는 논리를 수행하여 대상 경로를 찾은 다음 해당 경로로 전달하여 기본 Sling POST 서블릿이 JCR에서 실제 저장소를 수행하도록 하는 것입니다.

폼 작업과 forward.jsp이(가) "접착제" 코드로만 작동하는 경우 실제 처리를 수행하는 다른 서블릿도 있을 수 있습니다. 예를 들어 /libs/foundation/components/form/actions/mail의 메일 작업이 있습니다. 메일 서블릿이 있는 <currentpath>.mail.html에 세부 정보를 전달합니다.

그래서:

• post.POST.jsp은(는) 작업 자체로 완전히 수행되는 작은 작업에 유용합니다.
• forward.jsp은(는) 위임만 필요한 경우에 유용합니다.

스크립트 실행 순서는 다음과 같습니다.

• 양식을 렌더링할 때(GET):

  1. init.jsp
  2. 모든 필드의 제약 조건: clientvalidation.jsp
  3. 양식의 validationRT: clientvalidation.jsp
  4. 설정된 경우 로드 리소스를 통해 양식이 로드됨
  5. <form></form> 렌더링 내에서 addfields.jsp

• POST 양식을 처리할 때:

  1. init.jsp

  2. 모든 필드의 제약 조건: servervalidation.jsp

  3. 양식의 validationRT: servervalidation.jsp

  4. forward.jsp

  5. 전달 경로가 설정된 경우(FormsHelper.setForwardPath) 요청을 전달한 다음 cleanup.jsp을(를) 호출합니다.

  6. 정방향 경로가 설정되지 않은 경우 post.POST.jsp을(를) 호출합니다(여기서 종료되고 cleanup.jsp이(가) 호출되지 않음).

폴더에서 다시 다음을 선택적으로 추가합니다.

1. 필드를 추가하기 위한 스크립트.
   스크립트 이름은 addfields.<extension>입니다. 예: addfields.jsp
   양식 시작에 대한 HTML이 작성된 직후에 addfields 스크립트가 호출됩니다. 이렇게 하면 작업에서 사용자 지정 입력 필드 또는 양식 내에 다른 HTML을 추가할 수 있습니다.

2. 초기화 스크립트.
   스크립트 이름은 init.<extension>입니다. 예: init.jsp
   이 스크립트는 양식이 렌더링될 때 호출됩니다. 작업 세부 사항을 초기화하는 데 사용할 수 있습니다.

3. 정리 스크립트.
   스크립트 이름은 cleanup.<extension>입니다. 예: cleanup.jsp
   이 스크립트를 사용하여 정리를 수행할 수 있습니다.

parsys에서 Forms 구성 요소를 사용하십시오. 이제 작업 유형 드롭다운에 새 작업이 포함됩니다.

sling:Folder 유형의 노드를 만듭니다. 구현할 제약 조건을 반영하는 이름을 지정합니다.

예:

/apps/myProject/components/customFormConstraint

이 노드에서 다음 속성을 정의한 다음 모두 저장 ​을 클릭하여 변경 내용을 유지합니다.

• sling:resourceType - foundation/components/form/constraint(으)로 설정

• constraintMessage - 양식을 제출할 때 제한 사항에 따라 필드가 유효하지 않은 경우 표시되는 사용자 지정된 메시지

• 선택적으로:

  • jcr:title - 선택한 제목을 지정합니다. 선택 목록에 표시됩니다. 설정하지 않으면 노드 이름이 표시됩니다
  • hint - 필드 사용 방법에 대한 사용자의 추가 정보

이 폴더 내에서는 다음 스크립트가 필요할 수 있습니다.

• 클라이언트 유효성 검사 스크립트:
  스크립트 이름은 clientvalidation.<extension>입니다. 예: clientvalidation.jsp
  양식 필드가 렌더링될 때 호출됩니다. 클라이언트의 필드를 확인하기 위해 클라이언트 Javascript를 만드는 데 사용할 수 있습니다.

• 서버 유효성 검사 스크립트:
  스크립트 이름은 servervalidation.<extension>입니다. 예: servervalidation.jsp
  양식 제출 시 호출됩니다. 제출 후 서버에서 필드를 검증하는 데 사용할 수 있습니다.

특정 양식 구성 요소를 편집합니다.

표시/숨기기 ​를 선택하여 표시/숨기기 규칙 편집 대화 상자를 엽니다.

• 첫 번째 드롭다운 목록에서 표시 또는 숨기기 ​를 선택하여 조건에 따라 구성 요소를 표시할지 또는 숨길지 여부를 지정합니다.

• 맨 위 줄의 끝에 있는 드롭다운 목록에서 다음을 선택합니다.

  • 모두 - 구성 요소를 표시하거나 숨기려면 모든 조건이 true여야 하는 경우
  • 모두 - 구성 요소를 표시하거나 숨기려면 하나 이상의 조건만 true여야 하는 경우

• 조건 줄(하나가 기본값으로 표시됨)에서 구성 요소, 연산자를 선택한 다음 값을 지정합니다.

• 필요한 경우 조건 추가 ​를 클릭하여 조건을 더 추가합니다.

예:

확인 ​을 클릭하여 정의를 저장합니다.

정의를 저장한 후 양식 구성 요소 속성에서 표시/숨기기 옵션 옆에 규칙 편집 링크가 나타납니다. 변경하려면 이 링크를 클릭하여 규칙 표시/숨기기 편집 대화 상자를 엽니다.

모든 변경 내용을 저장하려면 확인 ​을 클릭하세요.