INHOUDSOPGAVE
- Algemeen
Algemeen
Voordat u aan de slag gaat met TheModus adviseren wij u eerst onderstaande artikelen goed door te nemen.
Deze artikelen helpen u bij de installatie en configuratie van TheModus.
TheModus maakt gebruik van een module genaamd "Gebruikersbeheer". Het Gebruikersbeheer geeft u de mogelijkheid om zelf te bepalen wie in uw organisatie gebruik gaat maken van TheModus en welke producten zij mogen gebruiken. Zodra een aankoop plaatsvindt van TheModus wordt u met behulp van e-mails geïnstrueerd hoe en waar uw collega's toe te voegen.
De functionaliteiten van TheModus zijn verzameld in één addin voor Autodesk Revit. Deze addin moet worden geïnstalleerd alvorens de gebruikers ervan gebruik kunnen maken. Deze addin is beschikbaar in een klein installatiepakket, welke bij iedere gebruiker geïnstalleerd moet worden. Ook de gebruikers worden via e-mail geïnformeerd waar ze deze addin kunnen downloaden.
Eerste keer aanmelden
Zodra u als TheModus gebruiker bent aangemeld in het gebruikersbeheer van TheModus ontvangt u onderstaande mail.
Als u reeds een TheModus gebruiker bent en TheModus is bij u geïnstalleerd, dan hoeft u niets meer te doen. U kunt Autodesk Revit opstarten en direct aan de slag gaan.
Als u een nieuwe gebruiker bent, dan moet u eerst uw account aanmaken en activeren.
Volg onderstaande stappen om uw account te maken en te activeren:
- Klik [ Naar Cadac TheModus ]
U krijgt een inlogscherm. Ditzelfde inlogscherm krijgt u als u TheModus opstart in Autodesk Revit of direct naar het portaal gaat via https://themodus.cadac.com.
- Klik Create an account;
Een nieuw scherm verschijnt:
- Geef uw email adres op;
- Geef uw gewenste wachtwoord op;
- Herhaal dit wachtwoord;
- Klik [ Create account ]
U krijgt nu een email, waarin u uw account moet valideren. - Valideer uw account.
Uw account is aangemaakt. U heeft nu toegang tot TheModus. U kunt nu TheModus installeren. Zie hiervoor de onderstaande artikelen.
Systeemvereisten
Voor TheModus zijn de minimale systeemeisen primair overeenkomstig met de eisen van Autodesk Revit.
Besturingssysteem
- Windows 7-sp1, x64
- Windows 8, x64
- Windows 10, x64
Programma’s
- De actuele versie van Autodesk Revit en de drie voorgaande releases. Voor allen alleen inclusief de laatste service packs / updates.
- Microsoft .NET Framework 4.5
- Internet browser: Microsoft Edge of Google Chrome
Systeem
- Circa 50 MB vrije schijfruimte voor de applicatie
- Grafische resolutie ten minste 1280x1024
- Om met Cadac TheModus te werken dient u over een actieve internetverbinding te beschikken
- De applicatie kan gewenste content cachen. Afhankelijk van de content moet hiervoor ruimte gereserveerd worden!
Toegangscontrole en Firewalls
- Standaardpoorten TCP/IP 80 en 443 zijn niet geblokkeerd.
- Voeg "https://themodus.cadac.com" toe aan de trusted sites
- Internet browser blokkeert geen scripts
- De volgende URL’s moeten worden toegelaten door Firewalls:
Software downloaden
Cadac TheModus wordt als ".msi" installatiepakket beschikbaar gesteld met een bestandsnaam "TheModus.Revit.Addin.Installer.
Volg onderstaande stappen voor het downloaden van de meest recente versie van TheModus:
- Open een internetbrowser, bij voorkeur Google Chrome of Microsoft Edge;
- Ga naar https://themodus.cadac.com
- Op de startpagina staat een verwijzing naar de downloads. Klik hier en de download start. Afhankelijk van uw internet browser wordt het installatiebestand lokaal opgeslagen.
Basisinstallatie
Een Microsoft Windows gebruiker die in Microsoft Windows bekend is als een “Standaard gebruiker” kan Cadac TheModus installeren.
Volg onderstaande stappen voor het installeren van TheModus:
- Dubbelklik op het installatiepakket “TheModus.Revit.Addin.Installer.msi”. De installatie start met een welkom scherm.
- Klik [ VOLGENDE ]
De installatie duurt enkele seconden. De voortgang wordt getoond.
Zodra de installatie gereed is wordt dit getoond.
- Klik [ Afsluiten ] om de installatie procedure af te sluiten.
Cadac TheModus is nu geïnstalleerd.
Trial, of de eerste keer opstarten
Zodra Autodesk Revit wordt opgestart, wordt ook TheModus opgestart.
Als u tijdens de installatie heeft opgegeven dat u gebruik maakt van een 'Trial' dan wordt eerst het 'trial'-scherm getoond. Zo niet dan gaat u rechtstreeks door naar het inlogscherm.
- Geef uw naam, e-mailadres en bedrijfsnaam op.
- Selecteer het gewenste product:
- Essential
- Professional
- Klik [ OK ]
U kunt TheModus 30 dagen als trail gebruiken.
Heeft u inmiddels een licentie en heeft uw beheerder u toegang verleend tot TheModus, klik dan bij het 'Trail'-scherm op:
[ Ik heb een licentie ]
Daarna wordt alles geïnitialiseerd. De volgende keer dat u opstart zal deze vraag niet meer worden gesteld.
Vervolgens kunt u inloggen op het inlogscherm:
- Geef uw E-mailadres
- Geef uw Wachtwoord
- Klik [ Inloggen ]
U kunt TheModus gebruiken.
Update
Het is van groot belang dat de gebruiker altijd gebruik maakt van de laatste addin. Daarmee maakt u altijd gebruik van de meest recente features.
TheModus controleert zelf bij het opstarten op kritieke updates. Als blijkt dat er een kritieke update beschikbaar is wordt direct na het opstarten gevraagd of u de update wilt installeren. Als u dit niet doet zal TheModus tijdelijk uitgeschakeld worden in Revit. Dit ter voorkoming van ernstige storingen omdat de client en de cloud niet correct met elkaar kunnen communiceren. U kunt dan wel doorwerken met Revit. TheModus wordt weer actief zodra de update is geïnstalleerd.
TheModus kent 3 typen updates:
- De verplichte update (1.x.x)
In geval van een verplichte update is er altijd sprake van een verplichte wijziging in de addin vaak als gevolg van nieuwe functionaliteiten en/of wijzigingen in de cloud. Als dit van toepassing is, krijgt u een melding tijdens het opstarten van Revit zodra TheModus actief wordt. U moet de addin updaten. Als u besluit dit op een later tijdstip te doen, dan wordt de addin uitgeschakeld. U kunt dan wel gewoon verder werken met Revit met alle beschikbare content in het Revit project. - De niet verplichte update (x.1.x)
In geval van een niet verplichte update is er doorgaans sprake van functionele uitbreiding van één of meerdere beschikbare features binnen TheModus. Bij een niet verplichte update krijgt u een melding tijdens het opstarten van Revit zodra TheModus actief wordt. U kunt ervoor kiezen om deze update op een later tijdstip uit te voeren. Met de huidige addin kan gewoon verder gewerkt worden. - Fixes (x.x.1)
In geval van Fixes is er sprake van een storing in de addin of een minimale gewenste aanpassing of uitbreiding. Deze kan zeer specifiek zijn voor een bepaalde klant. U wordt niet automatisch gewaarschuwd bij het opstarten. U kunt wel altijd zelf controleren op updates, via het about scherm.
Beheerders kunnen in het register afdwingen of update meldingen wel of niet mogen worden getoond. Zie hiervoor de paragraaf “Informatie voor ICT”.
In geval van verplichte updates is het cruciaal dat beheerders ervoor zorgen dat TheModus bij de eindgebruikers up-to-date is. Indien een verplichte update niet heeft plaatsgevonden wordt de addin uitgeschakeld ter voorkoming van storingen. De gebruiker heeft dan geen toegang meer.
U kunt zelf controleren of TheModus up-to-date is. Volg onderstaande stappen om naar updates voor Cadac TheModus te zoeken:
- Ga naar de knoppenbalk [ Cadac Revit ]
- Klik op [ Help ] in het paneel [ Algemeen ] en klik [ Over ]
- Klik [ Controleer op updates ]
- Klik [ Update ]
Het downloadproces van de meest recente addin start nu. Afhankelijk van uw internet browser wordt het installatiebestand lokaal opgeslagen. - Sluit Revit af om de update te kunnen installeren.
- Wanneer u de vraag krijgt of u de update wilt installeren, klik [ Ja ]
- Volg de stappen in het installatieproces.
Bij een update procedure gelden de volgende opmerkingen:
- Indien een update procedure is toegestaan, worden de paden gerespecteerd zoals bij de initiële installatie is meegegeven. Deze paden worden uit het register gehaald
- Indien een update procedure is toegestaan, moet de gebruiker schrijfrechten hebben op die plekken waar nieuwe informatie geschreven kan worden
- Bij een update procedure worden de volgende mappen bijgewerkt zoals ingesteld bij:
- TARGETDIR, waar de programma bestanden staan
- CONFIGPATH, waar de configuratie bestanden staan
- CONTENTPATH, waar de content definities staan
- Niet alle bestanden worden bijgewerkt. Er zijn enkele bestanden die de gebruiker of beheerder zelf zal moeten bijwerken. Deze bestanden kunnen namelijk aangepast zijn door gebruikers. Deze bestanden zijn:
- TheModus_COG_Mapping.xml
- MepSystemTypes.xml
- PipeDefinitions.xml
- Pipesystems.xml
- PipeTypes.xml
- RevitMaterials.xml
- AECSettings.xml
- TagSettings.xml
- TopLevel.xml
TheModus Fonts
TheModus heeft speciaal voor de constructeurs een aparte set met paalfunderingssymbolen. Deze symbolen zijn als lettertype verwerkt in het TheModus Font File.
U heeft beheerder privileges nodig op uw workstation. Indien u deze niet heeft zult u contact moeten opnemen met uw systeembeheerder voor het installeren van deze font file.
Volg onderstaande stappen om de installatie software te downloaden en te installeren.
- Open de verkenner en ga naar de configuratie bestanden. Standaard vindt u deze onder %localappdata%\Cadac Group\TheModus Revit Addin\Config\Main.
Indien uw beheerder de installatie heeft uitgevoerd, kan dit pad anders zijn. Neem dan content op met uw beheerder. - Zoek naar TheModus.ttf
- Dubbel klik TheModus.ttf
- Klik [ Installeren ]
De installatie wordt opgestart - De installatie gebeurt zeer snel. Sluit de voorbeeld weergave zodra de knop [ Installeren ] is uitgeschakeld.
Installatie herstellen of verwijderen
Wanneer u Cadac TheModus wilt herstellen, volg dan onderstaande stappen:
- Dubbelklik op het installatiepakket “TheModus.Revit.Addin.Installer.msi”.
De installatie start met een welkom scherm.
- Activeer [] 'Repareer TheModus Revit Addin'
- Klik [ VOLGENDE ]
De voortgang wordt getoond.
- Klik [ AFSLUITEN ]
De installatie is hersteld.
Wanneer u Cadac TheModus wilt verwijderen, volg dan onderstaande stappen:
- Dubbelklik op het installatiepakket “TheModus.Revit.Addin.Installer.msi”
De installatie start met een welkom scherm.
- Activeer [] 'Deinstalleer TheModus Revit Addin'
- Klik [ VOLGENDE ]
- Klik:
- [ JA ] om TheModus te verwijderen
De voortgang wordt getoond - [ NEE ] om TheModus te behouden
- [ JA ] om TheModus te verwijderen
- Klik [ AFSLUITEN ]
De installatie is verwijderd.
Specifieke gebruikersinformatie wordt niet verwijderd.
Informatie voor ICT
Paden bij een standaard installatie
Nadat een standaard installatie is uitgevoerd zijn de programma bestanden geplaatst in:
- %localappdata%\Cadac Group\Base Revit Addin. Hier staan alle standaard Autodesk Revit gerelateerde programma bestanden van Cadac.
- %localappdata%\Cadac Group\TheModus Revit Addin. Hier staan alle TheModus specifieke programma bestanden van Cadac.
Voor alle relevante instellingen is er een apart configuratiepad, namelijk: %localappdata%\Cadac Group\TheModus Revit Addin\Config. Dit pad bevat enkele submappen voor de specifieke toepassingen. Het is noodzakelijk dat de gebruiker schrijfrechten heeft in deze mappen! De specifieke toepassingen zijn:
| Pad: | Omschrijving: |
| ..\\CoG | Bevat de configuratiebestanden voor de Center of Gravity |
| ..\\Content | Bevat de configuratiebestanden voor het plaatsen van (eigen) content |
| ..\\Documentation | Bevat de configuratiebestanden voor de documentatie onderdelen |
| ..\\Logfiles | Bevat de logfiles |
| ..\\Main | Bevat de functie overstijgende configuratiebestanden |
Nadat bepaalde functionaliteiten de eerste keer worden gebruikt worden extra paden toegevoegd. Dit zijn:
| Pad: | Omschrijving: |
| ..\\Patterns | Bevat de patroonbestanden voor de verdeelfuncties |
| ..\\Sort | Bevat de configuratiebestanden voor de structureerfuncties |
| ..\\UserData | Bevat de bestanden van de actieve gebruikers |
Verder staan in de map %localappdata%\Cadac Group\TheModus Revit Addin diverse andere instellingen, te weten:
| Pad: | Omschrijving: |
| ..\\Content | Alle content gerelateerde bestanden |
| ..\\UserContent | Alle content gerelateerde bestanden uit uw eigen bibliotheek |
| ..\\Logs | Alle logbestanden |
| ..\\nl-NL | Alle taal resources |
| ..\\Cache | Alle gebruikte UOB data |
| ..\\CadContent | Alle gebruikte UOB template objecten |
In de map %localappdata%\Cadac Group\Temp\20xx worden alle tijdelijke bestanden opgeslagen.
Tevens zijn de .addin bestanden toegevoegd aan de daarvoor aangewezen locaties van Autodesk Revit.
Register bij een standaard installatie
Nadat de installatie wordt voltooid, worden er instellingen weggeschreven in het register.
De meeste instellingen kunnen via de addin worden gewijzigd!
Het is niet toegestaan instellingen rechtstreeks te wijzigen in het register. Dit kan leiden tot storingen!
Gedurende de installatie worden de settings ingesteld.
- Bij een 'User Installatie' wordt alles weggeschreven in:
Computer\HKEY_CURRENT_USER\SOFTWARE\Cadac Group\TheModus Revit Addin\ - Bij een 'Admin Installatie' wordt alles weggeschreven in:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Cadac Group\TheModus Revit Addin\'
Afhankelijk van het installatietype worden vervolgens de volgende instellingen weggeschreven:
- ..\Config\Messages, met daarin:
- Messagelevel
- 0 = Geen updatemeldingen in Addin
- 1 = Alleen verplichte updatemelding
- 2 = Alle updatemeldingen
- Loggingsettings
- append="true"
- filename="{path}"
- maxparts="20"
- maxsize="10240"
- rotate="weekly"
- reconnect="true"
- reconnect.interval="5"
- Messagelevel
- ..\Config\Paths, met daarin:
- Admin:
- 0 = User installatie
- 1 = Admin installatie
- InstallPath: Padverwijzing naar installatiebestanden (bij admin procedure)
- ConfigPath: Padverwijzing naar configuratiebestanden (bij admin procedure)
- ContentPath: Padverwijzing naarcontentbestanden (bij admin procedure)
- TempPath: Padverwijzing naar tijdelijke bestanden
- UserContentPath: Padverwijzing naar eigen contentbestanden
- Admin:
- ..\Config\User
- Language
- En-US voor een Engelstalige TheModus
- nl-NL voor een Nederlands talige TheModus
- LastDB: verwijzing naar de laatst gebruikte database
- Visibility:
- 0 = uitgegrijsde ribbonknoppen worden niet getoond in de ribbon
- 1 = uitgegrijsde ribbonknoppen zijn zichtbaar
- Language
- ..\Config\Web:
- AppURL verwijst naar het TheModus User management. Deze is "https://themodus.cadac.com/"
- WebURL verwijst naar de Themodus Website. Deze is "https://themodussuite.cadac.com/"
Verder worden in de Computer\HKEY_CURRENT_USER\SOFTWARE\Cadac Group\TheModus Revit Addin\ diverse sleutels weggeschrevn afhankelijk van het gebruik van de verschillende toepassingen. De belangrijkste kunnen worden gewijzigd vanuit het 'instellingen' menu in de addin.
Deployment
Een systeembeheerder kan Cadac TheModus uit laten rollen aan de hand van een “deployment procedure”. De systeembeheerder moet in Microsoft Windows bekend zijn als een “Beheerder”
Via een deployment procedure kunnen afwijkende paden worden opgegeven.
Voor een deployment is het noodzakelijk om parameters mee te geven. Zie onderstaande welke parameters beschikbaar zijn:
| Parameter | Omschrijving |
ADMIN | Geeft aan dat er gebruik wordt gemaakt van een administratieve installatie |
TARGETDIR | Geeft het pad aan waar TheModus geïnstalleerd wordt |
CONFIGPATH | Geeft het pad aan waar TheModus de configuratiebestanden kan vinden |
CONTENTPATH | Geeft het pad aan waar TheModus de content bestanden kan vinden |
USERCONTENTPATH | Geeft het pad aan waar TheModus de eigencontent bestanden kan vinden |
TEMPPATH | Geeft het pad aan waar TheModus tijdelijk mag schrijven |
MESSAGELEVEL | Geeft aan in welke mate update meldingen getoond mogen worden bij de gebruiker. Bij deze parameter zijn de volgende opties:
|
VISIBILITY | Geeft aan of eventuele uitgegrijsde knoppen in de addin mogen worden getoond. Knoppen worden uitgegrijsd als de gebruiker geen rechten heeft voor de feature. Bij deze parameter zijn de volgende opties:
|
Indien gebruik wordt gemaakt van een deployment procedure zijn enkele opmerkingen van toepassing:
- De installatie kan alleen plaatsvinden onder beheerdersprivileges;
- De beheerder is zelf verantwoordelijk voor de inrichting van TheModus;
- Indien de beheerder kiest om de automatische update te blokkeren, dan moet de beheerder zelf tijdig de update faciliteren;
- Bij het faciliteren van updates, moeten altijd de oorspronkelijke paden weer worden weergegeven. Als dit niet gebeurt kan dit leiden tot storingen;
- Er zijn opmerkingen over de update procedure. Zie het hoofdstuk Updates;
- De log paden kunnen niet worden gewijzigd;
- De gebruiker moet schrijfrechten hebben in de 'Config' paden;
- Bij een deïnstallatie altijd dezelfde procedure gebruiken. Bij deïnstallatie blijven altijd registry keys achter onder de HKEY_CURRENT_USER.
Voorbeeld deployment
Met name voor testdoeleinden zijn onderstaande voorbeelden beschikbaar gesteld. Onderstaande paden en naam installatiepakket moet worden gewijzigd.
Verwerk dit commando in een “Batch” bestand!
Voor een installatie:
d:
msiexec /i TheModus.Revit.Addin.Installer.msi ADMIN="1" TARGETDIR="C:\Cadac Group" CONFIGPATH="C:\Cadac Group\TheModus Revit Addin\Config\" CONTENTPATH="C:\Cadac Group\TheModus Revit Addin\Content\" TEMPPATH="C:\Cadac Group\Temp\" USERCONTENTPATH="C:\Cadac Group\TheModus Revit Addin\UserContent\" MESSAGELEVEL="1" VISIBILITY="0" /l*v TheModusPROInstall.txt
pause
Voor het verwijderen van een installatie:
d:
msiexec /uninstall TheModus.Revit.Addin.Installer.msi ADMIN="1" TARGETDIR="C:\Cadac Group" CONFIGPATH="C:\Cadac Group\TheModus Revit Addin\Config\" CONTENTPATH="C:\Cadac Group\TheModus Revit Addin\Content\" TEMPPATH="C:\Cadac Group\Temp\" USERCONTENTPATH="C:\Cadac Group\TheModus Revit Addin\UserContent\" MESSAGELEVEL="1" VISIBILITY="0" /qb /l*v TheModusPROUninstall.txt
pause
N.B.
Een deployment kan alleen worden uitgevoerd als u admin privileges heeft in uw Windows omgeving!
Installatie procedure t.b.v. admin installatie o.b.v. script (*.bat)
Nadat het installatie script is gemaakt dient de volgende werkwijze aangehouden te worden:
- Start de Commandprompt (CMD) middels 'Run as administrator/Als administrator uitvoeren';
- Wijzig de folder naar de folder waarin het script (*.bat) staat. (CD Folder\Subfolders);
- Geef de naam van het script;
- Indien er een spatie in de naam zit dient de naam tussen " " opgegeven te worden.
- Indien er geen spatie in de naam zit kan de naam zonder " " opgegeven worden.
De installatie wordt uitgevoerd.
- Na de installatie kan de Commandprompt worden afgesloten.
Register na deployment
Nadat de installatie via een deployment wordt voltooid, worden er instellingen weggeschreven in het register. Zie hiervoor het hoofdstuk “Basisinstallatie”
Indien de installatie plaatsvindt op administratieve basis dan worden de instellingen in het register gezet onder de HKEY_Local_Machine. De eerste keer dat een gebruiker zich dan aanmeldt wordt gecontroleerd of er instellingen beschikbaar zijn onder de HKEY_Current_User. Indien dat niet het geval is dan worden deze overgenomen vanuit de HKEY_Local_Machine voor deze (nieuwe) gebruiker.
Als de beheerder een nieuwe installatie uitvoert op administratieve basis, dan moeten de oorspronkelijke paden worden meegegeven. Gedurende een nieuwe installatie of update worden altijd de paden zoals beschikbaar in het register gerespecteerd.
Indien een beheerder besluit andere paden te kiezen, dan moet de beheerder deze paden zowel in de HKEY_Local_Machine bijwerken, alsmede bij de HKEY_Current_User. Bij het opstarten van TheModus worden altijd de paden gebruikt zoals opgegeven bij de HKEY_Current_User.
Bij Cadac maken we onderscheid tussen Sales, Service & Support. Sales & Service vinden wij vanzelfsprekend. Wij helpen u met de aanschaf van uw product, dienst, training of expert en zorgen ervoor dat u probleemloos aan de slag kunt. Gratis en voor niets. U kunt zorgeloos met uw software starten, wij zorgen ervoor dat u het meeste uit uw software kunt halen.
Loopt u tegen technische softwareproblemen aan? Dan kunt u gebruik maken van Cadac Support. Door de juiste informatie in te dienen kunnen wij u zo snel mogelijk helpen
