Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

Allplan 2014 Allfa Plus Manuel D'utilisation

Télécharger au format pdf ou txt
Télécharger au format pdf ou txt
Vous êtes sur la page 1sur 106

Allplan 2014

Allfa Plus

Manuel d’utilisation
Cette documentation a été rédigée avec le plus grand soin ; toutefois, la
société ne peut accepter aucune responsabilité quant à son contenu.
Les documentations diffusées par la société Nemetschek Allplan
Systems GmbH portent sur la totalité des modules et des fonctions du
programme, même si l’utilisateur n’en a fait qu’une acquisition
partielle. Lorsque la description figurant dans les documentations ne
coïncide pas avec le programme, les menus et les textes du programme
sont déterminants.
Le contenu de ces documents peut faire l'objet de modifications sans
avis préalable. Toute reproduction ou distribution partielle ou totale de
ce document, sous quelque forme que ce soit et par quelque moyen,
électronique ou mécanique, que ce soit, effectuée sans l’autorisation
expresse de Nemetschek Allplan Systems GmbH est illicite.
Certaines parties de ce produit ont été développées à l'aide de la
bibliothèque Xerces de "The Apache Software Foundation".
PHP 4 et PHP 5 sont distribués sous la licence PHP v3.01, Copyright (c)
the PHP Group.
Allfa® est une marque déposée de la société Nemetschek Allplan
Systems GmbH, Munich.
Allplan® est une marque déposée de la société Nemetschek AG, Munich
(RFA).
AutoCAD®, DXF™ et 3D Studio MAX® sont des marques ou des
marques déposées de la société Autodesk Inc. San Rafael, CA.
Microsoft®, Windows® et Windows Vista™ sont des marques ou des
marques déposées de la société Microsoft Corporation.
MicroStation® est une marque déposée de la société Bentley Systems,
Inc.
Oracle et Java sont des marques déposées d'Oracle Corporation et/ou
ses filiales.
Opticon, PHL2700 et IRU2700 sont des marques d'Opticon Inc.
Toutes les autres marques (déposées) appartiennent à leurs
propriétaires respectifs.
© Nemetschek Allplan Systems GmbH, Munich. Tous droits réservés -
All rights reserved.
1. édition, mars 2014
Manuel d'utilisation Contenu i

Contenu
Introduction ................................................................................... 1
Fonctionnalités ...................................................................................................... 2
Etats dynamiques............................................................................................................ 2
Annotation graphique .................................................................................................. 2
Filtre de recherche ......................................................................................................... 2
Attributs dynamiques.................................................................................................... 3
Catalogue d’articles ....................................................................................................... 3
Fonctions de base de données ................................................................................... 3
Domaine des services..................................................................................................... 3
Catalogue de nettoyage ............................................................................................... 4

Fonctions Allfa Plus ..................................................................... 5


Recherche Allfa Plus............................................................................................. 5
Etats dynamiques Allfa Plus............................................................................ 11
Domaine des services ........................................................................................ 12

Référence des fonctions ........................................................... 19


Fonctions générales de base de données .................................................... 19
AddMonths .................................................................................................................... 19
IfThenElseC; IfThenElseR; IfThenElseI; IfThenElseD .......................................... 19
IfThenElseCR ; IfThenElseCI ; IfThenElseCD ......................................................... 23
LastWeekDay ................................................................................................................. 25
LPad .................................................................................................................................. 25
NvlC; NvlR; NvlI; NvlD ................................................................................................ 27
NextWeekDay ................................................................................................................ 29
Replace ............................................................................................................................ 30
Round............................................................................................................................... 31
SearchStringList, SearchStringListEx .................................................................... 32
SubString ........................................................................................................................ 39
ToCharD ........................................................................................................................... 40
ToCharI ............................................................................................................................ 44
ToCharR ........................................................................................................................... 47
ii Contenu Allplan 2014

ToNumber........................................................................................................................50
TruncDate ........................................................................................................................53
TruncNum........................................................................................................................55
Expressions régulières .................................................................................................56
Fonctions générales spécifiques à Allfa ...................................................... 63
AttUseCount ...................................................................................................................63
CountChilds ....................................................................................................................65
HasPolygon .....................................................................................................................68
HasReference .................................................................................................................70
ParentAttFieldC; ParentAttFieldR; ParentAttFieldI; ParentAttFieldD ........72
ParentFieldC; ParentFieldR; ParentFieldI; ParentFieldD; ParentObjDsc1 ..74
PropValRemarkC; PropValRemarkR; PropValRemarkI; PropValRemarkD ..78
TrimCode0 .......................................................................................................................80
Fonctions pour la hiérarchie spatiale .......................................................... 81
BldCountEmployees .....................................................................................................81
BldCountEquipments...................................................................................................82
BldCountOccupancies .................................................................................................84
PrpCountEmployees.....................................................................................................85
PrpCountEquipments ..................................................................................................86
PrpCountOccupancies .................................................................................................88
SphCountEmployees ....................................................................................................89
SphCountEquipments .................................................................................................90
SphCountOccupancies ................................................................................................91
SphDefaultArea .............................................................................................................92
SphEmployeeList ...........................................................................................................93
SphFreeArea ...................................................................................................................95
SphOrgUnitList ..............................................................................................................96
SphPositionList ..............................................................................................................97
Fonctions pour l'utilisation ............................................................................. 98
PosEmployeeAttList .....................................................................................................98
PosEmployeeList............................................................................................................99
Fonctions pour les fonctions techniques.................................................. 100
FunSumRoomArea..................................................................................................... 100

Index ............................................................................................ 101


Manuel d'utilisation Introduction 1

Introduction
Si l’on classe les activités relevant de la gestion du patrimoine
immobilier en activités d’ordre technique, activités d’ordre commercial
et activités d’entretien, ce sont sans doute les activités concernant
l’entretien courant des bâtiments qui se révèlent les plus coûteuses. Les
frais de nettoyage représentent à eux seuls 25 - 30 % des coûts
d’utilisation des bâtiments.
La sous-traitance des services infrastructurels à des prestataires
externes peut permettre d’économiser jusqu’à 40 % de ces coûts et
présente donc un potentiel d’économie important pour les entreprises.
Mais uniquement à la condition de préparer soigneusement la
sous-traitance en établissant un relevé exact des surfaces et des
quantités à traiter et en définissant précisément les prestations
requises. Les appels d’offres relatifs aux prestations sous-traitées
doivent être établis avec grand soin et le recours à des logiciels
spécialisés est indispensable, en particulier s’il s’agit de bâtiments
d’envergure.
Avec Allfa TT, vous disposez d'un outil vous permettant de mener à
bien cette tâche de manière simple et rapide.
Afin de rendre Allfa TT encore plus performant, le module d'extension
Allfa Plus est disponible.
Il s'agit d'un complément à Allfa TT qui peut être installé
ultérieurement et à tout moment. Allfa Plus vous offre de nouveaux
outils d'analyse et de nouvelles informations.
Grâce à une installation très simple et centrale, les fonctionnalités de
Allfa Plus sont rapidement accessibles.
2 Fonctionnalités Allplan 2014

Fonctionnalités
Allfa Plus prend en charge les fonctionnalités suivantes :
• Evaluations avec les états dynamiques
• Annotations graphiques
• Filtre de recherche prédéfini
• Attributs dynamiques pour les calculs
• Complément de l'article catalogue
• Fonctions de base de données complètes
• Organisation avec le domaine des services
• Prestations de nettoyage correspondantes au catalogue de
nettoyage

Etats dynamiques
Les états dynamiques vous proposent déjà dans Allfa TT des
possibilités d'analyse complètes. Ils sont entièrement définis et mis en
forme par l'utilisateur.
Allfa Plus vous fournit 25 Etats dynamiques (rubriques connexes
"Etats dynamiques Allfa Plus" cf. page 10) supplémentaires issus de la
pratique que vous pouvez utiliser immédiatement. Des styles
supplémentaires sont également disponibles pour créer de nouveaux
calculs.

Annotation graphique
Grâce à Allfa Plus, vous disposez de 27 possibilités supplémentaires
pour l'annotation des objets. Vous pouvez créer des annotations sur
plusieurs lignes ou fusionner simplement des lignes vides.

Filtre de recherche
La Recherche Allfa Plus (cf. page 5) vous permet de rechercher des
données en particulier, sans en posséder toutes les informations. Allfa
Plus vous propose 74 filtres pour affiner votre recherche. Les
algorithmes de recherche prédéfinis vous offrent de toutes nouvelles
possibilités d'analyse. Vous pouvez alors rechercher, par exemple, des
pièces sans équipement, ou des pièces modifiées à une date précise.
Manuel d'utilisation Introduction 3

Attributs dynamiques
Dans Allfa, vous pouvez définir les propriétés dont vous avez besoin
sous la forme d'attributs dynamiques, puis les utiliser pour décrire les
différents objets.
Grâce à l'introduction de Allfa Plus, vous pouvez également faire appel
aux attributs dynamiques pour les fonctions de calcul, comme les
limitations de poids.

Catalogue d’articles
Le catalogue d'articles comprend des objets, comme par exemple
l'équipement de bureau. Chaque article peut être appelé et traité
séparément.
Allfa Plus ajoute 170 articles au catalogue. Les symboles DXF de tous
les articles sont déjà présents, ils peuvent donc être utilisés
immédiatement.
Chaque type d'objet possède son propre symbole dans l'arborescence, il
sont ainsi aisément identifiables.

Fonctions de base de données


Grâce à 47 nouvelles fonctions de base de données, Allfa Plus vous
permet de vérifier directement la définition d'un polygone ou la
présence d'un texte ou d'un modèle de texte.

Domaine des services


Le Domaine des services (cf. page 12) vous permet de définir un cycle
de maintenance et de nettoyage pour différents équipements ou pièces
pour, par exemple, que la vérification prescrite des installations ainsi
que des machines ou des extincteurs puisse être constamment
contrôlée et garantie.
Vous pouvez également créer des états concernant ces activités.
4 Fonctionnalités Allplan 2014

Catalogue de nettoyage
Les catalogues de nettoyage vous permettent de résumer ou de classer
les objets à nettoyer.
Par exemple, vous pouvez définir séparément le nettoyage des
éléments en verre et celui des surfaces de plancher. Vous disposez ainsi
des données correspondantes pour les prestations et le cycle de
nettoyage.
Manuel d'utilisation Fonctions Allfa Plus 5

Fonctions Allfa Plus


Recherche Allfa Plus
Vous devez indiquer l'emplacement de recherche, et par quel objet
l'effectuer.
Afin de définir l'emplacement, ouvrez dans Allfa TT la zone de liste
déroulante de Structure et sélectionnez une entrée. Cette sélection sera
affichée ultérieurement dans la partie supérieure de la boîte de
dialogue Rechercher... de la fonction Rechercher dans.
Pour indiquer l'objet selon lequel la recherche doit être effectuée,
ouvrez la zone de liste déroulante dans la boîte de dialogue
Rechercher..., comme décrit plus loin ci-dessous.
Les filtres peuvent être :
• … modif. > n jours
Recherche les objets qui ont été modifiés il y a plus de n jours.
• … modif. <= jours
Recherche les objets qui ont été modifiés il y a moins de n jours, ou
à cette date précise.
• … sans UnitOrg
Recherche les objets qui n'appartiennent à aucune unité
d'organisation.
• … sans type d'utilisation
Recherche les objets pour lesquels aucun type d'utilisation n'a été
défini.
• … sans graphique
Recherche les objets présents uniquement sous forme
alphanumérique dans la base de données.
• … sans centre de coûts
Recherche les objets qui n'appartiennent à aucun centre de coûts.
• ... Modifié par
Recherche les objets qui ont été modifiés par des personnes en
particulier.
• … sans AffectPoste
Recherche les objets qui n'ont aucune affectation des postes.
6 Recherche Allfa Plus Allplan 2014

Les filtres sont partiellement disponibles pour différents types d'objets.


L'élément de substitution "…" correspond à l'objet que vous avez
sélectionné, dans lequel la recherche doit être effectuée.
Vous pouvez exécuter la recherche comme indiqué dans les deux
exemples suivants, indépendamment du type d'objet que vous
recherchez.
Lorsque vous sélectionnez un autre type d'objet, d'autres filtres
différents de ceux des exemples peuvent être disponibles.

Rechercher dans Allfa Plus


1 Cliquez sur Recherche.
La boîte de dialogue Rechercher... s'ouvre.
2 Cliquez sur l'onglet Avancée pour utiliser le filtre.

Dans la zone de liste déroulante Rechercher par, vous pouvez


personnaliser un paramétrage par défaut pour le type d'objet pour
lequel vous souhaitez effectuer la recherche.
Manuel d'utilisation Fonctions Allfa Plus 7

3 Cliquez directement sur le type d'objet souhaité.

Dans l'onglet Avancée, vous pouvez désormais sélectionner le filtre


souhaité via la zone de liste déroulante.
4 Cliquez sur le filtre souhaité.

Certains filtres nécessitent des valeurs supplémentaires, comme par


exemple la recherche de pièces modifiées avant une période
donnée.
8 Recherche Allfa Plus Allplan 2014

5 Dans cet exemple, la recherche porte sur les pièces qui ont été
modifiées il y a plus de 5 jours. Il est également nécessaire de saisir
un 5 dans le champ Valeur.

6 Lancez ensuite la recherche au moyen du bouton Recherche.


Vous pouvez également rechercher des pièces qui ont été modifiées
il y a moins de n jours.
Manuel d'utilisation Fonctions Allfa Plus 9

7 Pour rechercher une ou plusieurs personnes ayant apporté des


modifications, sélectionnez le filtre correspondant et saisissez dans
le champ Valeur le nom de la personne. Pour en rechercher
plusieurs, séparez les noms au moyen d'un point-virgule.

8 Lancez la recherche au moyen du bouton Recherche.


Dans le cas d'une recherche telle que Pièces sans type d'utilisation,
il n'est pas nécessaire de renseigner le champ Valeur. La recherche
portera sur toutes les pièces auxquelles aucun type d'utilisation
n'est assigné.
10 Recherche Allfa Plus Allplan 2014

A noter : Pour les filtres de recherche des objets sans critère


particulier, il n'est en général pas nécessaire de saisir une valeur.

Dans la partie inférieure de la boîte de dialogue Rechercher..., les


objets trouvés s'affichent.
9 Pour passer à Allfa TT après la recherche, sélectionnez la ligne de
votre choix. Cliquez ensuite sur Atteindre.
Manuel d'utilisation Fonctions Allfa Plus 11

Etats dynamiques Allfa Plus


Pour utiliser les Etats dynamiques
1 Ouvrez la boîte de dialogue Etats dynamiques à l'aide de l'icône
Etats dynamiques dans Allfa TT.
L'interface utilisateur Etats dynamiques s'ouvre.
Dans le volet droit, vous voyez les différents Etats dynamiques
prédéfinis pour chaque objet de la structure.

2 Vous pouvez sélectionner les objets en cliquant sur les boutons.


Afin d'activer un Etat prédéfini, sélectionnez-le et démarrez la
sortie.
12 Domaine des services Allplan 2014

Exemple : Dans la propriété


Trois Etats dynamiques prédéfinis sont disponibles pour la propriété.
Ils contiennent en partie les mêmes éléments. L'état qui vous convient
va dépendre de ce que vous souhaitez y inclure.
Signification de l'état :
• Code adresse, Catégorie
L'adresse, le code et la catégorie de la propriété sont affichées dans
l'analyse.
• Code, Dés, Clé, Adr
Indique le code, la désignation complète, les numéros de clés
associés et les adresses des propriétés.
• Clé, Code, Dés, Adr
Indique le code, la désignation complète et l'adresse de la propriété.
• Clés
Indique la clé de propriété.

Domaine des services


A partir du niveau Etage dans la Hiérarchie spatiale, un nouvel onglet
Service est disponible. Le domaine des services vous permet de classer
les pièces en fonction des prestations et du cycle de nettoyage.
Les données et analyses nécessaires aux devis concernant le cycle de
nettoyage des pièces et équipements sont ainsi rapidement accessibles
et peuvent être aisément représentées à l'aide des états prédéfinis.

Pour utiliser le nouveau domaine des services


1 Accédez au Mode détails.
Manuel d'utilisation Fonctions Allfa Plus 13

2 Dans l'arborescence de la Hiérarchie spatiale, sélectionnez une


pièce et accédez à l'onglet Service dans l'espace de travail.

3 Sélectionnez le type d'affectation Cycle de nettoyage dans la zone


de liste déroulante Type d'affectation.
14 Domaine des services Allplan 2014

4 Cliquez à l'aide du bouton droit sur la zone vide du champ de détail


et sélectionnez Ajouter type d'affectation dans le menu
contextuel.
Manuel d'utilisation Fonctions Allfa Plus 15

Le catalogue d'activités s'affiche à l'écran.

5 En cliquant sur Ajouter, vous pouvez désormais sélectionner les


activités souhaitées les unes après les autres.
Une fois que vous avez sélectionné toutes les activités, terminez
l'opération en cliquant sur Fermer.
6 Dans l'arborescence, accédez au niveau hiérarchique (en dessous du
niveau de la propriété), à partir duquel vous souhaitez traiter vos
objets complets, puis sélectionnez Etats dynamiques.
16 Domaine des services Allplan 2014

La fenêtre des paramètres des Etats dynamiques s'affiche.

7 Définissez le Filtre temporel et fermez la boîte de dialogue.


Manuel d'utilisation Fonctions Allfa Plus 17

La fenêtre Allfa - Etat dynamique reste affichée.

8 Exécutez l'Etat dynamique en cliquant sur Démarrer la


recherche.
18 Domaine des services Allplan 2014

L'Etat dynamique est actualisé et vos données sont émises.


Manuel d'utilisation Référence des fonctions 19

Référence des fonctions


Fonctions générales de base de données
AddMonths
Description
Ajoute un certain nombre de mois à une valeur de date.
Valeur de retour
Une date. La date originale plus le nombre de mois défini.
Syntaxe
AddMonths (D, M)
La syntaxe de la fonction AddMonths se compose des éléments
suivants :

Elément Description

D Une date. La date à laquelle un nombre de mois


doit être ajouté.
M Un nombre entier. Le nombre de mois à ajouter.
Si la valeur est négative, les mois sont
soustraits.

Remarque
Si la date saisie pour AddMonths n'est pas le dernier jour du mois, le
numéro du jour de la date retournée est identique au numéro du jour
dans le mois de départ. Si le numéro du jour saisi est plus grand que le
numéro du dernier jour du nouveau mois, la fonction AddMonths
retourne comme résultat le dernier jour du nouveau mois.
Cette fonction peut toujours être utilisée.

IfThenElseC; IfThenElseR; IfThenElseI; IfThenElseD


Description
20 Fonctions générales de base de données Allplan 2014

Ces fonctions permettent de comparer deux valeurs. Le retour des


valeurs définies par l'utilisateur dépend du fait que la condition de
comparaison soit remplie ou non.
Valeur de retour

Fonction Type de données Valeur d'erreur

IfThenElseC Texte ERROR


IfThenElseR Nombre réel -999.0
IfThenElseI Nombre entier -9999
IfThenElseD Date 01.01.0100
Valeur d'erreur (voir tableau) : lorsque le type d'expression n'est pas
défini par exemple.
Syntaxe
IfThenElseC (TestValueC, ExprType, CheckValueC, TrueValueC,
FalseValueC)
IfThenElseR (TestValueR, ExprType, CheckValueR, TrueValueR,
FalseValueR)
IfThenElseI (TestValueI, ExprType, CheckValueI, TrueValueI,
FalseValueI)
IfThenElseD (TestValueD, ExprType, CheckValueD, TrueValueD,
FalseValueD)
Attention : Le type de données de la valeur de comparaison et de la
valeur de retour doit être identique. Le type de données de la fonction
doit correspondre à celui de la valeurs de comparaison et de la valeur
de retour.
Manuel d'utilisation Référence des fonctions 21

La syntaxe de la fonction IfThenElseX se compose des éléments


suivants :

Type de
Elément Description
données

TestValueC Texte Valeur à contrôler.


TestValueR Nombre réel Valeur à contrôler.
TestValueI Nombre entier Valeur à contrôler.
TestValueD Date Valeur à contrôler.
ExprType Texte La condition de comparaison. Vous
pouvez sélectionner les conditions de
comparaison dans une liste de
conditions disponibles.
CheckValueC Texte La valeur de comparaison.
CheckValueR Nombre réel La valeur de comparaison.
CheckValueI Nombre entier La valeur de comparaison.
CheckValueD Date La valeur de comparaison.
TrueValueC Texte La valeur de retour lorsque la condition
est remplie.
TrueValueR Nombre réel La valeur de retour lorsque la condition
est remplie.
TrueValueI Nombre entier La valeur de retour lorsque la condition
est remplie.
TrueValueD Date La valeur de retour lorsque la condition
est remplie.
FalseValueC Texte La valeur de retour lorsque la condition
n'est pas remplie.
FalseValueR Nombre réel La valeur de retour lorsque la condition
n'est pas remplie.
FalseValueI Nombre entier La valeur de retour lorsque la condition
n'est pas remplie.
FalseValueD Date La valeur de retour lorsque la condition
n'est pas remplie.
22 Fonctions générales de base de données Allplan 2014

Liste des conditions de comparaison

Fonction Condition de comparaison

IfThenElseC =
<>
IfThenElseR =
IfThenElseI <>
IfThenElseD
<
>
<=
>=

Remarque
Cette fonction peut par exemple être utilisée pour faire figurer des
valeurs d'attributs différentes en fonction de l'aire des pièces dans une
liste récapitulative de toutes les pièces.
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 23

IfThenElseCR ; IfThenElseCI ; IfThenElseCD


Description
Ces fonctions permettent de comparer deux textes. Le retour des
valeurs numériques et des valeurs de date définies par l'utilisateur
dépend du fait que la condition de comparaison soit remplie ou non.
Valeur de retour

Fonction Type de données Valeur d'erreur

IfThenElseCR Nombre réel -999.0


IfThenElseCI Nombre entier -9999
IfThenElseCD Date 01.01.0100

Syntaxe
IfThenElseCR (TestValue, ExprType, CheckValue, TrueValueR,
FalseValueR)
IfThenElseCI (TestValue, ExprType, CheckValue, TrueValueI,
FalseValueI)
IfThenElseCD (TesValue, ExprType, CheckValue, TrueValueD,
FalseValueD)
Attention : Le type de données des deux valeurs de retour possibles
doit être identique. Le type de données de la fonction doit correspondre
à celui de la valeur de retour.
La syntaxe de la fonction IfThenElseCX se compose des éléments
suivants :

Type de
Elément Description
données

TestValue Texte Valeur à contrôler.

ExprType Texte Le type de comparaison, "<", ">"


ou "=".
CheckValue Texte La valeur de comparaison.

TrueValueR Nombre réel La valeur de retour si la


comparaison s'applique.
TrueValueI Nombre entier La valeur de retour si la
comparaison s'applique.
24 Fonctions générales de base de données Allplan 2014

TrueValueD Date La valeur de retour si la


comparaison s'applique.
FalseValueR Nombre réel La valeur de retour si la
comparaison ne s'applique pas.
FalseValueI Nombre entier La valeur de retour si la
comparaison ne s'applique pas.
FalseValueD Date La valeur de retour si la
comparaison ne s'applique pas.

Remarque
Cette fonction peut par exemple être utilisée pour faire figurer des
valeurs d'attributs différentes en fonction de l'aire des pièces dans une
liste récapitulative de toutes les pièces.
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 25

LastWeekDay
Description
Cette fonction retourne la date du jour de la semaine défini par le
paramètre WeekDay qui précède la date spécifiée (paramètre D).
Valeur de retour
Valeur de date
Syntaxe
LastWeekDay (D, WeekDay)
La syntaxe de la fonction LastWeekDay se compose des éléments
suivants :

Elément Description

D Valeur de date.
WeekDay Un nombre entier. WeekDay doit être entré
dans la langue des dates utilisée au cours de
votre session (en fonction du paramètre
d'initialisation de la base de données
NLS_DATE_LANGUAGE). La partie heure de la
date retournée est identique à la partie heure de
la date de départ.
Si le jour de la semaine défini par WeekDay
correspond à la date de départ D, le résultat de
la fonction est la date de départ elle-même.
Exemple : D = '21.09.2009', WeekDay = 1 (Mo)
fournit comme résultat le 21.09.09, car le 21.09.
est également un lundi (WeekDay = 1),
par contre : D = '21.09.2009', WeekDay = 2 (Di)
fournit comme résultat le 15.09.09, car le 21.09.
n'est pas un mardi (WeekDay = 2).

Remarque
Cette fonction équivaut à la fonction NextWeekDay, à la différence
près que 7 jours sont retirés de la date résultat :
Cette fonction peut toujours être utilisée.

LPad
Description
26 Fonctions générales de base de données Allplan 2014

Complète un texte avec des points de suite, depuis la gauche jusqu'à la


longueur spécifiée.
Valeur de retour
Texte
Syntaxe
LPad (String, N, FillChars)
La syntaxe de la fonction LPad se compose des éléments suivants :

Elément Description

String Un texte. Le texte.


N Un nombre entier. Longueur totale du texte
complété.
FillChars Un texte. Chaîne de points de suite.

Remarque
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 27

NvlC; NvlR; NvlI; NvlD


Description
Retourne une valeur de remplacement lorsque la valeur transmise est
NULL. Si la valeur transmise n'est pas NULL, elle est retournée.
Valeur de retour

Fonction Type de données

NvlC Texte
NvlR Nombre réel
NvlI Nombre entier
NvlD Date

Syntaxe
NvlC (ValueC, ReplacementC)
NvlR (ValueR, ReplacementR)
NvlI (ValueI, ReplacementI)
NvlD (ValueD, ReplacementD)
Attention : Le type de données de la fonction et celui de la valeur à
contrôler et de la valeur de remplacement doivent être identiques.
La syntaxe de la fonction NvlX se compose des éléments suivants :

Type de
Elément Description
données

ValueC Texte Valeur à contrôler.


ValueR Nombre réel Valeur à contrôler.
ValueI Nombre entier Valeur à contrôler.
ValueD Date Valeur à contrôler.
ReplacementC Texte Valeur de remplacement si la valeur
à contrôler est NULL.
ReplacementR Nombre réel Valeur de remplacement si la valeur
à contrôler est NULL.
ReplacementI Nombre entier Valeur de remplacement si la valeur
à contrôler est NULL.
28 Fonctions générales de base de données Allplan 2014

ReplacementD Date Valeur de remplacement si la valeur


à contrôler est NULL.

Remarque
Les champs qui ne contiennent aucune valeur retournent la valeur
NULL. Ces fonctions vous permettent d'avoir une remarque ou une
autre valeur plausible plutôt qu'une valeur vide.
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 29

NextWeekDay
Description
Cette fonction retourne la date du jour de la semaine défini par le
paramètre WeekDay qui est consécutif à la date spécifiée (paramètre
D).
Valeur retournée
Valeur de date
Syntaxe
NextWeekDay (D, WeekDay)
La syntaxe de la fonction NextWeekDay se compose des éléments
suivants :

Elément Description

D Valeur de date.
WeekDay Un nombre entier. WeekDay doit être entré
dans la langue des dates utilisée au cours de
votre session (en fonction du paramètre
d'initialisation de la base de données
NLS_DATE_LANGUAGE). La partie heure de la
date retournée est identique à la partie heure de
la date de départ.
Si le jour de la semaine défini par WeekDay
correspond à celui de la date de départ D,
NextWeekDay calcule la date postérieure à la
date de départ D, soit dans ce cas D plus 7 jours.
Généralement, le résultat de la fonction est
toujours postérieur à la date de départ D.
Exemple : D = '21.09.2009', WeekDay = 1 (Mo)
fournit comme résultat le 28.09.2009, car le
21.09. est également un lundi (WeekDay = 1),
par contre : D = '21.09.2009', WeekDay = 2 (Di)
fournit comme résultat le 22.09.2009, soit le
mardi suivant (WeekDay = 2).

Remarque
Cette fonction peut toujours être utilisée.
30 Fonctions générales de base de données Allplan 2014

Replace
Description
Remplace dans un texte chaque occurrence d'une chaîne de caractères
donnée par une autre chaîne de caractères.
Valeur de retour
Un texte. Le texte contenant le caractère de remplacement.
Syntaxe
Replace (String, CompareString, Replacement)
La syntaxe de la fonction Replace se compose des éléments suivants :

Elément Description

String Un texte. Le texte à parcourir.


CompareString Un texte. La chaîne de caractères à rechercher.
Replacement Un texte. La chaîne de caractères de
remplacement.

Remarque
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 31

Round
Description
Arrondit la valeur ou la formule entrée au nombre de décimales
spécifié.
Valeur de retour
La valeur arrondie comme nombre réel.
Syntaxe
Round (R, N)
La syntaxe de la fonction Round se compose des éléments suivants :

Elément Description

R Un nombre réel. Valeur à arrondir.


N Un nombre entier. Nombre de décimales.

Remarque
Si le nombre de décimales est 0, la fonction retourne un nombre entier.
Si le nombre de décimales est négatif, il est arrondi à la dizaine ou à la
centaine suivante. Par exemple, Round(2356, -2) devient 2400.
Cette fonction peut toujours être utilisée.
32 Fonctions générales de base de données Allplan 2014

SearchStringList, SearchStringListEx
Description
Contrôle si un texte ou un modèle de texte d'une liste de modèles de
texte existe dans un texte. Cette fonction peut servir par exemple à
rechercher toutes les pièces dont la désignation1 contient les
expressions "dépôt" et "entrepôt". Les modèles de texte peuvent
contenir les caractères génériques Oracle "%" pour 0 à n caractères ou
'_' pour un caractère quelconque.
Valeur de retour
0: aucune correspondance trouvée
1: une ou des correspondances ont été trouvées
Syntaxe
SearchStringList (SourceString, StringList)
SearchStringListEx (SourceString, StringList, Type)
La syntaxe de la fonction SearchStringList ou SearchStringListEx se
compose des éléments suivants :

Elément Description

SourceString Un texte. Texte quelconque à contrôler (longueur


max. 1999 caractères).
StringList Un texte. Liste de textes ou de modèles de texte à
rechercher délimitée par des points-virgules. Les
modèles de texte peuvent contenir les caractères
génériques Oracle "%" pour 0 à n caractères ou '_'
pour un caractère quelconque.
Type Obligatoire (pour SearchStringListEx uniquement).
Un texte.
"C" pour tenir compte de la casse ; sinon, la casse est
ignorée.
"E" pour une recherche exacte ou "L" pour rechercher
les textes similaires ; sans précision supplémentaire,
les textes similaires sont recherchés à n'importe quel
endroit. Sont possibles par exemple les combinaisons
suivantes : "C", "E", "L", "CE", "CL" ou un texte vide.

Remarque
Manuel d'utilisation Référence des fonctions 33

Cette fonction peut servir par exemple à rechercher dans un site toutes
les pièces dont la désignation débute par ou est similaire à une valeur
figurant dans une liste.
Cette fonction peut toujours être utilisée.
34 Fonctions générales de base de données Allplan 2014

Exemple : SearchStringList
Les pièces contenant les désignations issues d'une liste de désignations
Créer un filtre
Sélectionner le champ de texte (dans le cas présent, la désignation de la
pièce)

Définir le paramètre de type texte pour le modèle de texte que doit


indiquer l'utilisateur.
Manuel d'utilisation Référence des fonctions 35

Définir les critères de filtre

Exemple pour les critères de filtre :


36 Fonctions générales de base de données Allplan 2014

Recherche de désignations de pièces semblables à n'importe quel


endroit :

\SearchStringListEx(#Désignation1#,?Désignations pièces?,"")
= 1

Recherche de désignations de pièces semblables à n'importe quel


endroit, en respectant la casse :

\SearchStringListEx(#Désignation1#,?Désignations pièces?,"C")
= 1

Recherche des désignations de pièces exactes, en respectant la


casse :

\SearchStringListEx(#Désignation1#,?Désignations
pièces?,"CE") = 1

Recherche de désignations de pièces semblables - Les éléments


de substitution Oracle '%' ou '_' doivent être saisis par
l'utilisateur :

\SearchStringListEx(#Désignation1#,?Désignations pièces?,"L")
= 1
Manuel d'utilisation Référence des fonctions 37

Exemple :

Type de recherche non défini

Type de recherche "CL" : la recherche portera sur toutes les


désignations de pièces commençant par WC ou Thé
38 Fonctions générales de base de données Allplan 2014

_
Manuel d'utilisation Référence des fonctions 39

SubString
Description
Extrait, en commençant à la position de départ, une sous-chaîne de
caractères de la longueur spécifiée.
Valeur de retour
Texte
Syntaxe
SubString (Text, Start, Length)
La syntaxe de la méthode SubString se compose des éléments
suivants :

Elément Description

Texte Obligatoire. Valeur de chaîne. Le texte.


Démarrage Obligatoire. Entier. Position de départ. En cas
de position de départ négative, le calcul
s'effectue à partir de la fin du texte.
Length Obligatoire. Entier. Longueur de la chaîne de
caractères à extraire. 0 signifie que toute la
chaîne de caractères doit être extraite.

Remarque
Cette fonction peut toujours être utilisée.
40 Fonctions générales de base de données Allplan 2014

ToCharD
Description
Formate une valeur de date conformément au format spécifié.
Valeur retournée
Texte : valeur de date au nouveau format
Syntaxe
ToCharD (Value, Format)
La syntaxe de la méthode ToCharD se compose des éléments suivants
:

Elément Description

Value Obligatoire. Valeur de date.


Format Obligatoire. Valeur de chaîne. Définit le format.

Modèles de format pour les dates

Masque Description

SCC ou Le siècle. En cas d'utilisation de SCC, toutes les


CC dates antérieures à l'an zéro sont précédées
d'un tiret (-).
SYYYY ou L'année en quatre chiffres. En cas d'utilisation
YYYY de SYYY, toutes les dates antérieures à l'an zéro
sont précédées d'un tiret (-).
IYYY L'année standard ISO à quatre chiffres.
YYY ou Les trois derniers, les deux derniers ou le
YY ou dernier chiffre de l'année. Le siècle en cours est
Y utilisé par défaut.
IYY ou Les trois derniers, les deux derniers ou le
IY ou dernier chiffre de l'année standard ISO. Le
I siècle en cours est utilisé par défaut.
Y,YYY L'année à quatre chiffres avec une virgule.
SYEAR ou L'année en toutes lettres. Le préfixe S ajoute le
YEAR ou signe "moins" devant les dates antérieures à
SYear ou l'an 0.
Year
Manuel d'utilisation Référence des fonctions 41

RR Les deux derniers chiffres de l'année. Ce format


est utilisé pour afficher les années appartenant
à des siècles différents du notre. Lisez à ce sujet
le paragraphe "RR : changement de millénaire".
BC ou Avant ou après l'an 0, saisie sans point.
AD
B.C. ou Avant ou après l'an 0, saisie avec points.
A.D.
Q Le trimestre de l'année ; valeur de un à quatre.
Janvier à mars correspond au premier trimestre,
avril à juin au deuxième, etc.
MM Le numéro du mois, une valeur entre 01 et 12.
Janvier est le mois numéro 01, septembre 09
etc.
RM Le numéro du mois en chiffres romains. Janvier
est I, septembre est IX.
MONTH ou Le nom du mois, soit en majuscules, soit en
Month majuscule et minuscules.
MON ou Le nom du mois abrégé, par exemple JAN pour
Mon janvier.
WW La semaine de l'année, de 1 à 53.
IW La semaine de l'année, de 1 à 52 ou 53,
conformément au standard ISO.
W La semaine dans le mois, de 1 à 5. La semaine 1
débute le premier jour du mois et se termine le
septième.
DDD Le jour de l'année, de 1 à 366.
DD Le jour du mois, de 1 à 31.
D Le jour de la semaine, de 1 à 7. Le jour de la
semaine considéré comme le premier jour est
défini par le paramètre d'initialisation
NLS_TERRITORY de la base de données.
DAY ou Le nom du jour en majuscules ou en majuscule
Day et minuscules
DY Le nom du jour abrégé, par exemple LUN pour
lundi.
42 Fonctions générales de base de données Allplan 2014

J Le format du jour selon le calendrier julien


(compté comme le nombre de jours depuis le
1er janvier 4712 avant Jésus-Christ, la date la
plus ancienne prise en charge par Oracle
RDBMS).
AM ou Indique si l'heure se rapporte à la matinée ou à
PM l'après-midi, sans point.
A.M. ou Indique si l'heure se rapporte à la matinée ou à
P.M. l'après-midi, avec points.
HH ou L'heure de la journée, de 1 à 12.
HH12
HH24 L'heure de la journée, de 0 à 23.
MI La partie minutes de l'heure, de 0 à 59.
SS La partie secondes de l'heure, de 0 à 59.
SSSSS Le nombre secondes depuis minuit de la partie
temporelle. Les valeurs vont de 1 à 86 399 ; une
heure a 3600 secondes.
TH Suffixe qui convertit un nombre en format
ordinal. 4 est par exemple converti en 4th, 1 en
1st. Cet élément peut uniquement figurer à la
fin du masque de format. La valeur retournée
est toujours en anglais, quelle que soit la langue
des dates réglée.
SP Suffixe qui écrit un nombre en toutes lettres.
Par exemple : 4 devient FOUR, 1 devient ONE et
221 devient TWO HUNDRED TWENTY-ONE.
Cet élément peut uniquement figurer à la fin du
masque de format. La valeur retournée est
toujours en anglais, quelle que soit la langue
des dates réglée.
SPTH Suffixe qui écrit un nombre en toutes lettres en
format ordinal. Par exemple : 4 devient
FOURTH et 1 devient FIRST. Cet élément peut
uniquement figurer à la fin du masque de
format. La valeur retournée est toujours en
anglais, quelle que soit la langue des dates
réglée.
FX Elément requérant la correspondance exacte
Manuel d'utilisation Référence des fonctions 43

des dates et du modèle de format (FX est


l'abréviation de Format eXact).
FM Elément paramétrant l'affichage ou non des
espaces dans le résultat de l'opération de
conversion (FM est l'abréviation de FillMode).
Autre texte Tous les signes de ponctuation tels que les
virgules (,), les barres obliques (/) ou les tirets (-)
sont répétés dans le résultat formaté de la
conversion. Vous pouvez aussi inclure des
textes entre guillemets (") qui apparaîtront tels
qu'ils ont été saisis dans la valeur convertie.

Remarque
Lorsqu'un format de date retourne une valeur en toutes lettres (des
mots au lieu de nombres, par exemple les formats MONTH, MON, DAY,
DY, AM et PM), la langue dans laquelle ces mots sont écrits est définie
par les paramètres du National Language Support
(NLS_DATE_LANGUAGE et NLS_LANGUAGE) ou par l'argument
optionnel de langue des dates de TO_CHAR à TO_DATE.
Cette fonction peut toujours être utilisée.
44 Fonctions générales de base de données Allplan 2014

ToCharI
Description
Formate une valeur formée d'un nombre entier conformément au
format spécifié.
Valeur retournée
Texte : nombre entier non formaté
Syntaxe
ToCharI (Value, Format)
La syntaxe de la méthode ToCharI se compose des éléments suivants
:

Elément Description

Obligatoire. Entier. Valeur formée d'un nombre


Value
entier.
Format Obligatoire. Valeur de chaîne. Définit le format.

Modèles de format pour les nombres

Masque Description

9 Chaque 9 représente une position de chiffre


importante qui doit être affichée. Les zéros en
début de nombre sont affichés ou sont
considérés comme des caractères vides
(espaces).
0 Chaque 0 représente une position de chiffre
importante qui doit être affichée. Les zéros en
début de nombre sont affichés ou sont
considérés comme des zéros.
$ Préfixe : insère un caractère "Dollar" avant le
nombre.
B Préfixe : affiche des espaces pour les valeurs
nulles, même si l'élément de format 0 a été
utilisé pour afficher les zéros en début de
nombre.
MI Suffixe : place le signe "moins" ( - ) après un
nombre s'il est négatif. Pour des valeurs
Manuel d'utilisation Référence des fonctions 45

positives, un caractère vide (espace) est affiché


à la fin, ce qui n'est pas la même chose que
NULL.
S Préfixe : place le signe "plus" ( + ) devant un
nombre positif et le signe "moins" ( - ) devant
un nombre négatif.
PR Suffixe : place des chevrons ( < et > ) autour
d'une valeur négative. Pour les valeurs
positives, un caractère vide (espace) est placé
avant et après le nombre.
D Indique la position du point décimal ou de la
virgule décimale dans la valeur de retour. Tous
les éléments de format à gauche de D formatent
la partie entière de la valeur et tous les éléments
de format à droite de D formatent la partie
décimale de la valeur. C'est le paramètre
d'initialisation de la base de données
NLS_NUMERIC_CHARACTERS qui définit s'il
s'agit d'un point décimal ou d'une virgule
décimale.
G Indique la position du séparateur de groupes
(par exemple une virgule ou un point pour
délimiter les milliers : 6.734). Le caractère
utilisé comme séparateur de groupes est défini
par le paramètre d'initialisation de la base de
données NLS_NUMERIC_CHARACTERS.
C Indique la position du symbole de monnaie ISO
dans la valeur de retour.
L Indique la position du symbole de monnaie
local ($ par exemple) dans la valeur de retour.
, (virgule) Indique qu'une virgule doit figurer à cet endroit
dans la valeur de retour.
. (point) Indique qu'un point doit figurer à cet endroit
dans la valeur de retour.
V Multiplie le nombre placé à gauche de V dans le
modèle de format par 10 puissance n, où n est le
nombre de neufs figurant après V dans le
modèle de format.
46 Fonctions générales de base de données Allplan 2014

EEEE Suffixe : indique que la valeur doit être


retournée en notation scientifique.
RN ou rn Indique que la valeur de retour doit être
convertie en chiffres romains en majuscules ou
en minuscules. Seuls les nombres compris entre
1 et 3999 peuvent être convertis en chiffres
romains. La valeur doit être un nombre entier.

Remarque
Exemples de masques de format contenant ces éléments :
• 9.999EEEE
• 00V99
• S9,999,999
• 00009MI
• 999D99
• 9G999G999
• L999.99
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 47

ToCharR
Description
Formate une valeur formée d'un nombre à virgule flottante
conformément au format spécifié.
Valeur retournée
Texte : valeur à virgule flottante non formatée
Syntaxe
ToCharD (Value, Format)
La syntaxe de la méthode ToCharR se compose des éléments
suivants :

Elément Description

Obligatoire. Valeur réelle. Valeur à virgule


Value
flottante.

Format Obligatoire. Valeur de chaîne. Définit le format.

Modèles de format pour les nombres

Masque Description

Chaque 9 représente une position de chiffre


importante qui doit être affichée. Les zéros en
9 début de nombre sont affichés ou sont
considérés comme des caractères vides
(espaces).
Chaque 0 représente une position de chiffre
importante qui doit être affichée. Les zéros en
0
début de nombre sont affichés ou sont
considérés comme des zéros.
Préfixe : insère un caractère "Dollar" avant le
$
nombre.
Préfixe : affiche des espaces pour les valeurs
nulles, même si l'élément de format 0 a été
B
utilisé pour afficher les zéros en début de
nombre.
MI Suffixe : place le signe "moins" ( - ) après un
48 Fonctions générales de base de données Allplan 2014

nombre s'il est négatif. Pour des valeurs


positives, un caractère vide (espace) est affiché
à la fin, ce qui n'est pas la même chose que
NULL.
Préfixe : place le signe "plus" ( + ) devant un
S nombre positif et le signe "moins" ( - ) devant
un nombre négatif.
Suffixe : place des chevrons ( < et > ) autour
d'une valeur négative. Pour les valeurs
PR
positives, un caractère vide (espace) est placé
avant et après le nombre.
Indique la position du point décimal ou de la
virgule décimale dans la valeur de retour. Tous
les éléments de format à gauche de D formatent
la partie entière de la valeur et tous les éléments
de format à droite de D formatent la partie
D
décimale de la valeur. C'est le paramètre
d'initialisation de la base de données
NLS_NUMERIC_CHARACTERS qui définit s'il
s'agit d'un point décimal ou d'une virgule
décimale.
Indique la position du séparateur de groupes
(par exemple une virgule ou un point pour
délimiter les milliers : 6.734). Le caractère
G
utilisé comme séparateur de groupes est défini
par le paramètre d'initialisation de la base de
données NLS_NUMERIC_CHARACTERS.
Indique la position du symbole de monnaie ISO
C
dans la valeur de retour.
Indique la position du symbole de monnaie
L
local ($ par exemple) dans la valeur de retour.
Indique qu'une virgule doit figurer à cet endroit
, (virgule)
dans la valeur de retour.
Indique qu'un point doit figurer à cet endroit
. (point)
dans la valeur de retour.
Multiplie le nombre placé à gauche de V dans le
modèle de format par 10 puissance n, où n est le
V
nombre de neufs figurant après V dans le
modèle de format.
Manuel d'utilisation Référence des fonctions 49

Suffixe : indique que la valeur doit être


EEEE
retournée en notation scientifique.
Indique que la valeur de retour doit être
convertie en chiffres romains en majuscules ou
RN ou rn en minuscules. Seuls les nombres compris entre
1 et 3999 peuvent être convertis en chiffres
romains. La valeur doit être un nombre entier.

Remarque
Exemples de masques de format contenant ces éléments :
• 9.999EEEE
• 00V99
• S9,999,999
• 00009MI
• 999D99
• 9G999G999
• L999.99
Cette fonction peut toujours être utilisée.
50 Fonctions générales de base de données Allplan 2014

ToNumber
Description
Transforme un nombre en format texte en nombre à virgule flottante.
Valeur retournée
Valeur à virgule flottante
Syntaxe
ToNumber(Value, Format)
La syntaxe de la méthode ToNumber se compose des éléments suivants
:

Elément Description

Value Obligatoire. Valeur de chaîne. Texte contenant


le nombre.
Format Obligatoire. Valeur de chaîne. Nombre de
décimales.

Modèles de format pour les nombres

Masque Description

9 Chaque 9 représente une position de chiffre


importante qui doit être affichée. Les zéros en
début de nombre sont affichés ou sont
considérés comme des caractères vides
(espaces).
0 Chaque 0 représente une position de chiffre
importante qui doit être affichée. Les zéros en
début de nombre sont affichés ou sont
considérés comme des zéros.
$ Préfixe : insère un caractère "Dollar" avant le
nombre.
B Préfixe : affiche des espaces pour les valeurs
nulles, même si l'élément de format 0 a été
utilisé pour afficher les zéros en début de
nombre.
MI Suffixe : place le signe "moins" ( - ) après un
nombre s'il est négatif. Pour des valeurs
Manuel d'utilisation Référence des fonctions 51

positives, un caractère vide (espace) est affiché


à la fin, ce qui n'est pas la même chose que
NULL.
S Préfixe : place le signe "plus" ( + ) devant un
nombre positif et le signe "moins" ( - ) devant
un nombre négatif.
PR Suffixe : place des chevrons ( < et > ) autour
d'une valeur négative. Pour les valeurs
positives, un caractère vide (espace) est placé
avant et après le nombre.
D Indique la position du point décimal ou de la
virgule décimale dans la valeur de retour. Tous
les éléments de format à gauche de D formatent
la partie entière de la valeur et tous les éléments
de format à droite de D formatent la partie
décimale de la valeur. C'est le paramètre
d'initialisation de la base de données
NLS_NUMERIC_CHARACTERS qui définit s'il
s'agit d'un point décimal ou d'une virgule
décimale.
G Indique la position du séparateur de groupes
(par exemple une virgule ou un point pour
délimiter les milliers : 6.734). Le caractère
utilisé comme séparateur de groupes est défini
par le paramètre d'initialisation de la base de
données NLS_NUMERIC_CHARACTERS.
C Indique la position du symbole de monnaie ISO
dans la valeur de retour.
L Indique la position du symbole de monnaie
local ($ par exemple) dans la valeur de retour.
, (virgule) Indique qu'une virgule doit figurer à cet endroit
dans la valeur de retour.
. (point) Indique qu'un point doit figurer à cet endroit
dans la valeur de retour.
V Multiplie le nombre placé à gauche de V dans le
modèle de format par 10 puissance n, où n est le
nombre de neufs figurant après V dans le
modèle de format.
52 Fonctions générales de base de données Allplan 2014

EEEE Suffixe : indique que la valeur doit être


retournée en notation scientifique.
RN ou rn Indique que la valeur de retour doit être
convertie en chiffres romains en majuscules ou
en minuscules. Seuls les nombres compris entre
1 et 3999 peuvent être convertis en chiffres
romains. La valeur doit être un nombre entier.

Remarque
Attention : "," et "." sont automatiquement utilisés respectivement
comme séparateur décimal et comme séparateur des milliers.
Exemple de format : "999G999D999"
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 53

TruncDate
Description
Tronque le format de date conformément au type spécifié.
Valeur de retour
Valeur de date tronquée
Syntaxe
TruncDate (D, Type)
La syntaxe de la méthode TruncDate se compose des éléments
suivants :

Elément Description

D Obligatoire. Valeur de date.


Type Obligatoire. Valeur de chaîne. Définit la
manière dont le format de date doit être
tronqué.

Types de troncation de dates

Masque Description

SCC ou Siècle (arrondi à partir du 1er janvier du siècle)


CC
SYYYY ou Année (arrondie à partir du 1er juillet)
YYYY
IYYY
YYY ou
YY ou
Y
IYY ou
IY ou
I
Y,YYY
SYEAR ou
YEAR ou
SYear ou
Year
54 Fonctions générales de base de données Allplan 2014

Q
MM Mois (arrondi à partir du 16e jour du mois)
RM
MONTH ou Month
MON ou
Mon
WW
IW
W
DDD Jour
DD
J
D Premier jour de la semaine
DAY ou
Day
DY
HH ou Heure
HH12
HH24
MI

Remarque
Pour certains types, les paramètres NSL de la session en cours sont
déterminants.
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 55

TruncNum
Description
Tronque la valeur ou la formule entrée au nombre de décimales
spécifié.
Valeur de retour
Valeur à virgule flottante tronquée
Syntaxe
TruncNum (R, N)
La syntaxe de la méthode TruncNum se compose des éléments
suivants :

Elément Description

Obligatoire. Valeur réelle. Un nombre à virgule


R
flottante

N Obligatoire. Entier. Nombre de décimales.

Remarque
Si le nombre de décimales est 0, la fonction retourne un entier. Si le
nombre de décimales est négatif, la valeur est tronquée à la dizaine, la
centaine, etc. la plus proche (par ex. à Trunc(2356, -2) = 2300).
Cette fonction peut toujours être utilisée.
56 Fonctions générales de base de données Allplan 2014

Expressions régulières
Les expressions régulières peuvent notamment contenir les caractères
spéciaux suivants :
. caractères quelconques
répétition quelconque du caractère précédent
*
(0 fois, 1 fois, ....)
répétition quelconque du caractère précédent
+
(1 fois, 2 fois, ....)
^ début de la ligne
$ fin de la ligne
[abcd]
un caractère de l'intervalle indiqué
[a-d]
[^abcd] tous les caractères à l'exception de l'intervalle
[^a-d] indiqué
(devant un métacaractère) : masque le caractère
suivant. Ce caractère perd alors sa signification
\ spéciale.
Exemple : xy\*a\[i\] signifie la chaîne de
caractères xy*a[i]
Formation d'une sous-expression. Il est
( ) possible d'y faire référence lors du
remplacement avec \1 \2 etc.
Lorsque le caractère .*^$[]()\ lui-même doit être utilisé, il faut le
masquer par un antislash (\).
Manuel d'utilisation Référence des fonctions 57

Expression régulière - description complète


c
Un caractère c hormis celui mentionné plus bas, y compris '{', '}', '(', ')',
'>' et '<' se comparent entre eux.
\c
Un caractère masqué c hormis '{', '}', '(', ')', '<', '>', 'b', 'B', 'w', 'W', '+'
et '?' se comparent entre eux.
[char-class]
Reconnaît tous les caractères d'une classe de caractères. Pour que le
caractère ']' d'une classe de caractères puisse être reconnu, il faut
l'entrer en premier. Une plage de caractères est définie à l'aide du
caractère '-', par exemple 'a-z' spécifie la plage des lettres minuscules.
Au lieu d'une définition de plage, vous pouvez également utiliser les
expressions suivantes pour décrire une classe de caractères :

Classe de Signification Préconfiguration


caractères internationale ("POSIX
Locale")

[:alnum:] Caractère [[:alpha:][:digit:]]


alphanumérique
[:alpha:] Lettre [[:upper:][:lower:]]
[:blank:] Espace Espace et tabulation horiz.
[:cntrl:] Caractères de Caractère de contrôle sauf
contrôle espace
[:digit:] Chiffre décimal [0123456789]
[:graph:] Caractère [[:alpha:][:digit:][:punct:]]
typographique
[:lower:] Lettre minuscule [abcdefghijklmnopqrstuv
wxyz]
[:print:] Caractère [ [:graph:]]
imprimable
[:punct:] Signe de []!"#$%&’()*+,./:;<=>?@\
ponctuation ^_‘{|}~[-]
[:space:] Espace libre tous les types d'espaces,
sauts de ligne et
58 Fonctions générales de base de données Allplan 2014

tabulations
[:upper:] Lettre majuscule [ABCDEFGHIJKLMNOPQ
RSTUVWXYZ]
[:xdigit:] Chiffre [[:digit:]A-Fa-f]
hexadécimal
Pour pouvoir rechercher le caractère '-' lui-même, il faut l'indiquer en
première ou en dernière position dans la classe de caractères.
[^char-class]
Reconnaît n'importe quel caractère hormis le caractère "Nouvelles
lignes" et tous les caractères de la classe de caractères définie
^
Si le premier caractère d'une expression régulière est ' ^', la
comparaison commence par le début de la ligne. Dans les autres cas, le
caractère lui-même est recherché.
$
Si le dernier caractère d'une expression régulière est '$', la
comparaison commence par la fin de la ligne. Dans les autres cas, le
caractère lui-même est recherché.
.
Compare exactement un caractère quelconque
(re)
Définit une sous-expression re (vide si possible). Les sous-expressions
peuvent être insérées. Une référence arrière ultérieure sous la forme
'\n', où n peut être un chiffre entre 1 et 9, est remplacée par le texte
trouvé par la sous-expression. Par exemple, l'expression régulière
'(a.c)\1' trouve dans le texte 'abcabc', mais pas dans 'abcadc'. Les
sous-expressions sont triées à partir du caractère séparateur de gauche.
*
Compare un caractère isolé, une expression régulière ou une
sous-expression aucune fois ou autant de fois que nécessaire. Si '*' est
le premier caractère d'une expression régulière ou d'une
sous-expression, le caractère lui-même est recherché. Le caractère '*'
fournit parfois des résultats inattendus. Par exemple, l'expression
régulière 'b*' compare le début du texte avec 'abbb', et non pas avec la
partie de texte 'bbb', car un modèle vide ne peut être comparé qu'au
modèle situé à l'extrémité gauche.
Manuel d'utilisation Référence des fonctions 59

\{n,m\}, \{n,\}, \{n\}


Compare un caractère isolé, une expression régulière ou une
expression au moins n fois et au maximum m fois. Si m est absent,
l'expression doit apparaître au moins n fois. En l'absence de virgule,
l'expression doit apparaître exactement n fois. Si ces formes
apparaissent en première position dans une expression régulière ou
une sous-expression, elles sont interprétées comme des caractères
normaux (par exemple, l'expression régulière '\{2\}' compare le texte
'{2}')
\>, \<
En conjonction avec un caractère isolé, une expression régulière ou
une sous-expression précédé(e) par '\<' ou suivi(e) de '\>', il est possible
de comparer des mots, par exemple en code ASCII, un nombre maximal
de caractères alphanumériques y compris le caractère de soulignement
'_'.
\ `, \'
Comparaison impérative à partir du début de la ligne '\`' et de la fin de
la ligne '\''
\?
Comparaison optionnelle d'un caractère isolé précédant une
expression régulière ou une sous-expression. Par exemple, l'expression
régulière 'a[bd]\?c' réussit à comparer les textes 'abc', 'adc' et 'ac'. Si
vous utilisez '\?' au début d'une expression régulière, la comparaison
porte sur le caractère '?'.
\+
Compare un caractère isolé, une expression régulière ou une
sous-expression au moins une fois ou autant de fois que nécessaire. Si
'\+' est le premier caractère d'une expression régulière ou d'une
sous-expression, le caractère '+' est recherché.
\b
Compare le début ou la fin d'un mot. Par exemple, l'expression
régulière '\bHallo\b' est équivalente à '\'' . '\b\b' est une expression
régulière correcte, par contre '\<\>' n'est pas autorisée.
\B
Compare un texte vide à l'intérieur d'un mot
\w
Compare des caractères quelconques à l'intérieur d'un mot
60 Fonctions générales de base de données Allplan 2014

\W
Compare des caractères quelconques à l'extérieur d'un mot
\n
Comparent les caractères de contrôle ASCII LF et LFCR
\\
Compare le caractère de masquage lui-même
Manuel d'utilisation Référence des fonctions 61

ReplaceRegEx
Description
Recherche dans un texte un modèle de texte (expression régulière) et le
remplace par une autre chaîne de caractères.
Valeur retournée
Texte : le texte contenant le modèle de texte de remplacement
Syntaxe
ReplaceRegEx (Text, Pattern, Replacement)
La syntaxe de la fonction ReplaceRegEx se compose des éléments
suivants :

Elément Description

Texte Un texte. Le texte à parcourir.


Pattern Un texte. Le modèle de texte à rechercher. Des
informations détaillées sur les expressions
régulières.
Replacement Un texte. La chaîne de caractères de
remplacement (peut reprendre des parties du
motif de texte à rechercher).

Remarque
Cette fonction peut toujours être utilisée.
62 Fonctions générales de base de données Allplan 2014

MatchRegEx
Description
Recherche un modèle de texte (expression régulière) dans un texte.
Valeur retournée
1: le texte contient le modèle de texte
0: le texte ne contient pas le modèle de texte
Syntaxe
MatchRegEx (Text, Pattern)
La syntaxe de la fonction MatchRegEx se compose des éléments
suivants :

Elément Description

Texte Un texte. Le texte à parcourir.


Pattern Un texte. Le modèle de texte à rechercher. Des
informations détaillées sur les expressions
régulières.

Remarque
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 63

Fonctions générales spécifiques à Allfa


AttUseCount
Description
Cette fonction calcule le nombre d'utilisations de l'attribut sélectionné
(pour un type d'objet donné ou pour tous les types d'objets).
Valeur retournée
0: l'attribut n'a pas été utilisé
>0: l'attribut a été utilisé autant de fois qu'indiqué
-1: erreur
Syntaxe
AttUseCount (AttID, ObjType)
La syntaxe de la fonction AttUseCount se compose des éléments
suivants :

Elément Description

AttID Un nombre entier. Clé d'identification interne


d'un attribut du catalogue d'attributs.
ObjType Un texte. Lorsqu'une chaîne vide est entrée, le
programme additionne les occurrences de
l'attribut pour tous les types d'objets.

liste des types d'objets

ObjType Désignation de l'objet

<vide> tous les objets


PRP Propriétés
BLD sites ;
SPH Unités spatiales
EQU Equipements
SPC Surfaces
ORG Organisations
64 Fonctions générales spécifiques à Allfa Allplan 2014

OUN Unités d'organisation


POS Postes
TSY Systèmes techniques
TFN Fonctions techniques
ITM Articles
DOC Documents
ATP Types de description
EMP Employés
CCT Centres de coûts
MMG Scénarios de déménagement (FT)
VMG Gestion des visiteurs

Remarque
Cette fonction peut être utilisée pour vérifier l'utilisation des attributs
du catalogue d'attributs.
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Référence des fonctions 65

CountChilds
Description
Cette fonction calcule le nombre d'objets d'un type donné qui font
référence à l'objet en cours. Elle peut par exemple être utilisée pour
déterminer le nombre d'employés d'une unité d'organisation.
Valeur retournée
0: il n'existe aucun objet subordonné
>0: nombre d'objets subordonnés existants
-1: erreur : ObjType n'est pas pris en charge
-2 : erreur : ChildObjType n'est pas pris en charge
Syntaxe
CountChilds (ID, ObjType, ChildObjType)
La syntaxe de la fonction CountChilds se compose des éléments
suivants :

Elément Description

ID Un nombre entier. Clé d'identification interne


d'un objet du type d'objet concerné.
ObjType Un texte. Identificateur du type d'objet actif.
ChildObjType Un texte. Identificateur du type d'objet
subordonné qui fait référence à l'objet actif.
66 Fonctions générales spécifiques à Allfa Allplan 2014

Les relations entre objets suivantes sont prises en charge :

Child
Objet actif Objet subordonné ObjType ObjType

Propriété sites ; PRP BLD


Propriété Fonctions PRP TFN
Propriété Documents PRP DOC
sites ; Unités spatiales BLD SPH
sites ; Equipements BLD EQU
sites ; Fonctions BLD TFN
sites ; Documents BLD DOC
Unité spatiale Occupations SPH OCC
Unité spatiale Equipements SPH EQU
Unité spatiale Surfaces SPH SPC
Unité spatiale Fonctions SPH TFN
Unité spatiale Documents SPH DOC
Equipement Fonctions EQU TFN
Equipement Documents EQU DOC
Organisation Centres de coûts ORG CCT
Organisation Employés ORG EMP
Unités
Organisation ORG OUN
d'organisation
Unité
Postes OUN POS
d’organisation
Unité
Employés OUN EMP
d’organisation
Unité
Occupations OUN OCC
d’organisation
Poste Employés POS EMP
Poste Documents POS DOC
Poste Equipements POS EQU
Manuel d'utilisation Référence des fonctions 67

Poste Occupations POS OCC


Fonction Propriétés TFN PRP
Fonction sites ; TFN BLD
Fonction Unités spatiales TFN SPH
Fonction Equipements TFN EQU
Fonction Documents TFN DOC
Structure
Articles ITC ITM
d'articles
Structure
Attributs ATC ATT
d'attributs

Remarque
Cette fonction peut par exemple être utilisée pour rechercher toutes les
pièces d'un site qui ne sont affectées à aucune fonction d'un système.
Cette fonction ne peut pas être utilisée dans les scénarios.
68 Fonctions générales spécifiques à Allfa Allplan 2014

HasPolygon
Description
La fonction contrôle si un polygone a été défini sur le dessin pour
l'objet Allfa concerné.
Valeur de retour
0: aucun polygone n'a été défini
1: un polygone a été défini
-1: erreur
Syntaxe
HasPolygon (ID, ObjType)
La syntaxe de la fonction HasPolygon se compose des éléments
suivants :

Elément Description

ID Un nombre entier. Clé d'identification interne


d'un objet du type d'objet concerné.
ObjType Un texte. Les valeurs possibles sont disponibles
dans la liste des types d'objets.

Liste des types d'objets

ObjType Désignation de l'objet

PRP Propriété
SPH Unité spatiale
BLD Bâtiments
EQU Equipement
SPC Surface
ORG Organisation
OUN Unité d’organisation
POS Poste
TSY Système technique
TFN Fonction technique
Manuel d'utilisation Référence des fonctions 69

TSA Affectation de fonction


OCC Occupation

Remarque
Cette fonction peut par exemple être utilisée pour rechercher toutes les
pièces qui n'ont pas été dessinées dans un site.
Cette fonction ne peut pas être utilisée dans les scénarios.
70 Fonctions générales spécifiques à Allfa Allplan 2014

HasReference
Description
La fonction contrôle s'il existe une référence externe de l'objet en cours
à un autre objet. Elle permet de déterminer par exemple si un centre de
coûts a été affecté à une pièce.
Valeur de retour
0: il n'existe aucune référence à l'objet tiers
1: il existe une référence à l'objet tiers
-1: erreur : ObjType n'est pas pris en charge
-2 : erreur : ForeignObjType n'est pas pris en charge
Syntaxe
HasReference (ID, ObjType, ForeignObjType)
La syntaxe de la fonction HasReference se compose des éléments
suivants :

Elément Description

ID Un nombre entier. Clé d'identification interne


d'un objet du type d'objet concerné.
ObjType Un texte. Identificateur du type d'objet actif.
ForeignObjType Un texte. Identificateur du type d'objet tiers
auquel l'objet actif fait référence.

Liste des relations entre objets prises en charge

Foreign
Objet actif Objet tiers ObjType ObjType

Unité spatiale Centre de coûts SPH CCT


Unité
Unité spatiale SPH OUN
d’organisation
Type
Unité spatiale SPH OCT
d'utilisation
Catégorie de
Unité spatiale SPH CLC
nettoyage
Equipement Centre de coûts EQU CCT
Manuel d'utilisation Référence des fonctions 71

Equipement Poste EQU POS


Poste Centre de coûts POS CCT
Type
Poste POS OCT
d'utilisation
Propriété Adresse PRP ADR
Bâtiments Adresse BLD ADR
Bâtiments Type de site BLD BTY

Remarque
Cette fonction peut par exemple être utilisée pour rechercher toutes les
pièces d'un site auxquelles aucun type d'utilisation n'a été affecté.
Cette fonction ne peut pas être utilisée dans les scénarios.
72 Fonctions générales spécifiques à Allfa Allplan 2014

ParentAttFieldC; ParentAttFieldR; ParentAttFieldI; ParentAttFieldD


Description
Ces fonctions permettent d'extraire les valeurs d'attributs dynamiques
de niveaux hiérarchiques supérieurs affectés à des objets parents. Elles
peuvent par exemple être utilisées pour faire figurer dans un état
dynamique portant sur un site l'attribut dynamique concerné de la
propriété (1er niveau), et ce même s'il existe des établissements.
Valeur retournée

Fonction Type de données

ParentAttFieldC Texte

ParentAttFieldR Nombre réel

ParentAttFieldI Nombre entier

ParentAttFieldD Date

NULL : lorsque le niveau hiérarchique n'existe pas ou qu'il est


inférieur, ou lorsque le type de champ n'existe pas ou n'est pas pris en
charge
Syntaxe
ParentAttFieldC (ID, ObjType, AttCodePath, Level)
ParentAttFieldR (ID, ObjType, AttCodePath, Level)
ParentAttFieldI (ID, ObjType, AttCodePath, Level)
ParentAttFieldD (ID, ObjType, AttCodePath, Level)
Attention : Le type de données de la fonction utilisée doit
correspondre à celui de l'attribut dynamique appelé.
La syntaxe des méthodes ParentAttFieldx se compose des éléments
suivants :

Elément Description

ID Un nombre entier. Clé d'identification interne d'un


objet du type d'objet concerné.
ObjType Un texte. Identificateur du type d'objet référencé.

AttCodePath Un texte. Code composé de l'attribut dont la valeur


doit être extraite. Les codes des niveaux de structure
doivent être séparés par ".". Les niveaux de structure
Manuel d'utilisation Référence des fonctions 73

inutilisés sont ignorés. Exemple : "G1.G2.M1".


Level Un nombre entier. Niveau hiérarchique de l'objet
référencé pour lequel la valeur doit être extraite.
Vous pouvez extraire les attributs dynamiques des types d'objets
suivants :

ObjType Objet Niveau (secteur)

SPH Unité spatiale 1- 5


BLD sites ; 1
PRP Propriété 1
ORE Unité d’organisation 1-6
TFN Fonctions techniques 1-6

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
74 Fonctions générales spécifiques à Allfa Allplan 2014

ParentFieldC; ParentFieldR; ParentFieldI; ParentFieldD; ParentObjDsc1


Description
Ces fonctions permettent d'extraire les valeurs de champs de niveaux
hiérarchiques supérieurs associés à des objets parents. Elles peuvent
par exemple être utilisées pour faire figurer dans une liste des
équipements la désignation de la structure d'articles d'un niveau
hiérarchique donné.
Valeur retournée

Fonction Type de données

ParentFieldC Texte
ParentFieldR Nombre réel
ParentFieldI Nombre entier
ParentFieldD Date
ParentObjDsc1 Texte
NULL : lorsque le niveau hiérarchique n'existe pas ou qu'il est
inférieur, ou lorsque le type de champ n'existe pas ou n'est pas pris en
charge.
Syntaxe
ParentFieldC (ID, ObjType, FieldType, Level)
ParentFieldR (ID, ObjType, FieldType, Level)
ParentFieldI (ID, ObjType, FieldType, Level)
ParentFieldD (ID, ObjType, FieldType, Level)
ParentObjDsc1 (ID, ObjType, Level)
Attention : Le type de données de la fonction s'obtient par le biais de
celui du champ. Dans le tableau relatif aux types d'objets et de champs,
vous pouvez voir quelles sont les fonctions utilisées pour les différents
champs.
Manuel d'utilisation Référence des fonctions 75

La syntaxe des fonctions ParentFieldx et ParentObjDsc1 se compose


des éléments suivants :

Elément Description

ID Un nombre entier. Clé d'identification interne d'un


objet du type d'objet concerné.
ObjType Un texte. Identificateur du type d'objet référencé.

FieldType Un texte. Identificateur du type de champ dont vous


voulez rechercher la valeur. Le type de champ n'est
pas requis dans le cadre de la méthode
ParentObjDsc1 (la valeur "DSC1" lui est
automatiquement associée).
Level Un nombre entier. Niveau hiérarchique de l'objet
référencé pour lequel la valeur doit être extraite.
Vous pouvez extraire les valeurs des champs listés plus bas pour les
types d'objets suivants :

Obj-T Niveau
ype Objet (secteur) FieldType FieldName Fonction

SPH Unité spatiale 1- 5 DSC1 Désignation 1 ParentFieldC


DSC2 Désignation 2 ParentFieldC
COMM Remarque ParentFieldC
Numéro
ID ParentFieldI
d'identification
ROOMNO N° de la pièce ParentFieldC
AREA Surface ParentFieldR
VOLUME Volume ParentFieldR
PERIMETER Périmètre ParentFieldR
HEIGHT Hauteur ParentFieldR
LENGTH Longueur ParentFieldR
WIDTH Largeur ParentFieldR
BLD sites ; 1 DSC1 Désignation 1 ParentFieldC
DSC2 Désignation 2 ParentFieldC
COMM Remarque ParentFieldC
76 Fonctions générales spécifiques à Allfa Allplan 2014

Numéro
ID ParentFieldI
d'identification
PRP Propriété 1 DSC1 Désignation 1 ParentFieldC
DSC2 Désignation 2 ParentFieldC
COMM Remarque ParentFieldC
Numéro
ID ParentFieldI
d'identification
PRKY Clé de propriété ParentFieldC
Unité
ORE organisationnel 1 - 6 DSC1 Désignation 1 ParentFieldC
le
Désignation de
STRD ParentFieldC
la structure
COMM Remarque ParentFieldC
Numéro
ID ParentFieldI
d'identification
Fonctions
TFN 1-6 DSC1 Désignation 1 ParentFieldC
techniques
Désignation de
STRD ParentFieldC
la structure
COMM Remarque ParentFieldC
Numéro
ID ParentFieldI
d'identification
ITM Articles 1-4 DSC1 Désignation 1 ParentFieldC
DSC2 Désignation 2 ParentFieldC
COMM Remarque ParentFieldC
Numéro
ID ParentFieldI
d'identification
Manuel d'utilisation Référence des fonctions 77

Remarque
Cette fonction permet par exemple d'établir une liste de toutes les
pièces incluant la désignation du type d'utilisation du 1er niveau
hiérarchique.
Cette fonction ne peut pas être utilisée dans les scénarios.
78 Fonctions générales spécifiques à Allfa Allplan 2014

PropValRemarkC; PropValRemarkR; PropValRemarkI; PropValRemarkD


Description
Ces fonctions permettent d'extraire les remarques associées à des
valeurs proposées d'attributs dynamiques.
Valeur retournée

Fonction Type de données

PropValRemarkC Texte
PropValRemarkR Nombre réel
PropValRemarkI Nombre entier
PropValRemarkD Date
NULL : il n'existe aucune valeur proposée comportant une valeur
correspondante.
Syntaxe
PropValRemarkC (AttValC, AttCodePath)
PropValRemarkR (AttValR, AttCodePath)
PropValRemarkI (AttValI, AttCodePath)
PropValRemarkD (AttValD, AttCodePath)
Attention : Le type de données de la fonction doit correspondre à celui
de l'attribut dynamique.
Manuel d'utilisation Référence des fonctions 79

La syntaxe de la fonction PropValRemarkX se compose des éléments


suivants :

Elément Description

AttValC La valeur proposée de type texte, dont la remarque


doit être appelée.
AttValR La valeur proposée de type nombre réel, dont la
remarque doit être appelée.
AttValI La valeur proposée de type nombre entier, dont
la remarque doit être appelée.
AttValD La valeur proposée de type date, dont la remarque
doit être appelée.
AttCodePath Un texte. Code composé de l'attribut dont la valeur
doit être extraite. Les codes des niveaux de structure
doivent être séparés par ".". Les niveaux de structure
inutilisés sont ignorés. Exemple : "G1.G2.M1".

Remarque
Pour assurer la fiabilité de cette fonction, nous recommandons de
verrouiller la modification manuelle des valeurs dans Allfa.
Cette fonction peut toujours être utilisée.
80 Fonctions générales spécifiques à Allfa Allplan 2014

TrimCode0
Description
Supprime les "00000" (5 zéros) dans les codes dont le niveau n'est pas
utilisé.
Valeur de retour
Code ou NULL lorsque code = "00000"
Syntaxe
TrimCode0(Code)
La syntaxe de la fonction TrimCode0 se compose des éléments
suivants :

Elément Description

Code Un texte. Code

Remarque
Dans Allfa, les codes non utilisés sont enregistrés avec "00000" (5
zéros).
Cette fonction peut toujours être utilisée.
Manuel d'utilisation Référence des fonctions 81

Fonctions pour la hiérarchie spatiale


BldCountEmployees
Description
Cette fonction permet de calculer le nombre d'employés dans les unités
spatiales d'un site (en option : tous secteurs de bâtiment compris). Elle
peut par exemple être utilisée pour déterminer le nombre d'employés
qui se trouvent sur un site.
Valeur retournée
Un nombre entier : Nombre
0: aucun employé ou aucune unité spatiale n'a été trouvé.
Syntaxe
BldCountEmployees (BldID, AggFlag)
La syntaxe de la fonction BldCountEmployees se compose des
éléments suivants :

Elément Description

BldID Un nombre entier. Clé d'identification interne


du site.
AggFlag Un texte. Ce commutateur permet d'activer
l'agrégation sur des niveaux hiérarchiques
supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Les postes sans employés ne sont pas pris en compte.
Cette fonction ne peut pas être utilisée dans les scénarios.
82 Fonctions pour la hiérarchie spatiale Allplan 2014

BldCountEquipments
Description
Cette fonction permet de calculer le nombre d'équipements d'un article
ou d'un groupe d'articles dans les unités spatiales d'un site (en option :
tous secteurs de bâtiment compris). Elle peut par exemple être utilisée
pour déterminer le nombre d'équipements d'un article donné qui se
trouvent sur un site.
Valeur retournée
Un nombre entier : Le nombre d'équipements au sein d'un bâtiment.
0: aucun équipement de cet article ou de ce groupe d'articles ou aucune
unité spatiale n'a été trouvé.
Syntaxe
BldCountEquipments (BldID, ItemCodePath, AggFlag)
La syntaxe de la fonction BldCountEquipments se compose des
éléments suivants :

Elément Description

SphID Un nombre entier. Clé d'identification interne


du site.
ItemCodePath Un texte. Code composé de l'article ou des
articles à rechercher. Le code composé peut
aussi contenir "%" représentant des caractères
quelconques. A.B.% signifie par exemple tous
les articles du groupe d'articles A.B
Etant donné que la structure d'articles et le
catalogue d'articles représentent ensemble
6 niveaux hiérarchiques, le code composé doit
toujours (!) contenir 5 points lorsqu'il inclut le
code de l'article lui-même, par ex. "A.B....K".
Lorsqu'aucun code n'est entré pour un niveau,
on suppose que le niveau n'est pas utilisé.
AggFlag Un texte. Ce commutateur permet d'activer
l'agrégation sur des niveaux hiérarchiques
supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Manuel d'utilisation Référence des fonctions 83

Cette fonction ne peut pas être utilisée dans les scénarios.


84 Fonctions pour la hiérarchie spatiale Allplan 2014

BldCountOccupancies
Description
Cette fonction permet de calculer le nombre d'occupations dans les
unités spatiales d'un site (en option : tous secteurs de bâtiment
compris). Elle peut par exemple être utilisée pour déterminer le nombre
d'occupations existant dans un site.
Valeur retournée
Un nombre entier : Le nombre d'utilisations au sein d'un bâtiment.
0: aucune occupation ou aucune unité spatiale n'a été trouvée.
Syntaxe
BldCountOccupancies (BldID, AggFlag)
La syntaxe de la fonction BldCountOccupancies se compose des
éléments suivants :

Elément Description

BldID Un nombre entier. Clé d'identification interne


du site.
AggFlag Un texte. Ce commutateur permet d'activer
l'agrégation sur des niveaux hiérarchiques
supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Référence des fonctions 85

PrpCountEmployees
Description
Cette fonction permet de calculer le nombre d'employés dans les unités
spatiales d'une propriété (en option : tous les établissements compris).
Valeur retournée
Un nombre entier : Le nombre de collaborateurs, qui dans un site
0: aucun employé ou aucune unité spatiale n'a été trouvé.
Syntaxe
PrpCountEmployees (PrpID, AggFlag)
La syntaxe de la fonction PrpCountEmployees se compose des
éléments suivants :

Elément Description

PrpID Un nombre entier. Clé d'identification interne


de la propriété.
AggFlag Un texte. Ce commutateur permet d'activer
l'agrégation sur des niveaux hiérarchiques
supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Les postes sans employés ne sont pas pris en compte.
Cette fonction ne peut pas être utilisée dans les scénarios.
86 Fonctions pour la hiérarchie spatiale Allplan 2014

PrpCountEquipments
Description
Cette fonction permet de calculer le nombre d'équipements d'un article
ou d'un groupe d'articles dans les unités spatiales d'une propriété (en
option : tous les établissements compris). Elle peut par exemple être
utilisée pour déterminer le nombre d'équipements d'un article donné
qui se trouvent sur une propriété.
Valeur retournée
Un nombre entier : Le nombre d'équipements sous un site.
0: aucun équipement de cet article ou de ce groupe d'articles ou aucune
unité spatiale n'a été trouvé.
Syntaxe
PrpCountEquipments (PrpID, ItemCodePath, AggFlag)
La syntaxe de la fonction PrpCountEquipments se compose des
éléments suivants :

Elément Description

PrpID Un nombre entier. Clé d'identification interne


de la propriété.
ItemCodePath Un texte. Code composé de l'article ou des
articles à rechercher. Le code composé peut
aussi contenir "%" représentant des caractères
quelconques. A.B.% signifie par exemple tous
les articles du groupe d'articles A.B
Etant donné que la structure d'articles et le
catalogue d'articles représentent ensemble
6 niveaux hiérarchiques, le code composé doit
toujours (!) contenir 5 points lorsqu'il inclut le
code de l'article lui-même, par ex. "A.B....K".
Lorsqu'aucun code n'est entré pour un niveau,
on suppose que le niveau n'est pas utilisé.
AggFlag Un texte. Ce commutateur permet d'activer
l'agrégation sur des niveaux hiérarchiques
supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Manuel d'utilisation Référence des fonctions 87

Cette fonction ne peut pas être utilisée dans les scénarios.


88 Fonctions pour la hiérarchie spatiale Allplan 2014

PrpCountOccupancies
Description
Cette fonction permet de calculer le nombre d'occupations dans les
unités spatiales d'une propriété (en option : toutes les propriétés
comprises). Elle peut par exemple être utilisée pour déterminer le
nombre d'occupations qui se trouvent sur une propriété.
Valeur retournée
Un nombre entier : Le nombre d'utilisations au sein d'un site.
0: aucune occupation ou aucune unité spatiale n'a été trouvée.
Syntaxe
PrpCountOccupancies (PrpID, AggFlag)
La syntaxe de la fonction PrpCountOccupancies se compose des
éléments suivants :

Elément Description

PrpID Un nombre entier. Clé d'identification interne


de la propriété.
AggFlag Un texte. Ce commutateur permet d'activer
l'agrégation sur des niveaux hiérarchiques
supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Référence des fonctions 89

SphCountEmployees
Description
Cette fonction permet de calculer le nombre d'employés présents dans
des unités spatiales (en option : toutes unités spatiales subordonnées
comprises). Elle peut aussi servir par exemple à identifier les pièces
auxquelles aucun employé n'est assigné.
Valeur retournée
Un nombre entier : Le nombre de collaborateurs au sein d'une unité
spatiale.
0: aucun employé ou aucune unité spatiale n'a été trouvé
Syntaxe
SphCountEmployees (SphID, AggFlag)
La syntaxe de la fonction SphCountEmployees se compose des
éléments suivants :

Elément Description

SphID Un nombre entier. Clé d'identification interne


de l'unité spatiale.
AggFlag Un texte. Ce commutateur permet d'activer
l'agrégation sur des niveaux hiérarchiques
supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Les postes sans employés ne sont pas pris en compte.
Cette fonction ne peut pas être utilisée dans les scénarios.
90 Fonctions pour la hiérarchie spatiale Allplan 2014

SphCountEquipments
Description
Cette fonction permet de calculer le nombre d'équipements d'un article
ou d'un groupe d'articles présents dans des unités spatiales (en option :
toutes unités spatiales subordonnées comprises). Elle peut aussi servir
par exemple à identifier les pièces qui ne contiennent pas un article
donné.
Valeur retournée
Un nombre entier : Le nombre d'équipements au sein d'une unité
spatiale.
0: aucun équipement de cet article ou de ce groupe d'articles ou aucune
unité spatiale n'a été trouvé.
Syntaxe
SphCountEquipments (SphID, ItemCodePath, AggFlag)
La syntaxe de la fonction SphCountEquipments se compose des
éléments suivants :

Elément Description

SphID Un nombre entier. Clé d'identification interne de l'unité spatiale.


ItemCodePath Un texte. Code composé de l'article ou des articles à rechercher. Le
code composé peut aussi contenir "%" représentant des caractères
quelconques. A.B.% signifie par exemple tous les articles du groupe
d'articles A.B
Etant donné que la structure d'articles et le catalogue d'articles
représentent ensemble 6 niveaux hiérarchiques, le code composé
doit toujours (!) contenir 5 points lorsqu'il inclut le code de l'article
lui-même, par ex. "A.B....K". Lorsqu'aucun code n'est entré pour un
niveau, on suppose que le niveau n'est pas utilisé.
AggFlag Un texte. Ce commutateur permet d'activer l'agrégation sur des
niveaux hiérarchiques supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Référence des fonctions 91

SphCountOccupancies
Description
Cette fonction permet de calculer le nombre d'occupations dans des
unités spatiales (en option : toutes unités spatiales subordonnées
comprises). Elle peut aussi servir par exemple à identifier les pièces
auxquelles aucune occupation n'est assignée.
Valeur retournée
Un nombre entier : Le nombre d'utilisations au sein d'une unité
spatiale.
0: aucune occupation ou aucune unité spatiale n'a été trouvée
Syntaxe
SphCountOccupancies (SphID, AggFlag)
La syntaxe de la fonction SphCountOccupancies se compose des
éléments suivants :

Elément Description

SphID Un nombre entier. Clé d'identification interne


de l'unité spatiale.
AggFlag Un texte. Ce commutateur permet d'activer
l'agrégation sur des niveaux hiérarchiques
supérieurs. Valeur "Yes" ou "No". Valeur par
défaut : "Yes" -> L'agrégation est effectuée.

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
92 Fonctions pour la hiérarchie spatiale Allplan 2014

SphDefaultArea
Description
Cette fonction calcule l'aire prévue de toutes les occupations d'une
pièce.
Valeur de retour
Un nombre réel : aire prévue en m²
Syntaxe
SphDefaultArea (SphID)
La syntaxe de la fonction SphDefaultArea se compose des éléments
suivants :

Elément Description

SphID Un nombre entier. Clé d'identification interne


de l'unité spatiale.

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Référence des fonctions 93

SphEmployeeList
Description
Cette fonction génère une liste délimitée par des virgules de tous les
employés d'une pièce.
Attention : Si l'employé est affecté à plusieurs postes, il apparaît
également plusieurs fois sur la liste !
Valeur retournée
Texte
Syntaxe
SphEmployeeList (SphID, Type)
SphEmployeeList2 (SphId, Type, Separator)
La syntaxe de la fonction SphEmployeeList se compose des éléments
suivants :

Elément Description

Un nombre entier. Clé d'identification interne


SphId
de l'unité spatiale.
Un texte. Cette entrée permet de configurer la
Type
structure de la liste.
Caractère de séparation entre les différents
Separator employés. Avec "CHR(13)", vous pouvez
indiquer un saut de ligne. Standard ", "

Liste des types

Type Description

N Nom (Modèle)
Prénom et nom
VN
(Jean Modèle)
Nom et prénom
NV
(Modèle, Henri)
Premier caractère du prénom et nom
V1N
(J. Modèle)
94 Fonctions pour la hiérarchie spatiale Allplan 2014

Nom et premier caractère du prénom


NV1
(Modèle, J.)
Titre, prénom et nom
TVN
(Dr Jean Modèle)
Titre, premier caractère du prénom et nom
TV1N
(Dr J. Modèle)
Titre, abréviation, prénom et nom
TKVN
(Dr Min Jean Modèle)
Pour que le code du poste précède le nom, vous pouvez placer le type
"SZ" devant, par exemple "SZNV1".
Pour utiliser le séparateur de champ standard ", " après le code de
poste, vous devez saisir un "/" après "SZ", sinon le caractère de
séparation entre le code de poste et le nom sera ":" .
Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Référence des fonctions 95

SphFreeArea
Description
Cette fonction calcule l'aire non affectée d'une pièce.
Valeur de retour
Un nombre réel : L'aire non affectée en m².
Syntaxe
SphFreeArea (SphID)
La syntaxe de la fonction SphFreeArea se compose des éléments
suivants :

Elément Description

SphID Un nombre entier. Clé d'identification interne


de l'unité spatiale.

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
96 Fonctions pour la hiérarchie spatiale Allplan 2014

SphOrgUnitList
Description
Cette fonction génère une liste délimitée par des virgules de toutes les
unités d'organisation des postes affectés d'une pièce.
Valeur retournée
Texte
Syntaxe
SphOrgUnitList (SphID, Type)
SphOrgUnitList2 (SphID, Type, Separator)
La syntaxe de la fonction SphOrgUnitList se compose des éléments
suivants :

Elément Description

SphID Un nombre entier. Clé d'identification interne


de l'unité spatiale.
Type Un texte. Cette entrée permet de configurer la
structure de la liste.
Separator Caractère de séparation entre les différentes
unités d'organisation. Avec "CHR(13)", vous
pouvez indiquer un saut de ligne. Le caractère
de séparation par défaut est ",".

Liste des types

Type Description

DSC1 Désignation
STRD Désignation de la structure

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Référence des fonctions 97

SphPositionList
Description
Cette fonction génère une liste délimitée par des virgules de tous les
postes d'une pièce.
Valeur de retour
Texte
Syntaxe
SphPositionList (SphID, Type)
SphPositionList2 (SphID, Type, Separator)
La syntaxe de la fonction SphPositionList se compose des éléments
suivants :

Elément Description

SphID Un nombre entier. Clé d'identification interne


de l'unité spatiale.
Type Un texte. Cette entrée permet de configurer la
structure de la liste.
Separator Caractère de séparation entre les différents
postes. Avec "CHR(13)", vous pouvez indiquer
un saut de ligne. Le caractère de séparation par
défaut est ",".

Liste des types

Type Description

SZ Code de poste

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
98 Fonctions pour l'utilisation Allplan 2014

Fonctions pour l'utilisation


PosEmployeeAttList
Description
Cette fonction génère une liste délimitée par des virgules d'un attribut
de tous les employés d'un poste
Valeur de retour
Texte : Liste d'un attribut de tous les employés d'un poste
Syntaxe
PosEmployeeAttList (PosID, AttCodePath)
La syntaxe de la fonction PosEmployeeAttList se compose des
éléments suivants :

Elément Description

PosID Un nombre entier. La clé d'identification


interne du poste.
AttCodePath Un texte. Le code composé de l'attribut dont la
valeur doit être extraite. Les codes des niveaux
de structure doivent être séparés par ".". Les
niveaux de structure inutilisés sont ignorés.
Exemple : "G1.G2.M1".

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Référence des fonctions 99

PosEmployeeList
Description
Cette fonction génère une liste délimitée par des virgules de tous les
employés d'un poste.
Valeur de retour
Texte : liste des employés
Syntaxe
PosEmployeeList (PosID, Type)
La syntaxe de la fonction PosEmployeeList se compose des éléments
suivants :
La sy ntaxe de la méthode

Elément Description

Obligatoire. Un nombre entier. Clé


PosID
d'identification interne du poste.
Un texte. Cette entrée permet de configurer la
Type
structure de la liste.

Liste des types

Type Description

N nom (Martin)
VN prénom et nom (Henri Martin)
V1N initiale du prénom nom (H. Martin)
TVN titre prénom nom (Dr Henri Martin)
TV1N titre initiale du prénom nom (Dr H. Martin)
titre abréviation prénom nom (Dr min Henri
TKVN
Martin)

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
100 Fonctions pour les fonctions techniques Allplan 2014

Fonctions pour les fonctions techniques


FunSumRoomArea
Description
Cette fonction permet de calculer la somme des aires de toutes les
unités spatiales (y compris les unités spatiales subordonnées) affectées
à la fonction.
Valeur de retour
Un nombre réel : La somme des surfaces.
0: aucune unité spatiale n'a été affectée.
Syntaxe
FunSumRoomArea (FunID)
La syntaxe de la fonction FunSumRoomArease compose des éléments
suivants :

Elément Description

FunID Un nombre entier. Clé d'identification interne


de la fonction.

Remarque
Cette fonction ne peut pas être utilisée dans les scénarios.
Manuel d'utilisation Index 101

Index
A IfThenElseCx 23
IfThenElsex 20
AddMonths 19
Annotation (graphique) 2 L
Attributs (dynamiques) 3 LastWeekDay 25
Attributs dynamiques 3 LPad 26
AttUseCount 64
M
B
MatchRegEx 63
BldCountEmployees 82
BldCountEquipments 83 N
BldCountOccupancies 85 NextWeekDay 29
C Nvlx 27

Catalogue d’articles 3 P
Catalogue de nettoyage 4 ParentAttFieldx 73
CountChilds 66 ParentFieldx 75
D ParentObjDsc1 75
PosEmployeeList 100
Domaine des services 3, 12 PropValRemarkx 79
E R
Etats dynamiques 2, 10 Rechercher 5
F Référence des fonctions 19
AttUseCount 64
Filtre de recherche 2 CountChilds 66
Fonctionnalités 2 FunSumRoomArea 101
Annotation (graphique) 2 HasPolygon 69
Attributs dynamiques 3 HasReference 71
Catalogue d’articles 3 IfThenElseCx 23
Catalogue de nettoyage 4 IfThenElsex 20
Domaine des services 3, 12 LastWeekDay 25
Etats dynamiques 2, 10 LPad 26
Filtre de recherche 2 MatchRegEx 63
Fonctions de base de données NextWeekDay 29
3 Nvlx 27
Fonctions de base de données 3 ParentAttFieldx 73
FunSumRoomArea 101 ParentFieldx 75
H ParentObjDsc1 75
PosEmployeeList 100
HasPolygon 69
PropValRemarkx 79
HasReference 71
Replace 31
I ReplaceRegEx 62
Round 32
102 Index Allplan 2014

SearchStringList 33
SearchStringListEx 33
SphCountEmployees 90
SphCountEquipments 91
SphCountOccupancies 92
SphDefaultArea 93
SphEmployeeList 94
SphFreeArea 96
SphOrgUnitList 97
SphPositionList 98
SubString 40
ToCharD 41
ToCharI 45
ToCharR 48
ToNumber 51
TrimCode0 81
TruncDate 54
TruncNum 56
Replace 31
ReplaceRegEx 62
Round 32
S
SearchStringList 33
SearchStringListEx 33
SphCountEmployees 90
SphCountEquipments 91
SphCountOccupancies 92
SphDefaultArea 93
SphEmployeeList 94
SphFreeArea 96
SphOrgUnitList 97
SphPositionList 98
SubString 40
T
ToCharD 41
ToCharI 45
ToCharR 48
ToNumber 51
TrimCode0 81
TruncDate 54
TruncNum 56

Vous aimerez peut-être aussi