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à.

# Creazione di un flusso di lavoro di abbinamento basato su regole
<a name="creating-matching-workflow-rule-based"></a>

La *[corrispondenza basata su regole](glossary.md#rule-based-matching-defn)* è un insieme gerarchico di regole di corrispondenza a cascata, suggerite e basate sui dati che inserisci ed è completamente configurabile dall' AWS Entity Resolution utente. Il flusso di lavoro di abbinamento basato su regole consente di confrontare dati in chiaro o con hash per trovare corrispondenze esatte in base a criteri personalizzati.

Quando AWS Entity Resolution trova una corrispondenza tra due o più record nei dati, assegna:
+ Un [Match ID](glossary.md#match-id-defin) ai record nel set di dati corrispondente
+ La [regola Match](glossary.md#match-rule-defn) che ha generato la corrispondenza.

Quando crei un flusso di lavoro di abbinamento basato su regole in AWS Entity Resolution, devi scegliere un tipo di regola **semplice** o **avanzato**. Il tipo di regola determina la complessità delle condizioni delle regole che è possibile creare. Non è possibile modificare il tipo di regola dopo aver creato il flusso di lavoro.

È possibile utilizzare la tabella seguente per confrontare i due **tipi di regole** e determinare quale si adatta al proprio caso d'uso.


**Tabella di confronto dei tipi di regole**  

| Caso d’uso | Tipo di regola avanzata | Tipo di regola semplice | 
| --- |--- |--- |
| Mappature dello schema mappate con i tipi di input one-to-one | ![\[alt text not found\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/success_icon.svg) Sì | No | 
| --- |--- |--- |
| Mappatura dello schema con più colonne di dati mappate agli stessi tipi di input | ![\[alt text not found\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/negative_icon.svg) No | Sì | 
| --- |--- |--- |
| Supporta la corrispondenza esatta e fuzzy | ![\[alt text not found\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/success_icon.svg) Sì | No (solo abbinamento esatto) | 
| --- |--- |--- |
| Supporta gli operatori AND, OR e tra parentesi | ![\[alt text not found\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/success_icon.svg) Sì | No (solo operatore AND) | 
| --- |--- |--- |
| Supporta flussi di lavoro in batch | ![\[alt text not found\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/success_icon.svg) Sì | Sì | 
| --- |--- |--- |
| Supporta flussi di lavoro incrementali | ![\[alt text not found\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/success_icon.svg) Sì | Sì | 
| --- |--- |--- |
| Supporta flussi di lavoro in tempo reale | ![\[alt text not found\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/negative_icon.svg)No | Sì | 
| --- |--- |--- |
| Supporta i flussi di lavoro di mappatura degli ID | ![\[alt text not found\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/negative_icon.svg) No | Sì | 
| --- |--- |--- |

**Dopo aver determinato il tipo di regola da utilizzare, utilizza i seguenti argomenti per creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **Avanzata** o Semplice.**

**Topics**
+ [Creazione di un flusso di lavoro di abbinamento basato su regole con il tipo di regola Avanzata](rule-based-mw-advanced.md)
+ [Creazione di un flusso di lavoro di abbinamento basato su regole con il tipo di regola semplice](rule-based-mw-simple.md)

# Creazione di un flusso di lavoro di abbinamento basato su regole con il tipo di regola Avanzata
<a name="rule-based-mw-advanced"></a>

**Prerequisiti**

Prima di creare un flusso di lavoro di abbinamento basato su regole, devi:

1. Creare una mappatura dello schema. Per ulteriori informazioni, consulta [Creazione di una mappatura dello schema](create-schema-mapping.md).

1. Se utilizzi i profili dei clienti Amazon Connect come destinazione di output, assicurati di avere configurato le autorizzazioni appropriate.

La procedura seguente mostra come creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **Advanced** utilizzando la AWS Entity Resolution console o l'API. `CreateMatchingWorkflow`

------
#### [ Console ]

**Per creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **Advanced utilizzando la console****

1. Accedi a Console di gestione AWS e apri la AWS Entity Resolution console all'indirizzo. [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/)

1. Nel riquadro di navigazione a sinistra, in **Flussi di lavoro**, scegli **Corrispondenza**.

1. Nella pagina **Flussi di lavoro corrispondenti**, nell'angolo in alto a destra, scegli **Crea flusso di lavoro corrispondente**.

1. Per il **passaggio 1: Specificare i dettagli del flusso di lavoro corrispondente**, procedi come segue: 

   1. Immettete un **nome del flusso di lavoro corrispondente** e una **descrizione** opzionale.

   1. Per l'**immissione dei dati **Regione AWS****, scegli un **AWS Glue database**, la **AWS Glue tabella** e quindi la **mappatura dello schema** corrispondente.

      È possibile aggiungere fino a 19 input di dati.
**Nota**  
Per utilizzare le regole **avanzate**, le mappature dello schema devono soddisfare i seguenti requisiti:  
Ogni campo di input deve essere mappato su una chiave di corrispondenza univoca, a meno che i campi non siano raggruppati insieme.
Se i campi di input sono raggruppati, possono condividere la stessa chiave di abbinamento.  
Ad esempio, la seguente mappatura dello schema sarebbe valida per le regole **avanzate**:  
`firstName: { matchKey: 'name', groupName: 'name' }`  
`lastName: { matchKey: 'name', groupName: 'name' }`  
In questo caso, i `lastName` campi `firstName` and sono raggruppati e condividono la stessa chiave di corrispondenza del nome, che è consentita.  
**Rivedi le mappature dello schema e aggiornale per seguire questa regola di one-to-one corrispondenza, a meno che i campi non siano raggruppati correttamente, per utilizzare le regole avanzate.**
Se la tabella di dati ha una colonna DELETE, il tipo di mappatura dello schema deve essere `String` e non puoi avere un and. `matchKey` `groupName` 

   1. L'opzione **Normalizza dati** è selezionata per impostazione predefinita, in modo che gli input di dati vengano normalizzati prima della corrispondenza. **Se non desiderate normalizzare i dati, deselezionate l'opzione Normalizza dati.**
**Nota**  
**La normalizzazione è supportata solo per i seguenti scenari in Create schema mapping:**   
**Se i seguenti sottotipi di **nome** sono raggruppati: **Nome, Secondo nome, **Cognome****.**
**Se i seguenti sottotipi di **indirizzo** sono raggruppati: **Indirizzo 1**, **Indirizzo 2, Indirizzo** **3**, **Città**, **Stato, **Paese**, Codice** postale.**
**Se i seguenti sottotipi **di telefono** sono raggruppati: **Numero di telefono, Prefisso telefonico** del paese.**

   1. Per specificare le autorizzazioni **di accesso al servizio**, scegli un'opzione e intraprendi l'azione consigliata.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-advanced.html)

   1. (Facoltativo) Per abilitare i **tag** per la risorsa, scegliete **Aggiungi nuovo tag**, quindi immettete la coppia **Chiave** e **Valore**.

   1. Scegli **Next (Successivo)**.

1. Per la **fase 2: Scegli la tecnica di abbinamento**:

   1. Per il **metodo di abbinamento**, scegli Abbinamento **basato su regole**.

   1. **Per **Tipo di regola**, scegli Avanzato.**  
![\[Scegli la schermata della tecnica di abbinamento con l'opzione di abbinamento avanzato basato su regole selezionata.\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/choose-matching-method-rule-based-advanced.PNG)

   1. Per **Processing cadence**, selezionate una delle seguenti opzioni.
      + Scegliete **Manuale** per eseguire un flusso di lavoro su richiesta per un aggiornamento collettivo 
      + Scegli **Automatico** per eseguire un flusso di lavoro non appena nuovi dati sono presenti nel tuo bucket S3 
**Nota**  
Se scegli **Automatico**, assicurati di avere EventBridge le notifiche Amazon attivate per il tuo bucket S3. Per istruzioni su come abilitare Amazon EventBridge tramite la console S3, consulta [Enabling Amazon EventBridge nella Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) *S3* User Guide.

   1. Per **le regole di abbinamento**, inserisci un **nome per la regola** e quindi crea la **condizione della regola** scegliendo le funzioni e gli operatori di corrispondenza appropriati dall'elenco a discesa in base al tuo obiettivo.

      Puoi creare fino a 25 regole.

      ****È necessario combinare una funzione di corrispondenza fuzzy (**Cosine**, **Levenshtein** o **Soundex**) con una funzione di corrispondenza esatta (Exact) utilizzando l'operatore AND. **ExactManyToMany******

      È possibile utilizzare la tabella seguente per decidere quale tipo di funzione o operatore utilizzare, a seconda dell'obiettivo.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-advanced.html)  
**Example Condizione della regola che corrisponde ai numeri di telefono e all'e-mail**  

      Di seguito è riportato un esempio di condizione della regola che corrisponde ai record relativi ai numeri di telefono (**Phone** match key) e agli indirizzi e-mail (**Email address** match key):

      `Exact(Phone,EmptyValues=Process) AND Levenshtein("Email address",2)`  
![\[Esempio di condizione della regola che corrisponde ai record relativi a numeri di telefono e indirizzi e-mail.\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/matching-rule-condition-example.png)

      Il tasto **Phone** match utilizza la funzione **Exact** matching per abbinare stringhe identiche. Il tasto **Phone** match elabora i valori vuoti nella corrispondenza utilizzando il modificatore **EmptyValues=Process**.

      La chiave **Email address** match utilizza la funzione di corrispondenza di **Levenshtein** per abbinare i dati con errori di ortografia utilizzando la soglia predefinita dell'algoritmo Levenshtein Distance pari a 2. **La chiave Email match non utilizza alcun modificatore opzionale.**

      L'operatore **AND** combina la funzione **Exact** matching e la funzione di matching **Levenshtein**.  
**Example Condizione della regola utilizzata per eseguire la corrispondenza dei matchkey ExactManyToMany**  

      Di seguito è riportato un esempio di condizione della regola che abbina i record in tre campi dell'indirizzo (**HomeAddress**match key, **BillingAddress**match key e **ShippingAddress**match key) per trovare potenziali corrispondenze controllando se ce ne sono alcune con valori identici. 

      L'`ExactManyToMany`operatore valuta tutte le possibili combinazioni dei campi di indirizzo specificati per identificare le corrispondenze esatte tra due o più indirizzi. Ad esempio, rileva se gli indirizzi `HomeAddress` corrispondono a o a `BillingAddress` o `ShippingAddress` se tutti e tre gli indirizzi corrispondono esattamente.

      ```
      ExactManyToMany(HomeAddress, BillingAddress, ShippingAddress)
      ```  
**Example Condizione della regola che utilizza il clustering**  

      In Advanced Rule Based Matching with Fuzzy Conditions, il sistema raggruppa innanzitutto i record in cluster in base alle corrispondenze esatte. Una volta formati questi cluster iniziali, il sistema applica filtri di corrispondenza fuzzy per identificare corrispondenze aggiuntive all'interno di ciascun cluster. Per prestazioni ottimali, è necessario selezionare condizioni di corrispondenza esatte in base ai modelli di dati per creare cluster iniziali ben definiti. 

      Di seguito è riportato un esempio di condizione della regola che combina più corrispondenze esatte con un requisito di corrispondenza fuzzy. Utilizza `AND` gli operatori per verificare che tre campi`FullName`, Data di nascita (`DOB`) e`Address`, corrispondano esattamente tra i record. Consente inoltre piccole variazioni nel `InternalID` campo utilizzando una distanza di Levenshtein di. `1` La distanza di Levenshtein misura il numero minimo di modifiche a un carattere necessarie per modificare una stringa in un'altra. Una distanza pari a 1 significa `InternalIDs` che corrisponderà alla differenza di un solo carattere (ad esempio un singolo errore di battitura, cancellazione o inserimento). Questa combinazione di condizioni consente di identificare i record che molto probabilmente rappresentano la stessa entità, anche se vi sono piccole discrepanze nell'identificatore.

      ```
      Exact(FullName) AND Exact(DOB) AND Exact(Address) and Levenshtein(InternalID, 1)
      ```

   1. Scegli **Next (Successivo)**.

1. Per la **fase 3: Specificare l'output e il formato dei dati**:

   1. **Per **Destinazione e formato di output dei dati**, scegli la **posizione Amazon S3** per l'output dei dati e se il **formato dei dati** sarà Dati **normalizzati o Dati originali**.**

   1. Per la **crittografia**, se scegli di **personalizzare le impostazioni di crittografia**, inserisci la **AWS KMS chiave** ARN.

   1. Visualizza l'**output generato dal sistema**.

   1. Per l'**output dei dati**, decidi quali campi includere, nascondere o mascherare, quindi intraprendi le azioni consigliate in base ai tuoi obiettivi.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-advanced.html)

   1. Scegli **Next (Successivo)**.

1. Per il **passaggio 4: rivedi e crea**:

   1. Rivedi le selezioni effettuate per i passaggi precedenti e modificale se necessario.

   1. Scegli **Create and run** (Crea ed esegui).

      Viene visualizzato un messaggio che indica che il flusso di lavoro corrispondente è stato creato e che il processo è iniziato.

1. Nella pagina dei dettagli del flusso di lavoro corrispondente, nella scheda **Metriche**, visualizza quanto segue in **Metriche dell'ultimo lavoro**:
   + Il **Job ID**. 
   + **Lo **stato** del processo del flusso di lavoro corrispondente: In **coda, **In corso**, Completato****, Non riuscito**** 
   + Il **tempo di completamento** del processo del flusso di lavoro.
   + Il numero di **record elaborati**. 
   + Il numero di **record non elaborati**. 
   + La **corrispondenza unica IDs generata**.
   + Il numero di **record di input**.

   Puoi anche visualizzare le metriche dei job per i job corrispondenti ai job del flusso di lavoro che sono stati eseguiti in precedenza **nella cronologia Job**.

1. Una volta completato il processo del flusso di lavoro corrispondente (**lo stato** è **completato**), puoi andare alla scheda **Data output** e quindi selezionare la tua sede **Amazon S3** per visualizzare i risultati.

1. (Solo tipo di elaborazione **manuale**) Se hai creato un flusso di lavoro **corrispondente basato su regole** con il tipo di elaborazione **manuale**, puoi eseguire il flusso di lavoro corrispondente in qualsiasi momento selezionando Esegui flusso di lavoro nella pagina dei dettagli del **flusso di lavoro corrispondente**.

1. (Solo tipo di elaborazione **automatica**) Se la tabella di dati contiene una colonna DELETE, allora: 
   + I record impostati su *true* nella colonna DELETE vengono eliminati.
   + I record impostati *false* nella colonna DELETE vengono inseriti in S3.

   Per ulteriori informazioni, consulta [Fase 1: Preparare tabelle di dati di prime parti](prepare-input-data.md#prepare-first-party-tables).

------
#### [ API ]

**Per creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **Advanced utilizzando l'API****
**Nota**  
Per impostazione predefinita, il flusso di lavoro utilizza l'elaborazione standard (batch). Per utilizzare l'elaborazione incrementale (automatica), è necessario configurarla in modo esplicito.

1. Apri un terminale o un prompt dei comandi per effettuare la richiesta API.

1. Crea una richiesta POST per il seguente endpoint: 

   ```
   /matchingworkflows
   ```

1. Nell'intestazione della richiesta, imposta il Content-type su application/json. 
**Nota**  
*[Per un elenco completo dei linguaggi di programmazione supportati, consulta l'API Reference.AWS Entity Resolution](https://docs.aws.amazon.com/entityresolution/latest/apireference/Welcome.html)* 

1. Per il corpo della richiesta, fornisci i seguenti parametri JSON richiesti: 

   ```
   {
      "description": "string",
      "incrementalRunConfig": { 
         "incrementalRunType": "string"
      },
      "inputSourceConfig": [ 
         { 
            "applyNormalization": boolean,
            "inputSourceARN": "string",
            "schemaName": "string"
         }
      ],
      "outputSourceConfig": [ 
         { 
            "applyNormalization": boolean,
            "KMSArn": "string",
            "output": [ 
               { 
                  "hashed": boolean,
                  "name": "string"
               }
            ],
            "outputS3Path": "string"
         }
      ],
      "resolutionTechniques": { 
         "providerProperties": { 
            "intermediateSourceConfiguration": { 
               "intermediateS3Path": "string"
            },
            "providerConfiguration": JSON value,
            "providerServiceArn": "string"
         },
         "resolutionType": "RULE_MATCHING",
         "ruleBasedProperties": { 
            "attributeMatchingModel": "string",
            "matchPurpose": "string",
            "rules": [ 
               { 
                  "matchingKeys": [ "string" ],
                  "ruleName": "string"
               }
            ]
         },
         "ruleConditionProperties": { 
            "rules": [ 
               { 
                  "condition": "string",
                  "ruleName": "string"
               }
            ]
         }
      },
      "roleArn": "string",
      "tags": { 
         "string" : "string" 
      },
      "workflowName": "string"
   }
   ```

   Dove:
   + `workflowName`(obbligatorio) — Deve essere univoco e deve contenere da 1 a 255 caratteri e corrispondere allo schema [a-zA-Z\$10-9-] \$1
   + `inputSourceConfig`(obbligatorio) — Elenco di 1—20 configurazioni delle sorgenti di ingresso
   + `outputSourceConfig`(richiesto) — Esattamente una configurazione della sorgente di uscita
   + `resolutionTechniques`(obbligatorio) — Imposta su «RULE\$1MATCHING» come ResolutionType per la corrispondenza basata su regole
   + `roleArn`(obbligatorio) — Ruolo IAM ARN per l'esecuzione del flusso di lavoro
   + `ruleConditionProperties`(obbligatorio): elenco delle condizioni della regola e nome della regola corrispondente.

   I parametri opzionali includono:
   + `description`— Fino a 255 caratteri
   + `incrementalRunConfig`— Configurazione incrementale del tipo di esecuzione
   + `tags`— Fino a 200 coppie chiave-valore

1. (Facoltativo) Per utilizzare l'elaborazione incrementale anziché l'elaborazione standard predefinita (batch), aggiungete il seguente parametro al corpo della richiesta: 

   ```
   "incrementalRunConfig": {
      "incrementalRunType": "AUTOMATIC"
   }
   ```

1. Inviare la richiesta .

1. In caso di successo, riceverai una risposta con il codice di stato 200 e un corpo JSON contenente: 

   ```
   {
      "workflowArn": "string",
      "workflowName": "string",
      // Plus all configured workflow details
   }
   ```

1. Se la chiamata non va a buon fine, potresti ricevere uno di questi errori:
   + 400 — ConflictException se il nome del flusso di lavoro esiste già
   + 400 — ValidationException se la convalida dell'input non supera
   + 402 — ExceedsLimitException se i limiti dell'account vengono superati
   + 403 — AccessDeniedException se non disponi di un accesso sufficiente
   + 429 — ThrottlingException se la richiesta è stata limitata
   + 500 — InternalServerException se si verifica un errore interno del servizio

------

# Creazione di un flusso di lavoro di abbinamento basato su regole con il tipo di regola semplice
<a name="rule-based-mw-simple"></a>

**Prerequisiti**

Prima di creare un flusso di lavoro di abbinamento basato su regole, devi:

1. Creare una mappatura dello schema. Per ulteriori informazioni, consulta [Creazione di una mappatura dello schema](create-schema-mapping.md).

1. Se utilizzi i profili dei clienti Amazon Connect come destinazione di output, assicurati di avere configurato le autorizzazioni appropriate.

La procedura seguente mostra come creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **Simple** utilizzando la AWS Entity Resolution console o l'API. `CreateMatchingWorkflow`

------
#### [ Console ]

**Per creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **Simple utilizzando la console****

1. Accedi a Console di gestione AWS e apri la AWS Entity Resolution console all'indirizzo. [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/)

1. Nel riquadro di navigazione a sinistra, in **Flussi di lavoro**, scegli **Corrispondenza**.

1. Nella pagina **Flussi di lavoro corrispondenti**, nell'angolo in alto a destra, scegli **Crea flusso di lavoro corrispondente**.

1. Per il **passaggio 1: Specificare i dettagli del flusso di lavoro corrispondente**, procedi come segue: 

   1. Immettete un **nome del flusso di lavoro corrispondente** e una **descrizione** opzionale.

   1. Per l'**immissione dei dati **Regione AWS****, scegli un **AWS Glue database**, la **AWS Glue tabella** e quindi la **mappatura dello schema** corrispondente.

      È possibile aggiungere fino a 19 input di dati.

   1. L'opzione **Normalizza dati** è selezionata per impostazione predefinita, in modo che gli input di dati vengano normalizzati prima della corrispondenza. **Se non desiderate normalizzare i dati, deselezionate l'opzione Normalizza dati.**
**Nota**  
**La normalizzazione è supportata solo per i seguenti scenari in Create schema mapping:**   
**Se i seguenti sottotipi di **nome** sono raggruppati: **Nome, Secondo nome, **Cognome****.**
**Se i seguenti sottotipi di **indirizzo** sono raggruppati: **Indirizzo 1**, **Indirizzo 2, Indirizzo** **3**, **Città**, **Stato, **Paese**, Codice** postale.**
**Se i seguenti sottotipi **di telefono** sono raggruppati: **Numero di telefono, Prefisso telefonico** del paese.**

   1. Per specificare le autorizzazioni **di accesso al servizio**, scegli un'opzione e intraprendi l'azione consigliata.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-simple.html)

   1. (Facoltativo) Per abilitare i **tag** per la risorsa, scegliete **Aggiungi nuovo tag**, quindi immettete la coppia **Chiave** e **Valore**.

   1. Scegli **Next (Successivo)**.

1. Per la **fase 2: Scegli la tecnica di abbinamento**:

   1. Per il **metodo di abbinamento**, scegli Abbinamento **basato su regole**.

   1. **Per **Tipo di regola**, scegli Semplice.**  
![\[Scegli la schermata della tecnica di abbinamento con l'opzione Abbinamento semplice basato su regole selezionata.\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/choose-matching-method-rule-based-simple.PNG)

   1. Per **Processing cadence**, selezionate una delle seguenti opzioni.
      + Scegliete **Manuale** per eseguire un flusso di lavoro su richiesta per un aggiornamento collettivo 
      + Scegli **Automatico** per eseguire un flusso di lavoro non appena nuovi dati sono presenti nel tuo bucket S3 
**Nota**  
Se scegli **Automatico**, assicurati di avere EventBridge le notifiche Amazon attivate per il tuo bucket S3. Per istruzioni su come abilitare Amazon EventBridge tramite la console S3, consulta [Enabling Amazon EventBridge nella Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) *S3* User Guide.

   1. (Facoltativo) Per **Indicizza solo per la mappatura degli ID**, puoi scegliere di **attivare** la capacità di indicizzare solo i dati e non di generarli. IDs 

      Per impostazione predefinita, il flusso di lavoro corrispondente viene generato IDs dopo l'indicizzazione dei dati. 

   1. Per **le regole di corrispondenza**, inserisci **il nome di una regola**, quindi scegli i **tasti di corrispondenza** per quella regola.

      Puoi creare fino a 15 regole e applicare fino a 15 chiavi di abbinamento diverse alle regole per definire i criteri di corrispondenza.  
![\[Le regole di corrispondenza si interfacciano con i campi per inserire il nome della regola e selezionare le chiavi di corrispondenza.\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/matching-rules.PNG)

   1. Per **Tipo di confronto**, scegli una delle seguenti opzioni in base al tuo obiettivo.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-simple.html)  
![\[Opzioni relative al tipo di confronto: campi di input multipli per trovare corrispondenze tra i dati archiviati in più campi o campo di input singolo per limitare il confronto all'interno di un campo.\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/comparison-type.PNG)

   1. Scegli **Next (Successivo)**.

1. Per la **fase 3: Specificare l'output e il formato dei dati**:

   1. **Per **Destinazione e formato di output dei dati**, scegli la **posizione Amazon S3** per l'output dei dati e se il **formato dei dati** sarà Dati **normalizzati o Dati originali**.**

   1. Per la **crittografia**, se scegli di **personalizzare le impostazioni di crittografia**, inserisci la **AWS KMS chiave** ARN.

   1. Visualizza l'**output generato dal sistema**.

   1. Per l'**output dei dati**, decidi quali campi includere, nascondere o mascherare, quindi intraprendi le azioni consigliate in base ai tuoi obiettivi.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-simple.html)

   1. Scegli **Next (Successivo)**.

1. Per il **passaggio 4: rivedi e crea**:

   1. Rivedi le selezioni effettuate per i passaggi precedenti e modificale se necessario.

   1. Scegli **Create and run** (Crea ed esegui).

      Viene visualizzato un messaggio che indica che il flusso di lavoro corrispondente è stato creato e che il processo è iniziato.

1. Nella pagina dei dettagli del flusso di lavoro corrispondente, nella scheda **Metriche**, visualizza quanto segue in **Metriche dell'ultimo lavoro**:
   + Il **Job ID**. 
   + **Lo **stato** del processo del flusso di lavoro corrispondente: In **coda, **In corso**, Completato****, Non riuscito**** 
   + Il **tempo di completamento** del processo del flusso di lavoro.
   + Il numero di **record elaborati**. 
   + Il numero di **record non elaborati**. 
   + La **corrispondenza unica IDs generata**.
   + Il numero di **record di input**.

   Puoi anche visualizzare le metriche dei job per i job corrispondenti ai job del flusso di lavoro che sono stati eseguiti in precedenza **nella cronologia Job**.

1. Una volta completato il processo del flusso di lavoro corrispondente (**lo stato** è **completato**), puoi andare alla scheda **Data output** e quindi selezionare la tua sede **Amazon S3** per visualizzare i risultati.

1. (Solo tipo di elaborazione **manuale**) Se hai creato un flusso di lavoro di **abbinamento basato su regole** con il tipo di elaborazione **manuale**, puoi eseguire il flusso di lavoro corrispondente in qualsiasi momento selezionando Esegui flusso di lavoro nella pagina dei dettagli del **flusso di lavoro** corrispondente.

------
#### [ API ]

**Per creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **semplice utilizzando l'API****
**Nota**  
Per impostazione predefinita, il flusso di lavoro utilizza l'elaborazione standard (batch). Per utilizzare l'elaborazione incrementale (automatica), è necessario configurarla in modo esplicito.

1. Apri un terminale o un prompt dei comandi per effettuare la richiesta API.

1. Crea una richiesta POST per il seguente endpoint: 

   ```
   /matchingworkflows
   ```

1. Nell'intestazione della richiesta, imposta il Content-type su application/json. 
**Nota**  
*[Per un elenco completo dei linguaggi di programmazione supportati, consulta l'API Reference.AWS Entity Resolution](https://docs.aws.amazon.com/entityresolution/latest/apireference/Welcome.html)* 

1. Per il corpo della richiesta, fornisci i seguenti parametri JSON richiesti: 

   ```
   {
      "description": "string",
      "incrementalRunConfig": { 
         "incrementalRunType": "string"
      },
      "inputSourceConfig": [ 
         { 
            "applyNormalization": boolean,
            "inputSourceARN": "string",
            "schemaName": "string"
         }
      ],
      "outputSourceConfig": [ 
         { 
            "applyNormalization": boolean,
            "KMSArn": "string",
            "output": [ 
               { 
                  "hashed": boolean,
                  "name": "string"
               }
            ],
            "outputS3Path": "string"
         }
      ],
      "resolutionTechniques": { 
         "providerProperties": { 
            "intermediateSourceConfiguration": { 
               "intermediateS3Path": "string"
            },
            "providerConfiguration": JSON value,
            "providerServiceArn": "string"
         },
         "resolutionType": "RULE_MATCHING",
         "ruleBasedProperties": { 
            "attributeMatchingModel": "string",
            "matchPurpose": "string",
            "rules": [ 
               { 
                  "matchingKeys": [ "string" ],
                  "ruleName": "string"
               }
            ]
         },
         "ruleConditionProperties": { 
            "rules": [ 
               { 
                  "condition": "string",
                  "ruleName": "string"
               }
            ]
         }
      },
      "roleArn": "string",
      "tags": { 
         "string" : "string" 
      },
      "workflowName": "string"
   }
   ```

   Dove:
   + `workflowName`(obbligatorio) — Deve essere univoco e deve contenere da 1 a 255 caratteri e corrispondere allo schema [a-zA-Z\$10-9-] \$1
   + `inputSourceConfig`(obbligatorio) — Elenco di 1—20 configurazioni delle sorgenti di ingresso
   + `outputSourceConfig`(richiesto) — Esattamente una configurazione della sorgente di uscita
   + `resolutionTechniques`(obbligatorio) — Imposta su «RULE\$1MATCHING» per la corrispondenza basata su regole
   + `roleArn`(obbligatorio) — Ruolo IAM ARN per l'esecuzione del flusso di lavoro
   + `ruleConditionProperties`(obbligatorio): elenco delle condizioni della regola e nome della regola corrispondente.

   I parametri opzionali includono:
   + `description`— Fino a 255 caratteri
   + `incrementalRunConfig`— Configurazione incrementale del tipo di esecuzione
   + `tags`— Fino a 200 coppie chiave-valore

1. (Facoltativo) Per utilizzare l'elaborazione incrementale anziché l'elaborazione standard predefinita (batch), aggiungete il seguente parametro al corpo della richiesta: 

   ```
   "incrementalRunConfig": {
      "incrementalRunType": "AUTOMATIC"
   }
   ```

1. Inviare la richiesta .

1. In caso di successo, riceverai una risposta con il codice di stato 200 e un corpo JSON contenente: 

   ```
   {
      "workflowArn": "string",
      "workflowName": "string",
      // Plus all configured workflow details
   }
   ```

1. Se la chiamata non va a buon fine, potresti ricevere uno di questi errori:
   + 400 — ConflictException se il nome del flusso di lavoro esiste già
   + 400 — ValidationException se la convalida dell'input non supera
   + 402 — ExceedsLimitException se i limiti dell'account vengono superati
   + 403 — AccessDeniedException se non disponi di un accesso sufficiente
   + 429 — ThrottlingException se la richiesta è stata limitata
   + 500 — InternalServerException se si verifica un errore interno del servizio

------