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à.
# Filtra, struttura ed elementi delle espressioni.
Questa sezione include informazioni sulla struttura delle espressioni di filtro e dei relativi elementi.
**Topics**
+ [Struttura delle espressioni di filtro](#filter-expression-structure)
+ [Filtrare gli elementi di espressione](#filter-expression-elements)
## Struttura delle espressioni di filtro
La struttura generale di un'espressione di filtro è la seguente:
```
EXCLUDE/INCLUDE ItemID/ActionID/UserID WHERE {{dataset type}}.{{field}} IN/NOT IN ({{value/parameter}})
```
È possibile creare manualmente espressioni di filtro o ottenere assistenza sulla sintassi e sulla struttura delle espressioni utilizzando il [generatore di espressioni](filter-real-time.md#using-filter-expression-builder) nella console.
## Filtrare gli elementi di espressione
Utilizzate i seguenti elementi per creare espressioni di filtro:
**INCLUDE o ESCLUDE**
`INCLUDE`Utilizzalo per limitare i consigli ai soli elementi che soddisfano i criteri di filtro *OPPURE* `EXCLUDE` per rimuovere tutti gli elementi che soddisfano i criteri di filtro.
**ItemID/ActionID/UserID**
Utilizzate uno di questi elementi dopo l'`EXCLUDE`elemento `INCLUDE` or. L'elemento utilizzato dipende dal fatto che stiate filtrando gli elementi (per i consigli sugli articoli), le azioni (per i consigli sulle azioni) o gli utenti (per i segmenti di utenti).
**WHERE**
`WHERE`Da utilizzare per verificare le condizioni relative a elementi, azioni o utenti. È necessario utilizzare l'`WHERE`elemento dopo `ItemID``ActionID`, o`UserID`.
**E/O**
Per concatenare più condizioni all'interno della stessa espressione di filtro, usa `AND` o`OR`. Condizioni concatenate utilizzando `AND` o `OR` possono influire solo sui campi del set di dati utilizzato nella prima condizione.
**Dataset.field**
Fornisci il set di dati e il campo di metadati in base ai quali desideri filtrare i consigli. `dataset` `field`formato. Ad esempio, per filtrare i consigli sugli articoli in base al campo genres nel set di dati Items, dovresti utilizzare items.genres nell'espressione di filtro.
**Condizione IF**
Usa una `IF` condizione *solo* per controllare le condizioni per `CurrentUser` e solo *una volta* alla fine di un'espressione. Tuttavia, è possibile estendere una `IF` condizione utilizzando`AND`.
**CurrentUser.attributo**
Per filtrare i consigli sugli articoli in base all'utente per cui li ricevi, utilizza `CurrentUser` e fornisci il campo utente *solo* in una condizione IF. Ad esempio, `CurrentUser.AGE`.
**CurrentItem.attributo**
Solo per articoli correlati, ricette e casi d'uso, usa`CurrentItem`. `attribute`per filtrare gli articoli in base a un attributo dell'articolo specificato nella richiesta di consigli sugli articoli correlati. Ad esempio `CurrentItem.GENRE` o `CurrentItem.PRICE`.
Puoi applicare un filtro con l' CurrentItem elemento solo se il caso d'uso del dominio o la ricetta personalizzata genera consigli sugli articoli correlati, come la ricetta Similar-Items o il caso d'uso del dominio *More Like X.* La prima volta che crei un filtro con un `CurrentItem` elemento, la creazione del filtro può richiedere alcuni minuti. Se si utilizza AWS KMS per la crittografia, la creazione del filtro può richiedere fino a 15 minuti.
**ENTRATA/NON DENTRO**
Usa `IN` or `NOT IN` come operatori di confronto per filtrare in base alla corrispondenza (o alla mancata corrispondenza) di uno o più valori di stringa. Amazon Personalize filtra solo su stringhe esatte.
**Operatori di confronto**
Usa =, <, <=, >, >= e\! = operatori per verificare l'uguaglianza dei dati numerici, inclusi i dati passati in un parametro segnaposto.
**Carattere asterisco (\*)**
`*`Da utilizzare per includere o escludere interazioni di tutti i tipi. Utilizzare `*` *solo* per le espressioni di filtro che utilizzano il `EVENT_TYPE` campo di un `Interactions` set di dati.
**Separatore di tubi**
Utilizzate il pipe separator (`|`) per concatenare più espressioni. Per ulteriori informazioni, consulta [Combinazione di più espressioni](multiple-expression-example.md).
**Parameters**
Per le espressioni che utilizzano operatori di confronto o l'`IN`operatore, utilizzate il simbolo del dollaro ($) e il nome di un parametro per aggiungere un parametro segnaposto come valore. Ad esempio, `$GENRES`. In questo esempio, quando ricevi consigli, fornisci il genere o i generi in base ai quali filtrare.
Il nome di un parametro viene definito quando lo si aggiunge a un'espressione. Il nome del parametro non deve necessariamente corrispondere al nome del campo. Si consiglia di utilizzare un nome di parametro simile al nome del campo e facile da ricordare. Si utilizza il nome del parametro (con distinzione tra maiuscole e minuscole) quando si applica il filtro alle richieste di consigli. Per un esempio che mostra come applicare un filtro con parametri segnaposto quando si utilizza l' AWS SDKS, consulta. [Applicare un filtro (AWS SDKs)](filter-real-time.md#applying-filter-sdk)