8 Naamgeving Parameter
We onderscheiden 3 soorten parameters dewelke door een gebruiker kunnen worden aangemaakt:
- Loadable Family Parameters
- Project Parameters
- Shared Parameters
8.1 Algemene afspraken
Er gelden een aantal algemene afspraken wat betreft naamgeving van Parameters:
- Hoofdletters mogen alleen worden gebruikt in positie 1,2 en 3. De omschrijving op positie 4 dient te worden genoteerd in PascalCase (Revit is hoofdlettergevoelig);
- PascalCase: meerdere woorden worden zonder spaties samengesteld, elk woord (inclusief het eerste woord) begint met een hoofdletter (bijv. DraaicirkelSymbool)
- Gebruik een underscore ( _ ) als scheidingsteken tussen de posities;
- Spaties alsook leestekens zoals “+ - / *” mogen niet worden gebruikt;
- Het weglaten of leeg laten van posities is niet toegestaan.
8.2 Loadable Family Parameters
Loadable Family Parameters zijn parameters t.b.v. de sturing van Families, deze kunnen niet in een Schedule worden uitgelezen.
8.3 Project Parameter
Projectparameters zijn parameters die worden aangemaakt op projectniveau, een Project Parameter kan ook ingelezen worden vanuit een shared parameter GUID. Projectparameters zijn parameters die exclusief in het project zelf worden opgenomen t.b.v. de organisatie van System Families, Rooms, Project Information, Views, etc. Ze worden minder vaak gebruikt voor Loadable Families omdat de parameter toegevoegd wordt voor alle Loadable Families van een bepaalde Revit Category terwijl dit niet altijd gewenst is. Bijkomend kunnen deze parameters aangemaakt worden om te verwerken in Key Schedules waarin geen shared parameters verwerkt kunnen worden. Deze parameters worden in Revit automatisch alfabetisch opgesomd in het Project Parameter dialoogvenster.
8.4 Shared Parameter
8.4.1 BERSnl
Shared Parameters zijn parameters waarvan de GUID in een .txt bestand wordt opgeslagen en zodoende kan worden hergebruikt en gedeeld tussen verschillende Families en projectmodellen.
Het gebruik van Shared Parameters is essentieel wanneer eigenschappen van Families in schedules uitgelezen dienen te worden of wanneer ze dienen te worden geëxporteerd.
De BERSnl levert een generieke Shared Parameter lijst aan, dewelke als bijlage bij deze documentatie is toegevoegd. De bedoeling van deze lijst is om ervoor te zorgen dat de voornaamste maatgevende parameters in Families kunnen worden doorgelust naar de generieke BERSnl parameters. Zodoende kan informatie steeds op dezelfde manier uitgelezen worden in Schedules. De parameters t.b.v. het mechanisme en het intern gebruik kunnen nog steeds benoemd worden volgens de bepalingen in voorgaande artikels.
8.4.2 Gebruiker
Als de Revit-gebruiker zelf een aantal Shared Parameters dient aan te maken dient dit te gebeuren volgens onderstaand naamgevingsprincipe.
Principe naamgeving Parameter
| Positie | Beschrijving | Karakters | Voorbeeld |
|---|---|---|---|
| <pos 1> | auteur of content provider | zo kort mogelijk | XXX |
| <pos 2> | discipline | 1 | C |
| <pos 3> | type of parameter (data type) | 2 | TX |
| <pos 4> | omschrijving | vrij maar logisch | OpdrachtgeverAdres |
- Voorbeeld Loadable Family Parameter: XXX_C_YN_Dorpel
- Voorbeeld Project Parameter: XXX_C_TX_GebouwReferentie
- Voorbeeld Shared Parameter: XXX_C_TX_OpdrachtgeverAdres
<pos 2> discipline
Op deze positie dient de afkorting van de discipline waarop de parameter van toepassing is te worden vermeld.
<pos 3> type of parameter (data type)
Op deze positie dient de afkorting van het type of parameter te worden vermeld.