Filtrer par attributs

Remarque :

L’outil Filter by Attributes (Filtrer par attributs) n’est disponible que dans ModelBuilder.

L’outil de modèle Filter by Attributes (Filtrer par attributs) crée une variable de données en sortie des entités qui satisfont les critères d’attribut.

La sortie est une variable de données en sortie qui peut être configurée comme couche intermédiaire ou couche hébergée.

Exemple

Les responsables de la gestion de la faune s’intéressent aux interactions entre les cougars et les hommes et décident de créer un modèle pour cartographier un habitat potentiel pour les cougars. Le choix de l'habitat repose sur certains critères, à savoir la végétation, la pente et la proximité des routes. L’outil Filter by Attributes (Filtrer par attributs) peut être utilisé dans le modèle pour restreindre la couche de végétation aux seuls types de végétation qui conviennent comme habitat des cougars.

Remarques sur l’utilisation

L’outil Filter by Attributes (Filtrer par attributs) inclut des configurations pour les critères de requête et la couche de résultat.

Critères de requête

Le groupe Query criteria (Critères de requête) inclut les paramètres suivants :

  • Input dataset (Jeu de données en entrée) indique si l’entrée est une couche d’entités hébergée ou une couche de tables hébergée. Vous pouvez sélectionner un jeu de données en cliquant sur Layer (Couche) Couche.
  • Expression définit les critères utilisés pour filtrer les entités. Les entités qui respectent tous les critères sont incluses dans la variable des données en sortie. Pour définir une requête, cliquez sur Build new query (Créer une nouvelle requête). Un jeu de données en entrée doit être spécifié pour mettre à jour l’expression.

    En savoir plus sur la génération d’une requête

    Remarque :

    Dans la plupart des cas, le générateur de requêtes comprend une liste des valeurs de champ disponibles pour faciliter la création d’une expression précise. La liste n’est pas disponible si le jeu de données en entrée est une sortie d’un autre outil. Vous devez saisir la valeur exacte dans la zone en entrée, au lieu de choisir la valeur dans une liste.

Couche de résultat

Le groupe Result layer (Couche de résultat) comprend les paramètres suivants :

  • Result type (Type de résultat) indique si la sortie est une couche intermédiaire ou une couche d’entités hébergée. Les options disponibles sont les suivantes :
    • Create intermediate data (Créer des données intermédiaires) crée un jeu de données temporaire qui peut être utilisé comme entrée d’un autre élément d’outil. Il s’agit de l’option par défaut pour tous les outils d’un modèle.
    • Create hosted layer (Créer une couche hébergée) : crée une couche hébergée pour les données en sortie. Si cette option est sélectionnée, les paramètres suivants sont disponibles :
      • Le paramètre Output name (Nom en sortie) spécifie le nom de la couche qui a été créée et est affichée. Le nom doit être unique. Si une couche du même nom existe déjà dans votre organisation, l’outil échoue et vous êtes invité à utiliser un autre nom.
      • If a layer exists with the same name, automatically overwrite it (S’il existe déjà une couche portant ce nom, la remplacer automatiquement) détermine si le modèle peut être exécuté à nouveau sans changer le nom de la couche en sortie. Si la couche n’existe pas encore dans l’organisation, une nouvelle couche est créée lors de la première exécution du modèle. Elle est remplacée lors des exécutions suivantes du modèle. Ce paramètre est activé par défaut.
      • Le paramètre Save in folder (Enregistrer dans un dossier) indique le nom d’un dossier de My content (Mon contenu) dans lequel est enregistré le résultat.
    • Overwrite existing layer (Remplacer la couche existante) indique une couche hébergée existante qui sera écrasée par la sortie de l’outil. Si cette option est sélectionnée, le paramètre Layer to overwrite (Couche à remplacer) est également disponible pour accéder à une couche existante.

En savoir plus sur les sorties de modèle

Limitations

Les limitations suivantes s’appliquent à l'outil :

  • L’outil Filter by Attributes (Filtrer par attributs) n’est disponible que dans ModelBuilder. Si vous n’utilisez pas ModelBuilder, vous pouvez appliquer un filtre à un jeu de données ou utiliser l’outil Find by Attributes and Location (Rechercher selon les attributs et la localisation).
  • Les expressions spatiales ne sont pas prises en charge.
  • Les listes des valeurs de champ ne sont pas disponibles dans le générateur de requêtes si la couche ou la table en entrée correspond à une sortie d’un autre outil.

Environnements

Cet outil ne respecte pas les environnements d’analyse.

Crédits

Cet outil ne consomme pas de crédit.

Sorties

L’outil Filter by Attributes (Filtrer par attributs) crée une variable de données en sortie qui peut correspondre à des données intermédiaires ou hébergées. Le jeu de données en sortie possède la géométrie et les champs du jeu de données en entrée.

Licences requises

Cet outil requiert le type d’utilisateur et les configurations suivants :

  • Type d’utilisateur Professional ou Professional Plus
  • Rôle d’éditeur, de facilitateur ou d’administrateur, ou rôle personnalisé équivalent

Ressources

Référez-vous aux ressources suivantes pour en savoir plus :