가이드

ABBYY Vantage는 분류 및 추출을 통해 비정형 콘텐츠를 구조화된 실행 가능한 정보로 전환하고, 인보이스, 주문서, W2 양식 등 특정 문서 유형을 처리할 수 있는 Content IQ 스킬을 제공합니다. UiPath용 ABBYY Vantage Connector를 사용하면 ABBYY Vantage 스킬을 UiPath 워크플로에 통합할 수 있습니다. 프로세스를 구성하고 실행하려면 ABBYY Vantage 계정이 필요합니다. UiPath용 ABBYY Vantage Connector는 다음 운영 체제에서 실행할 수 있습니다.

• Windows 10
• Windows Server 2016
• Windows Server 2019

UiPath용 커넥터는 다음 환경에서 사용할 수 있습니다.

• ABBYY Vantage 2.3.2 이상
• UiPath Enterprise Edition 2023.8.0
• Community Edition 2023.4.4 이상

다음 외부 구성 요소를 설치해야 합니다.

• Microsoft .NET Framework 4.8.1
• Microsoft .NET 8

UiPath용 ABBYY Vantage Connector는 사용자 정의 워크플로 내에서 UiPath 측에서 실행되는 액티비티 세트입니다. 이 액티비티는 NuGet 패키지로 제공됩니다. 패키지를 설치하려면 다음 단계를 따르세요.

1. ABBYYVantageConnectorForUiPath.<version>.exe를 실행하고 설치 마법사의 안내에 따릅니다. 설치 중에 커넥터 설치 폴더를 지정합니다. 기본 경로는 C:\Program Files\ABBYY Vantage Connector for UiPath입니다.
2. UiPath Studio에서 기존 프로젝트를 열거나 새 프로젝트를 만듭니다.
3. 리본에서 Design 탭의 Manage Packages를 클릭합니다.
4. nuget.org 패키지 소스가 활성화되어 있는지 확인합니다. 이 패키지 소스는 커넥터 패키지의 일부 종속성을 설치하는 데 필요합니다.
   이미 구성된 패키지 소스가 있고 이를 사용하려면 5단계를 건너뛰세요.
5. Manage Packages 창의 Settings 탭으로 이동하여 새 패키지 소스를 만듭니다. a. 새 패키지 소스의 이름을 입력합니다. b. 커넥터 NuGet 패키지를 배치할 폴더 경로를 지정합니다. c. 설정을 확인하려면 Add를 클릭합니다. 새 패키지 소스가 User defined package sources 영역과 Manage Packages 창의 왼쪽 pane에 표시됩니다.
6. ABBYY Vantage Connector for UiPath의 모든 NuGet 패키지를 설치 폴더에서 패키지 소스 폴더로 복사합니다. NuGet 패키지는 1단계에서 생성된 설치 폴더의 UiPath Activities 하위 폴더에 있습니다(기본 위치: C:\Program Files\ABBYY Vantage Connector for UiPath\UiPath Activities). NuGet 커넥터 패키지가 사용 가능한 패키지 소스에 추가되면 프로젝트 종속성에 커넥터 패키지를 설치할 수 있습니다.
7. Manage Packages 창에서 All Packages 섹션으로 이동한 다음 다음을 수행합니다. a. 새로 만든 패키지 소스 카테고리를 클릭합니다. b. 사용 가능한 패키지 목록에서 Abbyy.UiPath.Vantage.Activities를 선택하고 Install을 클릭합니다. License Acceptance 창에는 설치하는 각 타사 패키지의 라이선스 조건이 표시됩니다. c. 라이선스 조건을 읽으려면 View License를 클릭합니다. d. 라이선스 조건에 동의하고 패키지를 설치하려면 I Accept를 클릭합니다. 마지막으로 Save를 클릭합니다.
8. 설치가 완료되면 프로젝트에서 사용할 수 있는 액티비티 목록의 ABBYY Vantage 섹션에 Vantage 액티비티가 표시됩니다. 패키지 설치에 대한 자세한 내용은 UiPath Studio Guide를 참조하세요.

Windows-legacy 프로젝트를 Windows로 변환하는 것이 좋습니다. 이제 새 프로젝트의 기본 호환성은 Windows 호환성입니다. Windows-legacy 프로젝트를 Windows 호환성으로 변환하려면 각 Windows-legacy 호환성 프로젝트에 대해 다음 절차를 수행하세요.

1. UiPath Studio에서 Windows-legacy 프로젝트를 엽니다.
2. 리본 아래에 표시되는 메시지에서 Convert to Windows 링크를 클릭합니다.

Convert to Windows 대화 상자가 열립니다.

3. Windows-legacy 프로젝트를 Windows로 변환하는 방식을 지정합니다.
   • Windows 호환성을 사용하는 현재 프로젝트의 복사본을 만들고 원래 Windows-legacy 프로젝트는 유지하려면 Create a new project를 선택합니다. 프로젝트 이름, 원하는 위치, 필요에 따라 새 프로젝트에 대한 설명을 입력합니다.
   • 기존 프로젝트를 업데이트하여 Windows 호환성으로 변환하려면 Create a new project 옵션 선택을 해제합니다. 이 옵션의 선택을 해제하면 프로젝트에 적용되는 변경 사항을 되돌릴 수 없습니다.
4. Convert를 클릭합니다. Windows-legacy 프로젝트를 Windows 호환성으로 변환하는 방법에 대한 자세한 내용은 UiPath Studio Guide를 참조하세요.

UiPath용 ABBYY Vantage Connector를 사용하면 워크플로에서 문서 이미지를 ABBYY Vantage로 보내 사용 가능한 스킬로 처리할 수 있습니다. 사용 가능한 스킬을 확인하거나, 직접 스킬을 만들거나, 기존 스킬을 수정하려면 ABBYY Vantage Skill Catalog 또는 ABBYY Vantage Skill Designer를 사용하세요. 스킬 설정에 대한 자세한 내용은 ABBYY Vantage Skill Designer Guide를 참조하세요. UiPath용 ABBYY Vantage Connector는 ABBYY Vantage 작업에 사용할 수 있는 다음 액티비티을 제공합니다.

• Vantage Scope
• Use Skill
• Get Results
• Map Fields

UiPath 프로세스에 액티비티을 추가하려면 UiPath Studio의 Activities 패널에서 Designer 패널로 액티비티을 끌어다 놓으세요. 액티비티이 프로세스에 추가되면 Properties 패널의 필드를 입력해야 합니다. 일부 속성은 Designer 패널에서도 입력할 수 있습니다. 액티비티 속성에 대한 자세한 내용은 아래 섹션을 참조하세요. UiPath용 ABBYY Vantage Connector에는 워크플로에서 ABBYY Vantage 액티비티을 사용하는 방법을 보여 주는 샘플 프로세스도 함께 제공됩니다. 자세한 내용은 ABBYY Vantage 액티비티용 샘플 프로세스를 참조하세요. Vantage Scope 액티비티는 ABBYY Vantage 연결 설정을 다른 Vantage 액티비티에 전달합니다. 또한 다른 Vantage 액티비티를 담는 컨테이너 역할도 합니다. 다른 모든 ABBYY Vantage 액티비티는 Vantage Scope 액티비티 내부에 배치해야 합니다.

​

활동 속성

클라이언트 설정의 Vantage 사용자 암호, 프록시 암호, Client Secret은 Scope Activity에서 string 매개 변수 또는 해당 SecureString 유형 매개 변수에 설정할 수 있습니다. String 유형의 암호는 XAML 프로젝트 파일에 일반 텍스트로 저장되므로 안전하지 않습니다. String 암호는 스킬 목록을 가져오기 위해 Use Skill 및 Map Fields 액티비티를 구성할 때 또는 UiPath 프로세스를 디버깅할 때만 사용하는 것이 좋습니다. 프로세스 구성이 완료되면 다음과 같이 하세요.

• Resource Owner Password Credentials Flow를 사용하는 경우 Vantage Scope 액티비티에서 Password 속성을 제거하고 Secure Password 속성을 설정합니다.
• Client Credentials Flow를 사용하는 경우 Vantage Scope 액티비티에서 Client Secret 속성을 제거하고 Secure Client Secret 속성을 설정합니다.

자격 증명을 안전하게 저장하려면 UiPath Orchestrator assets를 사용하는 것이 좋습니다. 이 경우 암호는 Get Credential 액티비티를 사용해 Orchestrator에서 가져온 후, 변수를 통해 Vantage Scope 액티비티에 전달할 수 있습니다. Get Credential 액티비티에 대한 자세한 내용은 공식 UiPath 가이드를 참조하세요. ABBYY Vantage에서 클라이언트를 만들 때는 사용하는 grant type에 따라 클라이언트 설정의 OAuth 2.0 Flows Settings 섹션에서 다음을 구성하세요.

• Resource Owner Password Credentials Flow:
  • Allow Resource Owner Password Credentials Flow 옵션을 활성화합니다.
• Client Credentials Flow:
  • Allow issuing refresh tokens to refresh access tokens 옵션을 활성화합니다.
  • Allow client credentials flow 옵션을 활성화합니다.
  • Manage Roles 설정을 클릭하여 애플리케이션이 Vantage에 로그인할 때 사용할 필수 역할을 선택합니다.
  목록에서 스킬과 연결된 역할을 하나 이상 선택해야 하는 경우 해당 역할에 허용된 스킬도 함께 선택하세요.

Resource Owner Password Credentials Flow에 입력해야 하는 필드: Client Credentials Flow에서 입력해야 하는 필드: 런타임에 커넥터 요청이 프록시 서버를 거치도록 구성할 수 있습니다. 지원되는 프록시 인증 유형은 Basic, NTLM, IP 인증, 투명 프록시입니다. 프록시를 사용하려면 Vantage Scope 활동을 선택합니다. Proxy Settings (optional) 속성 그룹에서 Enable Proxy 속성 값을 "true"로 설정한 다음 Server URL 속성에 프록시 서버 주소를 지정합니다. Basic 인증을 사용하는 경우 Username 및 Password / Secure Password 속성에 프록시 연결 자격 증명을 지정합니다. NTLM 인증을 사용하는 경우 Username 및 Password field는 선택 사항입니다. Username 및 Password field가 비어 있으면 UiPath 프로세스를 실행하는 사용자의 자격 증명이 사용됩니다. Use Skill 액티비티은 ABBYY Vantage 스킬을 사용해 문서를 처리하는 트랜잭션을 생성합니다. 이후 트랜잭션의 고유 식별자가 Transaction Id 출력 속성으로 반환됩니다. InputFile 클래스 속성: Use Skill 액티비티을 설정할 때는 사용하는 인증 흐름에 따라 다음과 같이 하세요.

• Resource Owner Password Credentials Flow — 사용 가능한 스킬 목록을 가져오려면 Vantage Scope 액티비티의 Password 속성을 지정합니다. UiPath 워크플로 구성을 완료한 후에는 Password 속성을 Secure Password로 변경하는 것이 좋습니다.
• Client Credentials Flow — 사용 가능한 스킬 목록을 가져오려면 Vantage Scope 액티비티의 Client Secret 속성을 지정합니다. UiPath 워크플로 구성을 완료한 후에는 Client Secret 속성을 Secure Client Secret로 변경하는 것이 좋습니다.

자세한 내용은 Vantage Scope 액티비티 섹션을 참조하세요. Skill Name 아래 드롭다운 목록 오른쪽에 있는 버튼을 클릭해 스킬 목록을 가져옵니다. 그런 다음 Skill Name 드롭다운 목록을 펼치고 문서 처리에 사용할 스킬을 선택합니다. Get Results 액티비티는 ABBYY Vantage의 처리 결과를 가져오는 데 사용됩니다.

​

활동 속성

분류 스킬, Document skill, OCR skill을 사용할 경우 모든 트랜잭션 입력 파일이 하나의 문서로 조합됩니다. 프로세스 스킬을 사용할 경우에는 여러 결과 문서를 얻을 수 있습니다. 기본적으로 프로세스 스킬에서는 트랜잭션에 추가된 각 입력 파일마다 ABBYY Vantage에 별도의 문서가 생성됩니다. 문서들은 서로 다른 클래스를 가질 수 있지만 모두 하나의 트랜잭션 내에서 처리됩니다. 또한 프로세스 스킬의 Assemble Activity를 사용해 원하는 문서 조합 설정을 직접 지정할 수도 있습니다. 따라서 트랜잭션의 각 문서는 각각의 처리 결과를 갖게 됩니다. Get Results 활동의 문서 결과 출력 매개변수는 트랜잭션에 포함된 모든 문서의 처리 결과를 DocumentResult 클래스 인스턴스의 컬렉션으로 반환합니다. DocumentResult 클래스 속성: ClassificationConfidence 클래스 속성: 트랜잭션 처리가 성공적으로 완료되면(즉, Transaction Status = "Processed"), 결과가 출력 속성에 저장됩니다. 트랜잭션이 아직 처리 중이면(즉, Transaction Status = "New" / "Processing"), 몇 초간 기다린 후 Get Results 활동을 다시 호출합니다. Transaction Status = "Review"인 특별한 경우는 아래에서 설명합니다. Get Results 활동으로 얻을 수 있는 결과는 문서에 적용된 스킬에 따라 달라집니다:

• 분류 스킬 (예: Vantage Classifier):
  • 트랜잭션 상태
  • 문서 결과 (각 DocumentResult별): DocumentId, ClassificationConfidences, ClassName, IsClassificationConfident, ResultFiles (분류 결과 데이터가 포함된 JSON 파일)
• Document skill (예: Invoice US):
  • 트랜잭션 상태
  • 문서 결과 (각 DocumentResult별): DocumentId, ExtractedData, ResultFiles (결과는 두 개의 JSON 파일에 포함됩니다. 첫 번째 파일에는 모든 문서 데이터가, 두 번째 파일에는 추출된 필드 값과 규칙 오류가 포함되며 파일명은 _fields.json으로 끝납니다)
• OCR 스킬:
  • 트랜잭션 상태
  • 문서 결과 (각 DocumentResult별): DocumentId, ResultFiles (이 파일들은 OCR 스킬에 구성된 내보내기 대상에 따라 전달됨), DocumentFullText (스킬에서 TXT 내보내기가 활성화된 경우)
• 프로세스 스킬: 프로세스 스킬에 Classify 활동과 Extract 활동이 포함된 경우, 위 결과는 분류 스킬과 Document skill 모두에 대해 반환됩니다. 프로세스 스킬에 Classify 활동 또는 Extract 활동이 여러 개 포함된 경우, 결과는 해당 유형의 마지막 활동에 대해 반환됩니다. 프로세스 스킬의 Output 활동에 있는 Exported Data Settings 대화 상자에서 PDF 옵션이 활성화되어 있으면, 결과에는 추출 결과가 포함된 JSON 파일과 텍스트 레이어가 포함된 PDF 파일로 내보낸 문서 이미지가 포함됩니다. 각 트랜잭션 문서에 대해 스킬에서 TXT 내보내기가 활성화된 경우 DocumentFullText 매개변수도 전달됩니다. 프로세스 스킬에는 Review 활동도 포함될 수 있습니다. 이런 스킬을 문서 처리에 사용할 때 문서에 수동 검토가 필요하면 처리가 일시 중지될 수 있습니다. 이 경우 Get Results 활동은 다음 결과를 반환합니다:
  • 트랜잭션 상태 = "Review"
  • 검토 링크
  수동 검토와 트랜잭션 처리가 완료되면 Get Results 활동을 다시 호출하여 위 결과를 받을 수 있습니다.

트랜잭션 처리는 여러 가지 이유로 실패할 수 있습니다(예: 입력 파일이 손상되었거나 ABBYY Vantage에서 입력 파일 형식을 지원하지 않는 경우). 이 경우 Get Results 활동은 예외를 발생시킵니다. Map Fields 액티비티는 추출된 field 값을 UiPath 변수에 저장하는 데 사용됩니다. Designer 패널에서 ABBYY Vantage field를 UiPath 변수에 매핑할 수 있습니다. Map Fields 액티비티을 설정할 때는 사용하는 인증 흐름에 따라 다음을 수행하세요.

• Resource Owner Password Credentials Flow — 사용 가능한 스킬 목록을 가져오려면 Vantage Scope 액티비티의 Password 속성을 지정합니다. UiPath 워크플로 구성을 완료한 후에는 Password 속성을 Secure Password로 변경하는 것이 좋습니다.
• Client Credentials Flow — 사용 가능한 스킬 목록을 가져오려면 Vantage Scope 액티비티의 Client Secret 속성을 지정합니다. UiPath 워크플로 구성을 완료한 후에는 Client Secret 속성을 Secure Client Secret으로 변경하는 것이 좋습니다.

자세한 내용은 Vantage Scope 액티비티 섹션을 참조하세요. ABBYY Vantage field를 UiPath 변수에 매핑하려면 다음 단계를 수행하세요.

1. Designer 패널에서 Map Fields 액티비티을 열고, Skill Name 아래 드롭다운 목록 오른쪽에 있는 버튼을 클릭하여 사용 가능한 스킬 목록을 가져옵니다.
2. Skill Name 드롭다운 목록을 펼친 다음, 추출된 field 값을 UiPath 변수에 저장할 Document skill을 선택합니다.
   선택할 수 있는 것은 Document skill뿐입니다.
3. Refresh 버튼을 클릭합니다. Vantage Extracted Field 열에 field 트리가 표시됩니다.
4. 트리를 펼치고 매핑하려는 field 옆의 Plus 버튼을 클릭합니다. UiPath Variable 열에 UiPath 변수 이름과 유형이 표시됩니다. 기본적으로 변수 이름은 Vantage field 이름과 같지만, 필요에 따라 변경할 수 있습니다.
   Map Fields 액티비티에 지정한 UiPath 변수 이름이 UiPath 프로세스에 구성된 Variables Naming Convention과 일치하는지 확인하세요. 변수 이름이 명명 규칙을 따르지 않으면 UiPath 변수 목록에 warning 기호와 함께 표시됩니다. Variables Naming Convention에 대한 자세한 내용은 UiPath documentation을 참조하세요.
   
5. 매핑해야 하는 다른 모든 field에 대해서도 이전 단계를 반복합니다. 매핑을 설정할 때 이미 있는 UiPath 변수를 지정할 수도 있습니다. 이 경우 변수의 유형이 아래 표에서 권장하는 유형과 일치하는지 확인하세요.
6. 문서 field를 UiPath 변수에 매핑한 후 Apply를 클릭하여 변경 사항을 저장합니다. 이제 런타임에 Map Fields 액티비티이 호출되면 변수 값이 추출된 데이터로 채워집니다.

Map Fields 활동의 Skill Name 매개변수에서는 String 형식의 UiPath 변수를 사용해 스킬 이름을 저장할 수 있습니다. 디자인 패널에서 활동의 드롭다운 목록으로 스킬을 선택하면, 새로 선택한 스킬이 지정한 변수에 기록됩니다. 변수에 스킬 이름을 직접 저장할 수도 있습니다. 현재 변수 값에서 식이나 다른 변수 참조는 지원되지 않습니다. 아래 표는 각 ABBYY Vantage field 유형에 대응하는 UiPath 변수 유형을 보여줍니다. GroupItem 클래스 속성: GroupItem은 반복 객체(field 또는 field 그룹)의 한 인스턴스를 포함하는 구조입니다. FieldList 클래스 속성: FieldList는 field 또는 field 그룹(반복 field 또는 같은 이름의 반복 그룹)에 해당하는 구조이며, 해당 field 또는 그룹의 값(여러 인스턴스 가능)을 포함합니다. UiPath 커넥터에 포함된 샘플 프로세스를 확인하거나 릴리스 정보를 참조하세요.