Amazon Comprehend スコープ

Amazon Comprehend アクティビティは、 AWS Identity and Access Management (IAM) サービスを使用して、UiPath と AWS リソースの間で認証された接続を確立します。この接続によって、ロボットは Amazon Comprehend API を呼び出し、ユーザーに代わってリソースを読み書きできます。

認証された接続を確立するには、 IAM ユーザーを作成するか、既存の IAM ユーザーを使用してアクセスキー ([アクセスキー ID] と [シークレットアクセスキー]) を生成します。 IAM ユーザーを作成するときに、ロボットがアクセスできるリソースを指定するポリシーと権限を割り当てます (例: AmazonComprehendFullAccess)。

IAM ユーザーを作成してポリシーを割り当てた後、[ Amazon Comprehend スコープ] アクティビティに [アクセスキー ID] と [シークレットアクセスキー] を入力します。オートメーションプロジェクトを実行すると、各アクティビティによって作成される API 要求への署名にキーが使用されます。

動作のしくみ

以下の手順とメッセージシーケンスダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

「セットアップ」の手順を完了します。
プロジェクトに [ Amazon Comprehend スコープ] アクティビティを追加します。
アクティビティの本体にあるプロパティの値を入力します。
ダウンストリームスコープアクティビティでコネクションを再使用する場合は、[出力] プロパティに変数を入力します。

アクティビティの本体

認証の種類 - 使用する認証の種類です。 AmazonComprehend または既存の接続を選択できます。認証の選択によって、表示されるその他の認証プロパティが決まります。
アクセスキー - 認証する IAM ユーザーのアクセスキー ID です。このフィールドは、文字列または String 型変数のみをサポートします。アクセスキー ID を取得するには、AWS ドキュメントの以下のセクションのいずれかを参照してください。
リージョン - 接続に使用する AWS サービスエンドポイントです。 RegionEndpoint または RegionEndpoint 型変数を入力します。

注:
使用しているアクティビティに応じて、サービスを利用可能なリージョンを選択します。

リージョンのリストは、「RegionEndpoint」と入力します。これはオブジェクトの種類です。次にリージョンのリストを表示する期間 (..) を入力します (以下の画像を参照)。

Amazon Comprehend の今後のバージョンでは、この選択を容易にするためにドロップダウンリストが表示されます。
シークレット - Amazon Rekognition サービスに接続する IAM ユーザーのシークレットアクセスキーです。このフィールドは、文字列または String 型変数のみをサポートします。シークレットアクセスキーを取得するには、AWS ドキュメントの以下のセクションのいずれかを参照してください。
- アクセスキーを管理する (コンソール)
- アクセスキーを管理する (AWS CLI)
- アクセスキーを管理する (AWS API)
  
  重要:
  既存の IAM ユーザーを使用しており 、シークレットアクセスキーを持たない場合は、IAM ユーザーの概要で [ アクセスキーを作成 ] ボタンをクリックして新しい IAM ユーザーを作成します。この操作により、 新しいアクセスキー IDも作成されます。
  
  [ アクセスキーを作成 ] ボタンをクリックすると、ダイアログボックスが開きます。 AWS の指示に従い、「.csv をダウンロードする」を選択します。ファイルを使用して、アクセスキー ID とシークレットアクセスキーをコンピューター上の CSV ファイルに保存します。ファイルを安全な場所に保存します。このダイアログボックスを閉じると、シークレットアクセスキーへのアクセス権できなくなります。 CSV ファイルをダウンロードしたら、[閉じる] を選択します。
  
  Amazon では、キーローテーションを頻繁に行うことをお勧めします。 アクセスキー ID に関連付けられた シークレットアクセスキーが見つからない場合に、新しいキーをいつでも作成できます。新しいキーを作成する場合は、既存のプロジェクト内の [Amazon スコープ] アクティビティを必ず更新してください。
  
  詳細については、AWS ドキュメントの「<a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html?icmpid=docs_iam_console"target="_blank"> IAM Users</a> のアクセスキーの管理」をご覧ください。
既存の接続 - 以前に認証された AmazonComprehend 接続オブジェクトです。 AmazonComprehendConnection 型変数を入力します。

プロパティ

共通

表示名 - アクティビティの表示名です。このフィールドは、文字列または String 型変数のみをサポートします。

その他

プライベート - このチェックボックスをオンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

オプション

API エラーを例外として報告 - 選択すると、このアプリケーションスコープを使用するすべての子アクティビティにより API エラー応答がビジネスアクティビティ実行例外として報告されます。選択しないと、子アクティビティは API エラーメッセージを [応答ステータス] 出力プロパティに追加し、ワークフローの実行を続行します。ワークフローが正常に実行されたかどうかを確認するには [応答ステータス] プロパティを確認します。