﻿VIEWIQ CONNECT 0.3.13 - Revit-plugin
====================================

Met ViewIQ Connect publiceer je je Revit-model met een paar klikken naar
ViewIQ (https://app.viewiq.nl). Werkt in Revit 2023, 2024, 2025, 2026 en 2027.

Taal: Connect is er in het Nederlands, Engels en Duits. Deze download staat
op Nederlands. Een andere taal kies je in Revit op het tabblad Add-Ins bij
ViewIQ Connect > Instellingen > "Taal / Language / Sprache". Connect onthoudt die keuze, ook na een update.
(English: README.txt in the English download. Deutsch: LIESMICH.txt in der
deutschen Version. Both/beide: https://viewiq.nl/download/)


1. WAT HEB JE NODIG
-------------------

- Een account op https://app.viewiq.nl. Dat krijg je via een
  uitnodigingslink per mail.
- Een project in ViewIQ waarin je MODELLEUR of BEHEERDER bent.
  Ben je beheerder van je organisatie, dan maak je zelf een project:
  Projecten > Nieuw project.
  Zonder zo'n project ziet Connect niets om naartoe te publiceren.
- Revit 2023, 2024, 2025, 2026 of 2027. Geen beheerdersrechten nodig.
- Gebruik je een oudere versie dan 0.3.13, installeer deze versie dan
  over de oude heen; je API-sleutel en instellingen blijven werken.


2. CONTROLEER EERST DE DOWNLOAD
-------------------------------

ViewIQ Connect is nog niet digitaal ondertekend; een ondertekende
versie volgt zodra ons certificaat (SSL.com) is uitgegeven. Tot die tijd kunnen Windows en Revit bij het
installeren een waarschuwing tonen, en daarom controleer je ZELF, voor je iets installeert, dat de zip echt van
ViewIQ komt en onderweg niet is veranderd. Dat doe je met het SHA-256-
controlegetal:

1. Open https://viewiq.nl/download/ en zoek het controlegetal van deze
   versie (0.3.13). Het staat ook in het bestand
   ViewIQ-Connect-0.3.13.zip.sha256 naast de download.
2. Bereken het controlegetal van de zip die je hebt gedownload:
   - PowerShell:       Get-FileHash .\ViewIQ-Connect-0.3.13.zip -Algorithm SHA256
   - Opdrachtprompt:   certutil -hashfile ViewIQ-Connect-0.3.13.zip SHA256
3. Vergelijk de twee. Ze moeten PRECIES gelijk zijn (hoofdletters doen er
   niet toe).

Klopt het niet? Installeer dan NIETS en mail security@viewiq.nl.
Klopt het wel? Dan weet je dat de waarschuwingen hieronder alleen gaan
over het ontbreken van een handtekening, niet over de inhoud.


3. INSTALLEREN
--------------

1. Pak de zip HELEMAAL uit: rechtsklik op de zip > Alles uitpakken.
   Start niets vanuit de zip zelf.
2. Sluit Revit.
3. Dubbelklik in de uitgepakte map op Installeren.cmd.
   Zie je "Windows heeft uw pc beschermd" (SmartScreen)? Dat kan
   zolang de validatie van ons certificaat loopt.
   Alleen als het controlegetal klopte: klik op Meer informatie en
   daarna op Toch uitvoeren.
   Connect wordt geinstalleerd voor elke Revit-versie (2023-2027) op je pc.
4. Start Revit. Revit vraagt de eerste keer of je de add-in vertrouwt,
   zolang de handtekening nog niet gevalideerd is. Controleer dat de melding
   "ViewIQ Connect" van "Nexorah Group B.V." noemt. Alleen als het
   controlegetal klopte: kies "Altijd laden". Twijfel je: kies "Niet
   laden" en mail ons.

Je ziet nu op het tabblad Add-Ins het paneel ViewIQ Connect met de knoppen
Publiceren en Instellingen. (Tot en met versie 0.3.12 had Connect een eigen
tabblad ViewIQ; dat is vanaf 0.3.13 weg.) Hulp nodig? Wijs een knop van
Connect aan en druk op F1: dan opent de handleiding op viewiq.nl.

Installeren zonder script (als scripts door je bedrijf geblokkeerd zijn):
1. Controleer eerst het controlegetal (hoofdstuk 2).
2. Klik met rechts op de zip > Eigenschappen. Staat onderaan
   "Blokkering opheffen"? Vink aan, klik OK en pak de zip daarna
   (opnieuw) uit. Anders laadt Revit de bestanden niet.
3. Sluit Revit.
4. Open in Verkenner:  %AppData%\Autodesk\Revit\Addins\<jaar>\
   (bijv. ...\Addins\2025\). Bestaat de map niet, maak hem dan aan.
5. Kopieer uit de uitgepakte map <jaar>\ het bestand ViewIQ.addin en de
   map ViewIQ daarnaartoe. Je krijgt dan:
     ...\Addins\2025\ViewIQ.addin
     ...\Addins\2025\ViewIQ\ViewIQ.Connect.Revit.dll  (en de andere DLL's
                                                    en taal.txt)
6. Start Revit en kies "Altijd laden" (alleen na de controle van stap 1).

Beheert de IT-afdeling van je bedrijf welke software mag draaien
(AppLocker, WDAC)? Geef ze dan het controlegetal en deze LEESMIJ; zodra
Connect ondertekend is, krijgen zij bericht.


4. SLEUTEL MAKEN EN INSTELLEN (eenmalig)
----------------------------------------

Connect logt in met een API-sleutel, niet met je wachtwoord.

1. Log in op https://app.viewiq.nl.
2. Klik rechtsboven op je naam > Mijn account.
3. Ga naar "API-sleutels (ViewIQ Connect)".
4. Vul een naam in, bijvoorbeeld "Revit laptop".
5. Klik op Nieuwe sleutel en daarna op Kopieer.
   Je ziet de sleutel maar een keer. Kwijt? Maak gewoon een nieuwe.
6. In Revit: tabblad Add-Ins > ViewIQ Connect > Publiceren (of Instellingen).
7. Laat het serveradres staan (https://app.viewiq.nl), plak je sleutel
   en klik op Opslaan. Connect test de sleutel meteen.

De sleutel wordt versleuteld bewaard voor jouw Windows-account, en hoort
bij het serveradres waarvoor je hem hebt opgeslagen. Connect werkt
alleen met het ViewIQ-adres https://app.viewiq.nl. Vraagt iemand je
om bij Instellingen een ander adres in te vullen ("support", "backup",
een cijferadres)? Doe dat niet en meld het bij je beheerder: Connect
weigert zo'n adres, en na een adreswijziging vraagt hij altijd opnieuw
om je sleutel. Stond er van een eerdere versie nog een ouder
ViewIQ-adres ingevuld, dan zet Connect dat zelf om naar
https://app.viewiq.nl; je sleutel blijft dan gewoon werken.

Een account is persoonlijk en Connect werkt per account op EEN pc.
De eerste pc waarop je publiceert, wordt aan je account gekoppeld.
Nieuwe of andere pc? Vraag de beheerder van je organisatie om de oude
pc vrij te geven (in ViewIQ: Organisatie > bij je naam "Pc vrijgeven").
Connect stuurt daarvoor alleen een versleutelde computercode en de
pc-naam mee, en je Revit-gebruikersnaam.

Je ViewIQ-account hoort ook bij EEN Autodesk-account (je login in Revit,
rechtsboven). De eerste keer dat je met Connect werkt, koppelt ViewIQ je
account aan het Autodesk-account waarmee Revit is ingelogd. Werkt iemand
anders met een eigen Autodesk-account onder jouw ViewIQ-account, dan zegt
Connect: "Dit ViewIQ-account is gekoppeld aan een ander Autodesk-account.
Vraag je beheerder om de koppeling vrij te geven." Nieuwe medewerker op dit
account of een ander Autodesk-account? De beheerder van je organisatie geeft
de koppeling vrij (in ViewIQ: Organisatie > bij je naam "Autodesk
vrijgeven"). Connect stuurt alleen een versleutelde code van je
Autodesk-account mee, nooit je Autodesk-naam of e-mailadres.
Niet ingelogd bij Autodesk (bijv. een offline-licentie)? Publiceren kan
gewoon; Connect meldt het en ViewIQ legt vast dat het zonder Autodesk-login
gebeurde.


5. PUBLICEREN
-------------

1. Klik op Add-Ins > ViewIQ Connect > Publiceren.
2. Kies het project.
3. Kies:
   - "Nieuw model": vul een naam en discipline in, of
   - "Nieuwe versie van een bestaand model": deze staat al klaar als er in
     ViewIQ een model met dezelfde naam is. Kies je toch "Nieuw model",
     dan krijg je een tweede (dubbel) model.
4. Kies bij "Wat gaat mee":
   - 3D-view: alleen wat in die view zichtbaar is gaat mee (een sectiebox
     en verborgen elementen tellen mee), of "Hele model".
     Connect kiest zelf voor: de view van de vorige keer bij dit model,
     anders een view met ViewIQ, IFC of Dalux in de naam, anders de 3D-view
     die open staat, anders het hele model.
     Tip: maak een vaste 3D-view "ViewIQ" zonder sectiebox.
     Onder de keuze zie je hoeveel elementen meegaan en hoeveel het er bij
     de vorige publicatie waren. Zijn het er meer dan 30% minder, dan vraagt
     Connect eerst of dat klopt (half model door een sectiebox of
     detailview?).
   - IFC-instellingen: "ViewIQ-standaard" (IFC4 Reference View, gedeelde
     coordinaten, eigenschappen en hoeveelheden; vormen als driehoeken, dat
     exporteert sneller, elementen, eigenschappen en GUID's blijven gelijk),
     of een IFC-
     exportconfiguratie die in het model is opgeslagen, bijvoorbeeld die
     uit je BIM-uitvoeringsplan met NL-SfB-classificatie en een
     parameterbestand voor IfcName. Zo'n configuratie maak je in Revit via
     Bestand > Exporteren > IFC > Setup wijzigen; sla hem op in het model.
     IFC-instellingen worden per Revit-model bewaard: maak ze aan in het
     model dat je publiceert. In een ander model staan ze er niet.
     Het parameterbestand moet op deze pc op dezelfde plek staan; staat het
     er niet, dan zegt Connect dat onder de keuze.
   - Fase: "Standaard" (de fase van de view), of een vaste fase.
   Connect onthoudt deze keuzes per Revit-model.
5. Vul eventueel een opmerking in (wat is er veranderd?) en klik Publiceren.
   Connect vraagt ViewIQ eerst of er iets gewijzigd is en of de coordinaten
   kloppen (zie hieronder). Dat duurt een paar seconden, de export niet.
   Krijgen meerdere niveaus in de IFC dezelfde naam (bijvoorbeeld omdat de
   parameter IfcName op alle niveaus hetzelfde is), dan waarschuwt Connect
   eerst: ViewIQ toont ze dan als een verdieping. Geef elk niveau een eigen
   IfcName, of maak die parameter leeg; dan geldt de niveaunaam.
6. Revit reageert tijdens de IFC-export niet. Dat is normaal: sluit Revit
   niet af. Connect laat ViewIQ elke minuut weten dat hij bezig is. Bij een
   groot installatiemodel kan de export (van Revit zelf) lang duren. Heb je
   dit model eerder gepubliceerd, dan zie je vooraf en tijdens de export hoe
   lang het de vorige keer duurde, bijvoorbeeld "Vorige keer duurde
   exporteren 3 uur 3 min.".
   Een klein venster telt mee: hoeveel elementen Revit al heeft verwerkt
   (dezelfde teller als onderin de statusbalk van Revit), hoe lang het al
   bezig is en ongeveer hoe lang het nog duurt.
   Daarna pakt Connect het IFC-bestand in als .ifczip (een zip met het
   IFC-bestand erin, meestal 80 tot 90% kleiner). Je ziet de grootte voor
   en na, bijvoorbeeld "IFC 555 MB -> ingepakt 61 MB". Uploaden en
   verwerken lopen daarna op de achtergrond.
7. Klaar? Klik op "Openen in ViewIQ".

Niets gewijzigd:
- Is het model opgeslagen, sinds de laatste versie niet veranderd, en zijn
  de 3D-view, IFC-instellingen en fase hetzelfde, dan exporteert Connect
  niet. Je ziet "Niets gewijzigd sinds versie N". Dat werkt ook als een
  collega de vorige versie vanaf een andere pc publiceerde.
- Wil je toch een nieuwe export? Klik op "Toch publiceren".
- Niet opgeslagen wijzigingen? Dan exporteert Connect altijd.

Coordinatencheck:
- Connect stuurt voor de export de actieve projectlocatie van je model mee
  (hoek, oost-west, noord-zuid, hoogte). ViewIQ vergelijkt die met het
  model met discipline Bouwkundig in het project. Het verschil mag hooguit
  10 mm en 0,01 graad zijn.
- Wijkt je model af, dan waarschuwt Connect met een melding als
  Dit model staat 111 graden 39' 36" gedraaid, BWK staat op 0 graden.
  Publiceren gaat door; ook de viewer laat de waarschuwing zien.
  Controleer in Revit Manage > Location (Location Weather and Site) en, bij
  gelinkte modellen, of de coordinaten gedeeld zijn.
- Stopt Connect toch voor de export? Dan staat de blokkade op de server
  aan. De beheerder van het project kan dan zelf publiceren: reden
  invullen en "Toch publiceren". Dat geldt voor die ene publicatie en
  komt in het auditlog. Een modelleur kan dit niet opheffen.
- Is het model in de viewer uitgelijnd met Modellen uitlijnen, dan krijg
  je alleen een waarschuwing, ook als de blokkade aan staat.
- Staat er nog geen bouwkundig model in het project, of is dat nog niet
  met Connect 0.3.5 gepubliceerd, dan waarschuwt Connect en gaat het door.
  Publiceer daarom het bouwkundige model als eerste met deze versie.
- Wijken twee bouwkundige modellen onderling af, dan stopt Connect voor
  elk model in het project tot die twee gelijk staan. De melding noemt ze.
- In de viewer staat bij een afwijkend model een waarschuwing, met de knop
  Modellen uitlijnen. Lijn je het uit, dan verdwijnt de waarschuwing.

Connect meldt elke minuut aan ViewIQ hoe ver de publicatie is (model,
project, stap, tijd per stap), ook terwijl Revit stilstaat. Daar zie je
zelf niets van; lukt het melden niet, dan gaat het publiceren gewoon door.

Een publicatie mag zo groot zijn als de server toestaat (nu 3000 MB,
ingepakt). Connect toetst dat direct na het inpakken. Te groot? Publiceer
uit een 3D-view met minder zichtbaar, bijvoorbeeld alleen jouw discipline.

Werkgedeeld model / Autodesk Docs (ACC, BIM 360):
- Connect stelt de naam van het centrale model voor, niet die van je
  lokale kopie. Publiceren vanuit je lokale kopie is prima.
- Gelinkte modellen gaan niet mee. Publiceer elke discipline apart.

Modellen op elkaar (coordinaten):
- Connect exporteert met de Revit-standaardinstellingen en gedeelde
  coordinaten. Publiceer bouwkundig en installaties het liefst allebei
  via Connect, dan vallen ze in ViewIQ op elkaar.
- Kies je een eigen IFC-exportconfiguratie, dan gelden de coordinaat-
  instellingen uit die configuratie. Gebruik dan voor alle disciplines
  dezelfde coordinaatbasis.
- Exporteer je toch handmatig: Bestand > Exporteren > IFC, laat de
  standaardinstellingen staan en kies bij coordinaatbasis "Gedeelde
  coordinaten". Zet "IFCSITE-hoogte opnemen..." NIET aan. Mix je die
  instelling, dan staan modellen in hoogte verschoven.

Kleuren per systeem in de viewer:
- Elementen met connectoren (kanalen, leidingen, fittingen, roosters,
  toestellen) komen in hun systeem en krijgen de systeemkleur.
- Isolatie, ophangingen en generieke modellen horen bij geen systeem.


6. PROBLEMEN
------------

Logbestand: klik in het venster op "Logbestand openen", of open
  %AppData%\ViewIQ\connect.log
  Stuur dat bestand mee als je een probleem meldt. Je sleutel staat er
  niet in.

"Je API-sleutel werkt niet (meer)."
  Maak een nieuwe sleutel (zie 4) en plak hem bij Instellingen.

"ViewIQ Connect werkt alleen met het ViewIQ-adres ..."
  Het ingevulde serveradres is niet het ViewIQ-adres. Zet het terug op
  https://app.viewiq.nl. Heeft iemand je gevraagd een ander adres in te
  stellen? Meld dat bij je beheerder.

"Je opgeslagen API-sleutel hoort bij ..., niet bij ..."
  Het serveradres is gewijzigd na het opslaan van de sleutel. Plak bij
  Instellingen (opnieuw) een sleutel voor dit adres.

"Geen verbinding met ViewIQ."
  Controleer je internet. Via een bedrijfsproxy of VPN gebruikt Connect
  de proxy van Windows met je Windows-account.

"De proxyserver van je bedrijf blokkeert ViewIQ." (fout 407)
  Vraag je IT-afdeling om app.viewiq.nl toe te staan.

"Het IFC-bestand is ... MB; ViewIQ accepteert tot ... MB."
  Publiceer uit een 3D-view met minder zichtbaar.

"Je zit nog in geen enkel project" / "Je bent alleen kijker"
  Vraag de beheerder om je als modelleur aan een project toe te voegen.

"De verbinding is weggevallen tijdens het uploaden."
  Klik op Hervatten. Connect gaat verder waar hij was.

"Dit model is alleen-lezen geopend."
  Open het model gewoon (niet alleen-lezen) en publiceer opnieuw.

"Let op: ..% minder elementen dan de vorige publicatie"
  Controleer de gekozen 3D-view: staat er een sectiebox aan, zijn er
  elementen verborgen, of is het een detailview? Kies anders je vaste
  export-view of "Hele model". Klopt het wel (bijv. model opgeschoond),
  klik dan op Ja.

"Dit model staat ... gedraaid, BWK staat op ..." / "... verschoven ..."
  Zie Coordinatencheck bij 5. Publiceren. Je model staat niet op dezelfde
  plek als het bouwkundige model.

"De bouwkundige modellen wijken onderling af"
  Zet die twee eerst gelijk; zolang is niet duidelijk wat de referentie is.

"Let op: .. niveaus krijgen in de IFC dezelfde naam"
  Zie stap 5 bij Publiceren: geef elk niveau een eigen IfcName.

"... staat in ViewIQ, maar let op: Dit model heeft geen eigenschappen."
  (vanaf Connect 0.3.10) Het model staat in ViewIQ, maar zonder
  eigenschappen (of met veel minder dan de vorige versie). Kies bij
  IFC-instellingen de ViewIQ-standaard, of zet in je eigen IFC-configuratie
  de eigenschapsets aan (Revit-eigenschapsets en IFC-eigenschapsets).
  Publiceer daarna opnieuw. Gebruik bij Revit 2026 minimaal Connect 0.3.9.

"De IFC-export met de configuratie ... is mislukt."
  Kies bij IFC-instellingen de ViewIQ-standaard, of open de configuratie
  in Bestand > Exporteren > IFC en exporteer daar zelf om de fout te zien.

"De IFC-export is mislukt."
  Probeer Bestand > Exporteren > IFC zelf; daar zie je meestal wat er
  misgaat.

Paneel ViewIQ Connect ontbreekt
  Connect staat sinds 0.3.13 op het tabblad Add-Ins, niet meer op een
  eigen tabblad ViewIQ. Revit na het installeren opnieuw gestart? Bij de
  vraag van Revit "Niet laden" gekozen? Installeer dan opnieuw.
  Had je zelf een sneltoets of een knop op de werkbalk Snelle toegang
  gemaakt voor Publiceren of Instellingen? Stel die na de update opnieuw
  in; de oude verwijst nog naar het tabblad ViewIQ.

Sleutel intrekken (bijv. laptop kwijt)
  app.viewiq.nl > je naam > Mijn account > API-sleutels > intrekken.
  Je wachtwoord wijzigen trekt al je sleutels in.

Verwijderen
  Sluit Revit en dubbelklik Verwijderen.cmd in de uitgepakte map.


Nexorah Group B.V. - viewiq.nl
