메인 콘텐츠로 건너뛰기
JSON 파일에는 문서의 개수, 유형, 이름과 각 문서별 페이지의 수와 이름을 지정하는 데이터 구조가 포함됩니다. 특정 사용자의 시나리오에 맞게 모바일 업로드를 구성하려면 모바일 업로드 링크에서 이 JSON 파일을 사용합니다. md 매개변수는 JSON 파일을 두 가지 형식으로 받을 수 있습니다. 직접 인코딩된 링크 또는 인코딩된 JSON입니다. 인코딩된 링크를 사용하려면:
  1. JSON 파일에 대한 직접 액세스 링크를 생성합니다.
참고: 링크는 “http://” 또는 “https://“로 시작해야 합니다.
  1. 얻은 링크를 URL 인코딩 형식으로 인코딩합니다.
  2. 모바일 업로드 링크에서 md 매개변수의 값으로 인코딩된 URL을 지정합니다.
인코딩된 JSON을 사용하려면:
  1. JSON 파일을 URL 인코딩 형식으로 인코딩합니다.
  2. 모바일 업로드 링크에서 md 매개변수의 값으로 인코딩된 JSON 파일을 지정합니다.

​
JSON 구조

TransactionStructure는 트랜잭션에서 후속 처리를 위해 사용자가 모바일 업로드 세션 동안 캡처해야 하는 문서 집합을 정의합니다. 모든 문서가 캡처될 때까지 트랜잭션은 시작되지 않습니다.
PropertiesValueDescription
version2.4현재 ABBYY Vantage 버전입니다. 주의: 값은 모바일 업로드 링크의 v Parameter 값과 일치해야 합니다.
elementsElementStructure요소 컬렉션의 구조입니다.
ElementStructure는 트랜잭션에서 후속 처리를 위해 사용자가 캡처해야 하는 하나 또는 여러 세트의 문서 컬렉션을 정의합니다.
PropertiesValueDescription
typestandalone하나의 문서 세트로 구성된 컬렉션을 정의합니다.
typesingle_choice여러 문서 세트로 구성된 컬렉션을 정의합니다. 주의: 적어도 두 개 이상의 문서 세트가 지정되어야 합니다.
name마이크로 애플리케이션의 Capture Documents 화면에 표시될 문서 세트의 이름입니다. 주의: single_choice 타입에서만 사용할 수 있습니다.
documentDocumentStructure세트 내 단일 문서의 구조입니다. 주의: standalone 타입에서만 사용할 수 있습니다.
documentsDocumentStructure세트 내 모든 문서의 구조입니다. 주의: single_choice 타입에서만 사용할 수 있습니다.
DocumentStructure는 세트 내 각 문서에 대한 속성 컬렉션을 정의합니다.
PropertiesValueDescription
typeidcard신분증의 양면(앞면과 뒷면) 캡처를 정의합니다.
typepassport여권의 첫 페이지 캡처를 정의합니다.
typedocument임의의 문서 캡처를 정의합니다.
name마이크로 애플리케이션의 Capture Documents 화면에 표시될 문서의 이름입니다.
count1,2,3...한 트랜잭션에서 캡처해야 하는 필수 문서 수입니다. 기본값은 “1”입니다. 주의: 모든 문서가 캡처될 때까지 업로드가 시작되지 않습니다.
countany한 트랜잭션에서 캡처할 문서 수입니다. 주의: 캡처된 문서 수와 관계없이 업로드가 시작됩니다.
galleryEnabledfalse/true이 문서에 대해 기기 갤러리에서 문서 페이지 이미지를 업로드하는 것을 허용할지 여부를 정의합니다.
pagesPagesStructure문서 페이지의 구조입니다.
PagesStructure는 사용자가 캡처해야 하는 문서 페이지에 대한 속성 컬렉션을 정의합니다.
PropertiesValueDescription
nameFront side/Back side신분증 페이지의 이름입니다.
nameFirst page with photo여권 첫 페이지의 이름입니다.
nameDocument page name임의의 문서 페이지 이름입니다.
count1,2,3...문서에 대해 캡처해야 하는 필수 페이지 수입니다. 기본값은 “1”입니다. 문서의 모든 페이지가 캡처될 때까지 업로드는 시작되지 않습니다. 주의: 신분증 앞면과 뒷면에 대한 필수 값은 “1”입니다.
countany임의의 문서에 대해 캡처할 페이지 수입니다. 캡처된 페이지 수와 관계없이 업로드가 시작됩니다. 주의: 여권 첫 페이지에 대한 필수 값은 “1”입니다. 다른 여권 페이지에 대한 필수 값은 “any”입니다.

​
JSON 예시

정해진 페이지 수를 갖는 여권 문서를 특정 개수만큼 캡처하기 위한 JSON 구조 예시는 다음과 같습니다: 
{
  "version": "2.4",
  "elements": [
    {
      "type": "standalone",
      "document": {
        "type": "passport",
        "name": "Passport",
        "count": 1,
        "galleryEnabled": true,
        "pages": [
          {
            "name": "First page with photo",
            "count": 1
          },
          {
            "name": "Other pages",
            "count": "any"
          }
        ]
      }
    }
  ]
}
다음은 여러 개의 미리 정의된 문서 중 하나를 캡처할 때 사용하는 JSON 구조의 예입니다: 
{
  "version": "2.4",
  "elements": [
    {
      "type": "single_choice",
      "name": "Document",
      "documents": [
        {
          "type": "idcard",
          "name": "ID Card",
          "count": 1,
          "galleryEnabled": true,
          "pages": [
            {
              "name": "Front side",
              "count": 1
            },
            {
              "name": "Back side",
              "count": 1
            }
          ]
        },
        {
          "type": "passport",
          "name": "Passport",
          "count": 1,
          "galleryEnabled": true,
          "pages": [
            {
              "name": "First page with photo",
              "count": 1
            },
            {
              "name": "Other pages",
              "count": "any"
            }
          ]
        }
      ]
    }
  ]
}
선택 사항인 신분증을 포함해 여러 문서를 캡처할 때 사용하는 JSON 구조 예시는 다음과 같습니다: 
{
  "version": "2.4",
  "elements": [
    {
      "type": "standalone",
      "document": {
        "type": "document",
        "name": "Invoice",
        "count": 1,
        "galleryEnabled": true,
        "pages": [
          {
            "name": "Page",
            "count": "any"
          }
        ]
      }
    },
    {
      "type": "standalone",
      "document": {
        "type": "idcard",
        "name": "ID Card",
        "count": "any",
        "galleryEnabled": true,
        "pages": [
          {
            "name": "Front side",
            "count": 1
          },
          {
            "name": "Back side",
            "count": 1
          }
        ]
      }
    }
  ]
}