Skip to main content
Vantage Scope は、他のすべての UiPath コネクタ アクティビティを配置する必要があるコンテナーです。Use Skill、Get Results、および Map Fields は、いずれも Scope 内にネストして実行されます。Scope には、ネストされたアクティビティで共有する資格情報、プロキシ設定、および公開 API クライアント設定が保持されるため、接続の詳細はワークフローごとに一度だけ設定すれば済みます。
Vantage Scope アクティビティでは、Resource Owner Password Credentials Flow と Client Credentials Flow を使用して認証を構成できます。Vantage で外部 ID プロバイダーを設定した場合、使用できる認証フローは Client Credentials Flow のみです。
詳細については、以下を参照してください。

外部 ID プロバイダー

Vantage テナント用に、OAuth 2.0 または SAML 2.0 の ID プロバイダーを介した SSO を設定します。

公開 API クライアント

Vantage API で認証するための公開 API クライアントを作成して設定します。

認証

OAuth 2.0 フローを選択し、アクセス トークンを取得します。

​
アクティビティ プロパティ

​
接続設定

PropertyTypeDescription
Authorization grant typeIEnumerable<AuthorizationGrantType>認可に使用する grant type です: ResourceOwnerPassword または ClientCredentials。
PasswordStringABBYY Vantage への接続に使用するパスワードです。
Secure PasswordSecureStringABBYY Vantage への接続に使用するセキュア パスワードです。
Server URLStringABBYY Vantage サーバーのアドレスです。
TenantStringABBYY Vantage テナント名またはテナント identifier です。このプロパティが必要なのは、ABBYY Vantage サーバーへの接続に使用する資格情報のユーザーが、そのサーバー上の複数 (2 つ以上) のテナントに登録されている場合のみです。テナント名は、ブラウザーでパスワードを入力する際に表示される Vantage のサインイン ページで確認できます。
UsernameStringABBYY Vantage への接続に使用するユーザーのメールアドレスです。

​
プロキシ設定 (任意)

プロパティ型説明
Enable ProxyBooleanHTTPリクエストの送信にプロキシサーバーを使用できるようにします。
Server URLStringプロキシサーバーのアドレス (例: http://127.0.0.1:8080) 。
UsernameStringプロキシサーバーへの接続に使用するユーザー名。
パスワードStringプロキシサーバーへの接続に使用するパスワード。
Secure PasswordSecureStringプロキシサーバーへの接続に使用する、セキュリティで保護されたパスワード。

​
公開 API クライアント設定 (任意)

PropertyTypeDescription
Client IdStringVantage アプリケーション識別子です。
Client SecretString保護された Vantage アプリケーション キーです。
Secure Client SecretSecureStringセキュア文字列として格納された保護済み Vantage アプリケーション キーです。

​
資格情報を管理する

Vantage ユーザーのパスワード、プロキシ パスワード、およびクライアント設定の Client Secret は、Scope Activity で、文字列パラメーターまたは対応する SecureString 型のパラメーターのいずれかに設定できます。 String 型のパスワードは XAML プロジェクト ファイルにプレーン テキストで保存されるため、安全ではありません。String パスワードの使用は、skills の一覧を取得するために Use Skill アクティビティおよび Map Fields アクティビティを設定する場合、または UiPath process をデバッグする場合にのみ推奨されます。process の設定が完了したら、次のようにしてください。
  • 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 アクティビティに渡します。
接続設定、プロキシ設定、およびクライアント設定では、同じ種類のパスワードを使用する必要があります。

​
Vantage 公開 API クライアントを設定する

ABBYY Vantage でクライアントを作成する際は、使用する grant type に応じて、クライアント設定の OAuth 2.0 Flows Settings セクションで次の項目を設定してください。
認可フロー有効にする OAuth 2.0 クライアント設定
Resource Owner Password Credentials FlowAllow Resource Owner Password Credentials Flow
Client Credentials FlowAllow issuing refresh tokens to refresh access tokens、Allow client credentials flow、および Manage Roles で選択した必要な roles
Manage Roles で skills に関連付けられた roles を 1 つ以上選択する場合は、それらの roles に対して許可する skills も選択してください。
ABBYY Vantage の roles の詳細については、ロールベースアクセス制御 (RBAC) を参照してください。

​
アクティビティ fields に入力する

Vantage 公開 API クライアント設定 のすべてのプロパティが空の場合、既定の ABBYY Vantage client が使用されます。
この flow で入力する fields:
Resource Owner Password Credentials Flow の Vantage Scope アクティビティ fields

​
プロキシ設定を行う

実行時に、コネクタのリクエストがプロキシサーバーを経由するよう設定できます。サポートされているプロキシ認証の種類は、Basic、NTLM、IP 認証、透過型プロキシです。 プロキシを使用するには、Vantage Scope アクティビティを選択します。プロキシ設定 (任意) プロパティグループで、Enable Proxy プロパティの値を "true" に設定し、次に Server URL プロパティにプロキシサーバーのアドレスを指定します。
Username プロパティと Password / Secure Password プロパティに、プロキシ接続の認証情報を指定します。

Use Skill アクティビティ

Skill を使用してドキュメントを処理するための Vantage トランザクションを作成します。

Get Results アクティビティ

ABBYY Vantage から処理結果を取得します。

Map Fields アクティビティ

抽出した field 値を UiPath 変数に保存します。