Fonction IFS d’Archicad 29 : ordre des conditions et résultat par défaut

La fonction IFS décrite dans la documentation d’aide d’Archicad 29 évalue plusieurs conditions logiques dans l’ordre et renvoie la valeur associée à la première condition vraie. Ce guide présente sa syntaxe et les points à prendre en compte lors de la rédaction des conditions, avec des exemples. Le document Property Manager d’Archicad 26 de Graphisoft fournit, quant à lui, des informations distinctes sur la gestion des propriétés du projet et des types de données. Ces deux documents portent sur des sujets et des versions différents ; nous ne supposons pas ici que IFS fonctionne avec des propriétés basées sur des expressions.

Comment fonctionne la fonction IFS ?

IFS peut remplacer plusieurs expressions IF imbriquées. La fonction prend des conditions et les valeurs qui leur correspondent. Les conditions sont vérifiées dans l’ordre ; la valeur de la première condition vraie est renvoyée comme résultat. L’ordre de rédaction est donc important : dès qu’une condition antérieure est vraie, les conditions suivantes ne sont pas évaluées.

L’exemple de l’aide d’Archicad classe les poutres en trois catégories selon leur longueur. Si la longueur côté gauche dépasse 600 cm, le résultat est « Long » ; si elle est inférieure à 200 cm, le résultat est « Short ». Pour les poutres qui ne répondent à aucune de ces deux conditions, « Medium » est utilisé comme résultat par défaut :

IFS (Length Left > 600 cm, "Long", Length Left < 200 cm, "Short", TRUE, "Medium")

Ici, Length Left désigne la longueur côté gauche de la poutre. Le document source précise que les côtés « gauche » et « droit » sont définis par rapport à l’axe de référence de la poutre et que le sens de cet axe correspond à la direction dans laquelle le curseur est déplacé lors du tracé de la poutre. Dans l’exemple, les dimensions qui ne répondent à aucune des deux conditions limites obtiennent le résultat « Medium ».

IFS accepte jusqu’à 127 conditions logiques. Le caractère qui sépare les arguments de la fonction peut être une virgule ou un point-virgule ; selon Graphisoft, le séparateur utilisé dépend des paramètres régionaux de l’ordinateur.

Préparer les conditions : étape par étape

1. Définissez les catégories de résultats. Notez à l’avance la valeur souhaitée pour chaque condition. Dans l’exemple des poutres, il s’agit des chaînes « Long », « Short » et « Medium ». Toutes les valeurs de résultat de la fonction doivent avoir le même type de données et les mêmes unités.

2. Mettez les conditions dans l’ordre. IFS renvoie un résultat dès qu’elle rencontre la première condition vraie ; l’ordre des tests influe donc sur le résultat. Dans l’exemple, la longueur supérieure à 600 cm est d’abord vérifiée, puis celle inférieure à 200 cm ; un résultat par défaut est défini pour les autres cas. Dans votre propre utilisation, déterminez quelle condition doit être évaluée en premier.

3. Associez chaque condition à la valeur correspondante. La syntaxe est IFS (Logical1, Value1, [Logical2, Value2]...). La partie logique est évaluée comme vraie ou fausse ; chaque condition logique est suivie de la valeur à renvoyer si elle est vraie. Le document source indique qu’il est possible de définir jusqu’à 127 conditions logiques.

4. Choisissez un résultat par défaut. Si aucune condition n’est vraie et qu’aucune valeur par défaut n’a été définie, le résultat est Undefined. Pour attribuer une valeur à tous les cas, vous pouvez ajouter TRUE comme dernière condition logique, suivi du résultat par défaut. Celui-ci doit également être du même type de données que les autres résultats.

5. Vérifiez le séparateur et les types de résultat. Selon les paramètres régionaux de l’environnement dans lequel l’expression est utilisée, il peut être nécessaire d’employer une virgule ou un point-virgule. Vérifiez également que tous les résultats respectent les exigences de type de données et d’unité. La documentation d’Archicad précise que le séparateur est déterminé automatiquement en fonction des paramètres régionaux.

Distinction par rapport au document Property Manager

Le document Property Manager d’Archicad 26 décrit les étapes de création des propriétés et de définition de leur type de données. Cette fenêtre est accessible via Options > Property Manager ou depuis Classification Manager. Le document répertorie notamment les types de données String, Number, Integer, Area, Length, Angle, Volume, Tags List, Option Set et True/False pour les propriétés. Il constitue une référence distincte pour les utilisateurs qui souhaitent gérer les propriétés d’un projet ; il ne démontre pas que la fonction IFS peut être utilisée avec ces propriétés.

Le document indique que les types Tags List et Option Set ne peuvent pas être utilisés comme propriétés basées sur des expressions. Le type Option Set, lorsque la sélection multiple est désactivée, peut être utilisé dans une expression. Ces règles concernent les types de propriétés de Property Manager. Elles ne doivent pas être confondues avec l’exigence propre aux résultats d’IFS, qui doivent avoir le même type de données et les mêmes unités ; il convient de s’en tenir aux limites confirmées par les sources. Notez également que les informations sur Property Manager proviennent d’un document consacré à Archicad 26, tandis que la description d’IFS est tirée de la page d’aide d’Archicad 29.

Qu’est-ce que cela implique dans un flux de travail d’architecture et de visualisation ?

Le fait qu’IFS évalue plusieurs conditions de manière séquentielle au sein d’une seule fonction montre comment exprimer des classifications reposant sur plusieurs conditions. L’exemple de la documentation, qui classe les poutres selon leur longueur, illustre concrètement la définition de résultats différents en fonction des dimensions d’éléments de projet. Les équipes d’architecture et d’architecture d’intérieur peuvent s’appuyer sur cet exemple pour comprendre l’ordre des conditions et la notion de résultat par défaut ; toutefois, les informations présentées ici ne constituent pas une procédure d’utilisation confirmée d’IFS dans un autre champ de propriétés.

Les sources ne précisent ni exigences matérielles, ni effet sur le temps de rendu, ni conditions de licence, ni informations de compatibilité avec d’autres logiciels concernant IFS. Son évaluation pratique doit donc se limiter au comportement et à la syntaxe documentés. Il convient en particulier de tenir compte des versions : la description d’IFS vient d’Archicad 29, et les informations sur Property Manager du document d’Archicad 26.

Erreurs fréquentes

• Négliger l’ordre des conditions : comme le résultat de la première condition vraie est renvoyé, rédigez les conditions selon l’ordre de priorité souhaité.

• Oublier le résultat par défaut : si aucune condition n’est vraie et qu’aucun résultat par défaut n’est défini, Undefined est renvoyé.

• Mélanger les types de résultat : tous les résultats d’IFS doivent respecter les exigences de type de données et d’unité.

• Choisir le mauvais séparateur : le séparateur peut être une virgule ou un point-virgule, selon les paramètres régionaux de l’ordinateur.

• Considérer des documents distincts comme la preuve d’un usage commun : les documents sur Property Manager et IFS portent sur des versions et des sujets différents ; ils ne confirment pas leur utilisation conjointe.