Amazon Comprehend スコープ

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

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

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

動作のしくみ

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

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

アクティビティの本体

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

  使用しているアクティビティに応じて、サービスを利用可能なリージョンを選択します。リージョンのリストは、オブジェクトタイプである「RegionEndpoint」と入力し、リージョンのリストを表示するピリオド(.)を入力することで見つけることができます。Amazon Comprehend の今後のバージョンでは、この選択を容易にするためのドロップダウンリストが提供されます。

• シークレット - Amazon Rekognition サービスに接続する IAM ユーザーの シークレット アクセス キー です。このフィールドは、文字列または String 変数のみをサポートします。シークレット アクセス キーを取得するには、AWS ドキュメントの以下のいずれかのセクションをご覧ください。
  • アクセス キーを管理する (コンソール)
  • アクセス キーを管理する (AWS CLI)
  • アクセス キーを管理する (AWS API)
    重要:

    既存の IAM ユーザーを使用していて、 シークレット アクセス キーがなくなった場合は、IAM ユーザー概要の [アクセス キーの作成 ] ボタンをクリックして新しいアクセス キー ID も作成します。 [ アクセス キーの作成 ] ボタンをクリックすると、ダイアログ ボックスが開きます。AWS の指示に従って、「[Download .csv を選択します。アクセス キー ID とシークレット アクセス キーをコンピューターの CSV ファイルに保存するためのファイルです。ファイルを安全な場所に保存してください。このダイアログ ボックスを閉じると、シークレット アクセス キーに再度アクセスできなくなります。CSV ファイルをダウンロードしたら、[閉じる] を選択します。Amazonでは、アクセスキーIDに関連付けられたシークレットアクセスキーが見つからない場合は、いつでも新しいキーを作成できるように、キーを頻繁にローテーションすることを推奨しています。新しいキーを作成する場合は、既存のプロジェクト内の [Amazon スコープ ] アクティビティを必ず更新してください。詳細については、AWS ドキュメントの 「Managing Access Keys for IAM Users 」をご覧ください。

• 既存のコネクション - 以前に認証された AmazonComprehend コネクション オブジェクトです。AmazonComprehendConnection変数を入力します。

プロパティ

共通

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

その他

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

オプション

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

出力

• コネクション - 子アプリケーション スコープに渡すことができるコネクションです。このフィールドでは AmazonComprehendConnection 変数のみがサポートされています。