

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# オートメーションアクションのリファレンス
<a name="automations-actions-reference"></a>

App Studio で使用されるオートメーションアクションのリファレンスドキュメントを次に示します。

一般的にアクションと呼ばれるオートメーションアクションは****、オートメーションを構成するロジックの個々のステップです。各アクションは、E メールの送信、データレコードの作成、Lambda 関数の呼び出し、APIs呼び出しなど、特定のタスクを実行します。アクションはアクションライブラリのオートメーションに追加され、条件ステートメントまたはループにグループ化できます。

オートメーションとそのアクションの作成と設定については、「」のトピックを参照してください[自動化とアクション: アプリのビジネスロジックを定義する](automations.md)。

## API を呼び出す
<a name="automations-actions-reference-invoke-API"></a>

HTTP REST API リクエストを呼び出します。ビルダーはこのアクションを使用して、APIs を使用して App Studio から他のシステムまたはサービスにリクエストを送信できます。例えば、サードパーティーのシステムや自社開発のアプリケーションに接続してビジネスクリティカルなデータにアクセスしたり、専用の App Studio アクションでは呼び出せない API エンドポイントを呼び出すことができます。

REST APIs[RESTful API とは](https://aws.amazon.com/what-is/restful-api/)」を参照してください。

### プロパティ
<a name="automations-actions-reference-invoke-API-properties"></a>

#### コネクタ
<a name="automations-actions-reference-invoke-API-properties-connector"></a>

このアクションによって行われた API リクエストに使用する**コネクタ**。コネクタドロップダウンには、 `API Connector`および のタイプのコネクタのみが含まれます`OpenAPI Connector`。コネクタの設定方法に応じて、認証情報やデフォルトのヘッダー、クエリパラメータなどの重要な情報を含めることができます。

`API Connector` と の使用の比較など、API コネクタの詳細については`OpenAPI Connector`、「」を参照してください[サードパーティーのサービスに接続する](add-connector-third-party.md)。

#### API リクエスト設定プロパティ
<a name="automations-actions-reference-invoke-API-properties-request-config"></a>

プロパティパネルから **API リクエストの設定** を選択し、リクエスト設定ダイアログボックスを開きます。**API コネクタ**が選択されている場合、ダイアログボックスにはコネクタ情報が含まれます。

**メソッド:** API コールのメソッド。可能な値は以下のとおりです。
+ `DELETE`: 指定されたリソースを削除します。
+ `GET`: 情報またはデータを取得します。
+ `HEAD`: 本文のないレスポンスのヘッダーのみを取得します。
+ `POST`: 処理するデータを送信します。
+ `PUSH`: 処理するデータを送信します。
+ `PATCH`: 指定されたリソースを部分的に更新します。

**パス:** リソースへの相対パス。

**ヘッダー:** API リクエストで送信されるキーと値のペアの形式のヘッダー。コネクタが選択されている場合、その設定済みヘッダーは自動的に追加され、削除することはできません。設定されたヘッダーは編集できませんが、同じ名前の別のヘッダーを追加して上書きできます。

**クエリパラメータ:** API リクエストで送信されるキーと値のペアの形式のクエリパラメータ。コネクタが選択されている場合、設定されたクエリパラメータは自動的に追加され、編集または削除することはできません。

**本文:** API リクエストとともに JSON 形式で送信される情報。`GET` リクエストの本文はありません。

#### モック出力
<a name="automations-actions-reference-invoke-API-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリケーションに対するコネクタレスポンスと同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## 呼び出し AWS
<a name="automations-actions-reference-invoke-aws"></a>

 AWS サービスから オペレーションを呼び出します。これはサービス AWS またはオペレーションを呼び出すための一般的なアクションであり、目的の AWS サービスまたはオペレーション専用のアクションがない場合に使用する必要があります。

### プロパティ
<a name="automations-actions-reference-invoke-aws-properties"></a>

#### サービス
<a name="automations-actions-reference-invoke-aws-properties-service"></a>

実行するオペレーションを含む AWS サービス。

#### 運用
<a name="automations-actions-reference-invoke-aws-properties-operation"></a>

実行するオペレーション。

#### コネクタ
<a name="automations-actions-reference-invoke-aws-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-invoke-aws-properties-configuration"></a>

指定されたオペレーションを実行するときの JSON 入力。 AWS オペレーションの入力の設定の詳細については、「」を参照してください[AWS SDK for JavaScript](https://docs.aws.amazon.com/sdk-for-javascript)。

## Lambda を呼び出す
<a name="automations-actions-reference-invoke-lambda"></a>

既存の Lambda 関数を呼び出します。

### プロパティ
<a name="automations-actions-reference-invoke-lambda-properties"></a>

#### コネクタ
<a name="automations-actions-reference-invoke-lambda-properties-connector"></a>

このアクションによって実行される Lambda 関数に使用されるコネクタ。設定済みコネクタは、Lambda 関数にアクセスするための適切な認証情報と、Lambda 関数を含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。Lambda のコネクタの設定の詳細については、「」を参照してください[ステップ 3: Lambda コネクタを作成する](connectors-lambda.md#connectors-lambda-create-connector)。

#### 関数名
<a name="automations-actions-reference-invoke-lambda-properties-function-name"></a>

実行する Lambda 関数の名前。これは関数名であり、関数 ARN (Amazon リソースネーム) ではないことに注意してください。

#### 関数イベント
<a name="automations-actions-reference-invoke-lambda-properties-function-event"></a>

イベントペイロードとして Lambda 関数に渡されるキーと値のペア。

#### モック出力
<a name="automations-actions-reference-invoke-lambda-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリケーションに対するコネクタレスポンスと同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## ループ
<a name="automations-actions-reference-loop"></a>

ネストされたアクションを繰り返し実行して、項目のリストを一度に 1 つずつ反復処理します。たとえば、 [レコードの作成](#automations-actions-reference-create-record)アクションをループアクションに追加して、複数のレコードを作成します。

ループアクションは、他のループまたは条件アクション内にネストできます。ループアクションは並列ではなく順番に実行されます。ループ内の各アクションの結果は、同じループ反復内の後続のアクションにのみアクセスできます。ループの外部またはループの異なる反復でアクセスすることはできません。

### プロパティ
<a name="automations-actions-reference-loop-properties"></a>

#### ソース
<a name="automations-actions-reference-loop-properties-source"></a>

反復処理する項目のリスト。一度に 1 つの項目。ソースは、前のアクション、または JavaScript 式を使用して指定できる文字列、数値、またはオブジェクトの静的リストの結果です。

##### 例
<a name="automations-actions-reference-loop-properties-source-examples"></a>

次のリストには、ソース入力の例が含まれています。
+ 前のアクションの結果: `{{results.actionName.data}}`
+ 数値のリスト: `{{[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]}}`
+ 文字列のリスト: `{{["apple", "banana", "orange", "grape", "kiwi"]}}`
+ 計算された値: `{{params.actionName.split("\n")}}`

#### 現在の項目名
<a name="automations-actions-reference-loop-properties-function-name"></a>

反復する現在の項目を参照するために使用できる変数の名前。現在の項目名は、2 つ以上のループをネストし、各ループから変数にアクセスできるように設定できます。たとえば、2 つのループを持つ国と都市をループする場合は、 と を設定`currentCountry`して参照できます`currentCity`。

## Condition
<a name="automations-actions-reference-condition"></a>

オートメーションの実行時に評価される 1 つ以上の指定された論理条件の結果に基づいてアクションを実行します。条件アクションは、次のコンポーネントで構成されます。
+ `true` または と評価される JavaScript 式を提供するために使用される*条件*フィールド`false`。
+ 条件が に評価された場合に実行されるアクションを含む *true ブランチ*`true`。
+ 条件が に評価された場合に実行されるアクションを含む *false ブランチ*`false`。

条件アクションにドラッグして、アクションを true ブランチと false ブランチに追加します。

### プロパティ
<a name="automations-actions-reference-condition-properties"></a>

#### Condition
<a name="automations-actions-reference-condition-properties-condition"></a>

アクションの実行時に評価される JavaScript 式。

## レコードの作成
<a name="automations-actions-reference-create-record"></a>

既存の App Studio エンティティに 1 つのレコードを作成します。

### プロパティ
<a name="automations-actions-reference-create-record-properties"></a>

#### エンティティ
<a name="automations-actions-reference-create-record-properties-entity"></a>

レコードを作成するエンティティ。エンティティを選択したら、レコードを作成するエンティティのフィールドに値を追加する必要があります。フィールドのタイプ、およびフィールドが必須かオプションかは、エンティティで定義されます。

## レコードの更新
<a name="automations-actions-reference-update-record"></a>

App Studio エンティティの既存のレコードを更新します。

### プロパティ
<a name="automations-actions-reference-update-record-properties"></a>

#### エンティティ
<a name="automations-actions-reference-update-record-properties-entity"></a>

更新するレコードを含むエンティティ。

#### 条件
<a name="automations-actions-reference-update-record-properties-conditions"></a>

アクションによって更新されるレコードを定義する基準。条件をグループ化して、1 つの論理ステートメントを作成できます。グループまたは条件を `AND`または `OR`ステートメントと組み合わせることができます。

#### フィールド
<a name="automations-actions-reference-update-record-properties-fields"></a>

条件によって指定されたレコードで更新されるフィールド。

#### 値
<a name="automations-actions-reference-update-record-properties-values"></a>

指定されたフィールドで更新する値。

## レコードの削除
<a name="automations-actions-reference-delete-record"></a>

App Studio エンティティからレコードを削除します。

### プロパティ
<a name="automations-actions-reference-delete-record-properties"></a>

#### エンティティ
<a name="automations-actions-reference-delete-record-properties-entity"></a>

削除するレコードを含むエンティティ。

#### 条件
<a name="automations-actions-reference-delete-record-properties-conditions"></a>

アクションによって削除するレコードを定義する基準。条件をグループ化して、1 つのロジックステートメントを作成できます。グループまたは条件を `AND`または `OR`ステートメントと組み合わせることができます。

## データアクションを呼び出す
<a name="automations-actions-reference-invoke-data-action"></a>

オプションのパラメータを使用してデータアクションを実行します。

### プロパティ
<a name="automations-actions-reference-invoke-data-action-properties"></a>

#### データアクション
<a name="automations-actions-reference-invoke-data-action-properties-data-action"></a>

アクションによって実行されるデータアクション。

#### パラメータ
<a name="automations-actions-reference-invoke-data-action-properties-parameters"></a>

データアクションで使用されるデータアクションパラメータ。データアクションパラメータは、データアクションの入力として使用される値を送信するために使用されます。データアクションパラメータは、オートメーションアクションを設定するときに追加できますが、**データ**タブで編集する必要があります。

#### 詳細設定
<a name="automations-actions-reference-invoke-data-action-properties-advanced-settings"></a>

`Invoke data action` アクションには、次の詳細設定が含まれます。
+ **ページサイズ:** 各クエリで取得するレコードの最大数。デフォルト値は 500 で、最大値は 3000 です。
+ **ページ分割トークン:** クエリから追加のレコードを取得するために使用されるトークン。たとえば、 `Page size`が 500 に設定されている場合、500 を超えるレコードがある場合、ページ分割トークンを後続のクエリに渡すと、次の 500 が取得されます。これ以上レコードやページが存在しない場合、トークンは未定義になります。

## Amazon S3: オブジェクトを配置する
<a name="automations-actions-reference-s3-put-object"></a>

`Amazon S3 PutObject` オペレーションを使用して、キー (ファイルパス) によって識別されるオブジェクトを指定された Amazon S3 バケットに追加します。

### プロパティ
<a name="automations-actions-reference-s3-put-object-properties"></a>

#### コネクタ
<a name="automations-actions-reference-s3-put-object-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-s3-put-object-properties-configuration"></a>

`PutObject` コマンドで使用する必須オプション。オプションは以下のとおりです:

**注記**  
`Amazon S3 PutObject` オペレーションの詳細については、*Amazon Simple Storage Service API リファレンス*の[PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)」を参照してください。
+ **バケット:** オブジェクトを配置する Amazon S3 バケットの名前。
+ **キー:** Amazon S3 バケットに入れるオブジェクトの一意の名前。
+ **本文:** Amazon S3 バケットに入れるオブジェクトの内容。

#### モック出力
<a name="automations-actions-reference-s3-put-object-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリケーションに対するコネクタレスポンスと同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon S3: オブジェクトを削除する
<a name="automations-actions-reference-s3-delete-object"></a>

`Amazon S3 DeleteObject` オペレーションを使用して、指定された Amazon S3 バケットからキー (ファイルパス) によって識別されるオブジェクトを削除します。

### プロパティ
<a name="automations-actions-reference-s3-delete-object-properties"></a>

#### コネクタ
<a name="automations-actions-reference-s3-delete-object-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-s3-delete-object-properties-configuration"></a>

`DeleteObject` コマンドで使用する必須オプション。オプションは以下のとおりです:

**注記**  
`Amazon S3 DeleteObject` オペレーションの詳細については、*Amazon Simple Storage Service API リファレンス*の[DeleteObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)」を参照してください。
+ **バケット:** オブジェクトを削除する Amazon S3 バケットの名前。
+ **キー:** Amazon S3 バケットから削除するオブジェクトの一意の名前。

#### モック出力
<a name="automations-actions-reference-s3-delete-object-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリケーションに対するコネクタレスポンスと同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon S3: オブジェクトの取得
<a name="automations-actions-reference-s3-get-object"></a>

`Amazon S3 GetObject` オペレーションを使用して、指定された Amazon S3 バケットからキー (ファイルパス) によって識別されるオブジェクトを取得します。

### プロパティ
<a name="automations-actions-reference-s3-get-object-properties"></a>

#### コネクタ
<a name="automations-actions-reference-s3-get-object-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-s3-get-object-properties-configuration"></a>

`GetObject` コマンドで使用する必須オプション。オプションは以下のとおりです:

**注記**  
`Amazon S3 GetObject` オペレーションの詳細については、*Amazon Simple Storage Service API リファレンス*の[GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)」を参照してください。
+ **バケット:** オブジェクトを取得する Amazon S3 バケットの名前。
+ **キー:** Amazon S3 バケットから取得するオブジェクトの一意の名前。

#### モック出力
<a name="automations-actions-reference-s3-get-object-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリケーションに対するコネクタレスポンスと同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon S3: オブジェクトを一覧表示する
<a name="automations-actions-reference-s3-list-objects"></a>

`Amazon S3 ListObjects` オペレーションを使用して、指定された Amazon S3 バケット内のオブジェクトを一覧表示します。

### プロパティ
<a name="automations-actions-reference-s3-list-objects-properties"></a>

#### コネクタ
<a name="automations-actions-reference-s3-list-objects-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-s3-list-objects-properties-configuration"></a>

`ListObjects` コマンドで使用する必須オプション。オプションは以下のとおりです:

**注記**  
`Amazon S3 ListObjects` オペレーションの詳細については、*Amazon Simple Storage Service API リファレンス*の[ListObjects](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html)」を参照してください。
+ **バケット:** オブジェクトを一覧表示する Amazon S3 バケットの名前。

#### モック出力
<a name="automations-actions-reference-s3-list-objects-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリケーションに対するコネクタレスポンスと同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon Textract: ドキュメントを分析する
<a name="automations-actions-reference-textract-analyze-document"></a>

`Amazon Textract AnalyzeDocument` オペレーションを使用して、検出された項目間の関係について入力ドキュメントを分析します。

### プロパティ
<a name="automations-actions-reference-textract-analyze-document-properties"></a>

#### コネクタ
<a name="automations-actions-reference-textract-analyze-document-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-textract-analyze-document-properties-configuration"></a>

`AnalyzeDocument` コマンドで使用するリクエストの内容。オプションは以下のとおりです:

**注記**  
`Amazon Textract AnalyzeDocument` オペレーションの詳細については、*「Amazon Textract デベロッパーガイド*」の[AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeDocument.html)」を参照してください。
+ **ドキュメント/S3Object/バケット:** Amazon S3 バケットの名前。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **ドキュメント/S3Object/名前:** 入力ドキュメントのファイル名。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **ドキュメント/S3Object/バージョン:** Amazon S3 バケットでバージョニングが有効になっている場合は、オブジェクトのバージョンを指定できます。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **FeatureTypes:** 実行する分析のタイプのリスト。有効な値は、`TABLES`、`FORMS`、`QUERIES`、`SIGNATURES`、`LAYOUT` です。

#### モック出力
<a name="automations-actions-reference-textract-analyze-document-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリケーションに対するコネクタレスポンスと同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon Textract: 経費を分析する
<a name="automations-actions-reference-textract-analyze-expense"></a>

`Amazon Textract AnalyzeExpense` オペレーションを使用して、テキスト間の財務関係について入力ドキュメントを分析します。

### プロパティ
<a name="automations-actions-reference-textract-analyze-expense-properties"></a>

#### コネクタ
<a name="automations-actions-reference-textract-analyze-expense-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-textract-analyze-expense-properties-configuration"></a>

`AnalyzeExpense` コマンドで使用するリクエストの内容。オプションは以下のとおりです:

**注記**  
`Amazon Textract AnalyzeExpense` オペレーションの詳細については、*「Amazon Textract デベロッパーガイド*」の[AnalyzeExpense](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeExpense.html)」を参照してください。
+ **ドキュメント/S3Object/バケット:** Amazon S3 バケットの名前。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **Document / S3Object / Name:** 入力ドキュメントのファイル名。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **ドキュメント/S3Object/バージョン:** Amazon S3 バケットでバージョニングが有効になっている場合は、オブジェクトのバージョンを指定できます。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。

#### モック出力
<a name="automations-actions-reference-textract-analyze-expense-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、コネクタレスポンスがライブ環境で公開されたアプリケーションの場合と同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon Textract: ID を分析する
<a name="automations-actions-reference-textract-analyze-id"></a>

`Amazon Textract AnalyzeID` オペレーションを使用して、ID ドキュメントの関連情報を分析します。

### プロパティ
<a name="automations-actions-reference-textract-analyze-id-properties"></a>

#### コネクタ
<a name="automations-actions-reference-textract-analyze-id-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-textract-analyze-id-properties-configuration"></a>

`AnalyzeID` コマンドで使用するリクエストの内容。オプションは以下のとおりです:

**注記**  
`Amazon Textract AnalyzeID` オペレーションの詳細については、*「Amazon Textract デベロッパーガイド*」の[AnalyzeID](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeID.html)」を参照してください。
+ **ドキュメント/S3Object/バケット:** Amazon S3 バケットの名前。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **ドキュメント/S3Object/名前:** 入力ドキュメントのファイル名。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **ドキュメント/S3Object/バージョン:** Amazon S3 バケットでバージョニングが有効になっている場合は、オブジェクトのバージョンを指定できます。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。

#### モック出力
<a name="automations-actions-reference-textract-analyze-id-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、コネクタレスポンスがライブ環境で公開されたアプリケーションの場合と同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon Textract: ドキュメントテキストを検出する
<a name="automations-actions-reference-textract-detect-document-text"></a>

`Amazon Textract DetectDocumentText` オペレーションを使用して、入力ドキュメント内のテキスト行とテキスト行を構成する単語を検出します。

### プロパティ
<a name="automations-actions-reference-textract-detect-document-text-properties"></a>

#### コネクタ
<a name="automations-actions-reference-textract-detect-document-text-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-textract-detect-document-text-properties-configuration"></a>

`DetectDocumentText` コマンドで使用するリクエストの内容。オプションは以下のとおりです:

**注記**  
`Amazon Textract DetectDocumentText` オペレーションの詳細については、*Amazon Textract *[DetectDocumentText](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)」を参照してください。
+ **ドキュメント / S3Object / バケット:** Amazon S3 バケットの名前。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **ドキュメント/S3Object/名前:** 入力ドキュメントのファイル名。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。
+ **ドキュメント/S3Object/バージョン:** Amazon S3 バケットでバージョニングが有効になっている場合は、オブジェクトのバージョンを指定できます。**S3 アップロード**コンポーネントを使用して アクションにファイルが渡された場合、このパラメータは空のままにすることができます。

#### モック出力
<a name="automations-actions-reference-textract-detect-document-text-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、コネクタレスポンスがライブ環境で公開されたアプリケーションの場合と同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon Bedrock: GenAI プロンプト
<a name="automations-actions-reference-bedrock-prompt"></a>

[Amazon Bedrock InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) オペレーションを使用して、アクションプロパティで指定されたプロンプトパラメータと推論パラメータを使用して推論を実行します。アクションは、テキスト、イメージ、埋め込みを生成できます。

### プロパティ
<a name="automations-actions-reference-bedrock-prompt-properties"></a>

#### コネクタ
<a name="automations-actions-reference-bedrock-prompt-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。このアクションを正常に使用するには、**Amazon Bedrock ランタイム**をサービスとしてコネクタを設定する必要があります。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### モデル
<a name="automations-actions-reference-bedrock-prompt-properties-model"></a>

Amazon Bedrock がリクエストを処理するために使用される基盤モデル。Amazon Bedrock のモデルの詳細については、[「Amazon Bedrock ユーザーガイド」の「Amazon Bedrock 基盤モデル情報](https://docs.aws.amazon.com/bedrock/latest/userguide/foundation-models-reference.html)」を参照してください。 **

#### 入力タイプ
<a name="automations-actions-reference-bedrock-prompt-properties-input-type"></a>

Amazon Bedrock モデルに送信する入力の入力タイプ。指定できる値は、**テキスト**、**ドキュメント**、**イメージ**です。入力タイプを選択できない場合、設定されたモデルではサポートされていない可能性があります。

#### ユーザープロンプト
<a name="automations-actions-reference-bedrock-prompt-properties-user-prompt"></a>

レスポンスを生成するために処理する Amazon Bedrock モデルに送信するプロンプト。静的テキストを入力するか、パラメータを使用したコンポーネント、オートメーションの以前のアクション、または別のオートメーションなど、アプリケーションの別の部分から入力を渡すことができます。次の例は、コンポーネントまたは以前のアクションから値を渡す方法を示しています。
+ パラメータを使用してコンポーネントから値を渡すには: `{{params.paramName}}`
+ 前のアクションから値を渡すには: `{{results.actionName}}`

#### システムプロンプト (Claude モデル)
<a name="automations-actions-reference-bedrock-prompt-properties-system-prompt"></a>

リクエストの処理時に Amazon Bedrock モデルで使用されるシステムプロンプト。システムプロンプトは、Claude モデルにコンテキスト、手順、またはガイドラインを提供するために使用されます。

#### リクエスト設定
<a name="automations-actions-reference-bedrock-prompt-properties-request-settings"></a>

さまざまなリクエスト設定とモデル推論パラメータを設定します。以下の設定を設定できます。
+ **温度**: リクエストの処理時に Amazon Bedrock モデルで使用される温度。温度によって、Bedrock モデルの出力のランダム性または創造性が決まります。温度が高いほど、レスポンスはよりクリエイティブで分析性が低くなります。指定できる値は です`[0-10]`。
+ **最大トークン**: Amazon Bedrock モデルの出力の長さを制限します。
+ **TopP**: nucleus サンプリングでは、モデルは後続の各トークンのすべてのオプションに対する累積分布を確率の降順で計算し、**TopP** で指定された特定の確率に達すると切り捨てます。**温度**または **TopP** のいずれかを変更する必要がありますが、両方を変更することはできません
+ **Stop Sequences**: モデルがリクエストの処理と出力の生成を停止するシーケンス。

詳細については、*「Amazon Bedrock* [ユーザーガイド」の「基盤モデルの推論リクエストパラメータとレスポンスフィールド](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html)」を参照してください。

#### 停止シーケンス
<a name="automations-actions-reference-bedrock-prompt-properties-guardrail"></a>

Amazon Bedrock ガードレール **ID** と**バージョン**を入力します。ガードレールは、ユースケースと責任ある AI ポリシーに基づいて保護を実装するために使用されます。詳細については、[「Amazon Bedrock ユーザーガイド」の「Amazon Bedrock ガードレールを使用したモデルの有害なコンテンツの停止](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html)」を参照してください。 **

#### モック出力
<a name="automations-actions-reference-bedrock-prompt-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、コネクタレスポンスがライブ環境で公開されたアプリケーションの場合と同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## Amazon Bedrock: モデルを呼び出す
<a name="automations-actions-reference-bedrock-invoke-model"></a>

[Amazon Bedrock InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) オペレーションを使用して、リクエスト本文で指定されたプロンプトパラメータと推論パラメータを使用して推論を実行します。モデル推論を使用して、テキスト、イメージ、埋め込みを生成します。

### プロパティ
<a name="automations-actions-reference-bedrock-invoke-model-properties"></a>

#### コネクタ
<a name="automations-actions-reference-bedrock-invoke-model-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。このアクションを正常に使用するには、**Amazon Bedrock ランタイム**をサービスとしてコネクタを設定する必要があります。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-bedrock-invoke-model-properties-configuration"></a>

`InvokeModel` コマンドで使用するリクエストの内容。

**注記**  
コマンドの例を含む `Amazon Bedrock InvokeModel`オペレーションの詳細については、*「Amazon Bedrock API* [InvokeModel](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)」を参照してください。

#### モック出力
<a name="automations-actions-reference-bedrock-invoke-model-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、コネクタレスポンスがライブ環境で公開されたアプリケーションの場合と同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。

## JavaScript
<a name="automations-actions-reference-javascript"></a>

カスタム JavaScript 関数を実行して、指定された値を返します。

**重要**  
App Studio は、サードパーティーまたはカスタム JavaScript ライブラリの使用をサポートしていません。

### プロパティ
<a name="automations-actions-reference-javascript-properties"></a>

#### ソースコード
<a name="automations-actions-reference-javascript-properties-source-code"></a>

アクションによって実行される JavaScript コードスニペット。

**ヒント**  
AI を使用して、次の手順を実行して JavaScript を生成できます。  
展開アイコンを選択して、展開された JavaScript エディタを開きます。
(オプション): **コードの変更**トグルを有効にして、既存の JavaScript を変更します。それ以外の場合、AI は既存の JavaScript を置き換えます。
**JavaScript の生成**で、JavaScript で何をするかを記述します。例: **Add two numbers**。
送信アイコンを選択して JavaScript を生成します。

## オートメーションを呼び出す
<a name="automations-actions-reference-invoke-automation"></a>

指定されたオートメーションを実行します。

### プロパティ
<a name="automations-actions-reference-invoke-automation-properties"></a>

#### 自動化を呼び出す
<a name="automations-actions-reference-invoke-automation-properties-invoke-automation"></a>

アクションによって実行されるオートメーション。

## E メールの送信
<a name="automations-actions-reference-send-email"></a>

`Amazon SES SendEmail` オペレーションを使用して E メールを送信します。

### プロパティ
<a name="automations-actions-reference-send-email-properties"></a>

#### コネクタ
<a name="automations-actions-reference-send-email-properties-connector"></a>

このアクションによって実行されるオペレーションに使用されるコネクタ。設定済みコネクタは、オペレーションを実行するための適切な認証情報と、オペレーションで参照されるリソースを含む AWS リージョンなどのその他の設定情報を使用して設定する必要があります。

#### 設定
<a name="automations-actions-reference-send-email-properties-configuration"></a>

`SendEmail` コマンドで使用するリクエストの内容。オプションは以下のとおりです:

**注記**  
`Amazon SES SendEmail` オペレーションの詳細については、*Amazon Simple Email Service API リファレンス*の[SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)」を参照してください。

#### モック出力
<a name="automations-actions-reference-send-email-properties-mocked-output"></a>

アクションは、プレビュー環境の外部サービスまたはリソースとやり取りしません。**モック出力**フィールドは、テスト目的でプレビュー環境のコネクタの動作をシミュレートする JSON 式を提供するために使用されます。このスニペットは、ライブ環境で公開されたアプリケーションに対するコネクタレスポンスと同様に、アクションの`results`マップに保存されます。

このフィールドを使用すると、コネクタを介して外部サービスと通信することなく、さまざまな結果値、エラーシナリオ、エッジケース、不満のあるパスのシミュレートなど、オートメーション内の他のアクションに対するさまざまなシナリオとその影響をテストできます。