Générer un ensemble de définition à partir de la sélection (Gestion des données)

Synthèse

Crée un ensemble de définition (au format SQL) à partir des entités ou lignes sélectionnées dans la couche ou table.

Utilisation

• Une sélection active dans l’entrée est requise. Si des lignes sélectionnées apparaissent en surbrillance, elles sont utilisées pour générer la requête.

• La vue tabulaire ou couche en entrée doit être présente dans la carte ou scène.

• Si la table ou la couche en entrée n’est pas inscrite auprès de la géodatabase, une couche de requête est créée et l’ensemble de définition est généré à partir de cette couche.

• La clause d’un ensemble de définition a une limite de 1 000 valeurs. Si la sélection inclut plus de 1 000 valeurs, l’ensemble de définition obtenu comprend plusieurs clauses.

• Lorsque le paramètre Méthode de génération est défini sur Apparier la sélection, le champ ObjectID est utilisé par défaut. Lorsqu’une couche comporte un champ GlobalID, ce champ est utilisé à la place du champ ObjectID. Le champ GlobalID n’est pas indiqué dans le paramètre Champ lorsque le paramètre Méthode de génération est défini sur Utiliser les valeurs de champ.

• Le paramètre Ajouter l’ensemble de définition actif est disponible uniquement si le paramètre Méthode de génération est défini sur Utiliser les valeurs de champ et que la table ou couche en entrée comporte un ensemble de définition actif. Vous pouvez déterminer la requête active en examinant les propriétés de la table ou couche.

• Lorsque le paramètre Modifier l’ensemble de définition généré est sélectionné, mais que la valeur du paramètre Clause Where n’a pas été modifiée ou spécifiée, l’outil utilise l’ensemble de définition généré par défaut.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Vue tabulaire ou couche à partir de laquelle l’ensemble de définition est généré.	Table View
Méthode de génération (Facultatif)	Indique la méthode utilisée pour générer l’ensemble de définition. Apparier la sélection—Le champ ObjectID de la table en entrée (ou le champ GlobalID s’il est présent) est utilisé pour générer la requête avec les valeurs présentes dans la sélection. Il s’agit de l’option par défaut. Utiliser les valeurs de champ—La valeur du paramètre Champ est utilisée pour générer la requête avec les valeurs présentes dans la sélection.	String
Terrain (Facultatif)	Champ dans la vue tabulaire ou la table qui est utilisée pour générer les valeurs de la requête. Les types de champs acceptés sont Court, Long, Texte et GUID. Ce paramètre est requis lorsque le paramètre Méthode de génération est défini sur Utiliser les valeurs de champ.	Field
Nom de la requête (Facultatif)	Nom unique de la requête qui est générée.	String
Inverser la clause Where (Facultatif)	Indique si l’ensemble de définition généré (clause Where) est inversé et inclut toutes les valeurs non sélectionnées ou s’il inclut toutes les valeurs sélectionnées de la table en entrée. Activé : la clause Where est inversée. Désactivé : la clause Where n’est pas inversée. Il s’agit de l’option par défaut.	Boolean
Ajouter l’ensemble de définition actif (Facultatif)	Indique si l’ensemble de définition généré est ajouté à la requête active. Ce paramètre est disponible lorsque la couche ou la table comporte un ensemble de définition actif et que le paramètre Méthode de génération est défini sur Utiliser les valeurs de champ. Activé : l’ensemble de définition généré est ajouté à la requête active. Désactivé : l’ensemble de définition généré n’est pas ajouté à la requête active. Il s’agit de l’option par défaut.	Boolean
Modifier l’ensemble de définition généré (Facultatif)	Indique si l’ensemble de définition est affiché et peut être modifié à l’aide du paramètre Clause Where avant d’être généré. Activé : l’ensemble de définition est affiché et peut être modifié avant d’être généré. Désactivé : l’ensemble de définition ne peut pas être modifié. Il s’agit de l’option par défaut.	Boolean
Clause Where (Facultatif)	Expression SQL de l’ensemble de définition généré à partir des autres valeurs de paramètre. Pour plus d’informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression

Sortie obtenue

Étiquette	Explication	Type de données
Table mise à jour	Entrée mise à jour avec l’ensemble de définition généré.	Feature Layer, Table View

Python

arcpy.management.GenerateDefinitionQueryFromSelection(in_table, {method}, {field}, {query_name}, {invert_where_clause}, {append_active_query}, {overwrite_where_clause}, {where_clause})

Nom	Explication	Type de données
in_table	Vue tabulaire ou couche à partir de laquelle l’ensemble de définition est généré.	Table View
method (Facultatif)	Indique la méthode utilisée pour générer l’ensemble de définition. MATCH_SELECTION—Le champ ObjectID de la table en entrée (ou le champ GlobalID s’il est présent) est utilisé pour générer la requête avec les valeurs présentes dans la sélection. Il s’agit de l’option par défaut. USE_FIELD_VALUES—La valeur du paramètre field est utilisée pour générer la requête avec les valeurs présentes dans la sélection.	String
field (Facultatif)	Champ dans la vue tabulaire ou la table qui est utilisée pour générer les valeurs de la requête. Les types de champs acceptés sont Court, Long, Texte et GUID. Ce paramètre est requis lorsque le paramètre method est défini sur USE_FIELD_VALUES.	Field
query_name (Facultatif)	Nom unique de la requête qui est générée.	String
invert_where_clause (Facultatif)	Indique si l’ensemble de définition généré (clause Where) est inversé et inclut toutes les valeurs non sélectionnées ou s’il inclut toutes les valeurs sélectionnées de la table en entrée. INVERT—La clause Where est inversée. NON_INVERT—La clause Where n’est pas inversée. Il s’agit de l’option par défaut.	Boolean
append_active_query (Facultatif)	Indique si l’ensemble de définition généré est ajouté à la requête active Ce paramètre est disponible lorsque la couche ou la table comporte un ensemble de définition actif et que le paramètre method est défini sur USE_FIELD_VALUES. APPEND—L’ensemble de définition généré est ajouté à la requête active. NOT_APPEND—L’ensemble de définition généré n’est pas ajouté à la requête active. Il s’agit de l’option par défaut.	Boolean
overwrite_where_clause (Facultatif)	Indique si l’ensemble de définition peut être modifié à l’aide du paramètre where_clause avant d’être généré. OVERWRITE—L’ensemble de définition peut être modifié avant d’être généré. NOT_OVERWRITE—L’ensemble de définition ne peut pas être modifié. Il s’agit de l’option par défaut.	Boolean
where_clause (Facultatif)	Ensemble de définition qui remplace les autres valeurs de paramètre. Pour plus d’informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression

Sortie obtenue

Nom	Explication	Type de données
out_table	Entrée mise à jour avec l’ensemble de définition généré.	Feature Layer, Table View

Exemple de code

Exemple d’utilisation de la fonction GenerateDefinitionQueryFromSelection (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction GenerateDefinitionQueryFromSelection en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"

# Set local variables
in_table = "WisconsinAirports.lyrx"
where_clause = '"TRAFFICCOUNT" >= \'100\''

# Run the tool
arcpy.management.GenerateDefinitionQueryFromSelection(
    in_table,
    "MATCH_SELECTION",
    "MyPythonQueryName",
    "NON_INVERT",
    "NOT_APPEND",
    "OVERWRITE",
    where_clause)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui