SigningHub(미리 보기)
SigningHub는 문서 승인 워크플로, 고급 디지털 서명 및 문서 상태 추적을 위한 완벽한 솔루션입니다. 비즈니스 문서 제공, 검토, 승인 및 서명 방식을 신속하게 최적화하도록 설계되었습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 전자 메일 | support@ascertia.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Ascertia |
| 웹 사이트 | https://www.signinghub.com |
| 개인 정보 보호 정책 | https://www.signinghub.com/privacy-policy/ |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| contects 가져오기 |
SigningHub에서 로그인한 사용자와 관련된 연락처 목록 가져오기 |
|
Signing |
SigningHub 인스턴스 세부 정보 가져오기 |
| 문서 거부 |
받는 사람은 자신의 차례에 워크플로를 거절할 수 있습니다. |
| 문서 서명 |
로그인한 사용자로 문서에 서명 |
| 문서 승인 |
받는 사람은 이 턴에 워크플로를 승인할 수 있습니다. |
| 문서 워크플로 공유 |
받는 사람에게 문서 워크플로 공유 |
| 받는 사람 가져오기 |
기존 워크플로의 받는 사람 목록 가져오기 |
| 받는 사람 추가 |
기존 워크플로에 받는 사람 추가 |
| 워크플로 가져오기 |
로그인한 사용자에 대한 SigningHub에서 워크플로 목록 가져오기 |
| 워크플로 만들기 |
SigningHub 내에 새 워크플로 만들기 |
| 워크플로 삭제 |
워크플로 소유자가 기존 워크플로를 삭제합니다. |
| 워크플로 세부 정보 가져오기 |
워크플로 세부 정보 가져오기 |
| 워크플로 완료(중간에 종료) |
워크플로 소유자는 모든 단계에서 워크플로를 완료하여 종료할 수 있습니다. |
| 워크플로에 문서 업로드 |
기존 워크플로에 문서 업로드 |
| 워크플로에서 받는 사람 삭제 |
기존 워크플로에서 특정 받는 사람 삭제 |
| 워크플로에서 특정 문서 다운로드 |
기존 워크플로에서 특정 문서 다운로드 |
| 워크플로의 모든 문서 다운로드 |
SigningHub에서 기존 워크플로의 압축/압축된 형식으로 모든 문서 다운로드 |
| 템플릿 가져오기 |
SigningHub에서 모든 엔터프라이즈 템플릿 목록 가져오기 |
| 템플릿 적용 |
문서 워크플로에 제공된 서식 파일 적용 |
contects 가져오기
SigningHub에서 로그인한 사용자와 관련된 연락처 목록 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
기업
|
enterprise | boolean |
엔터프라이즈 연락처 목록 |
|
|
페이지 번호
|
pageNo | True | integer |
페이지 번호 |
|
페이지당 레코드
|
recordsPerPage | True | integer |
페이지당 레코드 수 |
|
텍스트 검색
|
searchText | string |
목록을 필터링할 검색 텍스트 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
array of object | ||
|
사용자 이메일
|
user_email | string |
사용자의 전자 메일 |
|
사용자 이름
|
user_name | string |
사용자의 이름 |
|
사용자 국가 ID
|
user_national_id | string |
사용자의 국가 ID |
SigningHub 정보
SigningHub 인스턴스 세부 정보 가져오기
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Build
|
aboutSigningHub.build | string |
SigningHub 인스턴스 빌드 |
|
저작권
|
aboutSigningHub.copyright | string |
SigningHub의 저작권 |
|
설치 이름
|
aboutSigningHub.installation_name | string |
SigningHub 인스턴스의 설치 이름 |
|
미국 특허 번호
|
aboutSigningHub.patents.us_patent_no | string |
미국 특허 번호 SigningHub의 |
|
버전
|
aboutSigningHub.version | string |
SigningHub 인스턴스의 버전 |
문서 거부
받는 사람은 자신의 차례에 워크플로를 거절할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
|
거절 이유
|
declineReason | True | string |
문서를 거절하는 이유 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문서 거부됨
|
documentDeclined | boolean |
문서 상태가 거부됨 |
문서 서명
로그인한 사용자로 문서에 서명
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
|
문서 ID
|
documentId | True | integer |
문서의 ID |
|
페이지 번호
|
pageNo | True | integer |
문서 페이지 번호 |
|
페이지 위치
|
pagePosition | True | string |
문서 페이지의 위치 |
|
페이지 X
|
pageX | integer |
문서 페이지의 가로 위치 |
|
|
페이지 Y
|
pageY | integer |
문서 페이지의 세로 위치 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문서 이름
|
documentName | string |
서명된 문서의 이름 |
|
필드 이름
|
fieldName | string |
서명된 필드의 이름 |
|
상태
|
status | string |
서명된 문서의 상태입니다. |
문서 승인
받는 사람은 이 턴에 워크플로를 승인할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
|
승인 이유
|
approveReason | string |
문서를 승인하는 이유 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
승인된 문서
|
documentApproved | boolean |
승인된 문서의 상태 |
문서 워크플로 공유
받는 사람에게 문서 워크플로 공유
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
array of object | ||
|
워크플로 ID
|
packageID | integer |
공유 워크플로의 ID |
받는 사람 가져오기
기존 워크플로의 받는 사람 목록 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
받는 사람
|
recipients | array of object |
받는 사람 |
|
대리자
|
recipients.delegatee | string |
대리인의 전자 메일 |
|
대리인 이름
|
recipients.delegatee_name | string |
대리자의 이름입니다. |
|
그룹 이름
|
recipients.group_name | string |
그룹의 이름입니다. |
|
순서
|
recipients.order | integer |
받는 사람의 순서 |
|
Placeholder
|
recipients.placeholder | string |
자리 표시자 값 |
|
프로세스 상태
|
recipients.process_status | string |
자리 표시자의 상태입니다. |
|
다음으로 처리됨
|
recipients.processed_as | string |
값으로 처리된 값 |
|
처리한 사람
|
recipients.processed_by | string |
처리한 전자 메일 |
|
처리됨
|
recipients.processed_on | string |
처리된 날짜 |
|
이유
|
recipients.reason | string |
이유(있는 경우) |
|
역할
|
recipients.role | string |
받는 사람의 역할 |
|
서명 순서
|
recipients.signing_order | integer |
서명 순서 |
|
사용자 이메일
|
recipients.user_email | string |
사용자의 전자 메일 |
|
사용자 이름
|
recipients.user_name | string |
사용자의 이름 |
|
사용자 국가 ID
|
recipients.user_national_id | string |
사용자의 국가 ID |
받는 사람 추가
기존 워크플로에 받는 사람 추가
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
기존 워크플로의 ID |
|
서명 필드 추가
|
addSignatureField | True | boolean |
워크플로에 서명 필드 추가 |
|
문서 ID
|
documentId | integer |
문서의 ID |
|
|
전자 메일 알림
|
emailNotification | True | boolean |
전자 메일 알림 |
|
나만
|
onlyMe | boolean |
나만 받는 사람의 유형 |
|
|
페이지 번호
|
pageNo | integer |
문서 페이지 번호 |
|
|
페이지 위치
|
pagePosition | True | string |
페이지의 위치 |
|
페이지 X
|
pageX | integer |
문서 페이지의 가로 위치 |
|
|
페이지 Y
|
pageY | integer |
문서 페이지의 세로 위치 |
|
|
역할
|
role | True | string |
받는 사람의 역할 |
|
서명 순서
|
signingOrder | True | integer |
받는 사람의 서명 순서 |
|
사용자 이메일
|
userEmail | True | string |
받는 사람의 전자 메일 |
|
사용자 이름
|
userName | True | string |
받는 사람의 이름 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
받는 사람이 추가됨
|
recipientAdded | boolean |
받는 사람이 응답을 추가했습니다. |
워크플로 가져오기
로그인한 사용자에 대한 SigningHub에서 워크플로 목록 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
문서 상태
|
documentStatus | True | string |
문서의 상태 |
|
폴더
|
folder | True | string |
사용자 워크플로의 폴더 |
|
페이지 번호
|
pageNo | True | integer |
문서 페이지 번호 |
|
페이지당 레코드
|
recordsPerPage | integer |
페이지당 레코드 수 |
|
|
텍스트 검색
|
searchText | string |
목록을 필터링할 검색 텍스트 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
array of object | ||
|
폴더
|
folder | string |
사용자 워크플로의 폴더 |
|
수정한 날짜
|
modified_on | string |
수정된 날짜 |
|
다음 서명자
|
next_signer | string |
워크플로의 다음 서명자 |
|
next_signer_email
|
next_signer_email | array of object |
next_signer_email |
|
user_email
|
next_signer_email.user_email | string |
user_email |
|
user_name
|
next_signer_email.user_name | string |
user_name |
|
소유자 이름
|
owner_name | string |
워크플로 소유자의 이름 |
|
워크플로 ID
|
package_id | integer |
워크플로의 ID |
|
워크플로 이름
|
package_name | string |
워크플로의 이름 |
|
워크플로 소유자
|
package_owner | string |
워크플로 소유자의 이메일 |
|
워크플로 상태
|
package_status | string |
워크플로의 상태 |
|
읽지 않음
|
unread | boolean |
읽지 않은 형식 |
|
에 업로드됨
|
uploaded_on | string |
업로드된 워크플로의 날짜 |
워크플로 만들기
SigningHub 내에 새 워크플로 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
문서 콘텐츠
|
documentContent | True | string |
base64의 문서 내용 |
|
워크플로 이름
|
documentName | True | string |
SigningHub 내에 새 워크플로 만들기 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문서 ID
|
documentId | integer |
문서의 ID |
|
패키지 ID
|
packageId | integer |
워크플로의 ID |
워크플로 삭제
워크플로 소유자가 기존 워크플로를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
워크플로 삭제됨
|
packageDeleted | boolean |
워크플로 삭제된 응답 |
워크플로 세부 정보 가져오기
워크플로 세부 정보 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
array of object | ||
|
문서
|
documents | array of object |
문서 |
|
allowed_permissions
|
documents.certify.allowed_permissions | array of string |
allowed_permissions |
|
default_permission
|
documents.certify.default_permission | string |
default_permission |
|
enabled
|
documents.certify.enabled | boolean |
enabled |
|
created_on
|
documents.created_on | string |
created_on |
|
document_height
|
documents.document_height | integer |
document_height |
|
document_id
|
documents.document_id | integer |
document_id |
|
document_name
|
documents.document_name | string |
document_name |
|
document_order
|
documents.document_order | integer |
document_order |
|
document_pages
|
documents.document_pages | integer |
document_pages |
|
document_source
|
documents.document_source | string |
document_source |
|
document_type
|
documents.document_type | string |
document_type |
|
document_width
|
documents.document_width | integer |
document_width |
|
form_fields
|
documents.form_fields | boolean |
form_fields |
|
lock_form_fields
|
documents.lock_form_fields | boolean |
lock_form_fields |
|
modified_on
|
documents.modified_on | string |
modified_on |
|
템플릿
|
documents.template | string |
템플릿 |
|
폴더
|
folder | string |
폴더 유형 |
|
수정한 날짜
|
modified_on | string |
수정된 날짜 |
|
다음 서명자
|
next_signer | string |
다음 서명자의 전자 메일 |
|
next_signer_email
|
next_signer_email | array of |
next_signer_email |
|
소유자 이름
|
owner_name | string |
소유자의 표시 이름 |
|
워크플로 ID
|
package_id | integer |
워크플로의 ID |
|
워크플로 이름
|
package_name | string |
워크플로의 이름 |
|
워크플로 소유자
|
package_owner | string |
워크플로의 소유자 |
|
패키지 상태
|
package_status | string |
워크플로의 현재 상태 |
|
에 업로드됨
|
uploaded_on | string |
업로드된 워크플로의 날짜 |
|
users
|
users | array of |
users |
|
계속 감소
|
workflow.continue_on_decline | boolean |
워크플로의 거절을 계속합니다. |
|
contacts
|
workflow.post_process.contacts | array of |
contacts |
|
Dropbox
|
workflow.post_process.dropbox | boolean |
Dropbox 사용 값 |
|
Google 드라이브
|
workflow.post_process.google_drive | boolean |
Google 드라이브 사용 값 |
|
워크플로 받는 사람
|
workflow.post_process.workflow_recipients | boolean |
워크플로 받는 사람 값 |
|
읽기 전용
|
workflow.read_only | boolean |
워크플로 읽기 전용 값 |
|
워크플로 모드
|
workflow.workflow_mode | string |
워크플로의 모드 |
|
워크플로 상태
|
workflow.workflow_status | string |
워크플로의 상태 |
|
워크플로 유형
|
workflow.workflow_type | string |
워크플로의 형식 |
워크플로 완료(중간에 종료)
워크플로 소유자는 모든 단계에서 워크플로를 완료하여 종료할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | string |
워크플로의 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
워크플로 완료
|
workflowCompleted | boolean |
완료된 워크플로의 상태 |
워크플로에 문서 업로드
기존 워크플로에 문서 업로드
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
기존 워크플로의 ID |
|
문서 콘텐츠
|
documentContent | True | byte |
base64에 추가된 문서의 내용 |
|
확장명을 가진 문서 이름
|
documentName | True | string |
확장명을 가진 추가된 문서의 이름 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문서 ID
|
documentId | string |
업로드된 문서의 ID |
워크플로에서 받는 사람 삭제
기존 워크플로에서 특정 받는 사람 삭제
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
|
순서
|
order | True | integer |
삭제된 받는 사람의 순서 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
받는 사람이 삭제됨
|
recipientDeleted | boolean |
받는 사람 삭제됨 상태 |
워크플로에서 특정 문서 다운로드
기존 워크플로에서 특정 문서 다운로드
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
|
문서 ID
|
documentId | True | integer |
문서의 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문서 콘텐츠
|
documentContent | byte |
base64 문자열의 문서 내용 |
|
문서 유형
|
documentType | string |
문서의 형식입니다. |
워크플로의 모든 문서 다운로드
SigningHub에서 기존 워크플로의 압축/압축된 형식으로 모든 문서 다운로드
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
워크플로 콘텐츠
|
packageContent | byte |
base64 문자열의 워크플로 내용 |
|
워크플로 유형
|
packageType | string |
워크플로 콘텐츠의 형식 |
템플릿 가져오기
SigningHub에서 모든 엔터프라이즈 템플릿 목록 가져오기
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
templatesCollection
|
templatesCollection | array of object |
templatesCollection |
|
|
templatesCollection.read_only | boolean |
read_only |
|
템플릿_아이디
|
templatesCollection.template_id | integer |
템플릿_아이디 |
|
template_name
|
templatesCollection.template_name | string |
template_name |
|
template_public
|
templatesCollection.template_public | boolean |
template_public |
템플릿 적용
문서 워크플로에 제공된 서식 파일 적용
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로 ID
|
packageId | True | integer |
워크플로의 ID |
|
문서 ID
|
documentId | True | integer |
문서의 ID |
|
모두에 적용
|
applyToAll | True | boolean |
모든 문서에 적용 |
|
서식 파일 이름
|
templateName | True | string |
적용된 템플릿의 이름 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Certify 사용
|
applyTemplate.certify.enabled | boolean |
인증 사용 값 |
|
권한 인증
|
applyTemplate.certify.permission | string |
인증 권한 값 |
|
문서 높이
|
applyTemplate.document_height | integer |
문서의 높이 |
|
문서 ID
|
applyTemplate.document_id | integer |
문서의 ID |
|
문서 이름
|
applyTemplate.document_name | string |
문서의 이름입니다. |
|
문서 순서
|
applyTemplate.document_order | integer |
워크플로의 문서 순서 |
|
문서 페이지
|
applyTemplate.document_pages | integer |
문서의 총 페이지 |
|
문서 원본
|
applyTemplate.document_source | string |
문서의 원본입니다. |
|
문서 유형
|
applyTemplate.document_type | string |
문서의 형식입니다. |
|
문서 너비
|
applyTemplate.document_width | integer |
문서의 너비 |
|
양식 필드
|
applyTemplate.form_fields | boolean |
문서의 양식 필드 가용성 |
|
양식 필드 잠금
|
applyTemplate.lock_form_fields | boolean |
잠금 양식 필드 사용 값 |
|
수정한 날짜
|
applyTemplate.modified_on | string |
수정된 날짜 |
|
읽기 전용
|
applyTemplate.template.read_only | boolean |
준비된 템플릿의 유일한 형식입니다. |
|
서식 파일 이름
|
applyTemplate.template.template_name | string |
적용된 템플릿의 이름 |
|
에 업로드됨
|
applyTemplate.uploaded_on | string |
업로드된 날짜 |