서식에 사용할 컨트롤을 정의하는 것으로, userGroupData는 서명자 그룹별로 사용할 컨트롤을 정의하고, userCstmData는 그룹별 데이터가 아닌 그 외의 데이터를 매핑할 컨트롤로 사용하시면 됩니다.

userGroupData는 작성자별 정보를 설정하고,  userCstmData는 공통 정보를 설정합니다. userCstmData는 추가 요구 사항이어서 따로 설정 할 수 있게 설계 되었습니다 . 

디자이너에 표시 될때 userGroupData는 작성자 하위 데이터로 표시되며, userCstmData는 공통 데이터로 표시 됩니다.

(이미지 참고) 

formKey는 1개의 서식(디자인), formDataKey는 서식을 기반으로 생성되는 1개의 문서(데이터)에 대응하는 개념입니다.

S01 인터페이스로 전자 서식 파일을 생성하면 해당 서식 파일의 고유 식별자 formKey를 반환 받습니다.

반환 받은 formKey를 업무단에서 관리하고, S03 인터페이스로 formKey와 서식에 매핑할 데이터(mappingData)를 넘겨 문서 데이터를 만들면 formDataKey를 반환 받습니다.

문서 1개에 여러 서명자가 참여하는 경우, 해당 서명자들은 동일한 formDataKey로 서명 뷰어를 호출해야 합니다. 호출 시 필요한 userId는 userGroupData의 해당 그룹의 pKey를 넣어 서명 뷰어를 호출하면 됩니다.

문서 발송을 위해 S03 formDataKey 생성 시 userGroupData, userCstmData으로 정의했던 컨트롤에 매핑할 데이터입니다.

userGroupData를 업무에서 설정하고, 사용자가 디자인하면, 업무에서 mappingData를 이용해서 글상자의 값을 동적으로 변경 할 수 있습니다.

mappingData는 서명자 그룹의 구분 없이 컨트롤의 id와 value를 나열하여, 아래와 같이 JSON 문자열을 넘기시면 됩니다.

{

    "mappingData": [

        { "id": "control_id_1", "value": "값1" },

        { "id": "control_id_2", "value": "값2" }

    ]

}

서식에 데이터를 넣어 미리보기 시 넘겨줄 데이터입니다.

U16의 report.setPreViewData(preViewData)로 미리보기에 적용할 데이터를 설정하고 report.preView() 호출 시 미리보기 뷰어로 동작합니다.

preViewData는 서명자 그룹의 구분 없이 key가 컨트롤 Id, value가 컨트롤의 값이 되는 쌍을 나열한 객체입니다.

미리보기시에 preViewData={user1_name : "홍길동"} 으로 설정하면 미리보기 화면에 '홍길동'으로 표시 됩니다. 

const preViewData = {

        control_id_1: "값1",

        control_id_2: "값2"

    };

report.setPreViewData(preViewData);

report.preView();

S01 인터페이스로 전자서식 키(formKey)를 생성할 때, 하나의 문서에 참여하는 인원 수만큼 userGroupData를 입력하여 생성합니다.

S03 인터페이스로 데이터를 매핑하여 전자서식 데이터 키(formDataKey)를 생성하고, 반환 받은 formDataKey를 같이 사용하여 서명 뷰어를 호출 하면 됩니다. (대량 발송의 경우 S06 사용 가능)

예를 들어 서식에 2개 서명 참여 그룹이 있는 경우, 2명에 대한 데이터를 포함한 mappingData를 넘기고 formDataKey 1개를 반환 받습니다. 해당 서명 참여자가 서명 뷰어를 호출할 때, 반환 받은 동일한 formDataKey와 본인이 속하는 그룹의 pKey를 사용하여 같은 문서를 작성하도록 합니다.

pdfStoragePath: 전자서식으로 만드려는 PDF 파일을 업로드할 디렉토리 입니다.

pdfExportPath: 서명을 완료하고 PDF로 Export 시 저장될 디렉토리 입니다. 

tempPath: 최종 PDF 파일을 새 비밀번호로 변경하고 새로운 PDF로 복제(S07)할 때 저장되는 디렉토리 입니다.

S04 인터페이스로 최종 PDF 파일 생성 시 비밀번호를 부여하거나,

S07 인터페이스를 이용하여 새로운 PDF로 복제하여 비밀번호를 부여할 수 있습니다.

여러명 서명일 때 S04를 이용하여 최종 PDF 파일을 생성하면, 1개 문서의 서명자들이 동일한 비밀번호로 PDF를 열람하여야 합니다.

그러므로 각 서명자마다 다른 비밀번호를 사용하려고 하시는 경우, S04로 최종 PDF 파일을 생성하고 S07로 비밀번호를 변경하여 PDF를 복제하는 방법을 사용하시면 됩니다. 복제된 PDF는 tempDir에 저장되고 U17 인터페이스의 report.pdfViewWithFile로 뷰잉할 수 있습니다.

E52 인터페이스: 서명자가 입력한 특정 필드의 값, 서명 데이터 1개 추출 가능합니다.

E53 인터페이스: 서명자가 입력한 전체 필드의 값, 서명 데이터 추출 가능합니다.

1. '라벨 컨트롤'에 이미지를 삽입하는 방법  

-서식을 디자인하는 시점에 라벨 컨트롤을 추가하여 이미지를 선택해 삽입하는 방법입니다.

2. 이미지 컨트롤을 추가하는 방법

-서명 뷰어에서 서명자가 직접 이미지를 선택할 수 있는 방법으로, 해당 이미지 컨트롤에 대해 권한이 있는 경우 이미지를 선택해 삽입할 수 있습니다.

3. 서명 목록 API를 연결한 경우(report.setSignList(apiUrl)), 서명 컨트롤에 서명 이미지를 삽입하는 방법

-내 서명 목록을 관리하는 기능을 구현하여 report.setSignList(apiUrl)로 API를 연결했을 때, 서명 모달의 하단에 API가 리턴하는 서명 이미지 목록이 나타납니다. 

서명 목록 API는 JSON 문자열로 작성가능합니다.

개인서명 이미지는 업무에서 관리하도록 되어 있습니다.