

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Ajouter des filtres de chemin aux destinations AWS IoT SiteWise Edge
<a name="destinations-add-path-filters"></a>

Ajoutez des filtres de chemin à une destination. Les filtres de chemin utilisent la syntaxe des rubriques MQTT, où il `#` s'agit d'un caractère générique correspondant à un nombre quelconque de niveaux et `+` d'un caractère générique correspondant à un seul niveau. Vous pouvez ajouter plusieurs destinations à une passerelle, chacune disposant de son propre ensemble de filtres de chemin abonnés à la télémétrie de votre équipement.

Siemens Industrial Edgeles passerelles utilisent un préfixe pour des raisons de compatibilité. Pour de plus amples informations, veuillez consulter [Préfixes pour les filtres de chemin](sitewise-edge-on-siemens.md#siemens-path-filters).

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

**Pour ajouter des filtres de chemin**

1. Ouvrez la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Sélectionnez la passerelle à laquelle vous souhaitez ajouter des filtres de chemin.

1. Dans la section **Filtres de chemin** sous **Ajouter une destination**, choisissez **Ajouter un filtre de chemin**.

1. Entrez le filtre de chemin auquel vous souhaitez que cette destination s'abonne. Vous pouvez utiliser des caractères génériques (`#`et`+`) pour vous abonner à plusieurs chemins.

1. Choisissez **Ajouter un filtre de chemin** pour ajouter le filtre de chemin à la liste.

1. Répétez les étapes pour ajouter des filtres de chemin supplémentaires, si nécessaire.

1. Une fois que vous avez ajouté tous les filtres de chemin requis, choisissez **Create**.

------
#### [ AWS CLI for self-hosted gateways ]

**Example : Configuration du filtre de chemin**  

```
{
  "destinations": [
    {
      ...
    }
  ],
  "filters": [
    {
      "type": "PATH",
      "config": {
        "paths": [
          "home/+/sensor1/temperature",
          "home/livingroom/sensor1/temperature",
          "home/livingroom/sensor1/temperature",
          "building/#"
        ]
      }
    }
  ]
}
```

------
#### [ AWS CLI for Siemens IEgateways ]

**Example : Configuration des préfixes pour les filtres de chemin**  
Capturez toutes les données en utilisant à la fois les préfixes data (`ie/d``ie/m`) et metadata () pour chaque filtre de chemin.  

```
{
  "destinations": [
    {
      ...
    }
  ],
  "filters": [
    {
      "type": "PATH",
      "config": {
        "paths": [
          "ie/d/home/+/sensor12/temperature",
          "ie/m/home/livingroom/sensor12/temperature",
          "ie/d/home/livingroom/sensor13/temperature2",
          "ie/m/home/livingroom/sensor13/temperature2",
          "ie/d/building/#",
          "ie/m/building/#"
        ]
      }
    }
  ]
}
```

------

**Note**  
Copiez les filtres de chemin entre les destinations en téléchargeant la liste des filtres de chemin. Pour de plus amples informations, veuillez consulter [Télécharger tous les filtres de chemin d'une destination (console)](destinations-manage.md#destinations-download-list).

## Téléchargez des filtres de chemin en bloc
<a name="destinations-path-filters-upload-file"></a>

Pour télécharger des filtres de chemin en bloc, utilisez un fichier CSV ou texte. AWS IoT SiteWise supprime automatiquement les doublons exacts lorsque vous téléchargez des fichiers. Par exemple, `windfarm/site1/` et `windfarm/site1/` sont des doublons exacts qui sont AWS IoT SiteWise interceptés parce que la chaîne est exactement la même. Les doublons partiels ne sont pas supprimés et entraînent des frais supplémentaires. Par exemple, `windfarm/#` et `windfarm/site1` sont des sujets qui se chevauchent parce qu'ils `windfarm/site1` sont déjà couverts par. `windfarm/#`

**Note**  
Évitez les doublons pour éviter des frais supplémentaires. Le fichier chargé doit être au format .csv ou .txt. Il ne peut pas contenir d'en-têtes et doit être composé d'une seule colonne. Dans la colonne, listez vos filtres de chemin, chaque filtre étant sur une ligne distincte. Aucune autre information ne doit être incluse dans le fichier.

**Exigences relatives au téléchargement de fichiers**

Il s'agit d'exigences supplémentaires en matière de filtre de chemin.
+ Vous pouvez télécharger un fichier .csv ou .txt. Les autres formats de fichiers ne sont pas pris en charge.
+ Les fichiers CSV (.csv) ne peuvent pas comporter d'en-têtes et ne doivent contenir qu'une seule colonne.
+ Vous pouvez avoir un filtre de chemin sur chaque ligne.
+ Les fichiers téléchargés ne peuvent pas être vides.
+ Lorsque vous utilisez `#` comme caractère générique, ce doit être le dernier caractère du filtre de rubrique. Par exemple, `topic/#` ou en tant que caractère autonome à un niveau particulier de la rubrique. Toutefois, il convient de noter que `#` peut également être utilisé comme caractère normal dans le nom d’un niveau de rubrique, par exemple `factory/machine#1/topic`. Pour plus d'informations, consultez [Caractères spéciaux dans les noms des filtres de chemin](gw-destinations.md#path-filters-special-characters).
  + Vous pouvez également utiliser le `+` personnage. Par exemple, utilisez-le `factory/+/temp` pour obtenir toutes les températures pour les usines au lieu de `factory/machine2/temp` les utiliser `factory/machine3/temp` individuellement.