Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Informazioni di riferimento relative alle operazioni di automazione
<a name="automations-actions-reference"></a>

Di seguito è riportata la documentazione di riferimento per le azioni di automazione utilizzate in App Studio.

Un'azione di automazione, comunemente denominata **azione**, è un singolo passaggio della logica che costituisce un'automazione. Ogni azione esegue un'attività specifica, che si tratti di inviare un'e-mail, creare un record di dati, richiamare una funzione Lambda o chiamare. APIs Le azioni vengono aggiunte alle automazioni dalla libreria di azioni e possono essere raggruppate in istruzioni condizionali o cicli.

Per informazioni sulla creazione e la configurazione delle automazioni e sulle relative azioni, consulta gli argomenti in. [Automazioni e azioni: definisci la logica di business della tua app](automations.md)

## Invoca l'API
<a name="automations-actions-reference-invoke-API"></a>

Richiama una richiesta API REST HTTP. I costruttori possono utilizzare questa azione per inviare richieste da App Studio ad altri sistemi o servizi con. APIs Ad esempio, puoi utilizzarla per connetterti a sistemi di terze parti o applicazioni sviluppate internamente per accedere a dati aziendali critici o richiamare endpoint API che non possono essere richiamati da azioni dedicate di App Studio.

[Per ulteriori informazioni su REST APIs, consulta Cos'è un'API? RESTful ](https://aws.amazon.com/what-is/restful-api/) .

### Properties
<a name="automations-actions-reference-invoke-API-properties"></a>

#### Connector
<a name="automations-actions-reference-invoke-API-properties-connector"></a>

Il **connettore** da utilizzare per le richieste API effettuate da questa azione. L'elenco a discesa dei connettori contiene solo connettori dei seguenti tipi: `API Connector` e`OpenAPI Connector`. A seconda di come è configurato, il connettore può contenere informazioni importanti come credenziali e intestazioni predefinite o parametri di query.

Per ulteriori informazioni sui connettori API, incluso un confronto tra l'utilizzo `API Connector` e`OpenAPI Connector`, vedere. [Connect a servizi di terze parti](add-connector-third-party.md)

#### Proprietà di configurazione delle richieste API
<a name="automations-actions-reference-invoke-API-properties-request-config"></a>

Scegliete **Configura richiesta API** dal pannello delle proprietà per aprire la finestra di dialogo di configurazione della richiesta. Se è selezionato un **connettore API**, la finestra di dialogo includerà le informazioni sul connettore.

**Metodo:** il metodo per la chiamata API. I valori possibili sono i seguenti:
+ `DELETE`: elimina una risorsa specificata.
+ `GET`: recupera informazioni o dati.
+ `HEAD`: recupera solo le intestazioni di una risposta senza il corpo.
+ `POST`: invia i dati da elaborare.
+ `PUSH`: invia i dati da elaborare.
+ `PATCH`: aggiorna parzialmente una risorsa specificata.

**Percorso:** il percorso relativo alla risorsa.

**Intestazioni:** qualsiasi intestazione sotto forma di coppie chiave-valore da inviare con la richiesta API. Se viene selezionato un connettore, le relative intestazioni configurate verranno aggiunte automaticamente e non possono essere rimosse. Le intestazioni configurate non possono essere modificate, ma è possibile sostituirle aggiungendo un'altra intestazione con lo stesso nome.

**Parametri di query:** qualsiasi parametro di query sotto forma di coppie chiave-valore da inviare con la richiesta API. Se viene selezionato un connettore, i relativi parametri di interrogazione configurati verranno aggiunti automaticamente e non possono essere modificati o rimossi.

**Corpo:** informazioni da inviare con la richiesta API in formato JSON. Non esiste un corpo per `GET` le richieste.

#### Output simulato
<a name="automations-actions-reference-invoke-API-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Invoca AWS
<a name="automations-actions-reference-invoke-aws"></a>

Richiama un'operazione da un servizio. AWS Si tratta di un'azione generale per chiamare AWS servizi o operazioni e deve essere utilizzata se non esiste un'azione dedicata per il AWS servizio o l'operazione desiderati.

### Properties
<a name="automations-actions-reference-invoke-aws-properties"></a>

#### Servizio
<a name="automations-actions-reference-invoke-aws-properties-service"></a>

Il AWS servizio che contiene l'operazione da eseguire.

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

L'operazione da eseguire.

#### Connector
<a name="automations-actions-reference-invoke-aws-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

L'input JSON da utilizzare quando si esegue l'operazione specificata. Per ulteriori informazioni sulla configurazione degli input per AWS le operazioni, consulta. [AWS SDK per JavaScript](https://docs.aws.amazon.com/sdk-for-javascript)

## Invoca Lambda
<a name="automations-actions-reference-invoke-lambda"></a>

Richiama una funzione Lambda esistente.

### Properties
<a name="automations-actions-reference-invoke-lambda-properties"></a>

#### Connector
<a name="automations-actions-reference-invoke-lambda-properties-connector"></a>

Il connettore da utilizzare per le funzioni Lambda eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per accedere alla funzione Lambda e altre informazioni di configurazione, come AWS la regione che contiene la funzione Lambda. Per ulteriori informazioni sulla configurazione di un connettore per Lambda, vedere. [Fase 3: Creare un connettore Lambda](connectors-lambda.md#connectors-lambda-create-connector)

#### Nome funzione
<a name="automations-actions-reference-invoke-lambda-properties-function-name"></a>

Il nome della funzione Lambda da eseguire. Tieni presente che questo è il nome della funzione e non la funzione ARN (Amazon Resource Name).

#### Evento della funzione
<a name="automations-actions-reference-invoke-lambda-properties-function-event"></a>

Coppie chiave-valore da passare alla funzione Lambda come payload dell'evento.

#### Output simulato
<a name="automations-actions-reference-invoke-lambda-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Loop
<a name="automations-actions-reference-loop"></a>

Esegue ripetutamente azioni annidate per scorrere un elenco di elementi, un elemento alla volta. Ad esempio, aggiungi l'[Crea record](#automations-actions-reference-create-record)azione a un'azione di loop per creare più record.

L'azione di loop può essere annidata all'interno di altri loop o azioni condizionali. Le azioni del ciclo vengono eseguite in sequenza e non in parallelo. È possibile accedere ai risultati di ogni azione all'interno del ciclo solo alle azioni successive all'interno della stessa iterazione del ciclo. Non è possibile accedervi all'esterno del ciclo o in diverse iterazioni del ciclo.

### Properties
<a name="automations-actions-reference-loop-properties"></a>

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

L'elenco degli elementi da esaminare, un elemento alla volta. L'origine può essere il risultato di un'azione precedente o di un elenco statico di stringhe, numeri o oggetti che è possibile fornire utilizzando un' JavaScript espressione.

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

L'elenco seguente contiene esempi di input di origine.
+ Risultati di un'azione precedente: `{{results.actionName.data}}`
+ Un elenco di numeri: `{{[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]}}`
+ Un elenco di stringhe: `{{["apple", "banana", "orange", "grape", "kiwi"]}}`
+ Un valore calcolato: `{{params.actionName.split("\n")}}`

#### Nome dell'articolo corrente
<a name="automations-actions-reference-loop-properties-function-name"></a>

Il nome della variabile che può essere utilizzata per fare riferimento all'elemento corrente in fase di iterazione. Il nome dell'elemento corrente è configurabile in modo da poter annidare due o più loop e accedere alle variabili da ciascun ciclo. Ad esempio, se stai esplorando paesi e città con due loop, puoi configurare e fare riferimento a e. `currentCountry` `currentCity`

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

Esegue azioni in base al risultato di una o più condizioni logiche specificate che vengono valutate quando viene eseguita l'automazione. L'azione di condizione è composta dai seguenti componenti:
+ Un campo di *condizione*, utilizzato per fornire un' JavaScript espressione che restituisce `true` o`false`.
+ Un *vero ramo*, che contiene le azioni che vengono eseguite se la condizione restituisce a. `true`
+ Un *ramo falso*, che contiene le azioni che vengono eseguite se la condizione restituisce a. `false`

Aggiungi azioni ai rami vero e falso trascinandole nell'azione della condizione.

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

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

L' JavaScript espressione da valutare quando viene eseguita l'azione.

## Crea record
<a name="automations-actions-reference-create-record"></a>

Crea un record in un'entità App Studio esistente.

### Properties
<a name="automations-actions-reference-create-record-properties"></a>

#### Entità
<a name="automations-actions-reference-create-record-properties-entity"></a>

L'entità in cui deve essere creato un record. Una volta selezionata un'entità, è necessario aggiungere valori ai campi dell'entità per creare il record. I tipi di campi e se i campi sono obbligatori o facoltativi sono definiti nell'entità.

## Aggiorna record
<a name="automations-actions-reference-update-record"></a>

Aggiorna un record esistente in un'entità App Studio.

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

#### Entità
<a name="automations-actions-reference-update-record-properties-entity"></a>

L'entità che contiene i record da aggiornare.

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

I criteri che definiscono quali record vengono aggiornati dall'azione. È possibile raggruppare le condizioni per creare un'unica dichiarazione logica. È possibile combinare gruppi o condizioni con le `OR` istruzioni `AND` or.

#### Campi
<a name="automations-actions-reference-update-record-properties-fields"></a>

I campi da aggiornare nei record specificati dalle condizioni.

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

I valori da aggiornare nei campi specificati.

## Eliminare il record
<a name="automations-actions-reference-delete-record"></a>

Elimina un record da un'entità App Studio.

### Properties
<a name="automations-actions-reference-delete-record-properties"></a>

#### Entità
<a name="automations-actions-reference-delete-record-properties-entity"></a>

L'entità che contiene i record da eliminare.

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

I criteri che definiscono quali record vengono eliminati dall'azione. È possibile raggruppare le condizioni per creare un'unica istruzione logica. È possibile combinare gruppi o condizioni con le `OR` istruzioni `AND` or.

## Invoca un'azione sui dati
<a name="automations-actions-reference-invoke-data-action"></a>

Esegue un'azione sui dati con parametri opzionali.

### Properties
<a name="automations-actions-reference-invoke-data-action-properties"></a>

#### Azione sui dati
<a name="automations-actions-reference-invoke-data-action-properties-data-action"></a>

L'azione sui dati che deve essere eseguita dall'azione.

#### Parameters
<a name="automations-actions-reference-invoke-data-action-properties-parameters"></a>

Parametri dell'azione dati che devono essere utilizzati dall'azione dati. I parametri di azione dei dati vengono utilizzati per inviare valori che vengono utilizzati come input per le azioni sui dati. I parametri di azione dei dati possono essere aggiunti durante la configurazione dell'azione di automazione, ma devono essere modificati nella scheda **Dati**.

#### Impostazioni avanzate
<a name="automations-actions-reference-invoke-data-action-properties-advanced-settings"></a>

L'`Invoke data action`azione contiene le seguenti impostazioni avanzate:
+ **Dimensione della pagina:** il numero massimo di record da recuperare in ogni query. Il valore predefinito è 500 e il valore massimo è 3000.
+ **Token di impaginazione:** il token utilizzato per recuperare record aggiuntivi da una query. Ad esempio, se `Page size` è impostato su 500, ma ci sono più di 500 record, passando il token di impaginazione a una query successiva verranno recuperati i 500 successivi. Il token non sarà definito se non esistono più record o pagine.

## Amazon S3: oggetto Put
<a name="automations-actions-reference-s3-put-object"></a>

Utilizza l'`Amazon S3 PutObject`operazione per aggiungere un oggetto identificato da una chiave (percorso del file) a un bucket Amazon S3 specificato.

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

#### Connector
<a name="automations-actions-reference-s3-put-object-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Le opzioni richieste da utilizzare nel comando. `PutObject` Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon S3 PutObject`operazione, consulta il *riferimento [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)all'API di Amazon Simple Storage Service*.
+ **Bucket:** il nome del bucket Amazon S3 in cui inserire un oggetto.
+ **Chiave:** il nome univoco dell'oggetto da inserire nel bucket Amazon S3.
+ **Corpo:** il contenuto dell'oggetto da inserire nel bucket Amazon S3.

#### Output simulato
<a name="automations-actions-reference-s3-put-object-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon S3: eliminare un oggetto
<a name="automations-actions-reference-s3-delete-object"></a>

Utilizza l'`Amazon S3 DeleteObject`operazione per eliminare un oggetto identificato da una chiave (percorso del file) da un bucket Amazon S3 specificato.

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

#### Connector
<a name="automations-actions-reference-s3-delete-object-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Le opzioni richieste da utilizzare nel comando. `DeleteObject` Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon S3 DeleteObject`operazione, consulta il *riferimento [DeleteObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)all'API di Amazon Simple Storage Service*.
+ **Bucket:** il nome del bucket Amazon S3 da cui eliminare un oggetto.
+ **Chiave:** il nome univoco dell'oggetto da eliminare dal bucket Amazon S3.

#### Output simulato
<a name="automations-actions-reference-s3-delete-object-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon S3: ottieni oggetto
<a name="automations-actions-reference-s3-get-object"></a>

Utilizza l'`Amazon S3 GetObject`operazione per recuperare un oggetto identificato da una chiave (percorso del file) da un bucket Amazon S3 specificato.

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

#### Connector
<a name="automations-actions-reference-s3-get-object-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Le opzioni richieste da utilizzare nel comando. `GetObject` Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon S3 GetObject`operazione, consulta il *riferimento [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)all'API di Amazon Simple Storage Service*.
+ **Bucket:** il nome del bucket Amazon S3 da cui recuperare un oggetto.
+ **Chiave:** il nome univoco dell'oggetto da recuperare dal bucket Amazon S3.

#### Output simulato
<a name="automations-actions-reference-s3-get-object-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon S3: elenca oggetti
<a name="automations-actions-reference-s3-list-objects"></a>

Utilizza l'`Amazon S3 ListObjects`operazione per elencare gli oggetti in un bucket Amazon S3 specificato.

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

#### Connector
<a name="automations-actions-reference-s3-list-objects-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Le opzioni richieste da utilizzare nel comando. `ListObjects` Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon S3 ListObjects`operazione, consulta il *riferimento [ListObjects](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html)all'API di Amazon Simple Storage Service*.
+ **Bucket: il nome del bucket** Amazon S3 da cui elencare gli oggetti.

#### Output simulato
<a name="automations-actions-reference-s3-list-objects-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon Textract: analizza il documento
<a name="automations-actions-reference-textract-analyze-document"></a>

Utilizza l'`Amazon Textract AnalyzeDocument`operazione per analizzare un documento di input per verificare le relazioni tra gli elementi rilevati.

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

#### Connector
<a name="automations-actions-reference-textract-analyze-document-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Il contenuto della richiesta da utilizzare nel `AnalyzeDocument` comando. Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon Textract AnalyzeDocument`operazione, consulta [AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeDocument.html)la *Amazon Textract Developer* Guide.
+ **Document/S3Object/Bucket: il nome del bucket** Amazon S3. **Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento S3.**
+ **Document/S3Object/Name: il nome** del file del documento di input. Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento **S3**.
+ **Document/S3Object/Version:** se il bucket Amazon S3 ha il controllo delle versioni abilitato, puoi specificare la versione dell'oggetto. **Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento S3.**
+ **FeatureTypes:** Un elenco dei tipi di analisi da eseguire. I valori validi sono: `TABLES`, `FORMS`, `QUERIES`, `SIGNATURES` e `LAYOUT`.

#### Output simulato
<a name="automations-actions-reference-textract-analyze-document-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon Textract: analizza le spese
<a name="automations-actions-reference-textract-analyze-expense"></a>

Utilizza l'`Amazon Textract AnalyzeExpense`operazione per analizzare un documento di input per verificare le relazioni finanziarie tra il testo.

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

#### Connector
<a name="automations-actions-reference-textract-analyze-expense-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Il contenuto della richiesta da utilizzare nel `AnalyzeExpense` comando. Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon Textract AnalyzeExpense`operazione, consulta [AnalyzeExpense](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeExpense.html)la *Amazon Textract Developer* Guide.
+ **Document/S3Object/Bucket: il nome del bucket** Amazon S3. **Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento S3.**
+ **Document/S3Object/Name: il nome** del file del documento di input. Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento **S3**.
+ **Document/S3Object/Version:** se il bucket Amazon S3 ha il controllo delle versioni abilitato, puoi specificare la versione dell'oggetto. **Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento S3.**

#### Output simulato
<a name="automations-actions-reference-textract-analyze-expense-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon Textract: analizza l'ID
<a name="automations-actions-reference-textract-analyze-id"></a>

Utilizza l'`Amazon Textract AnalyzeID`operazione per analizzare un documento di identità alla ricerca di informazioni pertinenti.

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

#### Connector
<a name="automations-actions-reference-textract-analyze-id-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Il contenuto della richiesta da utilizzare nel `AnalyzeID` comando. Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon Textract AnalyzeID`operazione, consulta [AnalyzeID](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeID.html) nella *Amazon Textract Developer* Guide.
+ **Document/S3Object/Bucket: il nome del bucket** Amazon S3. **Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento S3.**
+ **Document/S3Object/Name: il nome** del file del documento di input. Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento **S3**.
+ **Document/S3Object/Version:** se il bucket Amazon S3 ha il controllo delle versioni abilitato, puoi specificare la versione dell'oggetto. **Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento S3.**

#### Output simulato
<a name="automations-actions-reference-textract-analyze-id-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon Textract: rileva il testo del documento
<a name="automations-actions-reference-textract-detect-document-text"></a>

Utilizza l'`Amazon Textract DetectDocumentText`operazione per rilevare le righe di testo e le parole che compongono una riga di testo in un documento di input.

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

#### Connector
<a name="automations-actions-reference-textract-detect-document-text-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Il contenuto della richiesta da utilizzare nel `DetectDocumentText` comando. Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon Textract DetectDocumentText`operazione, consulta [DetectDocumentText](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)la *Amazon Textract Developer* Guide.
+ **Document/S3Object/Bucket: il nome del bucket** Amazon S3. **Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento S3.**
+ **Document/S3Object/Name: il nome** del file del documento di input. Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento **S3**.
+ **Document/S3Object/Version:** se il bucket Amazon S3 ha il controllo delle versioni abilitato, puoi specificare la versione dell'oggetto. **Questo parametro può essere lasciato vuoto se un file viene passato all'azione con il componente di caricamento S3.**

#### Output simulato
<a name="automations-actions-reference-textract-detect-document-text-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon Bedrock: GenAI Prompt
<a name="automations-actions-reference-bedrock-prompt"></a>

Utilizza l' InvokeModeloperazione [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) per eseguire l'inferenza utilizzando i parametri di prompt e inferenza forniti nelle proprietà dell'azione. L'azione può generare testo, immagini e incorporamenti.

### Properties
<a name="automations-actions-reference-bedrock-prompt-properties"></a>

#### Connector
<a name="automations-actions-reference-bedrock-prompt-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Per utilizzare correttamente questa azione, il connettore deve essere configurato con **Amazon Bedrock Runtime** come servizio. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene tutte le risorse a cui si fa riferimento nell'operazione.

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

Il modello base che verrà utilizzato da Amazon Bedrock per elaborare la richiesta. Per ulteriori informazioni sui modelli in Amazon Bedrock, consulta le [informazioni sul modello Amazon Bedrock Foundation](https://docs.aws.amazon.com/bedrock/latest/userguide/foundation-models-reference.html) nella *Amazon Bedrock User Guide*.

#### Tipo di input
<a name="automations-actions-reference-bedrock-prompt-properties-input-type"></a>

Il tipo di input dell'input inviato al modello Amazon Bedrock. I valori possibili sono **Text**, **Document** e **Image**. Se un tipo di input non è disponibile per la selezione, probabilmente non è supportato dal modello configurato.

#### Richiesta dell'utente
<a name="automations-actions-reference-bedrock-prompt-properties-user-prompt"></a>

Il prompt da inviare al modello Amazon Bedrock da elaborare per generare una risposta. Puoi inserire testo statico o trasmettere un input da un'altra parte dell'applicazione, ad esempio da un componente che utilizza parametri, un'azione precedente nell'automazione o un'altra automazione. Gli esempi seguenti mostrano come passare un valore da un componente o da un'azione precedente:
+ Per passare un valore da un componente utilizzando i parametri: `{{params.paramName}}`
+ Per passare un valore da un'azione precedente: `{{results.actionName}}`

#### Prompt di sistema (modelli Claude)
<a name="automations-actions-reference-bedrock-prompt-properties-system-prompt"></a>

Il prompt di sistema che deve essere utilizzato dal modello Amazon Bedrock durante l'elaborazione della richiesta. Il prompt di sistema viene utilizzato per fornire contesto, istruzioni o linee guida ai modelli Claude.

#### Impostazioni della richiesta
<a name="automations-actions-reference-bedrock-prompt-properties-request-settings"></a>

Configura varie impostazioni di richiesta e parametri di inferenza del modello. Ora puoi configurare le impostazioni seguenti:
+ **Temperatura**: la temperatura che deve essere utilizzata dal modello Amazon Bedrock durante l'elaborazione della richiesta. La temperatura determina la casualità o la creatività dell'output del modello Bedrock. Più alta è la temperatura, più creativa e meno analitica sarà la risposta. I valori possibili sono`[0-10]`.
+ **Numero massimo di token**: limita la lunghezza dell'output del modello Amazon Bedrock.
+ **TopP****: nel campionamento del nucleo, il modello calcola la distribuzione cumulativa su tutte le opzioni per ogni token successivo in ordine di probabilità decrescente e la interrompe quando raggiunge una particolare probabilità specificata dal TopP.** ****È necessario modificare la temperatura o il TopP, ma non entrambi****
+ **Sequenze di arresto**: sequenze che causano l'interruzione dell'elaborazione della richiesta e della generazione dell'output da parte del modello.

Per ulteriori informazioni, consulta [i parametri della richiesta di inferenza e i campi di risposta per i modelli di base](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html) nella *Amazon Bedrock User Guide*.

#### Stop Sequences
<a name="automations-actions-reference-bedrock-prompt-properties-guardrail"></a>

**Inserisci un **ID** e una versione di Amazon Bedrock Guardrail.** I guardrail vengono utilizzati per implementare misure di protezione basate sui casi d'uso e sulle politiche di intelligenza artificiale responsabili. Per ulteriori informazioni, consulta [Blocca i contenuti dannosi nei modelli che utilizzano Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) nella *Amazon Bedrock* User Guide.

#### Output simulato
<a name="automations-actions-reference-bedrock-prompt-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

## Amazon Bedrock: modello Invoke
<a name="automations-actions-reference-bedrock-invoke-model"></a>

Utilizza l' InvokeModeloperazione [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) per eseguire l'inferenza utilizzando i parametri di prompt e inferenza forniti nel corpo della richiesta. Utilizzi l'inferenza del modello per generare testo, immagini e incorporamenti.

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

#### Connector
<a name="automations-actions-reference-bedrock-invoke-model-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Per utilizzare correttamente questa azione, il connettore deve essere configurato con **Amazon Bedrock Runtime** come servizio. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene tutte le risorse a cui si fa riferimento nell'operazione.

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

Il contenuto della richiesta da utilizzare nel `InvokeModel` comando.

**Nota**  
Per ulteriori informazioni sull'`Amazon Bedrock InvokeModel`operazione, inclusi i comandi di esempio, consulta [InvokeModel](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)*Amazon Bedrock API Reference*.

#### Output simulato
<a name="automations-actions-reference-bedrock-invoke-model-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.

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

Esegue una JavaScript funzione personalizzata per restituire un valore specificato.

**Importante**  
App Studio non supporta l'utilizzo di JavaScript librerie personalizzate o di terze parti.

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

#### Codice sorgente
<a name="automations-actions-reference-javascript-properties-source-code"></a>

Il frammento di JavaScript codice che deve essere eseguito dall'azione.

**Suggerimento**  
Puoi utilizzare l'intelligenza artificiale per aiutarti a generare JavaScript per te eseguendo i seguenti passaggi:  
Scegli l'icona di espansione per aprire l' JavaScript editor espanso.
(Facoltativo): abilita l'interruttore **Modifica codice** per modificare qualsiasi codice esistente. JavaScript Altrimenti, l'intelligenza artificiale sostituirà quella esistente. JavaScript
In **Generate JavaScript**, descrivi cosa vuoi fare JavaScript, per esempio:**Add two numbers**.
Scegli l'icona di invio per generare il tuo JavaScript.

## Invoca l'automazione
<a name="automations-actions-reference-invoke-automation"></a>

Esegue un'automazione specificata.

### Properties
<a name="automations-actions-reference-invoke-automation-properties"></a>

#### Invoca l'automazione
<a name="automations-actions-reference-invoke-automation-properties-invoke-automation"></a>

L'automazione che deve essere eseguita dall'azione.

## Invio di e-mail
<a name="automations-actions-reference-send-email"></a>

Utilizza l'`Amazon SES SendEmail`operazione per inviare un messaggio di posta elettronica.

### Properties
<a name="automations-actions-reference-send-email-properties"></a>

#### Connector
<a name="automations-actions-reference-send-email-properties-connector"></a>

Il connettore da utilizzare per le operazioni eseguite da questa azione. Il connettore configurato deve essere configurato con le credenziali appropriate per eseguire l'operazione e altre informazioni di configurazione, come la AWS regione che contiene le risorse a cui si fa riferimento nell'operazione.

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

Il contenuto della richiesta da utilizzare nel `SendEmail` comando. Le opzioni sono le seguenti:

**Nota**  
Per ulteriori informazioni sull'`Amazon SES SendEmail`operazione, consulta il *riferimento [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)all'API di Amazon Simple Email Service*.

#### Output simulato
<a name="automations-actions-reference-send-email-properties-mocked-output"></a>

Le azioni non interagiscono con servizi o risorse esterne nell'ambiente di anteprima. Il campo di **output Mocked** viene utilizzato per fornire un'espressione JSON che simula il comportamento di un connettore nell'ambiente di anteprima a scopo di test. Questo frammento è memorizzato nella `results` mappa dell'azione, proprio come lo sarebbe la risposta del connettore per un'app pubblicata nell'ambiente live.

Con questo campo, puoi testare vari scenari e il loro impatto su altre azioni all'interno dell'automazione, come la simulazione di diversi valori di risultato, scenari di errore, casi limite o percorsi non soddisfacenti senza comunicare con servizi esterni tramite connettori.