Calculer un champ

Remarque :

Cet outil n’est disponible que dans ModelBuilder.

L’outil Calculer un champ utilise une expression SQL pour calculer les valeurs d’un champ nouveau ou existant. Le remplacement d’un champ dans le jeu de données en sortie n’affecte pas les valeurs des champs dans le jeu de données en entrée.

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

Exemples

Voici des exemples d'utilisation de cet outil :

• Un jeu de données inclut des champs pour le nombre de bâtiments résidentiels avec panneaux solaires sur le toit et le nombre total de bâtiments résidentiels par quartier. L’outil Calculer un champ peut être utilisé pour créer un nouveau champ et calculer le taux d’utilisation de panneaux solaires dans chaque quartier.
• Un jeu de données inclut un champ de nombre, où -9999 a été utilisé comme valeur d’espace réservé, ce qui peut avoir un impact sur les résultats de l’analyse si ce champ a été utilisé en tant qu’entrée. L’outil Calculer un champ peut être utilisé pour remplacer la valeur du champ par une valeur par défaut appropriée pour le sous-ensemble d’enregistrements avec la valeur d’espace réservé -9999.

Remarques sur l’utilisation

L’outil Calculer un champ inclut des configurations pour l’entrée, le calcul de champ et la couche de résultat.

Entrée

Le groupe Input (Entrée) 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) .

• Le paramètre Only apply calculations to certain records (Appliquer les calculs à certains enregistrements uniquement) définit les critères qui déterminent le sous-ensemble d’enregistrements auquel le calcul de champ sera appliqué. Les entités qui remplissent tous les critères sont incluses dans le sous-ensemble. 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.

  Pour appliquer le calcul à tous les enregistrements, laissez ce paramètre vide.

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

Calcul de champ

Le groupe Field calculation (Calcul de champ) inclut les paramètres suivants :

• Field to calculate (Champ à calculer) spécifie le champ dans lequel les valeurs calculées seront ajoutées. Vous pouvez effectuer votre choix dans une liste de champs existants ou créer un nouveau champ.

  Si un champ existant est sélectionné, les valeurs qui se trouvent actuellement dans le champ sont remplacées.

  Remarque :

  L’outil Calculer un champ crée un nouveau jeu de données en sortie. Le remplacement d’un champ dans le jeu de données en sortie n’affecte pas les valeurs des champs dans le jeu de données en entrée.

  Pour créer un nouveau champ, cliquez sur Create new field (Créer un nouveau champ) et fournissez les informations suivantes :
  • Field name (Nom de champ) : saisissez un nom pour le nouveau champ. Le nom de champ ne peut pas être identique à un nom de champ existant dans la couche, ne peut pas contenir de caractères spéciaux ni d’espaces et ne peut pas être un mot-clé SQL.
  • Field type (Type de champ) : sélectionnez un type de champ dans le menu. Le type de champ détermine les types de données et les expressions qui sont pris en charge pour le calcul du champ. Les types de champs suivants sont pris en charge :
    • Double : nombres comprenant des décimales.
    • Integer (Entier) : nombres entiers compris entre -2 147 483 648 et 2 147 483 647 (entier long).
    • Big Integer (Entier très grand) : nombres entiers compris entre -9 007 199 254 740 991 et 9 007 199 254 740 991. Ce type permet de stocker des nombres qui ne se trouvent pas dans la plage des données de type entier.
    • String (Chaîne) : séquence quelconque de caractères.
    • Date : date et heure.
    • Date Only (Date uniquement) : stocke une date, sans heure. Cela peut s’avérer utile si les heures ne sont pas nécessaires, par exemple, pour enregistrer le jour où un permis arrive à expiration.
    • Time Only (Heure uniquement) : stocke une heure, sans date. Le format d’heure est déterminé par vos paramètres utilisateur. Le type de données de ce champ est utile pour enregistrer des valeurs telles que des heures de départ.

• Field calculation expression (Expression de calcul de champ) définit une expression SQL utilisée pour calculer des valeurs pour Field to calculate (Champ à calculer). Cliquez sur Expression pour ouvrir la fenêtre SQL expression editor (Éditeur d’expressions SQL). Dans la fenêtre SQL expression editor (Éditeur d’expressions SQL), utilisez Fields (Champs) , Functions (Fonctions) et les opérateurs de base pour créer une expression valide.

  En savoir plus sur l’écriture d’expressions SQL

  Si le résultat de l’expression et le type de champ sont partiellement compatibles (par exemple, les types de champs double et entier prennent tous les deux en charge les résultats numériques, mais avec des restrictions différentes), les valeurs seront automatiquement transformées pour répondre aux exigences de ce type de champ. La transformation sera automatique et sans notifications.

  La table suivante décrit la façon dont certaines sorties seront transformées pour correspondre au type de champ :

  Sortie	Type de champ	Transformation
  Double	Entier	Arrondissez au nombre entier le plus proche
  Date Only (Date uniquement)	Date	Ajoutez 12:00 a.m. UTC à chaque date.
  Date	Date Only (Date uniquement)	Convertissez la date et l’heure au format UTC et stockez la date.
  Date	Time Only (Heure uniquement)	Convertissez la date et l’heure au format UTC et stockez l’heure.

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 Calculer un champ est uniquement disponible dans ModelBuilder. Si vous n’utilisez pas ModelBuilder, vous pouvez calculer les valeurs de champ dans Map Viewer.
• 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.
• Si une valeur calculée pour une chaîne ou un champ numérique dépasse la longueur maximale de ce champ, la sortie apparaît nulle pour les nouveaux champs ou conserve la valeur en entrée du champ pour les champs existants.
• Les calculs de champ qui utilisent des champs d’entrée et de sortie incompatibles peuvent produire des résultats inattendus. Par exemple, si vous utilisez un champ Time Only (Heure uniquement) pour calculer une sortie Date Only (Date uniquement), la date 1899-12-30 est utilisée pour tous les champs. Les autres combinaisons de champs incompatibles incluent les entrées Time Only (Heure uniquement) avec des sorties Date et les entrées Date Only (Date uniquement) avec des sorties Time Only (Heure uniquement).

Environnements

Cet outil ne respecte pas les environnements d’analyse.

Crédits

Cet outil ne consomme pas de crédit.

Sorties

L’outil Calculer un champ 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 même géométrie et les mêmes champs que le jeu de données en entrée, sauf si un nouveau champ est ajouté pour le calcul.

Remarque :

L’outil Calculer un champ crée un nouveau jeu de données en sortie. Le remplacement d’un champ dans le jeu de données en sortie n’affecte pas les valeurs des champs dans le 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 :

• Comment générer une requête
• Calculer des valeurs de champ (Map Viewer)
• Calculer un champ dans ArcGIS Data Pipelines
• Calculer un champ dans ArcGIS Pro